village generator

基本信息

属性	值
配置分类名	`village generator`（`Reference.CATEGORY_VILLAGE_GENERATOR`）
类	`astrotibs.villagenames.config.village.VillageGeneratorConfigHandler`
独立文件	是 —— 独立于 `GeneralConfig` 的单独配置文件
配置项总数	289（`grep -oE 'Reference\.CATEGORY_VILLAGE_GENERATOR'` 计数）
GUI 提示	`config.villagenames.villagegenerator.tooltip` = `Settings for the village generation system`（`en_US.lang:144`）

功能

本分类是本 mod 最大的单一配置文件（289 项），专门控制 Village Generator 替代性村庄生成系统。

依赖关系（最重要）

Activate New Village Generator 是总开关，源码说明明确指出："All other settings in this section require this to be true."（config/village/VillageGeneratorConfigHandler.java:593）

同时提示："You may need to deactivate village generation from other mods."——即启用本生成器时，可能需要手动关闭其他 mod 的村庄生成以免冲突。

核心参数

配置键	字段	类型	默认值	范围	行	说明（源码原文）
`Activate New Village Generator`	`newVillageGenerator`	boolean	true	—	`:593`	使用替代性村庄生成系统
`Village Size: Minimum`	`newVillageSizeMinimum`	float	1.0	1–5	`:596`	村庄随机尺寸下界。原版为 1
`Village Size: Maximum`	`newVillageSizeMaximum`	float	1.0	1–5	`:597`	村庄随机尺寸上界。原版为 1
`Village Size: Normal Order`	`newVillageSizeNormalOrder`	int	1	1–10	`:608`	尺寸由这么多个均匀分布的卷积得出
`Village Size: Mode`	`newVillageSizeMode`	float	1.0	1–10	`:611`	见文件内说明
`Village Spacing: Median`	`newVillageSpacingMedian`	int	20	1–100	`:623`	村庄间距中位数。原版为 20
`Village Spacing: Range`	`newVillageSpacingSpread`	int	12	1–100	`:624`	村庄间距浮动。必须小于 Median。原版为 12
`Village Spacing: Village-Free Radius`	`noVillagesRadius`	int	0	0–100000	`:625`	世界原点附近多少区块内不生成村庄

⚠️ 默认尺寸上下界均为 1.0，即默认与原版相同（原版村庄尺寸固定为 1）。要把本生成器的多村庄特性用出来，需手动调高 Village Size: Maximum。源码对 Minimum/Maximum 的说明均特意注明 "Vanilla is 1."

Village Spacing: Range 的约束是硬性的：源码说明 "Must be lower than Median value."（:624）。

村庄内容

配置键	字段	行
`Allow Taiga Troughs`	`allowTaigaTroughs`	`:532` 声明
`Allow Village Brewing Stands`	`allowVillageBrewingStands`	`:533` 声明
`Allow Village Beds`	`allowVillageBeds`	`:534` 声明
`Fill Troughs With Water`	`fillTroughsWithWater`	`:535` 声明
`Restrict Taiga Troughs`	`restrictTaigaTroughs`	`:536` 声明
`Pumpkin and Melon Crops`	`farmPumpkins`	`:626`，被整条注释掉（`//farmPumpkins = config.getBoolean(...)`）
`Replace Anvils`	`replaceAnvils`	`:557` 声明

上述 6 项默认值无法核实：config/village/VillageGeneratorConfigHandler.java:532-557 处只有字段声明，其 config.get(...) 赋值语句未在本页核实范围内逐条读取。

另有 12 个 decor* 装饰开关（:537-553）被整段注释，按"死代码 ≠ 注册内容"原则不收录。

旧版村庄建筑配置

本分类为原版 9 种村庄组件各提供一条字符串型配置（config/village/VillageGeneratorConfigHandler.java:32-40 声明，:633 起读取），用于按群系启用/停用原版建筑：

组件	配置键	声明行
`House4Garden`	`Small House`	`:633`
`Church`	`Church`	`:637`
`House1`	`Small House`	—
`WoodHut`	—	—
`Hall`	—	—
`Field1` / `Field2`	—	—
`House2` / `House3`	—	—

每个配置是"组件名 + 一串双精度数"，源码用 convertDoubleArrayToString(ald) 拼接，并以 generationStatsForL + "4.0" 等作为默认值（如 :633 的 "4.0"、:637 的 "20.0"）——即默认值是权重数值，可直接看出各组件的相对生成权重。

匹配逻辑见 Village Generator：值为 any 或 all 表示不限制；否则必须包含当前群系标识（且非空串）才启用。

与其他配置的交叉影响

其他配置	交互
`world of color` → `Concrete Well`	仅在本生成器关闭时生效（见 world of color settings）
`general` → `Well boundary` / `Well slabs` / `Well decorations`	控制本生成器产出的水井样式