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

• LegacyMenus - Showcase 01

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 [menu]	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:

plugins/LegacyMenus/menus/<menu>.yml

Basic example:

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 -.

Building

mvn clean package

The jar is created in target/legacymenus-<version>.jar.

License

MIT. See LICENSE.