Easymenu

# EasyMenu **Powerful Minecraft GUI menus. Simple YAML. No unnecessary complexity.** !(https://img.shields.io/badge/Paper-Supported-00B2EE?style=for-the-badge) !(https://img.shields.io/badge/Folia-Supported-3CB371?style=for-the-badge) !(https://img.shields.io/badge/Purpur-Supported-A331FF?style=for-the-badge) !(https://img.shields.io/badge/Dependencies-None-2EA44F?style=for-the-badge) !(https://img.shields.io/badge/PlaceholderAPI-Optional-4C8BF5?style=for-the-badge) (https://img.shields.io/badge/Support-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/7y6kgJ7XZG) EasyMenu makes it easy to build clean, interactive GUI menus without writing Java or turning your configuration into a programming language. Create navigation menus, shops, banks, server selectors, player utilities and more — all from simple YAML files. --- ## Why EasyMenu? ### Simple YAML Create menus with straightforward configuration files. No scripting language. No complicated setup. Just define your items and what should happen when players click them. ### Powerful Actions A menu item can do more than just run a command. EasyMenu supports actions such as: * running player commands * opening other menus * displaying messages * closing menus * requesting chat input * executing multiple actions from one click ### Chat Input Need a player to enter an amount, number or text? EasyMenu can temporarily close the GUI, ask for input in chat, validate it, and use the entered value in a command. Perfect for things like: * bank deposit / withdrawal menus * custom amount purchases * teleport coordinates * player search * text-based settings ### Unlimited Submenus Organize large menu systems without putting everything into one file. Create as many submenu files and menu layers as your server needs. ### PlaceholderAPI Support PlaceholderAPI integration is available when PlaceholderAPI is installed. Use dynamic player information such as names, balances, ranks and other plugin-provided placeholders inside your menus. **PlaceholderAPI is optional — EasyMenu does not require it to run.** ### Built for Modern Servers EasyMenu is designed for modern Spigot-based servers, including Paper and Folia-compatible environments. Menu loading and submenu access use asynchronous loading and caching where appropriate. --- ## See How Simple It Is A basic menu item can be created with only a few lines: ```yaml menu-title: "&6Server Menu" menu-size: 27 menu-items: - slot: 13 material: DIAMOND name: "&bTeleport to Spawn" lore: - "&7Click to teleport!" command: "/spawn" sound: "ENTITY_ENDERMAN_TELEPORT" close-menu: true ``` Save the file, run: ```text /menu reload ``` and the updated menu is ready — no server restart required. --- ## Features * Simple YAML-based GUI creation * Main menus and unlimited submenus * Player command execution * Multiple actions per click * Chat-based player input * Input validation * PlaceholderAPI integration * Custom item names and lore * Minecraft color codes * Custom sounds * CustomModelData support * Configurable menu sizes and item positions * Background items * Runtime configuration reload * Asynchronous menu loading * Submenu caching * English, Japanese and Russian language files * No required external plugins --- ## Perfect For EasyMenu works well for: * **Server Navigation** — spawn, worlds, areas and server features * **Warp Menus** — replace long warp command lists with a GUI * **Shops** — organize purchases into clean categories * **Banks** — combine GUI buttons with chat input * **Server Selectors** — build lobby-style server navigation * **Player Utilities** — homes, settings, kits and useful commands * **Rules & Help** — make server information easy to browse * **Custom Lobbies** — centralize your server's features * **Resource Pack GUIs** — use CustomModelData for custom menu designs EasyMenu is intended for servers that want **more than a basic command menu without requiring a huge GUI scripting system**. --- ## Compatibility | Requirement | EasyMenu 6 | | ------------------------ | ----------------- | | Java | 17+ | | Minecraft API | 1.20.1+ | | Spigot | Supported | | Paper | Supported | | Purpur | Supported | | Folia-compatible servers | Supported | | Required dependencies | None | | PlaceholderAPI | Optional, 2.11.7+ | Exact Minecraft versions available for each EasyMenu release are listed on the **Versions** page on Modrinth. --- ## Quick Start 1. Download the latest EasyMenu `.jar`. 2. Place it in your server's `plugins/` directory. 3. Start or restart the server. 4. Edit `plugins/EasyMenu/main.yml`. 5. Run `/menu` in-game. EasyMenu automatically creat