Skip to main content

Troubleshooting

Common issues encountered when installing or configuring EasyMenu 7 and how to resolve them.

1. Plugin disables with EasyMenu requires NegiLib 1.x​

Cause​

The required NegiLib plugin JAR is missing from your server's plugins/ directory or an outdated version is installed.

Solution​

  1. Verify that NegiLib-1.1.0.jar (or latest NegiLib 1.x) is present in plugins/.
  2. Restart the server.

2. /menu reload fails or changes do not appear​

Cause​

There is a syntax error (e.g. YAML indentation), an unrecognized material name, duplicate slots/IDs, or a reference to a missing menu in open-menu.

Solution​

  1. Check the server console for diagnostic messages containing codes such as [unknown-material] or [duplicate-slot].
  2. Correct the identified YAML lines and re-run /menu reload.

3. Dynamic open-command does not work​

Cause​

  • Player lacks required permissions.
  • The command name conflicts with an existing command registered by another plugin (e.g. EssentialsX).

Solution​

  1. Set permission-default: true to allow all players or grant the permission via your permission manager.
  2. If conflicting with another plugin, rename open-command.name or adjust its aliases.

4. Menu opens as a Chest UI instead of a Native Dialog​

Cause​

  • Server is running Minecraft 1.21.5 or earlier (Dialog API was introduced in Paper 1.21.6).
  • dialog: true or presentation.mode: native-preferred is not configured in the menu YAML.

Solution​

  1. Ensure your server is running Paper / Purpur 1.21.6 or later.
  2. Fallback to Chest UI on unsupported versions is expected, automatic behavior.

5. Enabling Verbose Debug Logging​

Enable debug mode in plugins/EasyMenu/config.yml:

plugins/EasyMenu/config.yml
debug: true

Run /menu reload to begin logging detailed parsing, condition evaluation, and interaction traces to your console.