🐱 MiaoMenu — The menu plugin that actually gets it right

Do what suits you best, make the difficult simple. That's the idea.

---

Sound familiar?

| Frustrating stuff | Other plugins | MiaoMenu |
|---|---|---|
| Bedrock players can't see menus | Need a separate plugin | Auto-detected, native support |
| Every config change means a reload | /reload over and over | Save the file, you're done — 0.5-second hot-reload |
| Cross-server menus are a pain | Complex setups required | BungeeCord / Velocity built in |
| Players lose the menu item | No protection | NBT-tagged clock, survives death |
| Folia breaks everything | Console spam | Runs natively on Folia |

---

What it does

🎯 One config, both editions

MiaoMenu checks whether a player is on Java or Bedrock and serves the right UI automatically:

• Java players get the classic chest inventory (1–6 rows, up to 54 slots)
• Bedrock players get a native form UI designed for touch screens（need Floodgate）

You write the menu logic once. The plugin handles the rest.

⚡ Hot-reload that actually works

Powered by Java's WatchService with a 0.5-second debounce. Edit a YAML file, hit save — the changes go live immediately. No commands needed.

(There's still a /dgm reload command if you prefer doing things manually.
Moreover, tested with over 10 reloads, no memory leaks detected.)

🕰️ The Time Mirror (menu clock)

Every player receives a clock item tagged with NBT data:

• Checked on login — if it's missing from their inventory, it gets replaced automatically. No duplicates.
• Protected on death — the clock never drops, and it reappears after respawn.
• Right-click to open the default menu instantly.
• Uniquely identified via NBT, so it won't clash with other items.

🔗 Cross-server teleportation

Built-in support for BungeeCord and Velocity proxy setups. The plugin detects which one you're running and configures itself.

# config.yml — one line to enable
settings:
  velocity-network: true

Pair it with a server-selector menu and players can hop between servers in one click:

# server-selector.yml
survival:
  slot: 12
  material: DIAMOND_SWORD
  display_name: "&c&lSurvival"
  left_click_commands:
    - "[player] server survival"
    - "[message] &aConnecting to survival..."
    - "[close]"

🎨 Flexible menu configuration

Java Edition — straightforward YAML:

menu_title: "&6&lMain Menu &7| &fServer Name"
rows: 6

items:
  server_info:
    slot: 10
    material: KNOWLEDGE_BOOK
    display_name: "&e&lServer Info"
    lore:
      - "&7Click to view server information"
      - "&fOnline: &a%server_online%&f/&a%server_max_players%"
    left_click_commands:
      - "[message] &6=== Server Info ==="
      - "[player] list"
      - "[close]"

Bedrock Edition — native forms:

menu:
  title: "§6§lMain Menu"
  items:
    - text: "§e§lServer Info\n§7Click for details"
      icon: "textures/items/book_enchanted"
      icon_type: "path"
      command: "dgeysermenu open info"
      execute_as: "player"

🛠 Action system

Five built-in action types cover the usual interactions:

| Action | Syntax | What it does |
|---|---|---|
| Run as player | [player] spawn | The player executes the command |
| Run as console | [cmd] give %player% diamond 1 | Console executes the command |
| Send a message | [message] &aWelcome back! | Sends chat text to the player |
| Close the menu | [close] | Closes the current menu |
| Open another menu | [menu] shop | Opens a different menu (nesting supported) |

You can bind separate actions to left-click and right-click:

left_click_commands:
  - "[player] spawn"
right_click_commands:
  - "[close]"

🧩 Plugin integrations

| Plugin | What you get |
|---|---|
| PlaceholderAPI | Full PAPI variable support — player stats, economy, online count, whatever you need |
| Floodgate / Geyser | Automatic Bedrock detection, no extra setup |
| CraftEngine | Use custom items as menu icons |
| bStats | Anonymous usage metrics, bundled in |

🎵 Menu sounds

Pick any Minecraft sound to play when a menu opens:

settings:
  open-menu-sound:
    enabled: true
    sound: "entity.experience_orb.pickup"
    volume: 1.0
    pitch: 1.0

🍃 Lightweight & Folia-ready

• Minimal footprint — core features only, no bloat.
• Detects Folia at startup and switches to the correct scheduler automatically.
• Built on Paper 1.21.8+ API.

---

Getting started

Installation

1. Drop the JAR into your server's plugins folder.
2. Restart the server.
3. Open plugins/MiaoMenu/ — sample menus are generated automatically.
4. Edit configs to match your server; changes apply on save.

Commands

| Command | Description | Permission |
|---|---|---|
| /dgm open <menu> | Opens a menu | dgeysermenu.use |
| /dgm reload | Reloads configs (rarely needed) | dgeysermenu.reload |
| /dgm help | Shows help | dgeysermenu.use |
| /getmenuclock | Gives you a Time Mirror | dgeysermenu.admin |

Every command has Tab completion — no need to type the whole thing out.

Permissions

dgeysermenu.use      # Basic access (everyone by default)
dgeysermenu.admin    # Admin tools (OP by default)
dgeysermenu.reload   # Reload command (OP by default)
dgeysermenu.menu.*   # Per-menu access control

---

File layout

MiaoMenu/
├── java_menus/              # Java Edition menus
│   ├── test.yml             # Sample main menu
│   └── server-selector.yml  # Server selector
├── bedrock_menus/           # Bedrock Edition menus
│   └── test.yml             # Sample main menu
└── config.yml               # Plugin settings

---

Going further

PlaceholderAPI variables

items:
  player_stats:
    slot: 22
    material: PLAYER_HEAD
    display_name: "&b%player_name%"
    lore:
      - "&fLevel: &e%player_level%"
      - "&fBalance: &6%vault_eco_balance%"
      - "&fPlaytime: &b%player_time_hours% hours"

Nested menus

left_click_commands:
  - "[menu] shop"
  - "[message] &2Welcome to the shop!"

CraftEngine custom items

# config.yml
settings:
  craftengine:
    enabled: true
    fallback-material: STONE

# In a menu file
items:
  custom_sword:
    material: "my_pack:custom_sword"
    display_name: "&d&lLegendary Sword"

---

Why MiaoMenu?

| | MiaoMenu | Typical alternative |
|---|---|---|
| Java + Bedrock | Both, out of the box | One or the other |
| Hot-reload | 0.5s, automatic | Manual /reload |
| Menu item | Managed automatically | Hand it out yourself |
| Cross-server | BungeeCord + Velocity built in | Needs another plugin |
| Folia | Native support | Errors everywhere |
| Custom items | CraftEngine integration | Vanilla materials only |
| Performance | Lightweight | Heavy |
| Price | Free, GPL v3 | Some are paid |

---

Try it now

/dgm open test          # Open the sample menu
/getmenuclock           # Get a Time Mirror
/dgm help               # See what's available

Java + Bedrock. No reload headaches. Five minutes to set up.

---

If MiaoMenu saves you some time, a ⭐ on GitHub goes a long way.

GPL v3 · by MingLi