? MiaoMenu — 真正懂你的菜单插件
做最适合你的事,化繁为简。 这就是它的理念。
似曾相识?
| 令人头疼的问题 |
其他插件 |
MiaoMenu |
| 基岩版玩家看不到菜单 |
需要单独的插件 |
自动检测,原生支持 |
| 每次修改配置都要重载 |
反复使用 /reload |
保存文件即可 — 0.5秒热重载 |
| 跨服务器菜单很麻烦 |
需要复杂的设置 |
内置 BungeeCord / Velocity 支持 |
| 玩家死亡后丢失菜单物品 |
无保护机制 |
NBT 标记时钟,死亡不掉落 |
| Folia 会导致一切崩溃 |
控制台刷屏 |
原生运行于 Folia |
它能做什么
? 一份配置,双端通用
MiaoMenu 会检查玩家使用的是 Java 版还是基岩版,并自动提供相应的 UI:
- Java 版玩家 获得经典的下拉式容器界面(1–6 行,最多 54 个槽位)
- 基岩版玩家 获得专为触摸屏设计的原生表单 UI(需要 Floodgate)
你只需编写一次菜单逻辑,插件会自动处理其余部分。

⚡ 真正有效的热重载
基于 Java 的 WatchService 驱动,并带有 0.5 秒的去抖动延迟。编辑 YAML 文件并保存 — 更改立即生效。无需任何命令。
(如果你更喜欢手动操作,仍然提供了 /dgm reload 命令。此外,经过超过 10 次重载测试,未发现内存泄漏。)
?️ 时间镜像(菜单时钟)
每位玩家都会获得一个带有 NBT 数据标记的时钟物品:
- 登录时检查 — 如果库存中缺少该物品,它会自动替换。不会重复生成。
- 死亡时受保护 — 时钟绝不会掉落,重生后会重新出现。
- 右键点击可立即打开默认菜单。
- 通过 NBT 唯一标识,因此不会与其他物品冲突。
? 跨服务器传送
内置对 BungeeCord 和 Velocity 代理设置的支持。插件会自动检测你正在运行哪一个并进行相应配置。
# config.yml — 启用只需一行
settings:
velocity-network: true
配合服务器选择器菜单,玩家只需点击一下即可在服务器间切换:
# server-selector.yml
survival:
slot: 12
material: DIAMOND_SWORD
display_name: "&c&l生存"
left_click_commands:
- "[player] server survival"
- "[message] &a正在连接至生存服..."
- "[close]"
? 灵活的菜单配置
Java 版 — 简单的 YAML:
menu_title: "&6&l主菜单 &7| &f服务器名称"
rows: 6
items:
server_info:
slot: 10
material: KNOWLEDGE_BOOK
display_name: "&e&l服务器信息"
lore:
- "&7点击查看服务器信息"
- "&f在线: &a%server_online%&f/&a%server_max_players%"
left_click_commands:
- "[message] &6=== 服务器信息 ==="
- "[player] list"
- "[close]"
基岩版 — 原生表单:
menu:
title: "§6§l主菜单"
items:
- text: "§e§l服务器信息\n§7点击查看详情"
icon: "textures/items/book_enchanted"
icon_type: "path"
command: "dgeysermenu open info"
execute_as: "player"
? 动作系统
五种内置动作类型覆盖常规交互:
| 动作 |
语法 |
作用 |
| 以玩家身份执行 |
[player] spawn |
玩家执行该命令 |
| 以控制台身份执行 |
[cmd] give %player% diamond 1 |
控制台执行该命令 |
| 发送消息 |
[message] &a欢迎回来! |
向玩家发送聊天文本 |
| 关闭菜单 |
[close] |
关闭当前菜单 |
| 打开另一个菜单 |
[menu] shop |
打开不同的菜单(支持嵌套) |
你可以为左键点击和右键点击绑定不同的动作:
left_click_commands:
- "[player] spawn"
right_click_commands:
- "[close]"
? 插件集成
| 插件 |
获得的功能 |
| PlaceholderAPI |
完整的 PAPI 变量支持 — 玩家状态、经济、在线人数等所需的一切 |
| Floodgate / Geyser |
自动检测基岩版,无需额外设置 |
| CraftEngine |
使用自定义物品作为菜单图标 |
| bStats |
匿名使用指标统计,已内置 |
? 菜单音效
选择任意 Minecraft 声音,在打开菜单时播放:
settings:
open-menu-sound:
enabled: true
sound: "entity.experience_orb.pickup"
volume: 1.0
pitch: 1.0
? 轻量级且支持 Folia
- 占用极小 — 仅包含核心功能,无冗余代码。
- 启动时检测 Folia 并自动切换到正确的调度器。
- 基于 Paper 1.21.8+ API 构建。
快速开始
安装
- 将 JAR 文件放入服务器的
plugins 文件夹。
- 重启服务器。
- 打开
plugins/MiaoMenu/ — 示例菜单会自动生成。
- 根据服务器需求编辑配置;保存即生效。
命令
| 命令 |
描述 |
权限 |
/dgm open <menu> |
打开菜单 |
dgeysermenu.use |
/dgm reload |
重载配置(很少需要) |
dgeysermenu.reload |
/dgm help |
显示帮助 |
dgeysermenu.use |
/getmenuclock |
给予你时间镜像 |
dgeysermenu.admin |
所有命令均支持 Tab 补全 — 无需输入完整命令。
权限
dgeysermenu.use # 基本权限(默认所有人)
dgeysermenu.admin # 管理工具(默认 OP)
dgeysermenu.reload # 重载命令(默认 OP)
dgeysermenu.menu.* # 按菜单控制访问权限
文件结构
MiaoMenu/
├── java_menus/ # Java 版菜单
│ ├── test.yml # 示例主菜单
│ └── server-selector.yml # 服务器选择器
├── bedrock_menus/ # Bedrock 版菜单
│ └── test.yml # 示例主菜单
└── config.yml # 插件设置

进阶用法
PlaceholderAPI 变量
items:
player_stats:
slot: 22
material: PLAYER_HEAD
display_name: "&b%player_name%"
lore:
- "&f等级: &e%player_level%"
- "&f余额: &6%vault_eco_balance%"
- "&f在线时长: &b%player_time_hours% 小时"
嵌套菜单
left_click_commands:
- "[menu] shop"
- "[message] &2欢迎来到商店!"
CraftEngine 自定义物品
# config.yml
settings:
craftengine:
enabled: true
fallback-material: STONE
# 在菜单文件中
items:
custom_sword:
material: "my_pack:custom_sword"
display_name: "&d&l传说之剑"
为什么选择 MiaoMenu?
|
MiaoMenu |
典型替代品 |
| Java + Bedrock |
两者均原生支持 |
仅支持其一 |
| 热重载 |
0.5秒,自动 |
手动 /reload |
| 菜单项 |
自动管理 |
需自行分发 |
| 跨服 |
内置 BungeeCord + Velocity |
需要其他插件 |
| Folia |
原生支持 |
处处报错 |
| 自定义物品 |
集成 CraftEngine |
仅限原版材质 |
| 性能 |
轻量级 |
重量级 |
| 价格 |
免费,GPL v3 |
部分收费 |

立即体验
/dgm open test # 打开示例菜单
/getmenuclock # 获取时间镜像
/dgm help # 查看可用命令
Java + Bedrock。无需重载烦恼。五分钟即可配置。
如果 MiaoMenu 为您节省了时间,在 GitHub 上点个 ⭐ 将是对我们最大的鼓励。
GPL v3 · by MingLi
? 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
- Drop the JAR into your server's
plugins folder.
- Restart the server.
- Open
plugins/MiaoMenu/ — sample menus are generated automatically.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧