LegacyMenus

# LegacyMenus LegacyMenus is a small Bukkit/Spigot plugin for Minecraft 1.8 servers. It opens inventory menus from YAML files in `plugins/LegacyMenus/menus`. Menus are managed through YAML files. Change the files, then reload them in-game. ## Showcase - <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/-XAZVSu89qg" title="LegacyMenus - Showcase" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> ## Features - YAML-based menu files - 9 to 54 slot inventories - Color codes with `&` - Player heads and base64 skull textures - Click commands as player or console - Optional command validation and command allow/block lists - Reload one menu or all menus without restarting the server ## Requirements - Spigot or compatible Bukkit server - Minecraft 1.8.8 - Java 8 or newer to run - Java 17 to build from source ## Installation 1. Download the jar from Releases. 2. Put it in your server `plugins` folder. 3. Restart the server. 4. Edit menu files in `plugins/LegacyMenus/menus`. 5. Run `/menu reload`. ## Commands | Command | Permission | Description | | --- | --- | --- | | `/menu open <menu>` | `legacymenus.use` | Open a menu | | `/menu open <menu> <player>` | `legacymenus.open.others` | Open a menu for another online player | | `/menu reload ` | `legacymenus.reload` | Reload one menu or all menus | | `/menu list` | `legacymenus.list` | List loaded menus | | `/menu help` | `legacymenus.use` | Show command help | Aliases: `/menus`, `/gui` ## Permissions | Permission | Default | Description | | --- | --- | --- | | `legacymenus.use` | true | Open menus | | `legacymenus.list` | true | List loaded menus | | `legacymenus.reload` | op | Reload menu files | | `legacymenus.open.others` | op | Open menus for other players | | `legacymenus.admin` | op | Includes admin permissions | ## Menu Files Menus live in: ```text plugins/LegacyMenus/menus/<menu>.yml ``` Basic example: ```yaml title: "&6Server Menu" size: 27 open-commands: filler: material: "STAINED_GLASS_PANE" data: 7 display-name: " " lore: items: 11: material: "COMPASS" display-name: "&aSpawn" lore: - "&7Click to go to spawn." commands: - "spawn" amount: 1 data: 0 glow: false ``` Command prefixes: | Prefix | Runs as | Example | | --- | --- | --- | | none | player | `spawn` | | `player:` | player | `player:warp crates` | | `console:` | console | `console:say %player% opened a menu` | `open-commands` runs the listed commands after the menu opens. Console commands are disabled by default. Enable them in `config.yml` only if you trust your menu files. ## Configuration - `config.yml` controls security, colors, sounds, and command filtering. - `menus/*.yml` controls menu layout and click actions. - `%player%` is replaced with the clicking player's name. Menu names may only use letters, numbers, `_`, and `-`.