GTNH Credits 配置（gtnh-credits.cfg）

基本信息

属性 值
配置文件路径 config/gtnh-credits/gtnh-credits.cfg（Config.java:34-35，目录名 gtnh-credits 带连字符，与 modid gtnhcredits 不同）
配置类 net.noiraude.gtnhcredits.Config（final，构造私有，单例）
初始化时机 ClientProxy.preInit → Config.synchronizeConfiguration(event.getModConfigurationDirectory())（ClientProxy.java:19）
初始化次数限制 第二次调用抛 IllegalStateException("Config already initialized")（Config.java:76）
分区数 2（menu_button、credits_screen，Config.java:11-12）
配置项总数 6
副作用 客户端专用（ClientProxy 带 @SideOnly(Side.CLIENT)），服务端不读此文件

文件不存在时由 Forge 的 Configuration 自动生成并写入默认值（Config.java:72 的 if (cfg.hasChanged()) cfg.save()）。

数值

menu_button 分区 —— 控制原版主菜单上那个模组自带的 Credits 按钮：

键 类型 默认值 取值范围 说明
enabled boolean false — 是否在原版 GuiMainMenu 上插入 Credits 按钮
buttonX int -18 -10000–10000 >= 0 为距左边缘的绝对坐标；< 0 为距右边缘的边距（buttonX = 屏幕宽 - 按钮宽 + buttonX）
buttonY int -18 -10000–10000 >= 0 为距顶部的绝对坐标；< 0 为距底部的边距
icon string ""（空） — 按钮图标贴图的 domain:path 资源位置；留空则不画图标

坐标换算实现见 CreditsButton.java:57-60。越界坐标不会被裁剪到屏幕内，源码没有做边界钳制。

credits_screen 分区 —— 控制 Credits 界面本身：

键 类型 默认值 取值范围 说明
logo string gtnhcredits:textures/gui/credits/logo.png — 界面左上角 logo 贴图的 domain:path 资源位置
fuzzyThreshold float 30.0 0.0–1000.0 模糊匹配模式下人名进入结果的最低评分，越低越严格

fuzzyThreshold 的字段类型是 double（Config.java:28），但 Forge 的 getFloat 读回的是 float，默认实参写作 30.0f（Config.java:68）。

相关条目