UI 计时器库

UI 计时器库

一个专为模组制作者设计的简易UI计时器,力求使用起来尽可能简单。

基础库

UI Utils

UI Utils 是一个轻量级的 Fabric 库,能够在不编写自有渲染器的情况下,轻松在 HUD 上显示元素。

它专为希望以快速、轻量方式在玩家屏幕上显示文本和计时器的模组开发者设计。

以下是该库的使用示例。

2026-06-15-11-15-40

功能

  • 在 HUD 上显示自定义文本
  • 显示实时倒计时器
  • 轻松更改文本和背景颜色
  • 显示和隐藏叠加层
  • 轻量级,易于集成到其他模组中

设置方法

  • 从“版本”选项卡下载最新的 ui-utils-<version>.jar。

  • 将 JAR 文件添加到项目依赖中。

  • 在模组中将 UI Utils 添加为依赖项。

    fabric.mod.json

    {
      "depends": {
        "fabricloader": "*",
        "minecraft": "1.21.6",
        "ui-utils": "*"
      }
    }
    
  • 在 Java 文件中导入。

    Main.java

    import com.uitutils.UIUtils;
    

使用方法

  • 显示带标签的计时器
UIUtils.show(String label, int seconds);
  • 隐藏计时器
UIUtils.hide();
  • 设置计时器数值
UIUtils.setTime(int seconds);
  • 设置计时器颜色(24 位 RGB 十六进制整数)
UIUtils.setColor(int rgb);
  • 设置背景颜色(24 位 RGB 十六进制整数)
UIUtils.setBackground(int rgb);

内部字段

这些字段可直接访问,但非正常使用所需。

  • 查询当前 HUD 文本字符串
UIUtils.text;
  • 查询倒计时数值(秒)
UIUtils.secondsRemaining;
  • 查询 HUD 可见性
UIUtils.visible;
  • 查询 HUD 文本颜色
UIUtils.color;
  • 查询背景颜色
UIUtils.background;