常规设置

基本信息

属性	值
配置文件	Forge 标准位置，由 `event.getSuggestedConfigurationFile()` 决定（`RTConfiguration.java:58`）
配置类	`lumien.randomthings.Configuration.RTConfiguration`
缓存类	`lumien.randomthings.Configuration.Settings`
分类	`Settings`、`VanillaChanges`、`DungeonLoot`、`PotionIds`、`Blocks`、`Items`
数量	本页覆盖 `Settings` 分类

功能

RTConfiguration 是全模组配置中枢：它既直接读取 Property，也负责把结果同步到各静态缓存类（ConfigBlocks、ConfigItems、Settings、VanillaChanges、ConfigDungeonLoot、MagneticForceHandler）。

同步入口为 syncConfig()（RTConfiguration.java:196-293），在三个时机调用：

preInit 中 RTConfiguration.init(event) 之后（RandomThings.java:91-92）
维度 ID 自动解析后（RandomThings.java:126）
药水 ID 变更后（ModPotions.java:61、:73）
客户端配置变更事件（RTConfiguration.java:192-194）

Settings 分类

成长与灵魂

配置项	默认	类型	说明	行
`FertilizedDirtGrowthIndicator`	`false`	boolean	沃土提升作物时是否产生骨粉粒子	`:61-65`
`SpiritChance`	`0.02`	double	不使用灵魂之剑时的灵魂生成概率（0–1）	`:66-70`
`SpiritChanceSword`	`0.1`	double	手持灵魂之剑时的灵魂生成概率（0–1）	`:71-75`
`FertilizedDirtGrowthModifier`	`3`	int	沃土推动上方作物的间隔	`:98-102`

维度与传送

配置项	默认	类型	说明	行
`SpectreDimensionID`	`-1`	int	灵魂世界维度 ID；-1 = 自动分配。需重启	`:84-89`
`SpectreDimensionFog`	`true`	boolean	灵魂世界是否显示雾效	`:90`
`MagneticForceTeleportLength`	`200`	int	磁力仪传送过程时长（tick，20 = 1 秒）	`:289-290`
`WirelessLeverRange`	`10`	double	无线拉杆联动半径（方块）	`:76-77`

[!NOTE] WirelessLeverRange 本身会被正常读取（写入 Settings.WIRELESSLEVER_RANGE），但对应的方块无法启用 —— 见无线拉杆页面的缺陷说明。

激素与充能

配置项	默认	类型	说明	行
`ImbueDuration`	`6000`	int	激素效果持续时间（tick），源码写为 `20 * 60 * 5`	`:103`
`SpectreImbueChance`	`0.1`	double	灵魂感染闪避概率，限定 0–1（`setMinValue(0).setMaxValue(1)`）	`:91-97`
`BiomeChargeTime`	`20`	int	生物群系胶囊收集 1 点充能所需 tick	`:104-108`
`LeaveDecaySpeed`	`7`	int	树叶衰减所需 tick（越小越快）	`:109-113`
`LeaveDecayFuzz`	`5`	int	每片树叶衰减时叠加的随机值上限；0 = 线性衰减	`:114-118`

[!NOTE] BiomeChargeTime 配置项已被读取（写入 Settings.BIOME_CHARGE_TIME），但 ItemBiomeCapsule.onUpdate 的充能判定硬编码为 % 20，与默认值巧合相同；改配置不会改变实际充能速度。见生物群系胶囊。

VanillaChanges 分类

配置项	默认	需重启	说明	行
`fixedBackground`	`""`	是	主菜单背景替换为指定 Resource Location	`:78-83`
`ModifiedBackgrounds`	`true`	是	泥土背景每次启动随机更换方块	`:237-243`
`LockedGamma`	`false`	是	把 Gamma 锁定为 0	`:244-245`
`FasterLeaveDecay`	`true`	否	树叶脱离原木后加速衰减	`:246-250`
`ThrowableMotion`	`false`	否	投掷物/箭继承玩家运动向量	`:251-256`

FasterLeaveDecay 与 LockedGamma 是直接驱动 Mixin 加载的开关（Mixins.java:35、:44），关闭时对应 Mixin 完全不应用。

DungeonLoot 分类

配置项	默认	说明	行
`WhiteStone`	`3`	地下城箱子中白石的权重	`:234`

硬编码常量（非配置）

以下 Settings 字段是硬编码 final 常量，配置文件中无对应键：

常量	值	行
`ENERGY_DISTRIBUTOR_PERTICK`	400	`Settings.java:50`
`ENERGY_DISTRIBUTOR_PERMACHINE`	60	`Settings.java:51`
`ENERGY_DISTRIBUTOR_MAXMACHINES`	15	`Settings.java:52`
`ENERGY_DISTRIBUTOR_BUFFERSIZE`	1 000 000	`Settings.java:53`
`ENDER_ENERGY_DISTRIBUTOR_PERTICK`	800	`Settings.java:55`
`ENDER_ENERGY_DISTRIBUTOR_PERMACHINE`	100	`Settings.java:56`
`ENDER_ENERGY_DISTRIBUTOR_BUFFERSIZE`	1 500 000	`Settings.java:57`
`ENDER_ENERGY_DISTRIBUTOR_RANGE`	6	`Settings.java:58`
`ENDER_ENERGY_DISTRIBUTOR_MAXMACHINES`	30	`Settings.java:59`
`ENDER_ENERGY_DISTRIBUTOR_RANGE_SQRD`	36	`Settings.java:60`

数值

数值名	值
配置分类数	6
Settings 分类项	13
VanillaChanges 分类项	5
DungeonLoot 分类项	1
PotionIds 分类项	6
硬编码能量常量	10