📕 運営ハンドブック

OP向け情報

このセクションは運営者向けです。「見るだけで運営ができる」 ことを目標に、やりたいこと別に具体的なコマンド手順をまとめています。

🔎 やりたいことから探す

やりたいこと	ページ	代表コマンド
プレイヤーのレベル・所持金を調整したい	👤 プレイヤー対応	/mmoadmin setlevel /money give
消えたアイテム・装備を再交付したい	👤 プレイヤー対応	/item give /equip give
ワープストーンを配りたい・個人ワープを管理したい	👤 プレイヤー対応	/pwarp give
クエストが詰まったプレイヤーを助けたい	👤 プレイヤー対応	/quest admin
イベントでボスを出したい	🎉 イベント運営	/boss spawn
経験値ブーストをかけたい	🎉 イベント運営	/mmoadmin boost
参加賞・記念品を配りたい	🎉 イベント運営	/item give /title give
新アイテム・新モブ・新クエストを追加したい	🔄 コンテンツ追加・設定変更	yml編集 → 各reload
ymlを変更してサーバーに反映したい	🔄 コンテンツ追加・設定変更	/mmo reload ほか
このWIKI自体を更新したい	🔄 コンテンツ追加・設定変更	.\scripts\update.ps1
プラグインを新バージョンに更新したい	🛠️ メンテナンス	mvn clean package
バックアップを取りたい・復元したい	🛠️ メンテナンス	—
何かが壊れた・動かない	🧯 トラブルシューティング	—
コマンドの正確な構文・権限を調べたい	📖 コマンド・権限リファレンス	—
どのymlがどこに効くか調べたい	🗺️ 設定ファイルマップ	—
敵・ボス・NPCの配置を設定したい	🐾 雑魚敵 / 🐉 ボス / 🧑 NPC	/npc spawn など
ダンジョンの入口を設定したい	🏰 ダンジョン設定	/dungeon setspawn
農園・遺跡（採集ノード）を設置したい	🌿 採集ノード設営	/farming add /archaeo add
プレイヤーにMMOツールを配りたい	🌿 採集ノード設営	/mmotool give

🧭 運営の基本ルール

1. 権限の前提

管理コマンドはOP権限(/op <player>)が前提です。個別権限(mmo.admin など)の詳細はコマンド・権限リファレンスを参照してください。

2. 設定変更は「編集 → reload → 確認」の3点セット

ymlを編集したら、対応するreloadコマンドを実行し、必ずゲーム内で反映を確認します。どのファイルがどのreloadに対応するかは設定ファイルマップにまとまっています。迷ったら /mmo reload が全体を再読み込みします。

3. プレイヤーデータには直接触れない

plugins/MattariMMO/03_プレイヤー/ 配下はプレイヤーの行動で自動更新されるデータです。手編集するとロールバック事故の原因になります。詳細は設定フォルダ構成を参照。

4. 破壊的コマンドはテストしてから

/mmoadmin reset や /boss spawn などは、本番投入前に別ワールドや自分自身で動作確認するのが安全です。

5. 変更したらWIKIも更新

ymlやソースを変更したら .\scripts\update.ps1 "変更内容" を実行するだけで、構文チェック → バックアップ → push → このサイトの自動更新まで完了します。詳細はコンテンツ追加・設定変更へ。