メインコンテンツまでスキップ

トラブルシューティング

EasyMenu 7の利用時によくあるトラブルと、その解決方法です。

1. 起動時に EasyMenu requires NegiLib 1.x と表示されて無効化される​

原因​

plugins/ フォルダに必須の NegiLib プラグインJARが配置されていないか、古いバージョンが配置されています。

解決手順​

  1. サーバーの plugins/ フォルダ内に NegiLib-1.1.0.jar（または最新のNegiLib 1.x）が存在するか確認してください。
  2. サーバーを再起動します。

2. /menu reload で設定が反映されない・エラーになる​

原因​

YAMLファイル内に文法エラー（インデントのズレなど）、存在しない素材名、スロットの重複、存在しないメニューへの画面遷移（open-menu）が含まれている可能性があります。

解決手順​

  1. サーバーコンソールを確認し、出力されている診断メッセージ（[unknown-material]、[duplicate-slot] など）のメニュー名・行番号・要素IDを確認してください。
  2. 指摘された箇所のYAMLを修正し、再度 /menu reload を実行してください。

3. open-command で登録したコマンドが使えない​

原因​

  • 権限（パーミッション）が不足している。
  • 他のプラグイン（EssentialsXなど）が既に同名のコマンドを登録しているため、衝突を防ぐため登録が拒否された。

解決手順​

  1. permission-default: true を設定して一般プレイヤーに開放するか、LuckPerms等で適切なパーミッションを付与してください。
  2. コマンド名が他プラグインと重複している場合は、メニューの open-command.name または aliases を変更してください。

4. Native Dialogでメニューが開かない（チェストUIで開く）​

原因​

  • サーバーバージョンが Minecraft 1.21.5 以下である（Native Dialog APIは 1.21.6+ で追加されました）。
  • メニュー設定で dialog: true または presentation.mode: native-preferred が設定されていない。

解決手順​

  1. Minecraft 1.21.6 以降の Paper / Purpur サーバーを使用しているか確認してください。
  2. 非対応サーバーでは自動的にインベントリGUI（チェスト画面）で開く仕様となっており、正常な動作です。

5. デバッグログを有効にして詳細を確認したい​

plugins/EasyMenu/config.yml でデバッグログを有効化できます。

plugins/EasyMenu/config.yml
debug: true

保存後に /menu reload を実行すると、メニュー解析、条件判定、クリック処理の詳細ログがコンソールに出力されるようになります。