HerobrineHUD

HerobrineHUD

专为Minecraft设计的专业电子竞技观察员与转播系统。

工具

HerobrineHUD - Minecraft 电子竞技转播与观战系统

HerobrineHUD 是一款专为 Minecraft 电子竞技、直播和专业转播环境量身打造的模组。 无论你是在举办大型官方锦标赛,还是休闲多人小游戏,本模组都旨在提供顶级的系统级观战界面。

我们的理念:Minecraft 从来不缺极具乐趣的游戏,但一直缺乏一款系统级的 UI 工具,让这些游戏在视觉上对观众产生吸引力。

✨ 核心功能

目前,HerobrineHUD 提供真正开箱即用的体验(无需任何配置)。只需在服务端和转播者客户端上安装本模组,客户端便会无缝显示实时队伍信息和玩家状态。原版 /team 分组会自动直接同步到转播者的 HUD 面板!

转播者 / 管理员快捷键:

  • H 键:快速切换 HUD 显示。
  • K 键:打开 HUD 管理与设置 GUI。在这里,你可以切换特定的 UI 元素(如盔甲槽、药水效果等),并轻松管理屏幕左右两侧显示哪些玩家。
  • 小键盘按键(1~9、0):快速切换镜头。在旁观者模式下,只需按下玩家在屏幕上槽位编号对应的小键盘按键,你的镜头就会立即平滑锁定到该玩家的视角!

HerobrineHUD 旨在为转播者清晰呈现:

  • 基于队伍的玩家卡片布局
  • 实时玩家生命值与状态变化
  • 装备、药水效果与游戏内信息显示
  • 为观战和镜头切换量身打造的高效控制体验

📌 当前状态

Fabric 端的多版本迁移与版本专属架构已完成。

当前支持的 Minecraft 版本:

  • 26.1
  • 1.21.11

🚀 未来计划

本模组基于标准 GSI(游戏状态集成)概念构建。其目标不仅是“显示游戏内信息”,而是逐步为 Minecraft 电子竞技和直播构建更完整的呈现生态。

长期计划包括:

  • 丰富的 GSI 状态字段(未来开放 API): 我们将逐步暴露更多游戏状态数据,允许第三方模组将其自定义游戏模式规则或特定扩展数据无缝注入 HUD 渲染管线,最终演化为开放的 API 生态。
  • 实时 HTTP 广播: 服务端将提供接口,将游戏数据作为实时 HTTP 服务广播。这将允许纯外部应用程序消费实时数据,并利用 Web 技术构建专用的第三方 overlay 界面(例如可直接用作 OBS 浏览器源,无需传统的游戏窗口捕获)。

🗺️ 路线图

  • 集成 AUI 框架,将原生 Web 技术引入游戏,以灵活渲染惊艳且高度可定制的 Web 风格 UI。
  • 提供丰富的 UI 主题框架以及完整的 主题管理器 支持。
  • 支持更多模组加载器,例如 NeoForge。

🛠️ 开发与调试

Windows PowerShell:

.\gradlew.bat build

运行客户端:

.\gradlew.bat runDebugClient
.\gradlew.bat runDebugClient "-PdebugVersion=26.1"
.\gradlew.bat runDebugClient "-PdebugVersion=1.21.11"

运行服务端:

.\gradlew.bat runDebugServer
.\gradlew.bat runDebugServer "-PdebugVersion=26.1"
.\gradlew.bat runDebugServer "-PdebugVersion=1.21.11"

🧱 项目结构

  • common/:共享数据模型与通用逻辑
  • fabric/:共享 Fabric 实现与版本专属覆盖代码
  • fabric-remap/:1.21.x 的 Remap 构建路径

在 fabric/src/ 下:

  • 共享服务端 / 平台逻辑:fabric/src/main/
  • 共享客户端逻辑:fabric/src/client/
  • 版本专属主端覆盖:fabric/src/mc<version>/main/
  • 版本专属客户端覆盖:fabric/src/mc<version>/client/