[Addon] RPGhuds for ItemsAdder - 货币与GPS界面增强

为你的服务器打造独一无二的游戏体验！RPGhuds 提供了一系列原版风格的屏幕显示（HUD）元素，如货币、GPS、箭矢指示器等，让你的服务器界面既美观又实用。它专为大型服务器优化，并且完全开源，你可以自由修改以满足个性化需求。

💡功能特性

• 原版风格货币指示器：类似 OriginRealms 的 Ruby 指示器，在屏幕上显示玩家货币。
• 原版风格 GPS 指示器：在屏幕上显示方向与坐标信息。
• 原版风格箭袋指示器：显示玩家携带的箭矢数量。
• 原版风格箭矢目标指示器：显示当前瞄准的目标。
• 大型服务器优化：性能经过优化，适合高负载环境。
• 完全开源：你可以自由编辑插件代码，以适应服务器的具体需求。

🎮安装指南

请严格按照以下步骤操作

前置准备

• 确保已更新到 ItemsAdder 3.4.1-r5 或更高版本。
• 安装所有必需的依赖插件（见下方列表）。

安装步骤

• 运行指令下载 Vault 的 PlaceholderAPI 扩展：/papi ecloud download Vault
• 重载 PlaceholderAPI：/papi reload
• 关闭服务器。
• 将本插件的 JAR 文件放入服务器的 plugins 文件夹。
• 启动服务器。
• 打开 plugins\RPGhuds\config.yml 文件，在其中添加你的世界名称。
• （仅限 1.18.2 或更低版本） 请阅读插件页面的特别说明。

资源包配置

• 使用指令生成资源包：/iazip
• 将生成的资源包上传到托管网站（如 Dropbox）。
• 更新 ItemsAdder 的 config.yml 中的资源包 URL。
• 使用指令重载 ItemsAdder 配置：/iareload

🔧使用方法

插件的主要功能通过以下两个指令管理

指令列表

/rpgcompass

• 描述：自定义指南针（GPS）目标点指令。
• 用法：/rpgcompass <player> <set|remove> <world> <x> <y> <z>

/rpghuds

• 描述：主插件指令，用于显示或隐藏 HUD。
• 用法：/rpghuds <action> <hud> [user]

❓权限节点

以下是所有可用的权限节点

基础 HUD 控制权限

• rpghuds.show：允许玩家对自己使用 /rpghuds show <hud>。
• rpghuds.hide：允许玩家对自己使用 /rpghuds hide <hud>。
• rpghuds.show.others：允许玩家对他人使用 /rpghuds show <hud> <player>。
• rpghuds.hide.others：允许玩家对他人使用 /rpghuds hide <hud> <player>。

指南针控制权限

• rpghuds.compass.set：允许玩家对自己使用 /rpgcompass set。
• rpghuds.compass.remove：允许玩家对自己使用 /rpgcompass remove。
• rpghuds.compass.set.others：允许玩家对他人使用 /rpgcompass set。
• rpghuds.compass.remove.others：允许玩家对他人使用 /rpgcompass remove。

✨依赖插件

本插件需要以下插件才能正常运行

• ItemsAdder (3.4.1-r5+)
• PlaceholderAPI
• Vault
• 一款经济插件 (例如：EssentialsX)

RPGHuds

RPGHuds 是一款为 Minecraft 服务器设计的插件，它允许玩家通过简单直观的菜单界面，自定义自己的生命值、饥饿值、经验值和等级等游戏 HUD（平视显示器）的显示样式。无论是想模仿经典 RPG 游戏的风格，还是追求独特的视觉体验，这个插件都能提供丰富的个性化选项。

💡主要特性

• 高度可定制：允许玩家自由选择生命值、饥饿值、经验值和等级的显示风格。
• 用户友好：通过图形化菜单进行设置，操作简单直观。
• 广泛兼容：支持多种 Minecraft 版本和服务器核心。
• 权限控制：管理员可以通过权限节点管理插件的使用。

🎮命令与权限

命令

• /rpghuds 或 /rh：打开 RPGHuds 主菜单。
• /rpghuds help：显示插件帮助信息。
• /rpghuds reload：重新加载插件配置文件（需要管理员权限）。

权限

• rpghuds.use：允许玩家使用 /rpghuds 命令打开菜单。（默认拥有）
• rpghuds.admin：允许玩家使用 /rpghuds reload 命令。（默认仅 OP 拥有）

🔧安装与配置

安装步骤

• 确保服务器运行的是受支持的 Minecraft 版本（例如 1.16.x - 1.20.x）。
• 将下载的 RPGHuds.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 插件会自动生成配置文件和数据文件夹。

基础配置

首次安装后，插件会生成 config.yml 文件。你可以在这里：

• 设置默认的 HUD 样式。
• 启用或禁用特定的显示元素。
• 调整菜单标题和消息文本。
• 修改完成后，使用 /rpghuds reload 命令应用更改。

✨使用方法

• 玩家在游戏中输入 /rpghuds 或 /rh 打开主菜单。
• 在菜单中，选择想要自定义的项目，例如“生命值样式”。
• 浏览并选择喜欢的显示风格（如：红心、数字、自定义图标等）。
• 选择后，玩家的 HUD 将立即更新为新的样式。
• 可以随时返回菜单更改其他项目或恢复默认设置。

❓常见问题

问：安装插件后，玩家的 HUD 没有变化？

• 答：玩家需要手动使用 /rpghuds 命令打开菜单并选择样式。管理员可以在 config.yml 中设置默认样式。

问：插件与其他 HUD 或资源包冲突吗？

• 答：RPGHuds 修改的是服务端的显示数据，通常与客户端资源包兼容。但若其他插件也修改了相同数据，可能会出现冲突。

问：如何为特定玩家组设置不同的默认样式？

• 答：目前插件版本不支持基于权限组的默认样式。所有玩家使用相同的全局默认设置，或需自行在菜单中更改。

问：支持哪些 Minecraft 版本？

• 答：插件支持 1.16.x, 1.17.x, 1.18.x, 1.19.x 和 1.20.x。请确保下载与服务器版本对应的插件文件。

⭐注意事项

• 在重载或重启服务器后，玩家的自定义 HUD 设置会被保存并自动恢复。
• 建议在正式使用前，在测试服务器上尝试不同的样式以确保兼容性。
• 定期备份 plugins/RPGHuds 文件夹，以防数据丢失。
• 查看官方页面或 Wiki 以获取最新的版本信息和详细文档。