ThE 配置项

基本信息

属性 值
实现类 thaumicenergistics.common.ConfigurationHandler（包私有，单例 INSTANCE）
实现接口 thaumicenergistics.api.IThEConfig
静态入口 ConfigurationHandler.loadAndSyncConfigFile(event.getSuggestedConfigurationFile())（ThaumicEnergistics.java:189）
调用时机 preInit 阶段（ThaumicEnergistics.java:181-189）
配置文件 由 event.getSuggestedConfigurationFile() 决定（Forge 惯例：config/thaumicenergistics.cfg）
分类 3 个：general（默认）、crafting、client
配置项总数 16

功能

ThE 的配置以「关掉某个内容的合成」为主要设计思路：大多数开关控制某台机器/总线能否被合成（供整合包作者裁剪内容），另有 1 个换算比率与 1 个纯客户端渲染开关。

分类 general（Forge 默认分类）

配置名 类型 默认值 范围 说明（源码原文）
Essentia Fluid Ratio Exponent int 7 1–11 Controls the conversion ratio of essentia/fluid. 1 essentia is converted to (2^this) milibuckets of fluid.

换算公式（ConfigurationHandler.java:45、:89）：

this.conversionMultiplier = (int) Math.pow(2, Math.min(fluidPow, 11));

即 1 要素 = 2^exponent mB 流体。默认 2^7 = 128 mB。

源码的警告文本明确指出该值的影响与上限风险：

Please be aware that this value effects how much fluid is transferred through the AE system, which also effects transfer speed and power consumption. Values above 11 make it impossible to use fluid transfer devices such as the ME IO Port, or anything from EC2. （ConfigurationHandler.java:86-88）

注意 Math.min(fluidPow, 11) 二次钳制 —— 即使配置文件被手改为大于 11 的值，实际计算仍会被压到 11。

分类 crafting（14 项）

CATEGORY_CRAFTING = "crafting"（ConfigurationHandler.java:22）。全部为 boolean，默认 true，各自控制一个内容的可合成性：

配置名 默认值 源码说明 控制的 feature
Arcane Assembler true Controls if the Arcane Assembler can be crafted. FeatureAutocrafting_Arcane
Arcane Crafting Terminal true Controls if the Arcane Crafting Terminal can be crafted. FeatureACT
Distillation Pattern Encoder. true Controls if the Distillation Pattern Encoder can be crafted. FeatureAutocrafting_Essentia
Essentia Cells true Controls if Essentia Cells and Components can be crafted. FeatureCells
Essentia Provider true Controls if the Essentia Provider can be crafted. FeatureEssentiaProvider
Essentia Vibration Chamber true Controlls if the Essentia Vibration Chamber can be crafted. FeatureEssentiaVibrationChamber
Golem Wifi Backpack true Controls if the Golem Wifi Backpack can be crafted. FeatureGolemBackpack
Infusion Provider true Controls if the Infusion Provider can be crafted. FeatureInfusionProvider
IO Buses true Controls if the import and export buses can be crafted. FeatureEssentiaIOBuses
Vis Relay Interface true Controls if the Vis Relay Interface can be crafted. FeatureVisRelayInterface（及其子类 CVRI）
Allow Crafting Wireless Essentia Terminal true Controls if the Wireless Essentia Terminal can be crafted. 对应 IThEConfig.craftWirelessEssentiaTerminal()
Certus Quartz Duplication true Controls if Certus Quartz can be duplicated in the crucible. FeatureQuartzDupe
Wrench Focus true Controls if the Wrench Focus is enabled and craftable. FeatureWrenchFocus
Force TC Facades true When enabled, overwrites the AE2 facade settings for some Thaumcraft blocks, allowing their facades to be crafted. FeatureThaumcraftFacades

源码中的拼写原样保留：Distillation Pattern Encoder.（带尾点，:105）与 Controlls（双 l，:126）—— 这两个字符串是配置文件里的实际键名，不可「纠正」，否则读取失败。

分类 client（1 项）

配置名 类型 默认值 源码说明
Disable Gearbox Model boolean false The iron and thaumium gearboxes will be rendered as a standard block.

CATEGORY_CLIENT = "client"（ConfigurationHandler.java:22）。该项使 Iron Gear Box 与 Thaumium Gear Box 渲染为普通方块，用于解决某些光影/材质包下的模型兼容问题。

与 AE2 自身特性的联动

部分 feature 除了读 ThE 配置，还检查 AE2 自身的特性开关（checkConfigs），两者必须同时满足：

Feature AE2 特性要求 ThE 配置要求
FeatureCells AEFeature.StorageCells craft_Essentia_Cells
FeatureWrenchFocus AEFeature.CertusQuartzTools 且 AEFeature.QuartzWrench enable_Wrench_Focus
FeatureVisRelayInterface AEFeature.P2PTunnel craft_Vis_Relay_Interface

FeatureCreativeVisRelayInterface 继承 FeatureVisRelayInterface 且不覆写 checkConfigs，因此与 VRI 共用同一套门控。

checkConfigs 直接 return true（不受任何配置控制）的 7 个 feature：

  • FeatureThaumicEnergisticsResearch（研究标签页总入口）
  • FeatureConversionCores（两种核心）
  • FeatureGearbox（齿轮箱与铁齿轮）
  • FeatureEssentiaIOBuses（三种要素总线 —— 见下方说明，其 craft_IO_Buses 开关只影响 Import/Export）
  • FeatureAdvancedInfusionProvider
  • FeatureCellMicroscope

FeatureCreativeVisRelayInterface 未覆写 checkConfigs，继承父类 FeatureVisRelayInterface 的实现，因此与 VRI 共用门控。

全部 20 个 feature 的 checkConfigs 实测结果（逐个读取 common/features/Feature*.java）：

Feature checkConfigs 返回
FeatureACT AE2 特性检查后 theConfig.craftArcaneCraftingTerminal()
FeatureAdvancedInfusionProvider true
FeatureAutocrafting_Arcane 两次 return false 后继续
FeatureAutocrafting_Essentia false → theConfig.craftDistillationPatternEncoder()
FeatureCellMicroscope true
FeatureCells false → theConfig.craftEssentiaCells()
FeatureConversionCores true
FeatureCreativeVisRelayInterface 未覆写（继承 VRI）
FeatureEssentiaIOBuses true，但把 craftIOBuses() 与 AE2 的 ImportBus/ExportBus 特性存入实例字段 isImportExportEnabled（FeatureEssentiaIOBuses.java:39-46）
FeatureEssentiaProvider theConfig.craftEssentiaProvider()
FeatureEssentiaVibrationChamber false → theConfig.craftEssentiaVibrationChamber()
FeatureGearbox true
FeatureGolemBackpack theConfig.craftGolemWifiBackpack()
FeatureInfusionProvider theConfig.craftInfusionProvider()
FeatureQuartzDupe theConfig.enableCertusQuartzDupe()
FeatureThaumcraftFacades theConfig.forceTCFacades()
FeatureThaumicEnergisticsResearch true
FeatureVisRelayInterface false → theConfig.craftVisRelayInterface()
FeatureWrenchFocus false → false → 配置项

⚠️ FeatureEssentiaIOBuses 的门控是「部分生效」：checkConfigs 恒返回 true（保证 Storage Bus 配方始终注册），而 craft_IO_Buses 开关的结果被存入实例字段 isImportExportEnabled（FeatureEssentiaIOBuses.java:41），只用于跳过 Import/Export Bus 的注册（:80、:129、:135 三处 if (this.isImportExportEnabled)）。因此关闭 IO Buses 后要素储存总线仍可合成，只是不再能合成导入/导出总线。

另：craft_Wireless_Essentia_Term（craftWirelessEssentiaTerminal()，ConfigurationHandler.java:245-248）虽定义了 getter，但没有任何 feature 读取它 —— 对应的部件已被标记弃用（见 已弃用的要素部件），属于遗留配置项。

数值

数值名 值 来源
配置项总数 16 1（general）+ 14（crafting）+ 1（client）
要素/流体换算指数默认值 7 DFT_CONVERSION_EXPONENT = 7（:27）
换算指数范围 1–11 getInt(..., 1, 11, ...)（:84-85）
默认换算比 2^7 = 128 mB / 要素 :45
硬上限 11（Math.min 二次钳制） :89
crafting 开关数 14 :92-174
client 开关数 1 :177-181
默认关闭的开关 0 个（DFT_DISABLE_GEARBOX = false 是唯一的 false 默认值） :33

交互

触发 行为
首次进入世界 生成配置文件并写入全部默认值
修改配置文件后重启 synchronizeConfigFile() 重新读取；有变更时 configSettings.save()（:184-187）
关闭某合成开关 对应 feature 的 checkConfigs 返回 false → 配方与研究均不注册
修改换算指数 影响要素↔流体换算，进而影响 AE 系统的流体传输速度与耗电
Disable Gearbox Model 客户端渲染变化，服务端无影响

已知缺口：主类末尾留有 // TODO: General: Sync server configs（ThaumicEnergistics.java:210）—— 服务器向客户端的配置同步尚未实现。

合成配方

本条目是配置文件说明，不含物品配方。各开关对应的配方见相关条目。

相关条目