Config Handler
基本信息
| 属性 | 值 |
|---|---|
| 类 | com.chaosthedude.naturescompass.config.ConfigHandler |
| 配置文件 | <minecraft>/config/naturescompass.cfg |
| 加载时机 | preInit 阶段（NaturesCompass.preInit 第一行） |
行为
读取/写入所有 NaturesCompass 的 Forge 配置项；配置变化通过 ConfigChangedEvent.OnConfigChangedEvent 重新初始化（ChangeListener）。所有字段静态持有，可被 worker / 渲染逻辑直接访问。
General 分类（搜索参数）
| 配置键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
naturescompass.distanceModifier |
int | 10000 | 最大搜索距离；值越大搜索越精确但更耗资源 |
naturescompass.sampleSpaceModifier |
int | 32 | 螺旋采样步长；值越小越精确但更耗资源 |
naturescompass.maxSamples |
int | 150000 | 单次搜索最大采样数；超限按 NOT_FOUND 结束 |
naturescompass.biomeBlacklist |
String[] | [] |
不可搜索的群系；可填群系名（如 Ocean）或 ID（如 0） |
Client 分类（GUI / HUD）
| 配置键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
naturescompass.displayWithChatOpen |
boolean | true |
打开聊天框时是否仍渲染 HUD 文字 |
naturescompass.fixBiomeNames |
boolean | true |
自动给群系名插入空格（ForestHills → Forest Hills） |
naturescompass.lineOffset |
int | 1 | HUD 文字行距偏移 |
naturescompass.overlaySide |
String | BOTTOMRIGHT |
HUD 文字落点（TOPLEFT/TOPRIGHT/BOTTOMLEFT/BOTTOMRIGHT） |
数值
| 数值 | 默认值 |
|---|---|
| 最大搜索距离 | 10000 |
| 采样步长 | 32 |
| 最大采样数 | 150000 |
| 黑名单 | [] |
| 聊天时显示 HUD | true |
| 修复群系名 | true |
| 行距偏移 | 1 |
| HUD 落点 | BOTTOMRIGHT |
派生行为
loadInt()会拒绝任何负数，自动恢复为默认值。biomeBlacklist由getBiomeBlacklist()返回新 List 以避免外部修改污染缓存。- HUD 渲染通过
RenderTickHandler+RenderUtils间接读取lineOffset、overlaySide、displayWithChatOpen。
相关条目
- EnumOverlaySide - HUD 落点枚举
- BiomeSearchWorker - 读取 distanceModifier/sampleSpace/maxSamples
- RenderTickHandler - 读取 displayWithChatOpen