配置项总览

基本信息

Draconic Evolution 的配置由两个类承担：

类	职责	文件
`ConfigHandler`	玩法开关、生成权重、ID 分配	`common/handler/ConfigHandler.java`
`BalanceConfigHandler`	数值平衡（容量、耗能、配方点数）	`common/handler/BalanceConfigHandler.java`

本条目覆盖 ConfigHandler。平衡数值见能量与功能物品、护甲、工具与武器等页面。

配置统计

项目	数量	统计方式
`public static` 非 final 字段声明	52	`ConfigHandler.java:14-86` 正则提取 `public static (?!final) <type> <name>;`
从 `config.get()` 读取	50 个不同字段（51 次调用）	`ConfigHandler.java` `syncConfig()`
从 `config.getStringList()` 读取	4	`disabledBlocksItems`、`itemDislocatorBlacklist`、`itemDislocatorBlockBlacklist`、`spawnerList`
声明但从未赋值	2	`dislocator_Min_Range`、`dislocator_Max_Range`
整段注释掉的配置键	3	`disableSunDial`、`disableXrayBlock`、`potionFlightID`

两个独立统计口径（config.get 调用点计数 51 / 不同字段计数 50）相互吻合，差值 1 来自 reactorFuelStorage 被重复读取两次。

配置分类

分类	条目数
`general`	36
`Draconic Reactor`	9（8 个不同键）
`long range dislocator`	3
`Gui Stuff`	1
`spawner`	1
`magicId's`	1
列表类（`getStringList`）	4

general 分类（36 条）

配置键	字段	默认值
`Disable Earth block`	`disableEarthBlock`	`false`
`Teleporter Uses PerPearl`	`teleporterUsesPerPearl`	1
`Bow Block Damage`	`bowBlockDamage`	`true`
`Show Unlocalized Names`	`showUnlocalizedNames`	`false`
`soulDropChance`	`soulDropChance`	1000
`passiveSoulDropChance`	`passiveSoulDropChance`	800
`Ender Comet Rarity`	`cometRarity`	10000
`Generate Ender Comets`	`generateEnderComets`	`true`
`Generate Chaos Islands`	`generateChaosIslands`	`true`
`Pigmen Blood Rage`	`pigmenBloodRage`	`true`
`Disable Item Lore`	`disableLore`	`false`
`InvertDPDSB`	`invertDPDSB`	`false`
`Disable Ore Spawn (End)`	`disableOreSpawnEnd`	`false`
`Disable Ore Spawn (Nether)`	`disableOreSpawnNether`	`false`
`Disable Ore Spawn (Overworld)`	`disableOreSpawnOverworld`	`false`
`Overworld Draconium Ore Weight`	`oreWeightOverworld`	2
`Nether Draconium Ore Weight`	`oreWeightNether`	5
`End Draconium Ore Weight`	`oreWeightEnd`	10
`Default Draconium Ore Weight`	`oreWeightDefault`	2
`Can dragon break blocks`	`dragonBreaksBlocks`	`true`
`Dragon egg spawn location`	`dragonEggSpawnLocation`	`int[]`
`Ore gen dimension blacklist`	`oreGenDimentionBlacklist`	空 `int[]`
`Ore gen dimension whitelist`	`oreGenDimensionWhitelist`	空 `int[]`
`Player speed cap`	`maxPlayerSpeed`	10.0
`Speed limit Dim black lack list`	`speedDimBlackList`	`int[] { 1 }`（仅下界）
`Speed limit effects ops`	`speedLimitops`	`false`
`Rapidly despawn aoe mined items`	`rapidlyDespawnMinedItems`	`false`
`Use old armor model`	`useOldArmorModel`	`false`
`Fast Summon Ritual`	`sumonRitualAccelerated`	`false`
`Use old 2D tool textures`	`useOldD2DToolTextures`	`false`
`Chaos Island Separation`	`chaosIslandSeparation`	10000
`Use the original 3D armor models`	`useOriginal3DArmorModel`	`false`
`Disable Guardian Crystal Respawn`	`disableGuardianCrystalRespawn`	`false`
`Item Dislocator Disable Sound`	`itemDislocatorDisableSound`	`false`
`Disable Log`	`disableLog`	`false`
`Enable Flight`	`enableFlight`	`true`

oreGenDimentionBlacklist 的拼写错误（Dimention）来自源码本身，配置键名保持原样。

Draconic Reactor 分类（8 个不同键）

配置键	字段	默认值	范围
`EnableBigExplosion`	`enableReactorBigBoom`	`true`	—
`maxFuelStorage`	`reactorFuelStorage`	10368	0 – 10,000,000
`EnergyOutputMultiplier`	`reactorOutputMultiplier`	1.0	0 – 1,000,000
`FuelUsageMultiplier`	`reactorFuelUsageMultiplier`	1.0	0 – 1,000,000
`linearReactorFuelUsage`	`linearReactorFuelUsage`	`true`	—
`awakenedDraconiumFuelValue`	`reactorFuelValue`	16	—
`chaosShardOutputValue`	`reactorChaosValue`	16	—
`enableAutomation`	`enableAutomation`	`false`	—

其他分类

分类	配置键	字段	默认值
`long range dislocator`	`Dislocator Min Range`	`admin_dislocator_Min_Range`	1000
`long range dislocator`	`Dislocator Max Range`	`admin_dislocator_Max_Range`	10000
`long range dislocator`	`Admin Dislocator Detect Range`	`admin_dislocator_Detect_Range`	5
`Gui Stuff`	`HUD Settings`	`hudSettings`	`int[]`
`spawner`	`listType`	`spawnerListType`	`false`
`magicId's`	`Reaper Enchant id`	`reaperEnchantID`	180

列表类配置

字段	用途	消费方
`disabledBlocksItems`（`ConfigHandler.java:245`）	要禁用的方块 / 物品未本地化名列表	写入 `disabledNamesList`（`ConfigHandler.java:423-425`），被 `ModBlocks.isEnabled` / `ModItems.isEnabled` 检查
`itemDislocatorBlacklist`（`ConfigHandler.java:308`）	物品错位器禁用列表	写入 `itemDislocatorBlacklistMap`
`itemDislocatorBlockBlacklist`（`ConfigHandler.java:313`）	物品错位器方块禁用列表	写入 `itemDislocatorBlockBlacklistMap`
`spawnerList`（`ConfigHandler.java:342`）	稳定刷怪笼可刷怪物列表	`TileCustomSpawner`；默认三个示例名（`ConfigHandler.java:79-80`）

disabledNamesList 是全局开关（全仓 10 处引用）：ModBlocks.isEnabled(Block)（ModBlocks.java:158-160）与 ModItems.isEnabled(Item)（ModItems.java:211-213）都会检查它，被禁用的内容不会注册。它还额外过滤合成配方（CraftingHandler.java:1016-1023 等每个 add* 辅助方法都做一次检查）。

已知缺陷

1. 两个声明但从未赋值的配置字段

dislocator_Min_Range 与 dislocator_Max_Range 在 ConfigHandler.java:68-69 声明，被 LongRangeDislocator.java:126-129 读取，但唯一赋值在 ConfigHandler.java:499-500 被注释掉。详见单方块机器的「已知缺陷」章节。

2. 三个整段注释掉的配置键

ConfigHandler.java 末尾的注释块中还有三个从未启用的键：

键	位置
`disableSunDial`	`ConfigHandler.java:104-105`、`ConfigHandler.java:483-484`
`disableXrayBlock`	`ConfigHandler.java:106-107`、`ConfigHandler.java:484-485`
`potionFlightID`	`ConfigHandler.java:356`

3. `reactorFuelStorage` 重复读取

maxFuelStorage 在 ConfigHandler.java:369-375 与 ConfigHandler.java:388-392 被读取两次，参数完全一致。当前无行为差异，但属于冗余。

交互

触发	行为
启动游戏	`ConfigHandler.init(File)` 首次创建并加载配置文件（`ConfigHandler.java:84-90`）
关闭 `Disable Earth block`	`earthBlock` 字段保持 `null`，方块与 TileEntity 均不注册（`ModBlocks.java:113`、`CommonProxy.java:228`）
在 `disabledNamesList` 中加入某物品名	该物品不注册，相关合成配方同时被跳过
调整 `Player speed cap`	影响全局玩家移动速度上限，`speedDimBlackList` 中的维度不受影响
关闭 `EnableBigExplosion`	反应堆爆炸规模降至约一次 TNT