Skip to main content

Troubleshooting

Start by checking the EasyMenu messages in the server console.

Check these items.

  • EasyMenu 6 was enabled during server startup.
  • The server uses Java 17 or later.
  • plugins/EasyMenu/main.yml exists.
  • menu-size is a multiple of 9 and no larger than 54.
  • Every item material exists in the current server version.

Reload fails​

/menu reload fails when a configuration contains a structural error.

Common causes include:

  • Incorrect YAML indentation
  • An invalid material name
  • A slot outside the menu size
  • Both action and actions on one item
  • An input command without {input}
  • timeout-seconds set to zero or less
  • Multiple items using the same slot

EasyMenu keeps the old settings after a failed reload.

Fix the console error and run reload again.

A placeholder is shown as text​

  1. Confirm that PlaceholderAPI 2.11.7 or later is installed.
  2. Confirm that the required expansion is installed.
  3. Test the value with PlaceholderAPI's /papi parse me <placeholder> command.
  4. Restart the server.

Without PlaceholderAPI, text such as %player_name% remains unchanged.

A language key is shown​

EasyMenu 6.0.0 fills messages missing from an old user file with bundled language defaults.

If a key such as input.timeout is still visible, confirm that the server uses EasyMenu 6.0.0 or later and run /menu reload.

A submenu cannot be found​

The ID for sub/shop.yml is shop.

/submenu shop

Menu IDs cannot contain /, \, .., or :.

Get more help​

Report the problem in the Discord support channel with this information:

  • EasyMenu version
  • Minecraft server name and version
  • Java version
  • YAML that produces the error
  • Relevant console log