KAMI 与暗影束配置

基本信息

属性 值
处理类 thaumic.tinkerer.common.core.handler.ConfigHandler
覆盖分类 general.kami（8 项）、balance.shadowbeam（4 项）、enchantments（14 项）
KAMI 段总开关 enableKami（ConfigHandler.java:87，默认 true）
死配置项 0

general.kami 与 balance.shadowbeam 两组共 12 项，加上 enchantments 分类的 14 个附魔 ID，合计 26 个配置项在本页。

数值：general.kami 分类（8 项）

这 8 项全部位于 if (enableKami) { … } 代码块内（ConfigHandler.java:188-243），即 enableKami 为 false 时它们根本不会被读取，配置文件中也不会被写入。

字段 配置键 类型 默认值 范围 源码行
bedrockDimensionID Bedrock dimension id 整数 -19 -1023–1023 ConfigHandler.java:190-196
OreClusterGenerator.blacklist Bedrock dimension ore Blacklist 字符串列表 { "oreFirestone" } — ConfigHandler.java:198-202
OreClusterGenerator.density Bedrock Dimension ore density 整数 1 0–1023 ConfigHandler.java:204-210
showPlacementMirrorBlocks placementMirror.blocks.show 布尔 true — ConfigHandler.java:212-216
netherDimensionID dimension.nether.id 整数 -1 -1023–1023 ConfigHandler.java:218-224
endDimensionID dimension.end.id 整数 1 -1023–1023 ConfigHandler.java:226-232
shouldKamiLegsDoLightFeature Kami Leggings Light Placing Feature Enabled 布尔 字段当前值 — ConfigHandler.java:233-237
shouldKamiBootsDoGrass Kami Boots Dirt into Grass Feature Enabled 布尔 字段当前值 — ConfigHandler.java:238-242

两处需要注意的取值细节

  1. bedrockDimensionID 的类字段初值与配置默认值不同：字段声明为 public static int bedrockDimensionID = 19;（ConfigHandler.java:49），而 loadConfig() 读取的默认值是 -19（ConfigHandler.java:193）。配置文件首次生成后生效值为 -19。且 ThaumicTinkerer.java:76 以 bedrockDimensionID != 0 作为「是否注册基岩维度」的判据，配置注释亦写明「or 0 to disable」。

  2. shouldKamiLegsDoLightFeature / shouldKamiBootsDoGrass 的默认值是字段自身：两处都写作 config.getBoolean(键, "general.kami", 字段名, 注释)，即默认值取自该字段的类初值 —— 分别为 false（ConfigHandler.java:50）与 true（ConfigHandler.java:51）。这是把字段初值当默认值的写法。

density 的分类归属不一致

OreClusterGenerator.density 虽与 blacklist 同在 if (enableKami) 块内且语义同属基岩维度矿脉，但传入的 category 是 "general"（ConfigHandler.java:206）而非 "general.kami"（blacklist 用的是 "general.kami"，ConfigHandler.java:200）。因此该项会出现在配置文件的 general 段而不是 general.kami 段。

数值：balance.shadowbeam 分类（4 项）

这 4 项不在 if (enableKami) 块内，位于文件更早的位置（ConfigHandler.java:155-186），因此即使 enableKami = false 仍会读取并写入配置文件。

字段 配置键 默认值 范围 源码行 读取点
visShadowbeamAir aer vis cost 15 Integer.MIN_VALUE–MAX_VALUE ConfigHandler.java:156-162 ItemFocusShadowbeam.java:41
visShadowbeamOrder ordo vis cost 25 同上 ConfigHandler.java:164-170 ItemFocusShadowbeam.java:40
visShadowbeamEntropy perditio vis cost 25 同上 ConfigHandler.java:172-178 ItemFocusShadowbeam.java:41
baseDamageShadowbeam shadowbeam base damage 8 同上 ConfigHandler.java:180-186 ItemFocusShadowbeam.java:43

4 项的取值范围都是 Integer.MIN_VALUE 到 Integer.MAX_VALUE（即不设实际上限），配置注释说明 vis 消耗以「1/100th in-game」为单位。源码读取处的 DAMAGE 常量同样在类加载时从 ConfigHandler 取值：private static final int DAMAGE = ConfigHandler.baseDamageShadowbeam;（ItemFocusShadowbeam.java:43）。

数值：enchantments 分类（14 项）

14 个附魔 ID 通过私有辅助方法统一加载：

private static int loadEnchant(String label, int defaultID) {
    return config.get("enchantments", "id_enchant." + label, defaultID).getInt(defaultID);
}

（ConfigHandler.java:264-266）

配置键统一为 id_enchant.<label>，其中 <label> 取自 LibEnchantNames 的常量值（均为 ttinkerer. 前缀 + 驼峰名）。

字段 配置键后缀 默认 ID 源码行
LibEnchantIDs.idAscentBoost id_enchant.ttinkerer.ascentBoost 220 ConfigHandler.java:245
LibEnchantIDs.idSlowFall id_enchant.ttinkerer.slowFall 221 ConfigHandler.java:246
LibEnchantIDs.idAutoSmelt id_enchant.ttinkerer.autoSmelt 222 ConfigHandler.java:247
LibEnchantIDs.idDesintegrate id_enchant.ttinkerer.desintegrate 223 ConfigHandler.java:248
LibEnchantIDs.idQuickDraw id_enchant.ttinkerer.quickDraw 224 ConfigHandler.java:249
LibEnchantIDs.idVampirism id_enchant.ttinkerer.vampirism 225 ConfigHandler.java:250
LibEnchantIDs.focusedStrike id_enchant.ttinkerer.focusedStrike 169 ConfigHandler.java:252
LibEnchantIDs.dispersedStrikes id_enchant.ttinkerer.dispersedStrike 166 ConfigHandler.java:253
LibEnchantIDs.finalStrike id_enchant.ttinkerer.finalStrike 168 ConfigHandler.java:254
LibEnchantIDs.valiance id_enchant.ttinkerer.valiance 173 ConfigHandler.java:255
LibEnchantIDs.pounce id_enchant.ttinkerer.pounce 170 ConfigHandler.java:256
LibEnchantIDs.shockwave id_enchant.ttinkerer.shockwave 171 ConfigHandler.java:257
LibEnchantIDs.shatter id_enchant.ttinkerer.shatter 167 ConfigHandler.java:258
LibEnchantIDs.tunnel id_enchant.ttinkerer.tunnel 172 ConfigHandler.java:259

默认值全部来自 LibEnchantIDs 的类字段初值（LibEnchantIDs.java:11-24）：前 6 个为 220–225，后 8 个为 166–173。14 项与 enchantments 分类一一对应，无遗漏、无多余。

注：dispersedStrikes 的字段名是复数，但配置后缀取自 LibEnchantNames.dispersedStrikes 的值 "ttinkerer.dispersedStrike"（单数），见 LibEnchantNames.java。

相关条目