zyramenu

---

🗂️ ZyraMenu — Custom GUI Menus for 1.8 → 1.21

ZyraMenu is a lightweight, fully YAML-driven GUI menu plugin with native multi-version support from Minecraft 1.8.8 all the way to 1.21.x — no NMS, no reflection hacks, just clean compatibility layers.

---

✨ Features

• YAML-based menus — each menu is its own .yml file in plugins/ZyraMenu/menus/, easy to edit and reload without restarting the server
• In-game menu creator — open a chest, place your items, close it: the menu is saved automatically (/zm create <name>)
• Image backgrounds — drop a .png named after your menu into IMAGES-MENU/, and ZyraMenu will slice it into a 9-slot grid and apply it as the inventory background
• Rich slot actions — assign one action per slot:
  • CLOSE — close the inventory
  • COMMAND:<cmd> — run a command as the player
  • CONSOLE:<cmd> — run a command from the console
  • MESSAGE:<text> — send a chat message
  • OPENMENU:<name> — open another ZyraMenu
  • SERVER:<name> — transfer to a BungeeCord server
• Item utilities — rename any held item or set individual lore lines directly in-game
• Player head support — set a skull owner per slot for custom player heads
• Hot reload — /zm reload picks up all config and menu changes instantly
• Tab completion — full tab-complete support on all subcommands

---

🔧 Commands

Command	Description
/zm view <menu>	Open a menu for yourself
/zm create <name>	Start the chest-based menu creator
/zm cancel	Cancel the current creation session
/zm reload	Reload all menus and configuration
/zm rename <name>	Rename the item in your main hand
/zm lorename <line> <text>	Set a lore line on the item in your main hand

---

🔒 Permissions

Permission	Default	Description
zyramenu.use	OP	Open menus with /zm view
zyramenu.admin	OP	Create menus and use item utilities
zyramenu.reload	OP	Reload the plugin configuration

---

📋 Menu Configuration Example

title: "&8&lMain Menu"
rows: 3

items:
  4:
    material: NETHER_STAR
    amount: 1
    name: "&6&lInfo"
    lore:
      - "&7Welcome to the server!"
      - ""
      - "&eClick to close"
    action: "CLOSE"
    enchanted: true
  10:
    material: COMPASS
    amount: 1
    name: "&eShop"
    action: "COMMAND:/shop"

---

⚙️ Compatibility

• Minecraft: 1.8.8 — 1.21.x
• Platform: Spigot / Paper
• BungeeCord: optional, required only for SERVER: action
• Java: 8+

---

📦 Installation

1. Drop ZyraMenu.jar into your plugins/ folder
2. Start the server — a default menus/zmenu1.yml is generated
3. Edit or create your own menus in plugins/ZyraMenu/menus/
4. Run /zm reload to apply changes

---

Made by sti_moi