Skip to main content

Installation

This guide covers system requirements and installation instructions for EasyMenu 7.


Requirements​

RequirementValueNotes
JavaJava 17 or laterRuntime requirement
Minecraft1.20.1 or laterPaper / Purpur / Folia
Server SoftwarePaper, Purpur, FoliaSpigot is not supported (requires Folia scheduler API)
Required PluginNegiLib 1.x (e.g. NegiLib-1.1.1.jar)UI rendering provider
Optional PluginPlaceholderAPI 2.11.x or laterPlayer placeholders & economy variables
Client BridgeGeyser (optional)Bedrock player compatibility
Spigot Support Discontinued

Because NegiLib relies on the Folia region scheduler API (implemented by Paper and Purpur as well), Spigot servers are no longer supported. Please use Paper, Purpur, or Folia.


Installation Steps​

1. Download Plugin JARs​

Download the following two JAR files:

  • NegiLib-1.1.1.jar (or latest NegiLib 1.x)
  • EasyMenu-7.0.2.jar (or latest EasyMenu 7.x)

2. Place in plugins/​

Place both JAR files into your server's plugins/ folder:

server/
└── plugins/
├── NegiLib-1.1.1.jar
└── EasyMenu-7.0.2.jar
Bedrock with Velocity

When Geyser runs on Velocity, place NegiLib-Geyser-Velocity-1.1.1.jar in Velocity's plugins/ directory. Keep NegiLib-1.1.1.jar and EasyMenu-7.0.2.jar on the backend Paper / Purpur / Folia server. The Velocity JAR is unnecessary when Geyser runs directly on the backend server. For Bedrock display settings, see the Bedrock / Geyser / Rich UI Guide.

3. Start the Server​

Start or restart your server.

During startup, verify the console output (example for Paper without Dialog API or Geyser, with language en_us): The capabilities=... field contains the number of detected capabilities. The renderers= count, the native dialog= value and the capabilities= count vary with your server version and installed plugins (such as Geyser). The numbers shown here are only an example.

[NegiLib] Enabling NegiLib v1.1.1
[NegiLib] NegiLib 1.1.1 (API 1.0) enabled on PAPER; renderers=3; native dialog=false
[EasyMenu] Enabling EasyMenu v7.0.2
[EasyMenu] EasyMenu has been enabled. NegiLib 1.1.1 (API 1.0), capabilities=...
Missing NegiLib

If NegiLib is not found in plugins/, EasyMenu logs EasyMenu requires NegiLib 1.x and disables itself safely rather than running partially broken.

4. Verify in Game​

Join your server with operator permissions and run:

/menu

If the default main menu (chest UI) appears, installation is successful!


Generated File Structure​

On first startup, the following default files will be generated in plugins/EasyMenu/:

plugins/EasyMenu/
├── config.yml # Global settings (language, cache, debug, etc.)
├── main.yml # Main menu definition (/menu)
├── lang/
│ ├── ja_jp.yml # Japanese messages
│ ├── en_us.yml # English messages
│ └── ru_ru.yml # Russian messages
└── sub/
└── shop.yml # Example submenu (Shop menu)