Upgrading
EasyMenu 6 continues to support the EasyMenu 5.x YAML format.
Back up both plugins/EasyMenuPlugin and plugins/EasyMenu before upgrading.
Upgrade steps
- Stop the server.
- Back up the old plugin JAR and configuration folders.
- Replace the JAR with EasyMenu 6.
- Start the server.
- Confirm that the console reports
EasyMenu has been enabled. - Run
/menu reloadand 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.