免费尝试 !
文档:
搭配 zMenu+ 插件使用:
功能:
✅ 能够创建无限数量的 GUI 菜单和命令。
✅ 可以在同一个库存界面中创建多个页面。
✅ 支持命令的参数、操作和自动补全。
✅ 拥有市场,可下载配置。
✅ 提供在线库存编辑器。
✅ 开源:GitHub。
✅ 高级 API。
✅ 支持基岩版玩家!
✅ 能够为每个动作创建无限数量的按钮。
✅ 高度可定制。
✅ 支持 PlaceholderAPI。
✅ 支持 Kyori Adventure Mini Message 格式。
✅ 支持 Folia。
✅ 支持从其他插件转换:zMenuConvert。
✅ 支持模式(Patterns),无需多次复制粘贴相同的配置!
✅ 支持 zHead 和 HeadDatabase。
✅ 文档已翻译成多种语言:
✅ 防复制系统。使用该插件后,复制将完全不可能发生。
✅ 使用 /zm save 命令将你的物品保存为配置。
✅ 支持用于打开库存的可执行物品。
✅ 支持将物品翻译成多种语言。插件会向玩家显示正确的翻译内容!
✅ 在库存中使用数学表达式!
插件文件:
视频:
Try for free !
Documentation:
With zMenu+ addon:
Features:
✅ Ability to create an infinite number of GUI menus and commands.
✅ Possibility to create several pages in the same inventory.
✅ Arguments, actions, and auto-completion for your commands.
✅ A marketplace to download configurations.
✅ An online inventory editor.
✅ Open Source: GitHub.
✅ Advanced API.
✅ Bedrock support !
✅ Ability to create an infinite number of buttons for each of your actions.
✅ Highly customizable.
✅ PlaceholderAPI support.
✅ Kyori Adventure Mini Message Format support.
✅ Folia support.
✅ Convert from other plugins: zMenuConvert.
✅ Patterns, no more need to copy and paste the same configuration several times!
✅ zHead and HeadDatabase support.
✅ Documentation translated into several languages:
- English: docs.zmenu.dev
- Français: docs.zmenu.dev/v/fr/
✅ Anti-duplication system. Duplication will be completely impossible with the plugin.
✅ Turn your items into a configuration with /zm save.
✅ Executable items for open inventories.
✅ Possibility to translate your items into several languages. The plugin displays the correct translation to the player!
✅ Use mathematical expressions in your inventories!
Plugin's files:
Video:
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zMenu
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新功能
database-configuration.max-lifetime选项:新增config.yml键值,单位为秒(默认值为1800),用于设置 MySQL/MariaDB 连接池的最大存活时间。该值会作为 HikariCP 的最大存活时间传递给 Sarah。设置为0表示在连接池关闭前保持连接;缺失或负数值将使用 Sarah 默认的 30 分钟;HikariCP 要求至少为 30 秒。当使用全局数据库配置时,也会从该配置中读取此值。Sarah 已从1.25更新至1.26。- API:
ButtonManager#registerRuleLoader(RuleLoader):第三方插件现在可以注册自己的规则类型(及其别名),这些规则可用于item_drag按钮的rule部分以及item-rule需求中。在此之前,只有 zMenu 内部带有@AutoRuleLoader注解的加载器才会被发现。 - API: ItemStack 序列化与 SoundOption 工厂方法:
InventoryManager现在公开了serializeItemStack(ItemStack),deserializeItemStack(String)和createSoundOption(String soundName, String categoryName, float pitch, float volume[, boolean isCustom])方法, 这些方法通过 XSound 解析音效,并在音效未知时返回null。 - API: 物品更新钩子:新增了
InventoryListener#updateItem(BaseInventory, boolean inPlayerInventory, ItemButton), 当已放置的按钮的物品在库存打开后被替换时调用此方法(返回true可跳过默认放置逻辑),ItemButton#setDisplayItem(ItemStack)以及VInventory#updateItem(boolean inPlayerInventory, int slot, ItemStack, boolean enableAntiDupe)。
改进
- 内存占用:几个随时间推移不断增长的缓存和每个玩家的地图现在有了上限或被清理:
- PlaceholderAPI 结果缓存 (
enable-cache-placeholder-api/cache-placeholder-api) 现在是一个有上限的缓存(10,000 个条目),其条目会在配置的持续时间后真正过期。以前过期的条目永远不会被移除。 OfflinePlayerCache不再缓存在线的Player对象,这些对象可能在登出后仍保留在内存中。此外,在执行/zm reload或插件禁用时会清除该缓存。ItemStackUtils不再将所有序列化或反序列化的物品保存在静态映射中。- 命令玩家参数、点击物品机制冷却时间、
item_drag任务状态和 PacketEvents 假库存内容现在会在玩家断开连接(或库存关闭)时被移除。 - PacketEvents 的标题和标题动画监听器现在会在玩家断开连接时移除其数据。
- PlaceholderAPI 结果缓存 (
- 在 Folia 上刷新按钮:按定时器刷新的按钮(
update/refresh-on-click刷新需求和库存update-interval)现在运行在查看者的调度程序上,而不是共享的java.util.Timer线程。一旦库存关闭,该库存的所有刷新任务都会立即取消;当一个槽位获得新的刷新任务时,旧的刷新任务也会被取消,因此任务不再堆积。 /zm reload后的物品检查:自定义物品库存检查现在在每个玩家自己的调度程序上运行,而不是为所有玩家运行一个异步任务,因此不再以非线程方式访问玩家库存。- 按钮命令调度:按钮的控制台和玩家命令(除通过玩家聊天发送的命令外)现在在所有平台上都进行调度:在玩家调度程序上执行,或在下一个刻(tick)执行控制台命令。在 Spigot/Paper 上,它们过去是立即运行的,因此现在可能会晚一个刻执行。
- 性能:
getTopInventory方法查找,每次点击、移动和数据包处理时都会用到,现在按视图类缓存,而不是每次都通过反射解析。当禁用close-inventory-on-move时,移动/传送距离检查会提前退出。颜色转换(color()/colorReverse())重用预编译的正则表达式,并且在文本中没有#时跳过十六进制处理。 - 更多配置警告:zMenu 现在会记录警告(包含文件和按钮路径),而不是静默忽略以下情况:
- 在 Minecraft 1.21 以下版本加载的
ANVIL库存(菜单回退到箱子,且rename-requirements不执行); - 没有匹配标题动画提供程序的
title-animation部分(可能缺少 PacketEvents); - 未知的
item_drag检查物品type(它仍然回退到full); - 无法实例化的
ButtonOption类(每类报告一次)。
- 在 Minecraft 1.21 以下版本加载的
- 按钮选项:
ButtonOption类不再需要接受Plugin参数的公共构造函数;现在使用无参公共构造函数作为回退方案。在此之前,此类选项会被静默丢弃。 - 标题动画提供程序:
title-animation.plugin现在区分大小写匹配,并且当省略plugin时,始终使用第一个注册的提供程序,而不是任意的一个。 /zm dumplog:上传的日志 URL 现在在所有平台上都以可点击链接的形式发送。- 捆绑的对话框示例:默认对话框文件现在使用
after-action(这是加载器实际读取的键,after_action会被忽略)并列出其真实值(CLOSE,NONE,WAIT_FOR_RESPONSE)。示例中的文本输入以及bedrock/custom-form.yml中的文本输入现在使用default-value而不是initial-value。现有安装保留其文件,必须手动重命名这些键。 - API: 移除
Tuples:未使用的记录fr.maxlego08.menu.api.utils.Tuples已从 API 模块中删除。这对引用它的插件来说是一个破坏性更改。 - 构建现在是可复现的(修复了 jar 包中的文件时间戳和顺序)。
修复
/zm download检查逻辑反转:当enable-download-command为true时,该命令被阻止;当其为false时,则允许执行。现在仅在设置enable-download-command: true时才运行。错误信息也指向config.yml而非config.json。- 无效的
item_drag规则:当item_drag按钮的rule部分无效时,该按钮现在会拒绝所有物品并记录警告日志。此前它会接受任何物品。 - 玩家头像在玩家库存按钮中的表现:放置在玩家库存中的
player_head按钮,其异步加载的纹理现在会显示在玩家库存槽位中,而不是菜单中相同编号的槽位。在使用 PacketEvents 的清空库存模式时,延迟的头像更新会通过数据包发送,而不会修改真实库存。 - Paper 26.3 物品组件:
Paper-26-3钩子(包括attack_animation、interact_animation、mob_visibility、provides_pottery_pattern、sign_text、villager_food、waxed等组件)现已打包进zMenu.jar。此前缺失这些组件导致它们不可用。 - MythicMobs 物品:
mythicmobs:材质现在会生成完整的物品(包括名称、描述、附魔、NBT 数据等),而不再返回 Mythic 缓存的基础物品。 %zmenu_player_previous_page%在第一页时不再返回负值。%zmenu_statistic_hours_played%此前返回的是分钟数而非小时数。- 不区分大小写的动作注册:第三方插件通过
ButtonManager#registerAction使用大写或混合大小写键名注册的动作,此前无法被找到。 - 使用 PacketEvents 假库存内容打开菜单时,不再在控制台中刷屏输出调试行。
新功能
- 新增了对 DeluxeMenus 的转换支持,通过
/zm convert deluxemenus [menu](也可简写为dm)命令,可将 DeluxeMenus 配置转换为 zMenu 库存,并报告不受支持或部分转换的功能。 - 新增了 ItemStack 到 zMenu 的转换支持,包括受支持的 Minecraft 物品组件的转换。
- 新增了库存、菜单项、按钮、动作、需求、物品组件、命令及相关 API 对象的序列化支持,允许将这些对象以 zMenu 可理解的格式写回。
- 新增了父/子占位符作用域和占位符修饰符,同时提升了占位符处理性能。
- 新增了库存替换模式,支持
CUMULUS和CHEST(基岩版玩家)。 - 新增了在解析颜色时使用 Bukkit 染料颜色名称的支持,包括
minecraft:<color>名称。 - 新增了
dialog_list对话框类型,这是 zMenu 此前不支持的最后一种原版对话框类型。它在dialogs:下列出的每个对话框显示一个按钮,并以该对话框的external-title作为标签。条目可以是 zMenu 对话框名称(name或plugin:name),也可以是原版/数据包对话框(registry-key: minecraft:server_links)。选项包括:number-of-columns(列数)、button-width(按钮宽度)、可选的exit-button(退出按钮),以及一个back-button(返回按钮),该按钮会添加到没有退出按钮的已列出对话框中,以便玩家可以返回列表。如果玩家未满足已列出对话框的open-requirement(打开需求),则该对话框会被隐藏。嵌套列表的最大层数由config.yml中的dialog-list-max-depth设置(默认为 4)。详见dialogs/dialog_list-dialog.yml。
改进
- 对话框现在同时读取
external_title和external-title。随附的示例对话框使用了external_title,此前被忽略。空的外部标题不再发送,因此客户端会回退使用对话框名称。 - 没有
server-links按钮的server_links对话框不再显示空白退出按钮。 - 改进了钩子加载机制,第三方插件导致的失败、缺失类、无效版本或损坏的 API 不再中止整个钩子注册过程。
- 改进了与 PacketEvents 的集成,增加了 API 可用性和就绪性检查。当 PacketEvents 不可用时,基于包的功能会安全禁用,而不会导致 zMenu 失败。
- 改进了插件关闭处理机制,即使初始化失败,部分初始化的管理器仍能被安全禁用并清理。
- 新增了对已注册的动作、需求和物品组件的序列化覆盖测试,以确保它们可以在不丢失配置的情况下序列化和加载。
- 将最低支持的(文档)Minecraft 版本更新为 1.20.6。
改进
-
库存热重载:
config.yml中新增hot-reload部分,默认禁用。启用后,zMenu 会监视inventories/文件夹及其子文件夹,无需任何命令即可应用更改:修改的文件会重新加载其库存,新文件会加载它,删除的文件(或文件夹)会卸载它。- 更改会通过
hot-reload.delay-milliseconds(默认为 500)进行防抖处理,因此编辑器分步保存文件时仅触发一次重载。 - 无法加载的文件(YAML 语法错误、未知按钮类型、无效大小等)不会被应用:前一个版本将继续保持加载状态,错误会被记录直到文件修复。
- 查看已重载库存的玩家会看到新版本在相同页面、具有相同历史库存的情况下打开(后退按钮也会打开新版本)。已卸载的库存会被关闭。
- 切换此选项的效果会在执行
/zm reload或/zm reload config时生效,或在游戏内配置对话框中更改后的两秒内生效。specify-path-menus中列出的文件不会被监视。 - 如果
inventories/文件夹被删除并重建(备份恢复、git checkout...),它将再次被自动监视。在 Windows 上,整个树状结构使用单个句柄进行监视,因此在服务器运行时仍可重命名或删除子文件夹。 - 文件夹每两秒扫描一次,因此即使在文件系统不发送事件的地方(Docker 或 WSL 挂载、网络共享、通过 SFTP 上传的文件),也能检测到更改。
- 当文件内容或修改日期发生变化时会重新加载;无变化地再次保存文件仍会触发重新加载,但同一版本永远不会被重新加载两次。
- 每次检测、重载、卸载和错误都会在控制台日志中使用
[HotReload]前缀记录(当enable-debug开启时,文件夹事件和跳过的文件也会被记录)。
- 更改会通过
-
修复:卸载库存时,如果另一个文件夹中仍有同名文件加载的库存存在,则
/zm open和/zm reload inventory的 tab 补全中不再移除该库存的名称。 -
修复:等待加载需求的库存不再在每次重新加载时排队第二次加载。
-
zMenu 现在可在 Spigot 上加载,并说明为何无法正常运行:zMenu 是一个 Paper 插件,仅通过
paper-plugin.yml(一个 Spigot 不会读取的文件)声明自身。因此,Spigot 会直接拒绝加载该 jar 包,提示“不包含 plugin.yml”,这容易被误认为是下载损坏,而非平台要求所致。现在该 jar 包同时附带了plugin.yml,使得 Spigot 能够加载并启用该插件,同时在控制台中打印警告信息,说明需要 Paper 或其分支(如 Purpur 或 Folia),并提供下载链接。当持有新权限zmenu.paper.warning(默认赋予管理员)的玩家加入时,也会收到相同的警告。- 在 Paper 上没有任何变化。当 jar 包同时包含两个描述文件时,Paper 会读取
paper-plugin.yml,而完全忽略plugin.yml,因此实际插件仍像以前一样正常加载,包括引导程序和插件加载器。 - 在此模式下,zMenu 的任何功能均不可用:没有菜单、没有命令、也没有 API。此设计是为了让原因可见,而不是让插件看起来像是坏了。
- 在 Paper 上没有任何变化。当 jar 包同时包含两个描述文件时,Paper 会读取
修复
- 由取消的命中事件关闭菜单的问题:自幽灵 GUI 保护机制(ZM-01)引入以来,每当菜单查看者被击中或击中他人时,即使该命中事件被其他插件取消,菜单也会被关闭。在禁用了 PvP 的 WorldGuard 区域内,任何玩家只需攻击另一名玩家即可关闭其菜单。现在,伤害、移动和传送处理器以
MONITOR优先级运行,并忽略已取消的事件:只有实际发生的命中才会关闭菜单,而其他插件取消的移动或传送也不再导致菜单关闭。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。






评论 0
登录后参与评分
还没有评论,来抢沙发吧