WarpGUI - 监狱服务器传送界面

EZRanksPro WarpGUI 是一个基于 EZRanksPro 的插件，它允许你通过一个可完全自定义的 GUI 界面来展示和管理服务器的等级（或传送点）。玩家可以直观地查看所有等级，点击后直接执行 /warp <rank> 命令。

💡前置需求与依赖

此插件的运行依赖于以下插件

• EZRanksPro
• Vault

请确保在安装本插件前，服务器已正确安装并配置好上述插件。

🎮命令与权限

命令

玩家可以通过以下方式打开 GUI 界面

• 执行配置文件中自定义的命令（例如 /ranks）。
• 执行 /warpgui。
• 拥有权限的玩家可以执行 /warpgui [player] 为其他玩家打开界面。

权限

• warpgui.command：允许使用 /warpgui 命令。
• warpgui.openothers：允许使用 /warpgui <player> 命令为其他玩家打开界面。
• essentials.warps.<rank>：插件通过检查此权限来判断玩家是否已解锁某个等级。这是 Essentials 插件的传送点权限。

注意：如果你拥有 OP 权限或通配符权限（如 或 essentials.warps.），所有等级都会显示为已解锁，界面可能看起来不太正常。这是目前最可行的实现方式。

🔧配置与自定义

插件的几乎所有内容都可以通过配置文件进行自定义，包括 GUI 标题、大小、物品、命令等。

主要配置项

• inv_name: GUI 窗口的标题。
• inv_size: GUI 的行数（每行 9 格，例如 6 代表 6 行，共 54 格）。
• commands: 用于打开此 GUI 的命令列表。
• slots: 定义每个 GUI 槽位对应的等级和物品。
• empty: 定义未使用的空槽位显示的物品。
• rank_not_reached: 当玩家尚未达到某个等级时，在物品提示信息中显示的文本。

物品配置详解

每个槽位 (slots) 下可以配置两种物品状态：

• item_locked: 等级未解锁时显示的物品。
• item_unlocked: 等级已解锁时显示的物品。

可配置的属性包括

• id: 物品 ID。
• sub: 物品子 ID/数据值。
• name: 物品显示名称（支持颜色代码）。
• lore: 物品描述文本（支持颜色代码）。
• glow: 设置为 true 可使物品带有附魔光效（此效果不显示在 lore 中）。

动态变量

在物品的 name 和 lore 中，可以使用以下变量，插件会自动替换：

• {CURRENT}: 当前等级名称。
• {STATUS}: 解锁状态（例如“已解锁”或“未达到”）。
• {PERCENTAGE}: 完成百分比。

配置示例

一个完整的配置示例可以在以下链接查看

http://pastebin.com/MYjnXCVF

**配置片段说明**

empty:
  id: 35
  sub: 14
  name: "&4Invalid rank"
  lore:
  - '&3This slot is'
  - '&3not in use.'

此部分定义了未使用槽位的填充物品。若想留空，可将 id 设置为 0。

✨工作原理

• 玩家通过配置的命令或 /warpgui 打开 GUI。
• 插件根据玩家拥有的 essentials.warps.<rank> 权限，判断每个等级的解锁状态。
• GUI 中每个槽位显示对应的等级物品。已解锁和未解锁状态使用不同的物品外观（item_unlocked 和 item_locked）。
• 当玩家点击一个物品时，插件会代表玩家执行 /warp <对应等级名> 命令。

❓注意事项与常见问题

• 权限检查：本插件完全依赖 essentials.warps.<rank> 权限来判定解锁。请确保你的权限组插件（如 GroupManager、LuckPerms）已正确设置这些权限。
• OP 玩家：由于 OP 玩家默认拥有所有权限，GUI 将显示所有等级均已解锁。
• 物品光效：glow: true 选项可以为已解锁物品添加附魔光效，这是一个视觉效果，不会实际附魔物品。
• 自定义命令：你可以在配置文件的 commands: 列表中添加任意命令别名，方便玩家使用。

---

开发者注：如果你喜欢这个插件并愿意支持开发者，可以通过 PayPal 向 [email protected] 进行捐赠。任何支持都值得感激。