AxRankMenu - LuckPerms 自动更新菜单

AxRankMenu 是一款面向 LuckPerms 的轻量级、自动更新的 /RANK 菜单插件，适合用来直观展示各个 rank 的权限信息，并支持在 GUI 中进行更多操作。

💡基本信息

• 支持的 Minecraft 版本：1.20.2-26.1.1
• 所需 Java 版本：21 或更高

⭐什么是 AxRankMenu？

AxRankMenu 是一个轻量级、可自动更新的 /RANK 菜单，专为 LuckPerms 设计。

它非常适合用来轻松展示 rank 的权限内容，无需频繁手动调整 GUI。

✨功能特色

• 节省时间
• 当权限发生变化时，无需手动编辑 GUI

• 多服务器支持
• 可显示你网络中其他服务器的权限信息

• 简单易用
• 权限内容易于编辑与翻译

• 多货币支持
• 可使用不同货币展示和出售 ranks

• 购买 ranks
• 可直接在 GUI 中购买 rank

🎮插件工作方式

• 权限及其属性的管理非常简单
• 权限内容可以轻松编辑
• 权限文本也便于翻译

🔧支持与委托

• 如果你需要 Commissions、Support 或其他帮助，可联系作者

AxRankMenu 文档

AxRankMenu 是一款功能强大的菜单插件，允许你为玩家创建自定义的等级菜单。它支持多种菜单类型，包括 GUI、聊天菜单和书本菜单，并提供了丰富的自定义选项。

💡功能特性

• 多种菜单类型：支持 GUI、聊天菜单和书本菜单。
• 丰富的自定义选项：可自定义菜单标题、大小、物品、音效等。
• 强大的条件系统：支持基于权限、等级、金钱、物品等多种条件的显示与执行。
• 动作系统：支持执行命令、给予物品、发送消息等多种动作。
• 变量支持：内置多种变量，并支持 PlaceholderAPI 变量。
• 多语言支持：内置多语言文件，支持自定义消息。

🎮命令与权限

命令

• /axrankmenu - 打开主菜单。
• /axrankmenu help - 显示帮助信息。
• /axrankmenu reload - 重载插件配置。
• /axrankmenu version - 查看插件版本。

权限

• axrankmenu.use - 允许使用 /axrankmenu 命令。
• axrankmenu.reload - 允许使用重载命令。
• axrankmenu.admin - 授予所有管理员权限。

🔧快速开始

安装步骤

• 将 AxRankMenu 插件文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑 plugins/AxRankMenu/config.yml 和菜单文件。
• 使用 /axrankmenu reload 重载配置。

创建第一个菜单

• 在 plugins/AxRankMenu/menus/ 目录下创建一个新的 YAML 文件（例如 example.yml）。
• 参考默认的示例菜单文件进行配置。
• 重载插件后，使用 /axrankmenu example 即可打开菜单。

✨配置详解

菜单配置结构

每个菜单文件通常包含以下部分

• menu-settings：定义菜单类型、标题、大小等基础设置。
• items：定义菜单中每个槽位的物品及其动作。
• conditions：（可选）定义菜单打开或物品点击的条件。
• open-actions 与 close-actions：（可选）定义菜单打开和关闭时执行的动作。

物品配置示例

items:
  0:
    material: DIAMOND
    name: "&b传送菜单"
    lore:
      - "&7点击打开传送菜单！"
    actions:
      on-click:
        - "[console] tp %player% 100 64 100"
        - "[message] &a你已被传送！"

❓常见问题

如何让菜单仅对特定权限的玩家显示？

在物品或菜单的 conditions 部分添加权限条件：

conditions:
  - "[permission] your.permission.here"

如何集成 PlaceholderAPI？

确保已安装 PlaceholderAPI。在配置的任何文本（如名称、描述）中，直接使用 %placeholder_name% 格式的变量即可。

菜单没有正常显示或打开？

• 检查 YAML 文件的缩进和语法是否正确。
• 查看服务器日志是否有错误信息。
• 确保已正确重载插件配置。

如何添加自定义音效？

在物品配置中使用 `sound` 字段，例如

sound: ENTITY_PLAYER_LEVELUP

⭐注意事项

• 修改配置文件后，请使用 /axrankmenu reload 重载以使更改生效。
• 建议在修改前备份你的菜单配置文件。
• 本插件需要 Java 17 或更高版本。
• 对于更高级的自定义，请参考插件 Wiki 或官方 Discord 社区。

如需更多帮助，请访问官方文档：https://docs.artillex-studios.com/axrankmenu.html