DreamCoreMod.properties 配置

基本信息

属性 值
文件路径 config/DreamCoreMod.properties
读取类 com.dreammaster.coremod.DreamCoreMod.injectData（DreamCoreMod.java:56-101）
存储类型 java.util.Properties（DreamCoreMod.java:30）
静态字段 DreamCoreMod.coremodConfig、DreamCoreMod.coremodConfigFile（DreamCoreMod.java:30-31）
写入注释头 Config file for the ASM part of GTNHCoreMod（DreamCoreMod.java:90）
配置项总数 5

⚠️ 与 dreamcraft.cfg 是两套独立配置

本文件不使用 GTNHLib ConfigurationManager，也不经过 CoreModConfig 的任何注解。它由 coremod 在 FML 早期用裸 Properties + FileReader / FileWriter 自行管理（DreamCoreMod.java:78-93），落盘路径是 <mcLocation>/config/DreamCoreMod.properties（DreamCoreMod.java:68-73）。

与 CoreModConfig（config/GTNewHorizons/dreamcraft.cfg，14 项，注解驱动）互不干扰。

功能

injectData 的读写顺序（DreamCoreMod.java:65-90）：

  1. 先写默认值再读文件（:65-67）—— 保证用户文件缺项时仍有值
  2. FileReader 载入（:78-79）；FileNotFoundException 静默忽略（首次运行的正常路径，:80-81）
  3. IOException 降级为 warn 并沿用默认值继续（:82-84）
  4. 回写 savedVersion 并 store 落盘（:88-90）

数值

属性名 默认值 生效方式 读取处
showConfirmExitWindow true "true".equalsIgnoreCase(...) DreamCoreMod.java:94
downloadOnlyOnce true "true".equalsIgnoreCase(...) DreamCoreMod.java:95
downloadUA Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:147.0) Gecko/20100101 Firefox/147.0 getProperty(key, default) DreamCoreMod.java:96-98
displayedModpackVersion Refstrings.MODPACKPACK_VERSION = 2.9.x getProperty(key, default) DreamCoreMod.java:99
savedVersion 无默认，缺失时 get() 返回 null 比较 Refstrings.VERSION DreamCoreMod.java:85

前 3 项的默认值由 coremodConfig.setProperty 显式写入（DreamCoreMod.java:65-67）；后 2 项走 getProperty(key, default) 的双参重载（DreamCoreMod.java:99）。

savedVersion 是自动维护字段：启动时与 Refstrings.VERSION（构建期生成的 BuildVersion.VERSION）比较，不等则置 modpackHasUpdated = true（:85-87）并回写新值（:88）。用户不应手动编辑。

交互

触发 行为
退出确认窗口点「返回游戏」 disableShowConfirmExitWindow() 把 showConfirmExitWindow 持久化为 false（DreamCoreMod.java:131-139）
整合包升级后首次启动 savedVersion 不匹配 → 触发 BetterQuesting 任务库自动重载
手工编辑 downloadUA 改写整合包发起下载时使用的 User-Agent
手工编辑 displayedModpackVersion 改写登录横幅与启动日志中显示的版本号（MainRegistry.java:252）

运行特性

数值名 值
属性数 5
需重启生效 是（coremod 仅在 FML 早期 injectData 执行一次）
失败降级策略 全部 warn + 沿用默认值，不中断启动

相关条目