个人技术开发随记
测试入口

已在白名单的玩家使用自己的邀请码；未加入白名单的玩家使用进服拒绝提示中的临时邀请码。

HUD Plugin

XiceHUD 显示插件

返回插件列表

XiceHUD 是服务器的通用 HUD 显示层，统一管理 action bar、侧边栏 scoreboard 和 BossBar，避免多个业务插件直接写同一个显示位置造成互相覆盖。

功能概述

插件本身不保存业务数据，也不直接连接数据库。它通过 Bukkit ServicesManager 暴露 HudService，业务插件可以提交 action bar 文本、侧边栏内容或创建由 XiceHUD 托管的 BossBar。

当前经济余额仍通过 action bar 显示：XiceHUD 会检测 XiceEconomy 是否可用，并调用经济插件公开的余额查询接口，周期性刷新玩家自己的余额显示。

自定义状态效果侧边栏、RPG 副本波次 BossBar 和简易工业亡灵潮 BossBar 都已迁移到 XiceHUD 统一渲染。业务插件只负责计算要显示的内容，不再直接创建 sidebar scoreboard 或 Bukkit BossBar。

命令入口

  • /hud on：开启自己的 HUD。
  • /hud off：关闭自己的 HUD。
  • /hud reload：重新加载 HUD 配置，需要管理员权限。

部署方式

插件基于 Paper API 运行，当前项目按 Paper 1.21.11 和 Java 21 构建。构建产物安装为 /opt/xicemc/runtime/plugins/XiceHUD.jar。

运行时配置文件位于 /opt/xicemc/runtime/plugins/XiceHUD/config.yml，主要字段包括默认开关状态、经济模块开关、余额刷新间隔和 action bar 文本格式。

插件声明了 XiceEconomy 软依赖：没有经济插件时 HUD 插件仍可加载，但经济余额模块会显示暂不可用。XiceMorePotionEffects、XiceRPG 和 XiceSimpleIndustry 会依赖或调用 XiceHUD 的显示服务。