Class: FantasyReturnService

クラス説明

Fantasia と現世のインベントリ/ゲームモードを安全にスワップするサービス。

重要な修正点:
- Fantasia滞在中の「現世側インベントリ(outside)」を必ずディスクへ永続化し、再起動後も /fantasy back で復元できる
- ログアウト時に outside を削除しない（Fantasia滞在中に再起動しても戻れる）
- outside が無い場合は絶対に外へ出さない（戻った瞬間に空になったように見える事故を防ぐ）

責務と見どころ

• イベント駆動 — Bukkit イベントやコールバックを受けて後続処理を分岐します。
• 非同期 / スケジューラ — 重い処理をメインスレッドから切り離し、定期実行も管理します。
• サービス層 — 業務ロジックを公開し、呼び出し側の窓口になります。

フィールド

コンストラクタ / 初期化

メソッド索引

メソッド詳細

代表的な処理フロー

1. 初期化フロー
   FantasyReturnService → getDataFolder → exists → mkdirs → getPluginManager → registerEvents
   依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
2. onQuit フロー
   onQuit → getPlayer → getUniqueId → isFantasiaGroup → getWorld → saveInsideSnapshot
   Fantasia滞在中にログアウトしても outside を消さない。
3. onStep フロー
   onStep → getPlayer → isFantasiaGroup → getWorld → hasMetadata → getName
   returnPad を踏んだら帰還（存在する構造に依存するので「同一ブロックにいるか」だけ判定）
4. onWorldChange フロー
   onWorldChange → getPlayer → hasMetadata → getUniqueId → currentTimeMillis → getFrom
   イベント発生時の分岐と後続処理を担当します。
5. loadInsideSnapshot フロー
   loadInsideSnapshot → file → exists → loadConfiguration → castList → getList
   必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
6. loadOutsideData フロー
   loadOutsideData → outsideFile → outsideRecoveryFile → exists → loadConfiguration → castList
   必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

外部との接点

関連クラス

• ArenaDimensionManager (minigame.arena) — Arena Dimension Manager に関する管理・集約処理を担当します。

補足

• メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
• 匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。