Tango's Dynamic Hud Lib

模组

· 作者 Pankraz01

一个用于可移动 HUD 组件的小型客户端 Fabric 库。 提供 API,供其他模组注册 HUD 元素使用。对玩家而言,这意味着 TangosHudLib 会渲染并存储通过此库注册的另一个模组的组件。

0 本站下载 0 关注 更新于 3 个月前

需要前置:Fabric API

最新 1.2.0+26.2 · 26.2 · Fabric

一键开服(送7天)

Tango's HudLib

Tango's HudLib 是一个面向客户端的 Fabric 库,用于实现可移动的 HUD(平视显示器)组件。

该模组本身并不提供主要的游戏功能。它提供了一个 API,供其他模组用来注册 HUD 元素。对玩家而言,这意味着 TangosHudLib 负责渲染并存储由其他模组通过此库注册的组件。

游戏内用法

  1. 安装该模组以及 Fabric API。
  2. 启动游戏,并确保已加载一个通过 TangosHudLib 注册组件的模组。
  3. 在 Minecraft 控制菜单中打开 Tango's HudLib 分类。
  4. 查找 HUD Editor (<Mod Name>)。
  5. 在游戏中按下绑定的按键以打开该模组的 HUD 编辑器。
  6. 使用鼠标左键拖拽组件以移动它们。
  7. 按相同的快捷键或 Esc 关闭编辑器。

组件位置保存在 config/tangos-hud-lib.json 中。

在你的模组中使用

最简单的干净集成包含两部分:

  1. 一个带有注解了 @HudWidget 的 static 方法的类。
  2. 在你的 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 作为快捷键。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源