# EasyMenu<\/p>\n
**EasyMenu** is a lightweight GUI menu plugin for Spigot and Paper servers.<\/p>\n
Create clean, clickable Minecraft menus using simple YAML files. Build a main menu, add unlimited submenus, run commands from items, customize sounds and lore, and reload your menu setup without restarting the server.<\/p>\n
\u65e5\u672c\u8a9e\u306b\u3082\u5bfe\u5fdc\u3057\u3066\u3044\u307e\u3059
\n—<\/p>\n
## Features<\/p>\n
– **YAML-based menu creation**
\n Create and edit menus with simple configuration files.<\/p>\n
– **Main menu and submenu support**
\n Use `main.yml` for the main menu and place submenu files inside the `sub\/` folder.<\/p>\n
– **Unlimited nested menus**
\n Open submenus from menu items and return to the main menu when needed.<\/p>\n
– **Command execution from menu items**
\n Run player commands such as `\/spawn`, `\/home`, `\/warp`, or any command provided by other plugins.<\/p>\n
– **Custom item display**
\n Configure materials, names, lore, sounds, slot positions, and custom model data.<\/p>\n
– **Multi-language support**
\n Built-in language files for English, Japanese, and Russian.<\/p>\n
– **Async loading and cache system**
\n Menu loading and submenu access are optimized with asynchronous processing and configurable caching.<\/p>\n
– **No external dependencies**
\n EasyMenu works without requiring Vault, PlaceholderAPI, or any other plugin.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Requirement | Version |
\n|—|—|
\n| Java | 17 or newer |
\n| Server software | Spigot \/ Paper \/ Purpur|
\n| Minecraft API version | 1.20+ |
\n| Verified Versions| 1.21.8 |
\n|Supported Versions (Not all versions have been individually tested)|1.16.x~paper latest|
\n| Dependencies | None |
\nFolia may load, but full compatibility is not guaranteed.
\n—<\/p>\n
## Installation<\/p>\n
1. Download the latest EasyMenu `.jar` file.
\n2. Place it into your server’s `plugins` folder.
\n3. Restart the server.
\n4. Edit the generated files in `plugins\/EasyMenu\/`.
\n5. Run `\/menu` in-game to open the menu.<\/p>\n
After the first startup, EasyMenu generates the following structure:<\/p>\n
“`text
\nplugins\/EasyMenu\/
\n\u251c\u2500\u2500 config.yml
\n\u251c\u2500\u2500 main.yml
\n\u251c\u2500\u2500 lang\/
\n\u2514\u2500\u2500 sub\/
\n“`<\/p>\n
—<\/p>\n
## Basic Usage<\/p>\n
### Open the main menu<\/p>\n
“`text
\n\/menu
\n“`<\/p>\n
### Reload the configuration<\/p>\n
“`text
\n\/menu reload
\n“`<\/p>\n
### Open a submenu directly<\/p>\n
“`text Example:<\/p>\n “`text —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | `\/menureload` is still available for compatibility, but `\/menu reload` is the recommended command.<\/p>\n —<\/p>\n ## Example Main Menu<\/p>\n Create or edit `plugins\/EasyMenu\/main.yml`.<\/p>\n “`yaml menu-items: – location: “5,4” —<\/p>\n ## Example Submenu<\/p>\n Create `plugins\/EasyMenu\/sub\/shop.yml`.<\/p>\n “`yaml menu-items: – location: “5,3” To open this submenu from another menu item, use:<\/p>\n “`yaml —<\/p>\n ## Supported Item Options<\/p>\n | Option | Description | —<\/p>\n ## Special Commands<\/p>\n | Format | Behavior | —<\/p>\n ## Configuration Overview<\/p>\n `config.yml` is used for plugin behavior and performance settings.<\/p>\n “`yaml async: cache: submenu: `main.yml` is used only for the main menu layout.<\/p>\n This separation makes large menu setups easier to manage and reduces the risk of mixing plugin settings with menu definitions.<\/p>\n —<\/p>\n ## Language Files<\/p>\n EasyMenu includes language files for:<\/p>\n – English: `en_us.yml` You can edit the generated language files in `plugins\/EasyMenu\/lang\/` and reload the plugin afterward.<\/p>\n —<\/p>\n ## Good For<\/p>\n EasyMenu is useful for:<\/p>\n – server navigation menus —<\/p>\n ## Notes for Updating from Older Versions<\/p>\n EasyMenu v5.0.0 uses a cleaner folder and configuration structure.<\/p>\n Older versions used:<\/p>\n “`text Newer versions use:<\/p>\n “`text Move your main menu definition into `main.yml` and keep plugin behavior settings in `config.yml`.<\/p>\n —<\/p>\n ## License<\/p>\n This plugin is free to use on Minecraft servers. A lightweight GUI menu plugin for Paper and Spigot servers. Create menus easily with YAML configuration.<\/p>\n","protected":false},"featured_media":103199,"template":"","meta":{"_minecraft_slug":"mituba-menu-plugin","_minecraft_project_id":"VyXfzGue","_minecraft_author":"mituba4154","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":1355,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mituba-menu-plugin.zip","_minecraft_size_bytes":344090,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T07:33:10.545851Z","_minecraft_date_created":"2024-11-10T05:19:46.149369Z","_minecraft_date_modified":"2026-04-25T01:17:33.926544Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mituba-menu-plugin","_minecraft_icon_attachment_id":103199,"_minecraft_imported_at":"2026-06-05T22:25:10+00:00","_minecraft_import_hash":"26ae739b291b29f8ee401ad20565ccb4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,867,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-103198","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n\/submenu
\n“`<\/p>\n
\n\/submenu shop
\n“`<\/p>\n
\n|—|—|—|
\n| `easymenu.admin` | Allows reloading the EasyMenu configuration | OP |
\n| `menu.reload` | Legacy reload permission kept for compatibility | OP |<\/p>\n
\nmenu-title: “&6&lEasyMenu”
\nmenu-opensound: “ENTITY_EXPERIENCE_ORB_PICKUP”
\nmenu-background-item: “GRAY_STAINED_GLASS_PANE”
\nmenu-size: 54<\/p>\n
\n – location: “5,3”
\n material: “DIAMOND”
\n name: “&bTeleport Home”
\n command: “\/home”
\n sound: “ENTITY_ENDERMAN_TELEPORT”
\n close-menu: true
\n lore:
\n – “&7Click to teleport”
\n – “&7to your home.”<\/p>\n
\n material: “EMERALD”
\n name: “&aShop”
\n command: “sub_shop”
\n sound: “BLOCK_NOTE_BLOCK_PLING”
\n close-menu: true
\n lore:
\n – “&7Open the shop menu.”
\n“`<\/p>\n
\nmenu-title: “&a&lShop Menu”
\nmenu-opensound: “BLOCK_CHEST_OPEN”
\nmenu-background-item: “LIME_STAINED_GLASS_PANE”
\nmenu-size: 27<\/p>\n
\n – location: “3,2”
\n material: “DIAMOND”
\n name: “&bBuy Diamonds”
\n command: “\/buy diamond 1”
\n sound: “ENTITY_EXPERIENCE_ORB_PICKUP”
\n close-menu: false
\n lore:
\n – “&7Price: $100”<\/p>\n
\n material: “BARRIER”
\n name: “&cBack to Main Menu”
\n command: “main_mainopen”
\n sound: “UI_BUTTON_CLICK”
\n close-menu: true
\n lore:
\n – “&7Return to the main menu.”
\n“`<\/p>\n
\ncommand: “sub_shop”
\n“`<\/p>\n
\n|—|—|
\n| `location` | Menu slot position in `column,row` format |
\n| `material` | Bukkit material name |
\n| `name` | Item display name with color codes |
\n| `command` | Command or EasyMenu special action |
\n| `sound` | Sound played when the item is clicked |
\n| `close-menu` | Whether the inventory closes after clicking |
\n| `lore` | Item lore lines |
\n| `custom-model-data` | Custom model data for resource packs |<\/p>\n
\n|—|—|
\n| `\/command` | Runs a command as the player |
\n| `sub_
\n| `main_mainopen` | Returns to the main menu |<\/p>\n
\nlanguage: “en_us”
\nload-on-startup: true
\nprecache-submenus: true<\/p>\n
\n worker-threads: 2<\/p>\n
\n submenu-expiry-seconds: 300
\n submenu-max-size: 100
\n cleanup-interval-seconds: 60
\n resolved-path-max-size: 200<\/p>\n
\n search-depth: 3
\n listener-failsafe-seconds: 30
\n“`<\/p>\n
\n– Japanese: `ja_jp.yml`
\n– Russian: `ru_ru.yml`<\/p>\n
\n– warp menus
\n– shop menus
\n– rule and help menus
\n– player utility menus
\n– server selector-style menus
\n– custom lobby menus
\n– resource-pack based custom GUI items<\/p>\n
\nplugins\/EasyMenuPlugin\/config.yml
\n“`<\/p>\n
\nplugins\/EasyMenu\/config.yml
\nplugins\/EasyMenu\/main.yml
\n“`<\/p>\n
\nRedistribution, resale, modified redistribution, or claiming this plugin as your own is not allowed without permission.<\/p>\n","protected":false},"excerpt":{"rendered":"