跳到正文

DynamicHUD

一个 HUD 前置库,可创建、显示、加载、保存和交互 HUD 元素(也称小部件),并支持更多功能。

收藏

截图

介绍

介绍由机器翻译自 Modrinth 原页面,仅供参考。

为模组创作者打造的游戏内 HUD 引擎

Discord
Docs

DynamicHUD 是一个前置库。它为开发者提供 API,用于为模组创建可自定义的 HUD 元素,供玩家修改和交互。

功能

| 功能 | 说明 |
| :— | :— |
| 自动保存与加载 | 小部件会自动保存其状态,并在游戏重启后重新加载 |
| 交互式上下文菜单 | 右键点击支持菜单的小部件,即可打开可自定义的滑块、颜色选择器、可运行项,以及列表/枚举选择菜单 |
| 屏幕边界限制 | 防止小部件超出窗口边界 |
| 网格吸附与对齐 | 智能吸附到其他小部件,并显示对齐网格以方便使用(可在设置中切换) |
| 渲染工具 | 使用 DrawHelper、ColorHelper 和 TextureHelper 简化渲染代码,可绘制圆角矩形、纹理、彩虹文字、渐变、轮廓、阴影及任意形状,还提供缩放工具和可滚动文本 |
| 动画系统 | DynamicHUD 内置基于 2D 缓动的动画系统,让小部件和菜单的动效更加流畅 |
| 维基 | https://tanishisherewith.gitbook.io/dynamic-hud |

打开选项屏幕后,你可以在“视野”滑块旁找到 DynamicHUD 专属设置按钮,用于自定义小部件和菜单。

按键绑定(v4.0.0+)

目前无法修改这些按键绑定。

在 Minecraft 选项屏幕中,点击位于视野滑块旁的 DynamicHUD 设置按钮,即可修改 DynamicHUD 的设置。

选择与分组

| 操作 | 控制方式 | 详情 |
| :— | :— | :— |
| 框选 | 在画布上点击并拖动 | 选中绘制边框内的所有小部件 |
| 多选 | CTRL + Left Click | 切换单个元素的选中状态 |
| 分组 / 取消分组 | CTRL + G | 将选中的元素关联在一起(显示绿色虚线轮廓) |
| 网格吸附 | Shift | 拖动时按住此键,可将元素锁定到最近的网格点。可在设置中更改网格大小(Snap Size)) |

注意:已锁定的小部件(isLocked = true)会保持锚定位置,拖动分组时不会移动。

调整小部件大小

| 方法 | 使用方式 |
| :— | :— |
| 精确 | 将鼠标悬停在任意小部件上,然后使用 CTRL + Scroll Wheel |
| 简易 | 点击并拖动选中小部件右下角的小白点 |

展示

展示视频

快速安装(玩家)

  1. 确保已安装 Fabric 加载器 和 Fabric API。(注意:较旧版本的 DynamicHUD 可能还需要安装 YACL)。
  2. 从 发布版本页面下载最新的 .jar 文件。
  3. 将文件放入 .minecraft/mods 文件夹。
  4. 启动游戏,尽情享受吧 😉

开发者入门

访问我们的维基,查看更详细的文档。

首先,在 build.gradle 文件中添加 DynamicHUD 作为依赖项:

allprojects {
	repositories {
		maven { url 'https://jitpack.io' }
	}
	maven {
		name 'Xander Maven'
		url 'https://maven.isxander.dev/releases'
	}
}

dependencies {
	// Dynamic HUD
	modImplementation 'com.github.V-Fast:DynamicHUD:<Version>'
}

参与贡献

欢迎贡献!如果你愿意帮忙,请查看我们的贡献指南。
我是一名在读大学生,独自开发这个项目,也还在学习编程。更新到最新版本可能需要一些时间。非常感谢你的帮助!

许可证

DynamicHUD 基于 MIT 许可证发布。欢迎在你的模组中使用和修改,但请注明出处并链接回本仓库。

支持

需要帮助或有建议?欢迎加入我们的Discord社区,或在 GitHub仓库中提交问题。

常见问题

DynamicHUD 支持哪些 Minecraft 版本?

DynamicHUD 支持 Minecraft Java 版 1.19.4–26.1.2,共 14 个版本,可用的加载器:Fabric / Quilt。下载时注意选择和你游戏版本一致的文件。

DynamicHUD 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / Quilt,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅客户端。

评论

登录后评论和评分

tanishisherewithhh 的其他作品

查看全部 →