通用配置项
基本信息
| 属性 | 值 |
|---|---|
| 配置分区 | general（Forge Configuration.CATEGORY_GENERAL） |
| 加载代码 | ConfigHandler.loadDefaultConfig（ConfigHandler.java:143-180） |
| 键名常量 | mcp.mobius.waila.utils.Constants（Constants.java） |
| 加载时机 | FMLPreInitializationEvent（Waila.java:59-64） |
Waila 自带的、与 addon 无关的基础配置。这些键在 preInit 时被 config.get(...) 一次性声明并写入配置文件（ConfigHandler.java:146-172）。
功能
布尔开关
| 键名常量 | 配置键 | 默认值 | 行 |
|---|---|---|---|
CFG_WAILA_SHOW |
waila.cfg.show |
true |
ConfigHandler.java:146 |
CFG_WAILA_MODE |
waila.cfg.showmode |
true |
ConfigHandler.java:147 |
CFG_WAILA_LIQUID |
waila.cfg.liquid |
false |
ConfigHandler.java:148 |
CFG_WAILA_METADATA |
waila.cfg.metadata |
false |
ConfigHandler.java:149 |
CFG_WAILA_KEYBIND |
waila.cfg.keybind |
true |
ConfigHandler.java:150 |
CFG_WAILA_NEWFILTERS |
waila.cfg.newfilters |
true |
ConfigHandler.java:151 |
CFG_WAILA_SHOWICON |
waila.cfg.showicon |
true |
ConfigHandler.java:152 |
键名常量定义见 Constants.java:18-23 与 Constants.java:31。ConfigHandler.showTooltip()（ConfigHandler.java:133-135）与 showIcon()（ConfigHandler.java:137-139）对前两者做了带默认值的封装。
布局与外观
| 键名常量 | 配置键 | 默认值 | 目标字段 | 行 |
|---|---|---|---|---|
CFG_WAILA_POSX |
waila.cfg.posx |
5000 |
OverlayConfig.posX |
ConfigHandler.java:154 |
CFG_WAILA_POSY |
waila.cfg.posy |
100 |
OverlayConfig.posY |
ConfigHandler.java:155 |
CFG_WAILA_ALPHA |
waila.cfg.alpha |
80 |
OverlayConfig.alpha |
ConfigHandler.java:157 |
CFG_WAILA_BGCOLOR |
waila.cfg.bgcolor |
0x100010 |
OverlayConfig.bgcolor |
ConfigHandler.java:158-159 |
CFG_WAILA_GRADIENT1 |
waila.cfg.gradient1 |
0x5000ff |
OverlayConfig.gradient1 |
ConfigHandler.java:160-161 |
CFG_WAILA_GRADIENT2 |
waila.cfg.gradient2 |
0x28007f |
OverlayConfig.gradient2 |
ConfigHandler.java:162-163 |
CFG_WAILA_FONTCOLOR |
waila.cfg.fontcolor |
0xA0A0A0 |
OverlayConfig.fontcolor |
ConfigHandler.java:164-165 |
CFG_WAILA_SCALE |
waila.cfg.scale |
100 |
OverlayConfig.scale |
ConfigHandler.java:166-167 |
scale 是唯一非直接赋值的项：读入的整数除以 100.0f 后才赋给 OverlayConfig.scale（ConfigHandler.java:166-167），故配置文件里填 150 等于 1.5 倍缩放。
实体 HUD
| 键名常量 | 配置键 | 默认值 | 目标字段 | 行 |
|---|---|---|---|---|
CFG_WAILA_NHEARTS |
waila.cfg.heartsperline |
20 |
HUDHandlerEntities.nhearts |
ConfigHandler.java:169-170 |
CFG_WAILA_MAXHP |
waila.cfg.maxhpbeforetext |
40 |
HUDHandlerEntities.maxhpfortext |
ConfigHandler.java:171-172 |
posx 默认值 5000 是一个极大值，用于把 HUD 推到屏幕外——即 Waila 出厂默认位置在屏幕外，需玩家自行调整。源码中该行无特殊注释，此判断依据为数值量级。
颜色合成
OverlayConfig.updateColors()（OverlayConfig.java:20-26）在 preInit 中紧随配置加载调用（Waila.java:60-61），把 0–100 的 alpha 换算为 << 24 的 alpha 通道，再与各 RGB 基色相加（OverlayConfig.java:21-25）：
alpha = (int)(cfg.alpha / 100.0f * 255f) << 24
bgcolor = alpha + cfg.bgcolor // 其余 4 项同构
数值
| 项 | 值 |
|---|---|
general 分区键总数 |
17 |
| 布尔键 | 7 |
| 布局/外观键 | 8 |
| 实体 HUD 键 | 2 |
OverlayConfig 静态字段数 |
8（OverlayConfig.java:10-17） |
Constants 中另有 4 个键名常量 CFG_WAILA_SHIFTBLOCK / CFG_WAILA_SHIFTENTS / CFG_WAILA_FLUIDUNIT / CFG_NEI_SHOW（Constants.java:14、Constants.java:27-28、Constants.java:32）在 loadDefaultConfig 中未被读取，故不计入上表。
交互
general 分区与 addon 声明的 modules / server_forcing 分区相互独立，见 配置 API。键位开关由 waila.cfg.keybind 控制，见 键位设置。NEI 相关键见 内置集成。