Supernova Config

基本信息

com.mitchej123.supernova.config.SupernovaConfig —— 用 GTNHLib 的 @Config 注解声明式配置。

@Config(modid = "supernova", filename = "supernova")
public final class SupernovaConfig { ... }

配置文件：config/supernova.cfg（文件名由 filename 指定）。

取值	含义（源码注释）
`RGB`	彩色光照（3 通道）
`SCALAR`	快速、等价 Starlight（无颜色）

字段	类型	`@Config.Default*`	`@Config` 属性	需重启
`lightingMode`	`LightingMode`	`DefaultEnum("RGB")`	`Comment`	`RequiresMcRestart`
`scaleEmissionToVanillaLight`	`boolean`	`DefaultBoolean(true)`	`Comment`	`RequiresMcRestart`
`enableStatsLog`	`boolean`	`DefaultBoolean(false)`	`Comment`	无

三个字段都是 public static 且没有 Java 字段初值 —— 实际值由配置系统注入。写条目时不能说「默认 X」，必须引用 @Config.Default* 注解里的值。

lightingMode：Lighting mode. RGB = colored light (3-channel). SCALAR = fast Starlight-equivalent (no color).
scaleEmissionToVanillaLight：Scale registered block colors so their max channel matches the block's vanilla lightValue.
enableStatsLog：Write light engine instrumentation to logs/supernova-stats.log. Diagnostic only; **the file grows without bound while enabled**.

public static boolean isScalarMode() { return lightingMode == LightingMode.SCALAR; }

被 Mixins 的 VANILLA_RENDERING 与 ENTITY_RENDERING 两组用作 setApplyIf 条件 —— SCALAR 模式不注入彩色渲染补丁。

注释自己声明 the file grows without bound while enabled，无轮转/截断逻辑；默认 false 缓解该问题。