config/GTNH-Web-Map.cfg

基本信息

属性 值
文件路径 <MC 根目录>/config/GTNH-Web-Map.cfg
创建代码 DynmapMod.preInit（forge/DynmapMod.java:94）
路径来源 new File(event.getModConfigurationDirectory(), "GTNH-Web-Map.cfg")（DynmapMod.java:94）
读写类 GwmConfig.init（GwmConfig.java:9）
格式 Forge Configuration（INI 风格）
键总数 4（GwmConfig.java:13-16）

功能

本 fork 相对上游 Dynmap 新增的配置面。上游 Dynmap 的绝大多数配置在 dynmap/configuration.txt（见 configuration.txt），而跨 mod 交互相关的开关集中在这个 Forge 标准配置里。

GwmConfig.init 的写入模式是"读-改-写"：cfg.load() → 逐项 cfg.get(...)（getBoolean 会把默认值写回）→ finally { cfg.save(); }（GwmConfig.java:18-21）。因此首次启动即生成完整文件，无需手工建档。

配置项

分区 键 默认值 作用
settings enableChunkLoadingMarkers true 为活跃区块加载器创建 area marker 标记集
settings useOldBiomeColoring false 强制使用旧版生物群系着色（仅在已有旧地图且不想重渲染时开启）
ServerUtilities enableClaimMarkers Loader.isModLoaded("serverutilities") 为所有已认领区块创建 area marker
ServerUtilities boostClaimMarkers true 给认领标记加 boost 标志，使其在开启 boosting 的地图上以更高分辨率渲染

源码原文：

  • GwmConfig.java:13 enableChunkLoadingMarkers，默认 true
  • GwmConfig.java:14 useOldBiomeColoring，默认 false
  • GwmConfig.java:15 enableClaimMarkers，默认 Loader.isModLoaded("serverutilities")
  • GwmConfig.java:16 boostClaimMarkers，默认 true

enableClaimMarkers 的默认值依赖运行时探测：装了 ServerUtilities 就默认开，没装就默认关。

[!NOTE] 配置键名与 Java 字段名不一致，读写时以键名为准： 键 ServerUtilities.enableClaimMarkers → 字段 GwmConfig.enableServerUtilitiesClaimsMarkers； 键 ServerUtilities.boostClaimMarkers → 字段 GwmConfig.boostServerUtilitiesClaimsMarkers（GwmConfig.java:25-26）。

数值

数值名 值
配置键总数 4
分区数 2（settings、ServerUtilities）
默认值为 true 的键 3（enableChunkLoadingMarkers、enableClaimMarkers（装 SU 时）、boostClaimMarkers）
默认值为 false 的键 1（useOldBiomeColoring）

交互

每个键都有真实的外部读取方（无死配置）：

键 读取位置
enableChunkLoadingMarkers DynmapMod.java:136（决定是否注册 ForgeChunkLoaderMarkers）、ForgeChunkLoaderMarkers.java:163、:168
enableServerUtilitiesClaimsMarkers DynmapMod.java:141
boostServerUtilitiesClaimsMarkers ServerUtilitiesClaimedChunksMarkers.java:100
useOldBiomeColoring hdmap/TexturePack.java:2638

相关条目