面向模组开发者的游戏内 HUD 引擎
DynamicHUD 是一个库。它为开发者提供了一套 API,用于创建可定制的 HUD 元素,供其模组使用,玩家还可以对这些元素进行修改和交互。
功能特性
| 功能 | 描述 |
|---|---|
| 自动保存与加载 | 小部件会自动保存状态,并在游戏重启后重新加载 |
| 交互式右键菜单 | 右键点击支持菜单的小部件,即可打开可定制的滑块、颜色选择器、运行命令(runnables)以及列表/枚举选项 |
| 屏幕边界限制 | 防止小部件超出窗口边界被裁剪 |
| 网格吸附与对齐 | 智能吸附到其他小部件,并显示辅助对齐网格(可在设置中切换开关) |
| 渲染工具类 | 使用 DrawHelper、ColorHelper 和 TextureHelper 简化渲染代码,例如绘制圆角矩形、纹理、彩虹文字、渐变、描边、阴影、任意形状、缩放工具以及可滚动文本 |
| 动画系统 | DynamicHUD 内置基于 2D 缓动函数的动画系统,让你的小部件和菜单更加流畅顺滑 |
| Wiki 文档 |
当你打开选项界面时,DynamicHUD 会在 'FOV' 滑块旁边提供一个专用的设置按钮,你可以用它来自定义你的小部件和菜单。
快捷键 (v4.0.0+)
目前这些快捷键不可修改。
在 Minecraft 的选项界面中,点击位于 FOV 滑块旁边的 DynamicHUD 设置按钮,以修改 DynamicHUD 的设置。
选择与分组
| 操作 | 控制方式 | 详情 |
|---|---|---|
| 框选 | 在画布上 点击 + 拖拽 |
选中绘制边界框内的所有小部件 |
| 多选 | CTRL + 左键单击 |
切换单个元素的选中状态 |
| 组合 / 解组 | CTRL + G |
将选中的元素链接在一起(显示绿色虚线轮廓) |
| 网格吸附 | Shift |
拖拽时按住此键,可将元素锁定到最近的网格。网格大小可在设置中更改 (Snap Size) |
注意:已锁定的小部件(
isLocked = true)会固定在原位,在拖拽组时不会移动。
小部件缩放
| 方法 | 使用方法 |
|---|---|
| 精确缩放 | 悬停在任意小部件上,并使用 CTRL + 滚轮 |
| 简单缩放 | 点击并拖拽选中小部件右下角的白色小圆点 |
展示
展示视频
快速上手(针对玩家)
- 确保你已安装 Fabric Loader 和 Fabric API。(注意:*对于较旧版本的 DynamicHUD,你可能还需要安装 YACL)。
- 从 Releases Tab 下载最新的
.jar文件。 - 将文件放入
.minecraft/mods目录。 - 启动游戏,享受吧 ;)
开发者入门指南
请访问我们的 wiki 获取更详细的文档。
首先,在你的 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 仓库 提交 Issue。
An in-game HUD engine for mod creators
DynamicHUD is a library. It is an API for developers to create customizable HUD elements for their mods that players can modify and interact with.
Features
| Feature | Description |
|---|---|
| Automatic Saving & Loading | Widgets automatically save their state and reload upon game restart |
| Interactive Context Menus | Right-click widgets supporting menus to open customisable sliders, color pickers, runnables, and lists/enum selection |
| Screen Boundary Clamping | Made to prevent widgets from clipping outside window boundaries |
| Grid Snapping and alignment | Smart snapping along other widgets and alignment grid displayed for your convienence (can be toggled in settings) |
| Rendering Utilities | Use DrawHelper, ColorHelper, and TextureHelper to simplify rendering code like drawing rounded rectangles, textures, chroma text, gradients,outlines, shadows, any shape, scaling utilities and scrollable text |
| Animation system | DynamicHUD comes with a 2D easing based animation system to help your widgets and menus feel smooth |
| Wiki |
DynamicHUD has a dedicated settings button when you open the option screen beside the 'FOV' slider which you can use to customise your widgets and menus.
Keybinds (v4.0.0+)
Currently these keybinds are unmodifiable.
Open the DynamicHUD Settings Button located next to the FOV Slider in the Minecraft options screen to modify DynamicHUD's settings.
Selection & Grouping
| Action | Control | Details |
|---|---|---|
| Box Select | Click + Drag on canvas |
Selects all widgets inside the drawn boundary box |
| Multi-Select | CTRL + Left Click |
Toggles selection state on individual elements |
| Group / Ungroup | CTRL + G |
Links selected elements together (shows a green dashed outline) |
| Grid Snapping | Shift |
Hold while dragging to lock elements to nearest grid. Grid size can be changed in the settings (Snap Size) |
Note: Locked widgets (
isLocked = true) remain anchored in place and will not move when dragging a group.
Widget Scaling
| Method | How to Use |
|---|---|
| Accurate | Hover over any widget and use CTRL + Scroll Wheel |
| Simple | Click and drag the small white dot on the bottom-right corner of a selected widget |
Showcase
Showcase Video
Quick Setup (For Players)
- Ensure you have Fabric Loader, Fabric API. (Note: You may also need YACL installed for older versions of DynamicHUD).
- Download the latest
.jarfrom the Releases Tab. - Drop the file into your
.minecraft/modsdirectory. - Launch the game and enjoy ;)
Getting Started For Developers
Visit our wiki for more detailed documentation.
To get started, begin with adding DynamicHUD as a dependency in your build.gradle file:
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>'
}
Contributing
Contributions are welcome! If you’re interested to do any help, please review our contributing guidelines. I myself am a solo developer in college and still learning to code. Updating to latest versions may take time. Any help will be greatly appreciated!
License
DynamicHUD is released under the MIT License. Feel free to use and modify it in your mods, with proper attribution back to this repository.
Support
Need assistance or have suggestions? Join our Discord community or submit an issue on our GitHub repository.
下载 DynamicHUD
下载 DynamicHUD
下载 DynamicHUD
下载 DynamicHUD
下载 DynamicHUD
下载 DynamicHUD
下载 DynamicHUD
下载 DynamicHUD
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DynamicHUD
下载 DynamicHUD
已更新至版本 26.1.x
面向用户的主要亮点:
- 移除 YACL:已移除并替换了 YACL 依赖。
- 更好的 Minecraft 皮肤:MinecraftSkin 得到了增强,新增了界面音效、更佳的搜索功能和光标变化效果。
- 工具提示:为小部件以及选项添加了更多工具提示。
- 自定义化:小部件现在看起来更加定制化和流畅。
面向开发者的主要变更:
- [特性] TextWidget (String -> Component):文本小部件现在也接受通过注册表供应商传递的组件(Component)以及字符串(String)。在传递给供应商时,可以使用 MutableComponent 对组件进行样式设置。
- [更新] DynamicValueRegistry 重写:该注册表现在完全共享,并且需要 Identifier 作为键。
- [修复] drawChromaText 中的样式字符:
drawChromaText现在接受并渲染带有其原始样式的组件。 - [重构]:
drawScalableText和drawTruncatedScaledText已移至DrawHelper。 - [特性]
Util.getSearchResults():根据函数参数中设置的布尔值flatten,该函数将展平并排序结果选项,或者返回排序后的选项组 + 选项。 - [重构.] 选项
name、description和value访问修饰符变更:请分别使用其字段的 getter 方法。 - [特性]
renderTooltipIfHovered():该函数已被重载,现在在显示工具提示之前会等待指定的延迟时间。 - [特性] WidgetBuilder 中的
valudId:对于使用DynamicValueWidget的小部件,字段registryKey和registryId已被Identifier valueId替换。 - 完整更改日志:
Wiki 也已更新。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧