Essentials Warp GUI - 传送点界面美化

💡简介

WarpGUI 是一个轻量级、功能强大的 Minecraft 插件，它在经典的 Essentials / EssentialsX 插件基础上，为 /warp 命令提供了一个美观、可完全自定义的图形用户界面（GUI）。它自动检测现有的 Essentials 地标，无需重新创建，并允许你通过直观的菜单来管理和使用所有地标。

🎮核心特性

稳定性与性能

• 完整支持从 1.8.8 开始的所有 Minecraft 版本，并对 1.13+ 的现代版本有更好的支持。
• 完全兼容旧版 Essentials 和 EssentialsX。
• 采用干净、模块化的代码结构，轻量且高效。
• 支持多线程处理，减轻主线程压力，对服务器 TPS 几乎无影响。

功能与易用性

• 开箱即用：配置简单直观，无需花费大量时间进行复杂设置。
• 无缝集成：不会替换 Essentials 原有的地标功能，而是基于其构建。自动检测所有现有地标，无需重新创建。
• 独立存储：每个地标都存储在自己的文件中，便于迁移和修改。
• 高度可定制：支持自定义所有消息、GUI 外观，甚至每个地标按钮的显示名称、图标和描述文本（Lore）。
• 多页支持：可添加任意数量的地标，GUI 会自动分页显示。
• 悦耳音效：在打开/关闭界面、点击地标等事件时可播放音效（可禁用）。
• Hex 颜色支持：在 1.16+ 版本中，支持使用 Hex 颜色代码（例如 &#FF00FF）。
• 灵活布局：可以强制自定义每个地标在 GUI 中的显示位置。

🔧配置说明

主要配置文件 config.yml 允许你深度定制 WarpGUI 的外观和行为。

库存（GUI）设置

• inventory-title: GUI 标题（第一页）。
• inventory-title-page: 第二页及之后的 GUI 标题，可使用 {page} 变量。
• inventory-height: GUI 高度（1-6 行），设为 -1 可自动调整。
• inventory-center-x / inventory-center-y: 控制地标按钮的自动对齐方式（NONE， CENTRALIZED， ALIGNED）。
• inventory-offset-*: 设置地标按钮区域与 GUI 边界的偏移量。
• inventory-background-material / inventory-offset-material: 设置背景和偏移区域的填充材料。
• next-page-bar-material / next-page-button-material: 设置分页栏和“下一页”按钮的材料。

音效设置

可以为以下事件配置音效（名称、音量、音高）

• open: 打开 GUI 时。
• close: 关闭 GUI 时。
• click-warp: 点击地标按钮时。
• teleport-warp: 传送至地标时。
• switch-page: 切换页面时。

命令监听

• listen-to-commands: 用于打开 WarpGUI 的命令列表，默认为 - warps 和 - warp。

消息定制

所有插件消息都可以在 messages.yml 文件中进行自定义，包括命令使用反馈、错误提示和界面文本。

✨权限系统

WarpGUI 不修改 Essentials 原有的权限系统。玩家在 GUI 中只会看到他们拥有权限访问的地标。

• 要访问特定地标，玩家需要 essentials.warps.<地标名称> 权限。
• 要访问所有地标，玩家需要 essentials.warps.* 权限。
• 要使用管理员配置命令 /warpcfg，需要 warpcfg.cfg 权限。

Essentials 本身还有一个 per-warp-permission 配置选项，可用于完全控制权限检查。

⭐物品语法

在使用 /warpcfg icon <warp> <icon> 命令设置地标图标时，需要遵循特定的物品语法。

支持的功能

• 1.19+ 版本：可以使用与 /give 命令相同的物品语法（包括 NBT 数据）。
• 1.20.5+ 版本：需使用物品组件（Item Components）替代 NBT。
• 支持使用旧版本（1.12 之前）的材料 ID（不推荐）。
• 支持使用新旧版本的材料名称。
• 自定义头颅：

- `player_head:<玩家名>`

- `player_head:<Base64材质纹理>`

• 染色皮革盔甲（使用 HEX 颜色）：

- 例如：`leather_chestplate:#FF00FF`

示例

• stone
• 1:1 （变成花岗岩）
• iron_pickaxe:50 （带有一些耐久损耗的镐）
• player_head:Notch （Notch 的头颅）
• player_head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYjA0ODMxZjdhN2Q4ZjYyNGM5NjMzOTk2ZTM3OThlZGFkNDlhNWQ5YmNkMThlY2Y3NWJmYWU2NmJlNDhhMGE2YiJ9fX0= （一个地球仪材质）
• leather_chestplate:#FFFF00 （黄色皮革胸甲）
• stick{Enchantments:[{id:"minecraft:knockback",lvl:1s}]} （仅限 1.19 - 1.20.4，带有击退 I 附魔的木棍）

你可以通过在线资源（如 Minecraft 材料列表网站）查找所有可用的材料名称。请注意，与你服务器 Minecraft 版本不兼容的材料将无法使用。

❓相关插件

同一开发者还提供了功能类似的 KitGUI 插件，用于为 /kits 命令提供图形界面。

**官方资源**

• SpigotMC 页面
• （请将“官方网站”链接替换为实际网址）