Addons教程 【MC官方文件汉化转载】生物群系文档 - minecraft:village_type（村庄类型组件）

上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转

---

文档原链接：点我跳转

生物群系文档 - minecraft:village_type（村庄类型组件）​

确定该生物群系的村庄类型。

生物群系村庄类型属性 (Biome Village Type Properties)​

名称	默认值	类型	描述	示例值
type	未设置	类型选项 (Type choices)	控制在此生物群系中生成的村庄风格。	"minecraft:desert"

​

类型选项 (Type Choices)​

值	标题	描述
default	默认	默认村庄类型（平原村庄）
desert	沙漠	沙漠村庄类型
ice	冰原	冰原村庄类型
savanna	热带草原	热带草原村庄类型
taiga	针叶林	针叶林村庄类型

JSON 示例：

"minecraft:village_type": {
    "type": "minecraft:desert"
}

完整生物群系示例（使用村庄类型）：

{
    "format_version": "1.20.0",
    "minecraft:biome": {
        "description": {
            "identifier": "myaddon:my_biome"
        },
        "components": {
            "minecraft:climate": {
                "temperature": 0.5,
                "downfall": 0.5,
                "precipitation": "rain"
            },
            "minecraft:village_type": {
                "type": "minecraft:plains"
            },
            "minecraft:tags": {
                "tags": [
                    "minecraft:plains",
                    "minecraft:has_village"
                ]
            }
        }
    }
}

村庄类型视觉效果对比：

村庄类型	主要建筑材料	特色方块	适用生物群系
default（默认）	橡木木板、圆石	草方块、橡树	平原、森林
desert（沙漠）	砂岩、切制砂岩	沙子、仙人掌	沙漠
ice（冰原）	云杉木板、圆石	雪块、冰	雪原、冰原
savanna（热带草原）	金合欢木板、金合欢原木	金合欢树、干草块	热带草原
taiga（针叶林）	云杉木板、云杉原木	云杉树、浆果丛	针叶林

注意事项：

1. 类型字段 — type 必须从预定义的类型选项中选择一个有效值。
2. 命名空间前缀 — 建议使用 minecraft: 前缀以确保兼容性（如 minecraft:desert）。
3. 村庄生成条件 — 仅有村庄类型不足以生成村庄，还需配合以下条件：
   
   • 生物群系需要标记为允许村庄生成（如 minecraft:has_village 标签）
   • 需要在结构生成规则中启用村庄
4. 与标签配合 — 通常需要配合 minecraft:tags 组件使用，确保生物群系被识别为可生成村庄的类型。
5. 建筑风格的改变 — 此组件仅改变村庄的建筑风格和材料，不影响村庄的生成频率或大小。
6. 自定义村庄 — 如需完全自定义村庄结构，需要使用拼图结构（Jigsaw Structures）系统。

村庄类型与生物群系推荐搭配：

生物群系类型	推荐村庄类型	说明
平原	default	标准平原村庄
沙漠	desert	沙漠风格村庄
雪原/冰原	ice	雪地风格村庄
热带草原	savanna	热带草原风格村庄
针叶林	taiga	针叶林风格村庄
森林	default	默认平原村庄
丛林	default 或 savanna	无原生村庄类型
恶地	desert	类似沙漠风格
沼泽	default	无原生村庄类型

村庄结构文件位置：

behavior_pack/
└── structures/
    ├── village/
    │   ├── village_desert/      # 沙漠村庄
    │   ├── village_plains/      # 平原村庄（default）
    │   ├── village_savanna/     # 热带草原村庄
    │   ├── village_snowy/       # 冰原村庄
    │   └── village_taiga/       # 针叶林村庄

完整村庄生成配置示例：

{
    "format_version": "1.20.0",
    "minecraft:biome": {
        "description": {
            "identifier": "myaddon:village_biome"
        },
        "components": {
            "minecraft:climate": {
                "temperature": 0.5,
                "downfall": 0.5,
                "precipitation": "rain"
            },
            "minecraft:surface_builder": {
                "builder": {
                    "type": "minecraft:overworld",
                    "top_material": "minecraft:grass",
                    "mid_material": "minecraft:dirt",
                    "foundation_material": "minecraft:stone"
                }
            },
            "minecraft:village_type": {
                "type": "minecraft:plains"
            },
            "minecraft:tags": {
                "tags": [
                    "minecraft:plains",
                    "minecraft:has_village"
                ]
            }
        }
    }
}

村庄类型相关标签：

标签	说明
minecraft:has_village	允许在此生物群系生成村庄
minecraft:village_plains	平原村庄
minecraft:village_desert	沙漠村庄
minecraft:village_savanna	热带草原村庄
minecraft:village_snowy	冰原村庄
minecraft:village_taiga	针叶林村庄

---

注意事项（续）：

1. 版本差异 — 不同 Minecraft 版本可能支持不同的村庄类型，请确保与目标版本兼容。
2. 结构池配合 — 村庄生成还需要正确的结构池（Structure Pool）配置，仅设置村庄类型可能不足以生成完整村庄。
3. 村民职业 — 不同村庄类型会影响村民的职业分布和交易内容。
4. 僵尸围城 — 村庄类型不影响僵尸围城事件，该事件由其他机制控制。

---

---

上一篇：
下一篇：
回到二级页：点我跳转
回到总目录：点我跳转