Skip to main content

Upgrading

EasyMenu 6 continues to support the EasyMenu 5.x YAML format.

Back up both plugins/EasyMenuPlugin and plugins/EasyMenu before upgrading.

Upgrade steps

  1. Stop the server.
  2. Back up the old plugin JAR and configuration folders.
  3. Replace the JAR with EasyMenu 6.
  4. Start the server.
  5. Confirm that the console reports EasyMenu has been enabled.
  6. Run /menu reload and confirm that no configuration error appears.

Folder migration

EasyMenu migrates this EasyMenu 5.x folder when the new folder does not exist yet.

plugins/EasyMenuPlugin/

The new location is:

plugins/EasyMenu/

When an old config.yml contains the main menu and main.yml does not exist, EasyMenu moves the menu section into main.yml.

Supported legacy settings

  • location: "5,3"
  • command: "/spawn"
  • command: "sub_shop"
  • command: "main_mainopen"
  • close-menu: true

Changed command

/menureload has been removed.

Use this command instead.

/menu reload

Its permission is easymenu.command.reload.

Configuration errors

EasyMenu 6 stops reload when it finds an invalid material, out-of-range slot, invalid action, duplicate slot, or invalid input action.

An unknown sound or background material produces a warning and uses a fallback value.

A failed reload keeps the last working menu available.