
AuMenus
一款轻量级、开源的 GUI 菜单插件,适用于 Paper & Folia 1.21.1+。它是 DeluxeMenus 的现代替代品,原生支持 Folia、MiniMessage 格式,且无需任何依赖项。一条命令即可迁移现有的 DM 配置。
核心优势
01. 开源(MIT)。 可分叉、修改,无任何限制。大多数菜单插件均为闭源或付费。
02. 原生支持 Folia & Paper。 从第一天起就基于区域线程调度器构建。无需兼容层,无需外部调度库。
03. 零依赖。 将 jar 包放入插件文件夹即可运行。Vault 和 PlaceholderAPI 为可选,非必需。
04. 内置 DeluxeMenus 迁移工具。 一条命令即可转换现有配置。
05. 支持现代文本格式。 渐变、悬停文本、点击事件。原生 MiniMessage 支持,而非事后添加。
功能特性
MiniMessage 格式化
支持渐变、悬停文本和点击事件的现代文本格式化。旧版颜色代码仍可用于迁移。
需求系统
控制谁能打开菜单、点击物品以及看到物品的条件。支持权限、金钱、经验值、物品、元数据、正则表达式、数学表达式、位置和反向检查。表达式引擎原生处理 &&、||、括号和字符串方法。DeluxeMenus 需要 JavaScript 引擎才能实现相同功能。
游戏内编辑器
无需触碰配置文件即可通过拖放方式编辑菜单。移动物品、添加新物品、拾取物品以清空槽位。关闭编辑器时自动保存 YAML。DeluxeMenus 不具备此功能。
分页
用于大型物品列表的多页菜单。内置 prev_page 和 next_page 动作,以及可在标题、物品名称和描述中使用的 {page} 和 {max_page} 占位符。
平滑菜单过渡
页面更改和同尺寸菜单打开(例如跨多个 YAML 文件分布的商店分类)会复用现有窗口,而不是关闭并重新打开。即使标题包含页码也不会闪烁。其他菜单插件均无此功能。可在 config.yml 中切换。
目标玩家
通过向命令传递 -p:playername,或以 tab 补全的第一个参数形式,通过任何菜单查看其他玩家的数据。占位符针对目标玩家解析。支持在线和(可选)离线状态。
持久化玩家元数据
存储跨重启保留的每个玩家的数据(字符串、数字、布尔值)。无需数据库文件或额外存储。基于 Minecraft 的 PersistentDataContainer 实现,直接存储在玩家对象上。可通过菜单动作或 /am meta 进行设置、增加、减少、切换或删除。可通过 PlaceholderAPI 读取或在需求中进行检查。
铁砧与聊天文本输入
收集玩家的自由文本。铁砧输入会打开一个铁砧 GUI,玩家可在重命名字段中输入。聊天输入会关闭菜单并等待下一条聊天消息。可构建搜索菜单、命名系统、自定义表单等。DeluxeMenus 不具备此功能。
物品模板
在 templates/ 中定义一次可复用的物品,然后在各个菜单中使用变量替换。使用 {variable} 占位符设置 material、name、lore、点击动作和需求,然后在使用时填入具体值。只需编写一次商店条目,即可为所有物品复用。
图案布局
使用字符网格来排列菜单,而非计算槽位编号。将字符映射到物品,AuMenus 会自动放置它们。
动画物品
帧循环物品,支持可配置的间隔、反向播放和单次播放。每帧均可覆盖材质、名称、描述和附魔。内置功能,无需额外插件。
进度条
根据来自占位符的当前/最大值填充一行槽位。分别设置已填充和未填充的视觉效果。适用于 XP、任务、地牢进度或任何具有比例的内容。
动态标题
按定时器更新库存标题,使用实时占位符。倒计时计时器、在线玩家数量、余额显示、天气和时间指示器。更新过程与页面更改一样流畅无闪烁。
玩家列表菜单
根据单个模板为每位在线玩家自动生成页面物品。配置头像、名称和描述一次。点击动作针对列出的玩家。可构建员工列表、好友菜单、组队邀请、传送菜单等。
谓词菜单
根据需求检查结果打开不同的菜单。配置一个条件和两个目标菜单,通过或不通过。AuMenus 会将玩家路由至正确的菜单。
开发者 API
其他插件可以注册自定义动作和需求类型,监听菜单事件,并以编程方式打开菜单。可在 JitPack 获取。代码库是开源的,你可以阅读其确切的工作原理。
DeluxeMenus 迁移
一条命令即可转换现有的 DeluxeMenus 配置。包括菜单选项、物品、动作、需求、占位符,甚至 JavaScript 表达式。原始文件保持不变。
附加功能
- 铁砧和聊天文本输入
- 按点击类型执行的动作(左键、右键、Shift+左键、Shift+右键、中键)
- 离线玩家占位符支持
- BungeeCord 和 Velocity 服务器切换
- 点击冷却时间,全局默认值加上每个菜单的覆盖选项
- 资源包自定义声音的原始声音动作
- 内置占位符:
{page}、{max_page}、{target}、{player},以及%aumenus_current_menu%和%aumenus_previous_menu% - 可配置的插件消息
- 支持 HeadDatabase、ItemsAdder、Oraxen、Nexo
联系方式
- Wiki: github.com/auvq/AuMenus/wiki
- Discord: discord.gg/B7ArGXP6
- 源代码: github.com/auvq/AuMenus
- 问题反馈: github.com/auvq/AuMenus/issues




AuMenus
A lightweight, open-source GUI menu plugin for Paper & Folia 1.21.1+. The modern DeluxeMenus alternative with native Folia support, MiniMessage formatting, and zero required dependencies. One command migrates your existing DM configs.
Key Things That Set It Apart
01. Open source (MIT). Fork it, modify it, no restrictions. Most menu plugins are closed source or paid.
02. Native Folia & Paper support. Built on the region-threaded scheduler from day one. No compat layer, no external scheduler library.
03. Zero dependencies. Drop the jar in and it works. Vault and PlaceholderAPI are optional, not required.
04. Built-in DeluxeMenus migration tool. One command converts your existing configs.
05. Supports modern text formatting. Gradients, hover text, click events. MiniMessage native, not bolted on.
Features
MiniMessage Formatting
Modern text formatting with gradients, hover text, and click events. Legacy color codes still work for migration.
Requirement System
Conditions that control who can open menus, click items, and see items. Permissions, money, exp, items, metadata, regex, math expressions, location, and inverted checks. The expression engine handles &&, ||, parentheses, and string methods natively. DeluxeMenus needs a JavaScript engine for the same thing.
In-Game Editor
Drag and drop menu editing without touching config files. Move items around, add new ones, pick items up to clear slots. Closing the editor saves the YAML. DeluxeMenus does not have this.
Pagination
Multi page menus for large item lists. Built-in prev_page and next_page actions, plus {page} and {max_page} placeholders that work in titles, item names, and lore.
Smooth Menu Transitions
Page changes and same-size menu opens (like shop categories spread across multiple YAMLs) reuse the existing window instead of closing and reopening it. No flicker, even when the title contains the page number. No other menu plugin does this. Toggleable in config.yml.
Target Player
View another player's data through any menu by passing -p:playername to the command, or as the first argument with tab completion. Placeholders resolve against the target. Works online and (optionally) offline.
Persistent Player Metadata
Store per player data (strings, numbers, booleans) that survives restarts. No database file, no extra storage. Backed by Minecraft's PersistentDataContainer, stored on the player object directly. Set, add, subtract, switch, or remove via menu actions or /am meta. Read it back with PlaceholderAPI or check it in requirements.
Anvil and Chat Text Input
Collect free text from players. Anvil input opens an anvil GUI where the player types into the rename field. Chat input closes the menu and waits for the next chat message. Build search menus, naming systems, custom forms. DeluxeMenus does not have this.
Item Templates
Define a reusable item once in templates/, then use it across menus with variable substitution. Set material, name, lore, click actions, and requirements with {variable} placeholders, then fill in values per use. Write your shop entry once, reuse it for every item.
Pattern Layouts
Lay out a menu with a character grid instead of counting slot numbers. Map characters to items and AuMenus places them automatically.
Animated Items
Frame cycling items with configurable interval, reverse, and one-time playback. Each frame can override material, name, lore, and enchantments. Built in, no extra plugin needed.
Progress Bars
Fill a row of slots based on a current/max value from placeholders. Set the filled and empty visuals separately. Works for XP, quests, dungeon progress, anything with a ratio.
Dynamic Titles
Update an inventory's title on a timer with live placeholders. Countdown timers, online player counts, balance displays, weather and time indicators. Updates ride the same flicker-free path as page changes.
Player List Menus
Auto generate page items for every online player from a single template. Configure the head, name, and lore once. Click actions target the listed player. Build staff lists, friends menus, party invites, teleport menus.
Predicate Menus
Open different menus based on a requirement check. Configure a condition and two target menus, pass and fail. AuMenus routes the player to the right one.
Developer API
Other plugins can register custom action and requirement types, listen to menu events, and open menus programmatically. Available on JitPack. The codebase is open source so you can read exactly how it works.
DeluxeMenus Migration
One command converts existing DeluxeMenus configs. Menu options, items, actions, requirements, placeholders, even JavaScript expressions. Original files left untouched.
Extras
- Anvil and chat text input
- Per click type actions (left, right, shift+left, shift+right, middle)
- Offline player placeholder support
- BungeeCord and Velocity server switching
- Click cooldowns, global default plus per menu overrides
- Raw sound actions for resource pack custom sounds
- Built-in placeholders:
{page},{max_page},{target},{player}, plus%aumenus_current_menu%and%aumenus_previous_menu% - Configurable plugin messages
- HeadDatabase, ItemsAdder, Oraxen, Nexo support
For Contact
- Wiki: github.com/auvq/AuMenus/wiki
- Discord: discord.gg/B7ArGXP6
- Source: github.com/auvq/AuMenus
- Issues: github.com/auvq/AuMenus/issues



下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuMenus
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
v1.0.6
功能:
- 无闪烁的菜单过渡:页面切换和同尺寸跨菜单打开时,标题和内容在单个捆绑数据包中交换,无中间空帧。可在
config.yml中使用smooth_transitions进行切换。
性能:
- 材质查找缓存:
Material.matchMaterial现在针对每个唯一字符串仅解析一次。 - 静态 ItemStack 缓存:没有占位符且不依赖玩家材质的物品构建一次并在后续渲染时克隆。重载时清除。
- 跨菜单平滑交换仅空出孤立的槽位,而不是对整个库存调用
inventory.clear()。
修复:
- 禁用时崩溃:
onDisable正在关闭每个在线玩家的打开库存,在 Folia 的世界拆除期间对真实末影箱导致 NPE。现在只关闭我们自己的菜单,每个都尝试/捕获。 - Folia 上的 ConcurrentModificationException 来自 tab-complete 和广播操作在突变过程中迭代
Bukkit.getOnlinePlayers()。所有迭代现在通过Util.snapshotOnlinePlayers(),它在 CME 上重试并回退到空值。 update_interval低于 1 秒被忽略(全局任务限制为 1 秒)。任务现在以 50ms 滴答。- 动画物品闪烁回到基础(更新任务覆盖动画任务刚刚写入的帧)。
- 具有
{page}/{max_page}的静态物品在分页后显示陈旧数字。添加了refreshStaticItems传递。 - DOUBLE 上的元数据加减累积浮点错误。现在使用 BigDecimal 并保留输入比例。
- 需求拒绝列表中的裸动作名称(例如
- close)发送到聊天而不是执行。 player:动作不再双重斜杠以/开头的命令。click_cooldown在启用时缓存并在/am reload时未刷新。现在从配置实时读取。
编辑器修复:
- 刚丢弃的物品在保存时被删除(孤儿清理循环迭代了包含它刚刚添加物品的实时视图)。
- 玩家头部纹理丢失。丢弃的头现在保存为
basehead-<texture>或head-<owner>而不是纯PLAYER_HEAD。 - 仅捕获材质/槽位/数量/名称/lore。现在也捕获 custom_model_data、item_model、tooltip_style、附魔、物品标志、不可破坏、稀有度、隐藏工具提示、伤害以及皮革/药水 RGB。
- 名称和 lore 现在使用 MiniMessage 序列化,以便颜色、渐变、字体和装饰存活(原来是纯文本)。
- 当物品没有
custom_name时回退到item_name,因此只有规范名称的资源包物品正确保存。 - Nexo、ItemsAdder、Oraxen 和 HeadDatabase 物品现在作为
nexo-<id>/itemsadder-<id>/oraxen-<id>/hdb-<id>保存,通过每个插件的反向查找 API 而不是它们的 vanilla 基础材质。 - 使用先前编辑器会话的陈旧编辑器 PDC 标签拖入的物品(例如 shift-clicked out,放入新菜单)保存为裸
slot:存根。除非它们指向当前菜单配置中已存在的名称,否则标签将被忽略。 - 每属性元数据捕获包装,因此单个失败的 API 调用(例如在未来版本方法上)跳过该部分而不是中止整个物品。
诊断:
- 防御性
%player_name%回退在动作/占位符解析结束时,当回退触发时带有调试日志。 MetaStore.set记录[Meta] <player> set <key> (<type>) = <value>到控制台当debug: true时。- 编辑器记录
[Editor] <type> saved as material '<resolved>'当debug: true时。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧