📂 設定フォルダ構成 (OP向け)

OP向け情報

plugins/MattariMMO/ 内のファイルは 3分類フォルダ に整理されています。 どのファイルを触ってよいか、フォルダ名で一目で判断できます。

3分類の考え方

各ファイルを「何がきっかけで変化するか」で 3 つに分けています。

フォルダ	区分	変化のきっかけ	OP の扱い
01_定義/	定義・設定	開発者が手編集したときだけ。実行時は変化しない	設定変更はここを編集 → reload
02_OP管理/	OP操作データ	OP がゲーム内コマンドを使うと変化する	原則コマンド経由で操作。直接編集は非推奨
03_プレイヤー/	プレイヤーデータ	プレイヤーの行動で自動的に変化する	絶対に手を触れない（消すとロールバック事故）

ルート直下の config.yml だけは Minecraft の慣例上ここに残ります（プラグイン全体設定）。

フォルダの中身

plugins/MattariMMO/
├── config.yml              ← プラグイン全体設定
│
├── 01_定義/                🟦 手編集してよい
│   ├── items.yml  enemies.yml  drops.yml  skills.yml  jobs.yml
│   ├── quests.yml  shops.yml  decorations.yml  fishing.yml
│   ├── mining.yml  farming.yml  archaeology.yml  collecting.yml
│   ├── excavation.yml  logging.yml  guild_atelier.yml
│   └── guild_furniture.yml  titles.yml  enhance.yml
│
├── 02_OP管理/              🟨 コマンドで変化
│   ├── field_spawns.yml  field_boss_spawns.yml  npc_data.yml
│   ├── mining_nodes.yml  farming_nodes.yml  excavation_nodes.yml
│   ├── collecting_nodes.yml  archaeology_nodes.yml  logging_nodes.yml
│   └── warps.yml  menu-warps.yml
│
├── 03_プレイヤー/          🟩 触らない
│   ├── playerdata/  (プレイヤー別データ＋quests/)
│   ├── bags/  storage/
│   ├── *_player_data.yml  player_levels.yml  craft_data.yml
│   ├── homes.yml  guilds.yml  mail_data.yml  market_data.yml
│   └── museum_data.yml  ranking_data.yml ほか
│
└── _旧版/                  🗑 旧バージョンの遺物（未使用）

旧構成からの自動移行

移行は自動・既存データは保持されます

プラグイン更新後の初回起動時、旧フラット構成（直下に全 yml）のファイルは 自動的に上記フォルダへ移動されます（LayoutMigration）。

• 移動先に同名ファイルが無いときだけ移動するため、既存データを上書きしません。
• 移行が完了すると .layout-v2 というマーカーファイルが作られ、次回以降はスキップされます。
• フラット構成へ戻して再移行したい場合は .layout-v2 を削除してください。

reload との関係

01_定義/ のファイルを編集したら、対応する reload コマンドで反映します （設定ファイルマップ を参照）。 02_OP管理/ 03_プレイヤー/ は reload ではなくプラグインが随時読み書きします。