Compatibility
Server platform compatibility and version-by-version feature support for EasyMenu 7.
Supported Server Software
| Server Software | Support Status | Notes |
|---|---|---|
| Paper | Fully Supported (Recommended) | Minecraft 1.20.1 or later |
| Purpur | Fully Supported | Minecraft 1.20.1 or later |
| Folia | Fully Supported | Native region scheduler support |
| Spigot | Not Supported | Missing required Folia scheduler APIs |
| Integration | Status |
|---|---|
| PlaceholderAPI | Optional. EasyMenu starts without it. |
| Geyser (Bedrock support) | Optional. Implementations exist for both direct Paper (Geyser-Spigot) and Velocity (Geyser-Velocity + NegiLib Geyser Velocity) topologies. Client-side rendering is not verified by automated tests (Bedrock guide). |
Java Requirement
Java 17 or higher is required at runtime.
Feature Matrix by Minecraft Version
| Feature | 1.20.1 | 1.20.5+ | 1.21.6+ | 1.21.9+ |
|---|---|---|---|---|
| Inventory Menus (Chest UI) | Supported | Supported | Supported | Supported |
| Base64 Custom Heads | Supported | Supported | Supported | Object Head supported |
| CustomModelData | Legacy format | Modern snapshot | Modern snapshot | Modern snapshot |
Enchantment Glint (glint) | Substitute effect | Component | Component | Component |
Modern Components (rarity, etc.) | Skipped with warning | Supported | Supported | Supported |
Max Stack Size (max-stack-size) | Skipped with warning | 1.21+ Supported | Supported | Supported |
Item Models (item-model) | Resolver fallback | Resolver fallback | Supported | Supported |
| Native Dialogs | Automatic chest UI fallback | Automatic chest UI fallback | Native Dialogs supported | Native Dialogs supported |
| Dialog Input Forms | Automatic chat fallback | Automatic chat fallback | Form inputs supported | Form inputs supported |
| Object Sprite / Head (item icons in dialogs) | Not supported | Not supported | Not supported | Supported |
"1.21+ Supported" under 1.20.5+ means max-stack-size takes effect on Minecraft 1.21 and later servers.
A component the server cannot express is logged once and skipped. The item still renders and the menu still opens.
Dynamic Capability Detection
EasyMenu and NegiLib never branch on raw server version strings (e.g. "1.20.1"). Instead, capabilities are dynamically probed once at startup via PaperCapabilityProbe.
This ensures forward compatibility with future Minecraft point releases and custom Paper forks without requiring manual code changes.