Tango's HudLib
Tango's HudLib 是一个面向客户端的 Fabric 库,用于实现可移动的 HUD(平视显示器)组件。
该模组本身并不提供主要的游戏功能。它提供了一个 API,供其他模组用来注册 HUD 元素。对玩家而言,这意味着 TangosHudLib 负责渲染并存储由其他模组通过此库注册的组件。
游戏内用法
- 安装该模组以及 Fabric API。
- 启动游戏,并确保已加载一个通过 TangosHudLib 注册组件的模组。
- 在 Minecraft 控制菜单中打开
Tango's HudLib分类。 - 查找
HUD Editor (<Mod Name>)。 - 在游戏中按下绑定的按键以打开该模组的 HUD 编辑器。
- 使用鼠标左键拖拽组件以移动它们。
- 按相同的快捷键或
Esc关闭编辑器。
组件位置保存在 config/tangos-hud-lib.json 中。
在你的模组中使用
最简单的干净集成包含两部分:
- 一个带有注解了
@HudWidget的static方法的类。 - 在你的
ClientModInitializer中的一条注册调用。
示例
package eu.example.mod;
import eu.tango.tangosHudLib.api.HudContent;
import eu.tango.tangosHudLib.api.HudLibrary;
import eu.tango.tangosHudLib.api.HudWidget;
import net.fabricmc.api.ClientModInitializer;
import net.minecraft.client.MinecraftClient;
import net.minecraft.text.Text;
import net.minecraft.util.Formatting;
import org.lwjgl.glfw.GLFW;
public final class ExampleModClient implements ClientModInitializer {
@Override
public void onInitializeClient() {
HudLibrary.registerWidgets("examplemod", GLFW.GLFW_KEY_H, ExampleWidgets.class);
}
public static final class ExampleWidgets {
private ExampleWidgets() {
}
@HudWidget(id = "position")
public static HudContent position() {
MinecraftClient client = MinecraftClient.getInstance();
if (client.player == null) {
return HudContent.builder()
.line(Text.literal("Position").formatted(Formatting.GOLD))
.line(Text.literal("No world loaded").formatted(Formatting.GRAY))
.build();
}
return HudContent.builder()
.line(Text.literal("Position").formatted(Formatting.GOLD))
.line(Text.literal(
client.player.getBlockX() + " "
+ client.player.getBlockY() + " "
+ client.player.getBlockZ()
).formatted(Formatting.WHITE))
.build();
}
}
}
@HudWidget 的规则
组件方法必须满足以下条件:
- 必须是
static - 不能有任何参数
- 返回类型为
HudContent - 使用非空的
id
HudContent 必须至少包含一行非空内容:
HudContent.builder()
.line(Text.literal("Title"))
.line(Text.literal("Content"))
.build();
API 摘要
HudLibrary.registerWidgets(String ownerId, int defaultKey, Class<?> clazz)注册该类中所有的@HudWidget方法,并分配一个默认的 HUD 编辑器快捷键。HudLibrary.registerWidgets(String ownerId, Class<?> clazz)注册组件,但不分配默认快捷键。HudLibrary.registerWidgets(Class<?> clazz)使用库默认值tangos-hud-lib和H作为快捷键。
你是这个资源的作者?登录后可认领此资源。
相似资源
一个用于收集生物掉落物的多区块模组。
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
查看物品与配方
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
适用于 MC 1.18+ 的 Effekseer 加载器
一个基于构建器的 Minecraft 配置库!
评论 0
登录后参与评分
还没有评论,来抢沙发吧