Installation
This guide covers system requirements and installation instructions for EasyMenu 7.
Requirements
| Requirement | Value | Notes |
|---|---|---|
| Java | Java 17 or later | Runtime requirement |
| Minecraft | 1.20.1 or later | Paper / Purpur / Folia |
| Server Software | Paper, Purpur, Folia | Spigot is not supported (requires Folia scheduler API) |
| Required Plugin | NegiLib 1.x (e.g. NegiLib-1.1.1.jar) | UI rendering provider |
| Optional Plugin | PlaceholderAPI 2.11.x or later | Player placeholders & economy variables |
| Client Bridge | Geyser (optional) | Bedrock player compatibility |
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
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=...
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)