配置项

基本信息

本 mod 不用 Forge 原生 Configuration，而是 GTNHLib 的注解式配置—— 字段用 @Config.DefaultInt / @Config.DefaultBoolean / @Config.DefaultString / @Config.DefaultFloat 标注默认值，类与嵌套类用 @Config.LangKey 指定界面标题。 默认值全部来自源码注解，不是猜的。

4 个配置文件

⚠️ 源码缺陷：ClassicBarConfig 与 LightOverlayConfig 抢同一个文件

configs/ClassicBarConfig.java:7：

@Config(modid = MODID, category = "classicbar", configSubDirectory = "InfoHUD", filename = "LightOverlayConfig")

filename 写的是 "LightOverlayConfig"，应为 "ClassicBarConfig"。

HudConfig（65 项，5 个嵌套类）

configs/HudConfig.java:7： @Config(modid = MODID, category = "hud", configSubDirectory = "InfoHUD", filename = "HudConfig") @Config.LangKey("infohud.config.hud.name") → §cHUD Settings

5 个嵌套类通过 public static final 单例暴露（HudConfig.java:11-15）：

public static final HudGeneral hudGeneral = new HudGeneral();
public static final HudOrder hudOrder = new HudOrder();
public static final HudItems hudItems = new HudItems();
public static final HudEnabled hudEnabled = new HudEnabled();
public static final HudPotion hudPotion = new HudPotion();

HudGeneral（4 项，HudConfig.java:18-36）

@Config.LangKey("infohud.config.hud.hud_general.name") → §aHUD General

HUD 默认在屏幕左上角（0, 0），缩放 1.0。

HudPotion（3 项，HudConfig.java:39-52）

@Config.LangKey("infohud.config.hud.hud_potion.name") → §aHUD Potion

控制 HUD 上自定义的药水效果显示（时长 / 等级）。 与之配套的还有 GeneralConfig.DisablePotionEffect（默认 true）—— 后者关掉原版药水图标，两者配合是「用 HUD 的替代原版的」。

HudOrder（19 项，HudConfig.java:55-…）

@Config.LangKey("infohud.config.hud.hud_order.name") → §aHUD Order

全部 19 项都是 @Config.RangeInt(min = 1, max = 100)（范围 1–100）。 默认值恰好是 1–19 的一个完整排列，无重复、无空缺。

⚠️ @Config.Order（GUI 显示顺序）与默认值（实际排序权重）刻意不同：

按默认值排序后的实际 HUD 顺序（这才是屏幕上从上到下的次序）：

Fps(1) → Ping(2) → Tps(3) → Memory(4) → ServerMemory(5) → Position(6)
→ Lp(7) → Warp(8) → Dimension(9) → Biome(10) → Direction(11) → OreChunk(12)
→ SlimeChunk(13) → WorldTime(14) → PlayTime(15) → SessionTime(16)
→ Jump(17) → Forestry(18) → Nutrient(19)

即 @Config.Order 只是配置界面里的行序，与 HUD 实际排列无关—— 排版时必须看默认值，不要照 @Config.Order 写。

⚠️ 无 CountItem 对应的顺序项——InfoCountItem 的 order 在 Hud.java:72 硬编码为 0，不可配置。 因此 HudOrder 19 项 + 硬编码的 1 项 = 20 个实例。

HudItems（19 项，HudConfig.java 的 hud_icons 段）

@Config.LangKey("infohud.config.hud.hud_icons.name") → §aHUD Icons

全部是 @Config.DefaultString("...")，值为物品 ID 字符串：

⚠️ 两个跨 mod 物品 ID 的大小写陷阱： AWWayofTime:weakBloodOrb 与 Thaumcraft:ItemEldritchObject 都首字母大写， 与 GTNH 常见的全小写域不同。见 可选 mod 集成。

📌 SessionTimeItem 是唯一带 meta 后缀的（minecraft:golden_apple/1， meta 1）；SlimeChunkItem 与 JumpItem 共用 minecraft:slime_ball。

⚠️ 无 CountItem 字段——InfoCountItem 没有图标（与 HudOrder 情况一致）。

HudEnabled（20 项，HudConfig.java:235-316）

@Config.LangKey("infohud.config.hud.hud_toggles.name") → §aHUD Toggles

全部 20 项 @Config.DefaultBoolean(true)——默认全开。

20 项开关 vs 19 项顺序 vs 19 项图标——差的那 1 项就是 CountItemEnable： 有开关、无顺序、无图标。

GeneralConfig（1 项）

configs/GeneralConfig.java:7，无 category（顶层）：

作用：取消原版药水效果图标的渲染。 @Config.DefaultBoolean(true) 意味着默认就关闭原版图标。

@Inject(method = "func_147044_g", at = @At("HEAD"), cancellable = true)
private void cancelPotionEffectRendering(CallbackInfo ci) {
    if (GeneralConfig.DisablePotionEffect) {
        ci.cancel();
    }
}

（mixins/early/InventoryEffectRendererMixin.java:15-21， 目标 InventoryEffectRenderer，方法 func_147044_g）

📌 不是 bug：名字是 DisablePotionEffect = 「禁用（原版的）药水效果渲染」， 默认 true 是因为 InfoHUD 用 HudPotion 的 PotionEnable / TimeEnable / LevelEnable 替代它。两者配合：关掉 GeneralConfig.DisablePotionEffect 会让原版图标与 HUD 图标同时出现。

LightOverlayConfig（1 项）

configs/LightOverlayConfig.java:7，category = "light"：

作用：光照覆盖层的数字是否跟随视角。 默认 false = 跟随（吸附到 4 个正方向）；true = 固定朝 180。 见 光照等级覆盖层。

ClassicBarConfig（2 项）

configs/ClassicBarConfig.java:7，category = "classicbar" （⚠️ filename 写错，见上文缺陷）：

默认关闭。见 经典状态条。

语言包

本 mod 没有任何中文翻译。

9 个 @Config.LangKey 全部能在 en_US.lang 的 1–9 行找到对应键：

其余 30 行是 HUD 行、光照模式与按键的文本（10–38）。

📌 HudPotion 的 lang 键是 infohud.config.hud.hud_potion.name（en_US.lang:9）， 但它在 HudConfig.java 里的 @Config.LangKey 与 HudItems（hud_icons）、HudEnabled（hud_toggles）分开定义—— hud_potion 是第 5 个嵌套类，源码里定义在 HudPotion.java 段（39-52）。

关联

• 20 个信息行的图标 / 顺序 / 开关对应见 HUD 信息行
• 经典条见 经典状态条
• 光照层见 光照等级覆盖层