MiaoMenu

插件

· 作者 AMingLi

适用于多环境(大概吧 lol)的最佳菜单解决方案

0 本站下载 0 关注 更新于 7 个月前

最新 2.5 · 26.1 · Bukkit / Folia

一键开服(送7天)

? MiaoMenu — 真正懂你的菜单插件

做最适合你的事,化繁为简。 这就是它的理念。


似曾相识?

令人头疼的问题 其他插件 MiaoMenu
基岩版玩家看不到菜单 需要单独的插件 自动检测,原生支持
每次修改配置都要重载 反复使用 /reload 保存文件即可 — 0.5秒热重载
跨服务器菜单很麻烦 需要复杂的设置 内置 BungeeCord / Velocity 支持
玩家死亡后丢失菜单物品 无保护机制 NBT 标记时钟,死亡不掉落
Folia 会导致一切崩溃 控制台刷屏 原生运行于 Folia

它能做什么

? 一份配置,双端通用

MiaoMenu 会检查玩家使用的是 Java 版还是基岩版,并自动提供相应的 UI:

  • Java 版玩家 获得经典的下拉式容器界面(1–6 行,最多 54 个槽位)
  • 基岩版玩家 获得专为触摸屏设计的原生表单 UI(需要 Floodgate)

你只需编写一次菜单逻辑,插件会自动处理其余部分。

Preview Preview

⚡ 真正有效的热重载

基于 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 构建。

快速开始

安装

  1. 将 JAR 文件放入服务器的 plugins 文件夹。
  2. 重启服务器。
  3. 打开 plugins/MiaoMenu/ — 示例菜单会自动生成。
  4. 根据服务器需求编辑配置;保存即生效。

命令

命令 描述 权限
/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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源