WonderHUD - 动态游戏界面插件

WonderHUD 是一款为玩家创建个性化抬头显示界面的插件，它允许你自定义显示玩家需要查看的各种信息。

💡前置需求

• 核心服务端：Spigot v1.8 - v1.11
• 必需插件：
• ProtocolLib（请使用与你的 Minecraft 版本对应的 ProtocolLib 版本！）
• PlaceholderAPI
• 可选插件（用于区域特定 HUD）：
• WorldEdit
• WorldGuard

如果你喜欢 WonderHUD，不妨也试试 HoloGUI 插件！

🎮关于 PlaceholderAPI

本插件使用 PlaceholderAPI 的占位符在 HUD 中显示信息。PlaceholderAPI 的扩展需要单独下载安装。

安装扩展教程

• 首先在游戏中运行命令：/papi enablecloud
• 下载默认配置中使用的扩展：

- `/papi ecloud download Server`

- `/papi ecloud download Player`

• 你可以浏览所有可用扩展列表：/papi ecloud list all <页码>
• 看到喜欢的扩展后，使用相同方式下载：/papi ecloud download <扩展名>
• 下载完所有需要的扩展后，运行命令：/papi reload

🔧命令列表

• /wh - 查看插件作者、版本和网站信息。
• /wh help - 显示 WonderHUD 命令帮助文本。
• /wh reloadconfig - 重载配置文件数据并更新所有 HUD。
• /wh playersviewing - 显示当前正在查看 HUD 的玩家数量。
• /wh hide - 隐藏你的 HUD（重新登录后会再次显示）。
• /wh show - 显示你的 HUD。
• /wh hideall - 对所有在线玩家隐藏 HUD。
• /wh showall - 对所有拥有 wh.see 权限的在线玩家显示 HUD。

权限要求

• wh.admin 权限：可使用 /wh reloadconfig 和 /wh playersviewing 命令。
• wh.visibility 权限：可使用 /wh hide 和 /wh show 命令切换自身 HUD 可见性。
• wh.* 权限：可使用所有 WonderHUD 命令和功能。

✨配置详解

文本格式与颜色代码

在文本字符串中插入以下代码来格式化文本

格式代码

• |obfuscated| - 后续文本变为乱码
• |bold| - 后续文本加粗
• |strikethrough| - 后续文本添加删除线
• |underline| - 后续文本添加下划线
• |italic| - 后续文本变为斜体
• |reset| - 重置后续文本的格式

颜色代码

• |black|, |dark_blue|, |dark_green|, |dark_aqua|, |dark_red|
• |dark_purple|, |gold|, |gray|, |dark_gray|, |blue|
• |green|, |aqua|, |red|, |light_purple|, |yellow|, |white|

示例 1：使用格式代码

• 配置文本："|dark_red||bold|WonderHUD|reset| is |underline|awesome!"
• 显示效果：WonderHUD is <u>awesome!</u>

示例 2：使用 PlaceholderAPI 占位符

• 配置文本："Welcome %player_name%, to the server!"
• 显示效果：Welcome Kloudy, to the server!

基础消息配置

• hud-show-text: "HUD now visible" - 显示 HUD 时提示的文本
• hud-hide-text: "HUD now hidden" - 隐藏 HUD 时提示的文本
• hud-show-all-text: "HUDs now visible to all players" - 为所有玩家显示 HUD 时的提示文本
• hud-hide-all-text: "HUDs now hidden from all players" - 为所有玩家隐藏 HUD 时的提示文本
• restart-huds-on-world-change: true - 玩家切换世界时是否重启 HUD 序列
• max-players: 35 - 允许同时查看 HUD 的最大玩家数量

定义 HUD 对象

所有 HUD 都在 hud-objects: 节点下定义。

图片 HUD 配置示例

welcome: # 你定义的 HUD 名称（需唯一）
  type: image-hud # HUD 类型 (选项: basic-hud, image-hud)
  image-src: welcome.gif # 要显示的图片源文件（图片必须位于 plugins/WonderHUD/images 文件夹内）
  width: 60 # HUD 宽度 (默认: 40)
  height: 20 # HUD 高度 (默认: 20)
  start-time: 0 # 登录后多少秒开始显示 (默认: 0)
  duration: 10 # 显示持续多少秒 (默认: -1 表示无限)

基础文本 HUD 配置示例

welcome-text:
  type: basic-hud
  start-time: 10
  show-permission: "" # 玩家拥有指定权限时才可看到此 HUD（玩家仍需 wh.see 权限才能看到 HUD）
  hide-permission: "" # 玩家拥有指定权限时将不会看到此 HUD
  duration: 5 # -1 表示 HUD 将无限期可见
  loop-after: true # 此 HUD 显示结束后是否重新开始 HUD 序列
  lines: # 要显示的文本行
    - "Welcome |gray||bold|%player_name%|reset|, to |gold||bold|%player_server%"
    - "Current Position: x: %player_x%, y: %player_y%, z: %player_z%"
    - "|green||bold|Players Online|reset|: %server_online%"

❓相关信息

• 使用本插件的服务器：playminecraft.net
• GitHub 项目地址：你可以在 GitHub 上查看 WonderHUD 的源码。
• 支持与捐赠：如果你喜欢这个插件，请考虑捐赠支持开发者。