EasyMenu

Powerful Minecraft GUI menus. Simple YAML. No unnecessary complexity.

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:

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:

/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 creates its configuration directory on first startup:

plugins/EasyMenu/
├── config.yml
├── main.yml
├── lang/
└── sub/

Open the main menu:

/menu

Reload menu configuration:

/menu reload

Open a submenu directly:

/submenu <id>

---

Documentation & Support

Documentation / Wiki https://wiki.mitubasite.org/docs/easymenu/main/

The Wiki contains the full configuration reference, installation guide, actions, chat input, PlaceholderAPI integration and troubleshooting information.

Discord / Bug Reports / Support https://discord.gg/sKzSJqcsPv

---

日本語にも対応

EasyMenuは日本語に標準対応している。

メニュー内の日本語表示だけでなく、プラグイン本体の言語ファイルとして日本語を同梱している。

詳しい設定方法はWikiを参照。

https://wiki.mitubasite.org/docs/easymenu/main/

---

Updating from EasyMenu 5

EasyMenu 6 introduces new functionality while keeping migration from older EasyMenu installations in mind.

Before upgrading an existing server, check the migration guide for configuration changes and compatibility information:

https://wiki.mitubasite.org/docs/easymenu/upgrading

---

License

EasyMenu is free to use on Minecraft servers.

Redistribution, resale, modified redistribution, or claiming EasyMenu as your own is not permitted without permission.