软盘HUD

软盘HUD

一个类似DOOM的HUD客户端模组!

游戏机制

Fabric 版本即将推出,关注项目即可在新版本发布时收到通知!

Floppy HUD 是一个适用于 Minecraft NeoForge 1.21.1 的纯客户端 HUD 转换模组。它完全替换原版 Minecraft 界面,以 1993 年传奇的 Doom 共享软件版本为灵感,打造怀旧且功能完整的复古 UI。 本模组是官方 2019 年愚人节版本《3D Shareware v1.34》HUD 的移植版,并加入了新功能。

功能特性

  • 经典面板: 自定义的完全透明 256x64 复古快捷栏面板,完美贴合屏幕底部。
  • 实时 3D 玩家面部: 完全动画化的玩家面部 3D 渲染,位于 HUD 正中央。该模型采用自定义旋转算法来模拟“四处张望”,同时完美冻结游戏世界中实体的实际碰撞箱。
  • 动态像素级状态栏:
    • 饥饿值: 经典的肉腿图标,会随着你挨饿而逐像素逐渐削减,使用精确的包围盒 UV 运算。
    • 氧气值: 自定义气泡图标,在水下潜水时会无缝出现并缩小。
  • 简洁文本与翻译: 支持 Minecraft 原生本地化(HEALTH 和 ARMOR 文本完全可翻译)以及动态百分比追踪。
  • 无缝原版集成: 自动移动原版叠加层(如经验等级和物品名称)以适应新布局,同时通过自定义 Mixin 和 NeoForge 事件总线安全地消除冲突的原版 HUD 元素(护甲、食物、生命值)。

安装

由于这是纯客户端模组,无需在服务器上安装。

  1. 确保已安装 NeoForge 1.21.1。
  2. 从 Releases 标签页下载最新的 .jar 文件。
  3. 将模组放入你的 .minecraft/mods 文件夹。
  4. 启动游戏,享受 Doom 风格的 HUD!

技术内幕(面向开发者)

本模组在构建时高度重视简洁、现代的渲染实践和优化的代码结构:

  • GuiGraphics 与 Z 层级: 利用现代的 GuiGraphics.blit 和矩阵栈平移(pose().translate)实现完美的 Z 层级排序和 Alpha 混合。
  • 智能 UI 运算: 摒弃了原版 1.14 中有缺陷的整数除法陷阱,改用纯浮点百分比计算来实现 UI 缩小效果。
  • 安全覆盖: 结合使用 @Mixin(Gui.class) 在不需要的原版渲染调用发生之前直接将其消除,并使用 RenderGuiLayerEvent.Pre 安全地移动必要的原版文本元素,而不破坏其他模组。

本地化

本模组原生支持 Minecraft 的 .json 语言系统。目前支持 en_us;en_gb;pt_pt 和 pt_br。要为你的语言添加翻译,只需在模组的资源文件夹中创建一个新的语言文件(例如 es_es.json),包含以下键:

{
  "gui.floppyhud.health": "HEALTH",
  "gui.floppyhud.armor": "ARMOR"
}