简幻欢第三方镜像文档

data/
  <modid>/
    neoforge/
      biome_modifier/
        add_ore_to_overworld.json
        remove_vanilla_ore_from_plains.json
        add_custom_spawns.json
        remove_zombie_from_swamp.json
        add_carver_example.json
        remove_carver_example.json

注意：biome_modifier 在 neoforge/ 下，不在 worldgen/ 下。

10.2 示例 1：给所有主世界 biome 加矿

data/<modid>/neoforge/biome_modifier/add_mythril_ore_to_overworld.json

{
  "type": "neoforge:add_features",
  "biomes": "#minecraft:is_overworld",
  "features": "<modid>:ore_mythril_placed",
  "step": "underground_ores"
}

10.3 示例 2：只从指定 biome 删除某个矿

data/<modid>/neoforge/biome_modifier/remove_diamond_from_plains_forest.json

{
  "type": "neoforge:remove_features",
  "biomes": ["minecraft:plains", "minecraft:forest"],
  "features": "minecraft:ore_diamond",
  "steps": "underground_ores"
}

10.4 示例 3：新增刷怪

data/<modid>/neoforge/biome_modifier/add_spawn_zombie_overworld.json

{
  "type": "neoforge:add_spawns",
  "biomes": "#minecraft:is_overworld",
  "spawners": {
    "type": "minecraft:zombie",
    "weight": 25,
    "minCount": 1,
    "maxCount": 4
  }
}

10.5 示例 4：删除某些实体刷怪

data/<modid>/neoforge/biome_modifier/remove_creeper_from_desert.json

{
  "type": "neoforge:remove_spawns",
  "biomes": "minecraft:desert",
  "entity_types": "minecraft:creeper"
}

10.6 示例 5：批量设置 spawn cost

data/<modid>/neoforge/biome_modifier/add_spawn_cost_for_undead.json

{
  "type": "neoforge:add_spawn_costs",
  "biomes": "#minecraft:is_overworld",
  "entity_types": ["minecraft:zombie", "minecraft:skeleton"],
  "spawn_cost": {
    "energy_budget": 1.0,
    "charge": 0.2
  }
}

10.7 示例 6：添加 carver

data/<modid>/neoforge/biome_modifier/add_liquid_carver_to_deep_ocean.json

{
  "type": "neoforge:add_carvers",
  "biomes": "minecraft:deep_ocean",
  "carvers": "minecraft:canyon",
  "step": "air"
}

10.8 验证步骤（L1）

先只放 1 个 modifier 文件
启动后确认无 codec 报错
逐个增加 modifier，防止多文件交叉干扰
出现异常时按加载顺序回滚

11. 实战 L2：自定义地物（矿脉/树/植被）并注入指定 biome

11.1 链路总览

定义 configured_feature
定义 placed_feature
用 biome_modifier:add_features 注入

11.2 示例 A：自定义矿脉

文件 1：configured_feature

data/<modid>/worldgen/configured_feature/ore_mythril.json

{
  "type": "minecraft:ore",
  "config": {
    "size": 9,
    "discard_chance_on_air_exposure": 0.0,
    "targets": [
      {
        "target": {
          "predicate_type": "minecraft:tag_match",
          "tag": "minecraft:stone_ore_replaceables"
        },
        "state": { "Name": "<modid>:mythril_ore" }
      },
      {
        "target": {
          "predicate_type": "minecraft:tag_match",
          "tag": "minecraft:deepslate_ore_replaceables"
        },
        "state": { "Name": "<modid>:deepslate_mythril_ore" }
      }
    ]
  }
}

文件 2：placed_feature

data/<modid>/worldgen/placed_feature/ore_mythril_placed.json

{
  "feature": "<modid>:ore_mythril",
  "placement": [
    { "type": "minecraft:count", "count": 8 },
    { "type": "minecraft:in_square" },
    {
      "type": "minecraft:height_range",
      "height": {
        "type": "minecraft:trapezoid",
        "min_inclusive": { "absolute": -48 },
        "max_inclusive": { "absolute": 64 }
      }
    },
    { "type": "minecraft:biome" }
  ]
}

文件 3：注入 biome

data/<modid>/neoforge/biome_modifier/add_mythril_ore_modifier.json

{
  "type": "neoforge:add_features",
  "biomes": "#minecraft:is_overworld",
  "features": "<modid>:ore_mythril_placed",
  "step": "underground_ores"
}

11.3 示例 B：自定义地表植被 patch

configured_feature

data/<modid>/worldgen/configured_feature/crystal_plant_patch.json

{
  "type": "minecraft:random_patch",
  "config": {
    "tries": 64,
    "xz_spread": 6,
    "y_spread": 2,
    "feature": {
      "feature": {
        "type": "minecraft:simple_block",
        "config": {
          "to_place": {
            "type": "minecraft:simple_state_provider",
            "state": { "Name": "<modid>:crystal_plant" }
          }
        }
      },
      "placement": [
        { "type": "minecraft:block_predicate_filter", "predicate": { "type": "minecraft:would_survive", "state": { "Name": "<modid>:crystal_plant" } } }
      ]
    }
  }
}

placed_feature

data/<modid>/worldgen/placed_feature/crystal_plant_patch_placed.json

{
  "feature": "<modid>:crystal_plant_patch",
  "placement": [
    { "type": "minecraft:count", "count": 3 },
    { "type": "minecraft:in_square" },
    { "type": "minecraft:heightmap", "heightmap": "WORLD_SURFACE_WG" },
    { "type": "minecraft:biome" }
  ]
}

biome modifier

data/<modid>/neoforge/biome_modifier/add_crystal_plants_to_snowy.json

{
  "type": "neoforge:add_features",
  "biomes": ["minecraft:snowy_plains", "minecraft:grove"],
  "features": "<modid>:crystal_plant_patch_placed",
  "step": "vegetal_decoration"
}

12. 实战 L3：从 0 自定义新生物群系（Biome）并参与分布

12.1 关键事实：注册一个 biome 不等于会自然出现

你创建 worldgen/biome/*.json 只是在 registry 里有了对象。

要自然生成，必须被某个 biome source 选中（例如 multi_noise 参数空间映射）。

源码依据：BiomeSource.getNoiseBiome、MultiNoiseBiomeSource.getNoiseBiome。

12.2 最小 biome 模板（可运行）

data/<modid>/worldgen/biome/crystal_fields.json

{
  "has_precipitation": true,
  "temperature": 0.5,
  "downfall": 0.7,
  "effects": {
    "fog_color": 12638463,
    "water_color": 4159204,
    "water_fog_color": 329011,
    "sky_color": 7972607,
    "mood_sound": {
      "sound": "minecraft:ambient.cave",
      "tick_delay": 6000,
      "block_search_extent": 8,
      "offset": 2.0
    }
  },
  "spawn_settings": {
    "creature_spawn_probability": 0.1,
    "spawners": {
      "creature": [
        {
          "type": "minecraft:sheep",
          "weight": 12,
          "minCount": 2,
          "maxCount": 4
        }
      ],
      "monster": [
        {
          "type": "minecraft:zombie",
          "weight": 80,
          "minCount": 1,
          "maxCount": 4
        }
      ]
    },
    "spawn_costs": {}
  },
  "generation_settings": {
    "carvers": {
      "air": ["minecraft:cave", "minecraft:cave_extra_underground"],
      "liquid": ["minecraft:canyon"]
    },
    "features": [
      [],
      [],
      [],
      [],
      [],
      [],
      ["minecraft:ore_coal_upper", "minecraft:ore_iron_upper"],
      ["minecraft:ore_gold", "minecraft:ore_diamond"],
      [],
      ["<modid>:crystal_plant_patch_placed"],
      []
    ]
  }
}

features 是“按 step ordinal 对齐的列表”，最容易写错。新手更建议把新增 feature 交给 biome_modifier 注入。

12.3 把新 biome 接入分布（自定义维度最稳）

在自定义维度里使用 biome_source.type = minecraft:multi_noise，并直接填写 biomes 参数列表（见第 13 章）。

原因：

原版 overworld preset 过于复杂
multi_noise_biome_source_parameter_list 预设只内置 overworld/nether（见 MultiNoiseBiomeSourceParameterLists）

13. 实战 L4：完全自定义新维度 + 维度 biome 分布 + 预设

这是完整链路，分 4 步。

13.1 第一步：定义 DimensionType

data/<modid>/dimension_type/crystal_realm_type.json

{
  "fixed_time": 6000,
  "has_skylight": true,
  "has_ceiling": false,
  "ultrawarm": false,
  "natural": false,
  "coordinate_scale": 1.0,
  "bed_works": true,
  "respawn_anchor_works": false,
  "min_y": -64,
  "height": 384,
  "logical_height": 384,
  "infiniburn": "#minecraft:infiniburn_overworld",
  "effects": "minecraft:overworld",
  "ambient_light": 0.02,
  "monster_settings": {
    "piglin_safe": false,
    "has_raids": true,
    "monster_spawn_light_level": {
      "type": "minecraft:uniform",
      "value": { "min_inclusive": 0, "max_inclusive": 7 }
    },
    "monster_spawn_block_light_limit": 0
  }
}

字段严格对齐 DimensionType.DIRECT_CODEC。

13.2 第二步：定义维度专属 biome

例如：

data/<modid>/worldgen/biome/crystal_lowlands.json
data/<modid>/worldgen/biome/crystal_highlands.json
data/<modid>/worldgen/biome/crystal_voidsteppe.json

每个 biome 都可有各自 spawns/features。

13.3 第三步：定义 LevelStem（dimension 文件）

data/<modid>/dimension/crystal_realm.json

{
  "type": "<modid>:crystal_realm_type",
  "generator": {
    "type": "minecraft:noise",
    "settings": "minecraft:overworld",
    "biome_source": {
      "type": "minecraft:multi_noise",
      "biomes": [
        {
          "parameters": {
            "temperature": { "min": -1.0, "max": -0.1 },
            "humidity": { "min": -1.0, "max": 1.0 },
            "continentalness": { "min": -1.0, "max": 1.0 },
            "erosion": { "min": -1.0, "max": 1.0 },
            "depth": { "min": -1.0, "max": 0.0 },
            "weirdness": { "min": -1.0, "max": 1.0 },
            "offset": 0.0
          },
          "biome": "<modid>:crystal_lowlands"
        },
        {
          "parameters": {
            "temperature": { "min": -0.1, "max": 0.6 },
            "humidity": { "min": -1.0, "max": 1.0 },
            "continentalness": { "min": -1.0, "max": 1.0 },
            "erosion": { "min": -1.0, "max": 1.0 },
            "depth": { "min": 0.0, "max": 0.6 },
            "weirdness": { "min": -1.0, "max": 1.0 },
            "offset": 0.0
          },
          "biome": "<modid>:crystal_highlands"
        },
        {
          "parameters": {
            "temperature": { "min": 0.6, "max": 1.0 },
            "humidity": { "min": -1.0, "max": 1.0 },
            "continentalness": { "min": -1.0, "max": 1.0 },
            "erosion": { "min": -1.0, "max": 1.0 },
            "depth": { "min": 0.6, "max": 1.0 },
            "weirdness": { "min": -1.0, "max": 1.0 },
            "offset": 0.0
          },
          "biome": "<modid>:crystal_voidsteppe"
        }
      ]
    }
  }
}

13.4 第四步：定义 world preset

data/<modid>/worldgen/world_preset/crystal_preset.json

{
  "dimensions": {
    "minecraft:overworld": {
      "type": "minecraft:overworld",
      "generator": {
        "type": "minecraft:noise",
        "settings": "minecraft:overworld",
        "biome_source": {
          "type": "minecraft:multi_noise",
          "preset": "minecraft:overworld"
        }
      }
    },
    "minecraft:the_nether": {
      "type": "minecraft:the_nether",
      "generator": {
        "type": "minecraft:noise",
        "settings": "minecraft:nether",
        "biome_source": {
          "type": "minecraft:multi_noise",
          "preset": "minecraft:nether"
        }
      }
    },
    "minecraft:the_end": {
      "type": "minecraft:the_end",
      "generator": {
        "type": "minecraft:noise",
        "settings": "minecraft:end",
        "biome_source": {
          "type": "minecraft:the_end"
        }
      }
    },
    "<modid>:crystal_realm": "<modid>:crystal_realm"
  }
}

13.5 维度开发最低可行验证法

先只有 dimension_type + dimension，不加 preset（用命令/自定义传送验证）
再加 preset
再加自定义 biome 分配
最后再调噪声设置与地表规则

14. 进阶：自定义 BiomeModifier 类型（Java 侧扩展）

当内置 neoforge:add_* / remove_* 不够时，用 Java 扩展。

14.1 接口实现骨架

package com.example.examplemod.worldgen;

import com.mojang.serialization.MapCodec;
import net.minecraft.core.Holder;
import net.minecraft.world.level.biome.Biome;
import net.neoforged.neoforge.common.world.BiomeModifier;
import net.neoforged.neoforge.common.world.ModifiableBiomeInfo;

public record ForceRainBiomeModifier(float minDownfall) implements BiomeModifier {
    @Override
    public void modify(Holder<Biome> biome, Phase phase, ModifiableBiomeInfo.BiomeInfo.Builder builder) {
        if (phase != Phase.MODIFY) return;
        var climate = builder.getClimateSettings();
        if (climate.getDownfall() < minDownfall) {
            climate.setDownfall(minDownfall);
        }
    }

    @Override
    public MapCodec<? extends BiomeModifier> codec() {
        return ModBiomeModifierCodecs.FORCE_RAIN.get();
    }
}

14.2 serializer 注册

package com.example.examplemod.worldgen;

import com.mojang.serialization.MapCodec;
import com.mojang.serialization.codecs.RecordCodecBuilder;
import net.neoforged.neoforge.common.world.BiomeModifier;
import net.neoforged.neoforge.registries.DeferredHolder;
import net.neoforged.neoforge.registries.DeferredRegister;
import net.neoforged.neoforge.registries.NeoForgeRegistries;

public final class ModBiomeModifierCodecs {
    public static final DeferredRegister<MapCodec<? extends BiomeModifier>> REG =
        DeferredRegister.create(NeoForgeRegistries.Keys.BIOME_MODIFIER_SERIALIZERS, "examplemod");

    public static final DeferredHolder<MapCodec<? extends BiomeModifier>, MapCodec<ForceRainBiomeModifier>> FORCE_RAIN =
        REG.register("force_rain", () -> RecordCodecBuilder.mapCodec(i -> i.group(
            com.mojang.serialization.Codec.FLOAT.fieldOf("min_downfall")
                .forGetter(ForceRainBiomeModifier::minDownfall)
        ).apply(i, ForceRainBiomeModifier::new)));
}

14.3 数据文件使用

data/<modid>/neoforge/biome_modifier/force_rain_overworld.json

{
  "type": "examplemod:force_rain",
  "min_downfall": 0.6
}

15. 进阶：地表规则（SurfaceRules）与噪声参数定制思路

地表（顶层方块）受 surface_rule 控制，定义在 noise_settings 里。

源码入口：SurfaceRules。

15.1 你要知道的核心事实

SurfaceRules 也是 codec 分发体系
condition 与 rule 都可组合
实际计算发生在噪声生成阶段

15.2 定制策略建议

新手不要从 0 写完整 surface rule，建议：

先复用原版 minecraft:overworld noise settings
只在 biome 层做特征与方块表现
等系统稳定后再 fork noise settings 做 surface rule 小改

15.3 何时必须自定义 noise settings

你要非标准高度（例如低重力浮空大陆）
你要彻底改地形风格（非 Overworld 逻辑）
你需要独立 spawn target 气候参数

相关定义：NoiseGeneratorSettings。

16. 工程化方法：如何组织 worldgen 资源与版本升级策略

16.1 推荐目录布局

data/<modid>/
  dimension_type/
  dimension/
  neoforge/biome_modifier/
  worldgen/
    biome/
    configured_feature/
    placed_feature/
    configured_carver/
    noise_settings/
    world_preset/

16.2 命名策略

统一前缀：

ore_*
tree_*
biome_*
dim_*
preset_*

避免“语义弱命名”如 test1/test2/new_biome。

16.3 版本升级策略

Minecraft/NeoForge 升级时优先检查：

codec 字段变更
registry key 迁移
noise 参数语义变化
内置 biome modifier serializer 变化

17. 排错大全：从日志到根因定位（按错误类型索引）

以下按“报错现象 -> 根因 -> 解决方式”组织。

17.1 `Unknown registry element` / `Failed to parse`

常见根因：

路径放错注册表目录
type 写错命名空间
引用了不存在的 feature/carver/biome

定位方法：

看报错里 registry 名
对照 Registries
回查资源路径与 id

17.2 `height has to be multiple of 16`

根因：dimension_type 或 noise_settings 里高度参数不合法。

依据：DimensionType``构造校验、NoiseSettings.guardY。

17.3 `Feature order cycle found`

根因：feature step 关系形成循环。

依据：FeatureSorter.buildFeaturesPerStep。

处理：

不要随意跨 step 搬运 vanilla 特征
先从单个 injected feature 开始

17.4 “新 biome 不生成”

根因：未接入 biome source 参数空间。

定位：检查 dimension 文件里的 biome_source 配置。

17.5 “modifier 写了但看不到效果”

根因候选：

modifier 文件路径错误
biomes 过滤条件没命中
features 引用 ID 不存在
被后续 modifier 覆盖

验证点：ServerLifecycleHooks.runModifiers 生命周期时序。

17.6 “维度存在但创建世界界面选不到”

根因：缺少 world_preset 或 preset 未被使用。

对照：WorldPresets.bootstrap 的标准模式。

17.7 “能进维度但地形异常/全空/全石”

根因候选：

generator.settings 与 dimension_type 高度不匹配
自定义 noise settings 参数不合法
surface rule 不适配

先回退到 minecraft:overworld settings 做基线，再逐步改。

17.8 “刷怪异常（过多/过少/无刷怪）”

检查：

biome 的 spawn_settings
biome modifier 是否 add/remove 了 spawns
spawn costs 是否过严

参考：MobSpawnSettings。

18. 性能与稳定性：世界生成不是越复杂越好

18.1 复杂度来源

biome 参数点数量过多
feature 放置次数高 + 条件复杂
过多 carvers
过度自定义噪声网络

18.2 经验阈值建议

新维度初期 biome 数量：2~5
每 biome 新增 placed feature：先 1~3
每次迭代只改一个方向（分布/频率/高度）

18.3 为什么要“渐进式调参”

因为世界生成故障往往是组合问题。一次改 10 个参数，你几乎无法定位根因。

19. 最终落地清单：发布前必须自查的 60 条检查项

下面给你按模块的检查表（建议发布前逐条过）：

19.1 注册与路径（1~12）

所有 worldgen 资源在正确目录
biome_modifier 在 data/<modid>/neoforge/biome_modifier
所有 type 都是有效 id
所有引用对象存在
大小写一致
命名空间统一
无遗留 examplemod id
无多余尾逗号
JSON 编码为 UTF-8
无 BOM 干扰
路径无拼写错误
启动日志无 registry decode 错误

19.2 Biome（13~22）

effects 字段完整
spawn_settings 结构合法
generation_settings 结构合法
biome 至少能被 biome source 引用
温度/降雨值合理
生物群系视觉符合预期
地表植被密度合理
刷怪池无荒谬配置
不依赖未加载资源
兼容主世界/维度目标

19.3 Feature（23~34）

configured_feature 可解析
placed_feature 可解析
placement modifier 链合法
step 选择合理
生成频率可控
高度范围合理
不与关键结构强冲突
无 feature cycle
生存平衡可接受
创造模式观察无异常
区块边界表现正常
多次进出世界结果稳定

19.4 BiomeModifier（35~44）

modifier 能命中目标 biome
ADD/REMOVE/MODIFY 语义合理
多个 modifier 顺序影响可解释
无互相抵消配置
删除行为不会破坏世界逻辑
刷怪改动无 mob category 错位
spawn cost 调整可验证
carver 改动不过度
服务端日志确认已应用
客户端表现与服务端一致

19.5 维度（45~56）

dimension_type 字段完整合法
min_y/height/logical_height 通过约束
dimension 文件 type 引用正确
generator type 有效
settings 引用有效
biome_source 配置有效
world_preset 引用维度正确
世界创建界面可见（若期望可见）
传送逻辑可达
回主世界路径可达
客户端 effects 正常
存档重开不损坏

19.6 稳定性与发布（57~60）

新存档连续运行无崩溃
老存档升级策略明确
已记录已知兼容性限制
文档说明了关键配置与可调参数

20. 总结：你应该真正带走的能力

学完这篇之后，你不该只会“照抄一个 json”。你应该获得的是下面这 6 个能力：

能分层定位问题：维度、地形、biome、feature、spawn、modifier 分得清
能从源码反推数据格式：先看 registry，再看 codec，再写文件
能做低风险迭代：L1→L4 逐层推进，不一口吃成胖子
能解释每个参数为什么存在：不是玄学调参
能写可维护 worldgen 资源：目录、命名、依赖、验证流程成体系
能在版本升级时有章可循：先看 codec 与 registry 变化，再迁移数据

如果你按本文方法执行，世界生成开发会从“黑盒碰运气”，变成“可设计、可验证、可迭代”的工程工作流。

附录 A：速查索引（按需求反查源码）

想改原版 biome 内容：BiomeModifier、BiomeModifiers
想查 modifier 何时应用：ServerLifecycleHooks.runModifiers
想查 biome 结构：Biome.DIRECT_CODEC
想查特征结构：ConfiguredFeature.DIRECT_CODEC、PlacedFeature.DIRECT_CODEC
想查地形噪声设置：NoiseGeneratorSettings.DIRECT_CODEC
想查维度类型字段：DimensionType.DIRECT_CODEC
想查维度定义：LevelStem.CODEC
想查预设：WorldPresets
想查注册表加载：RegistryDataLoader

附录 B：常用模板集合（可直接复制后替换 `<modid>`）

B1. 最小 add_features modifier

{
  "type": "neoforge:add_features",
  "biomes": "#minecraft:is_overworld",
  "features": "<modid>:example_feature_placed",
  "step": "vegetal_decoration"
}

B2. 最小 biome

{
  "has_precipitation": true,
  "temperature": 0.8,
  "downfall": 0.4,
  "effects": {
    "fog_color": 12638463,
    "water_color": 4159204,
    "water_fog_color": 329011,
    "sky_color": 7907327,
    "mood_sound": {
      "sound": "minecraft:ambient.cave",
      "tick_delay": 6000,
      "block_search_extent": 8,
      "offset": 2.0
    }
  },
  "spawn_settings": {
    "creature_spawn_probability": 0.1,
    "spawners": {},
    "spawn_costs": {}
  },
  "generation_settings": {
    "carvers": {},
    "features": []
  }
}

B3. 最小 dimension_type

{
  "has_skylight": true,
  "has_ceiling": false,
  "ultrawarm": false,
  "natural": false,
  "coordinate_scale": 1.0,
  "bed_works": true,
  "respawn_anchor_works": false,
  "min_y": -64,
  "height": 384,
  "logical_height": 384,
  "infiniburn": "#minecraft:infiniburn_overworld",
  "effects": "minecraft:overworld",
  "ambient_light": 0.0,
  "monster_settings": {
    "piglin_safe": false,
    "has_raids": true,
    "monster_spawn_light_level": {
      "type": "minecraft:uniform",
      "value": { "min_inclusive": 0, "max_inclusive": 7 }
    },
    "monster_spawn_block_light_limit": 0
  }
}

B4. 最小 dimension（LevelStem）

{
  "type": "<modid>:your_dimension_type",
  "generator": {
    "type": "minecraft:noise",
    "settings": "minecraft:overworld",
    "biome_source": {
      "type": "minecraft:multi_noise",
      "biomes": [
        {
          "parameters": {
            "temperature": { "min": -1.0, "max": 1.0 },
            "humidity": { "min": -1.0, "max": 1.0 },
            "continentalness": { "min": -1.0, "max": 1.0 },
            "erosion": { "min": -1.0, "max": 1.0 },
            "depth": { "min": -1.0, "max": 1.0 },
            "weirdness": { "min": -1.0, "max": 1.0 },
            "offset": 0.0
          },
          "biome": "<modid>:your_biome"
        }
      ]
    }
  }
}

附录 C：学习路径建议

1.

学会 neoforge:biome_modifier 增删特征与刷怪
理解 GenerationStep.Decoration

2.

自定义 2 个矿脉 + 1 个植被 patch
练习放置修饰器组合

3.

新建 2~3 个 biome
做一个简单 multi_noise 参数分区

4.

新建独立维度
接 world preset
做一次完整平衡迭代

坚持这条路径，你会从“能用”快速进入“能设计”。

NeoForge 世界生成开发指南

目录Copy Anchor Link

1. 先建立正确模型：世界生成不是一个系统，而是一串流水线Copy Anchor Link

2. 先读源码再写代码：最关键入口总览（建议收藏）Copy Anchor Link

2.1 注册表 key 在哪里Copy Anchor Link

2.2 谁加载这些注册表数据Copy Anchor Link

2.3 NeoForge world 修改入口Copy Anchor Link

3. 底层原理一：注册表 + Codec + 数据加载，是世界生成的一切前提Copy Anchor Link

3.1 先问“对象是谁”，再问“文件怎么写”Copy Anchor Link

3.2 Codec 的本质Copy Anchor Link

3.3 数据加载流程如何影响调试Copy Anchor Link

4. 底层原理二：区块状态机（ChunkStatus）决定生成顺序Copy Anchor Link

5. 底层原理三：BiomeModifier 如何“改原版世界”Copy Anchor Link

5.1 修改不是替换，而是“拷贝 + 分阶段变更”Copy Anchor Link

5.2 阶段顺序不是装饰，而是逻辑保障Copy Anchor Link

5.3 内置 modifier 能做什么Copy Anchor Link

6. 底层原理四：Feature 放置链（Feature -> Configured -> Placed）Copy Anchor Link

6.1 Feature 周期冲突（cycle）为什么会报错Copy Anchor Link

7. 底层原理五：噪声地形与生物群系分配（NoiseRouter + Climate）Copy Anchor Link

7.1 地形不是“一个噪声”，而是噪声网络Copy Anchor Link

7.2 RandomState 负责把“参数化图”实例化成“带 seed 的函数”Copy Anchor Link

7.3 biome 分配通过 Climate 参数空间最近匹配Copy Anchor Link

7.4 为什么原版 overworld biome 分布那么复杂Copy Anchor Link

8. 底层原理六：维度系统（DimensionType + LevelStem + WorldPreset）Copy Anchor Link

8.1 DimensionType：描述“这个宇宙的物理规则”Copy Anchor Link

8.2 LevelStem：维度实例的关键组合Copy Anchor Link

8.3 WorldPreset：创建世界时的维度集合Copy Anchor Link

9. 方法论：四层递进开发法（L1→L4）Copy Anchor Link

L1：只改原版（BiomeModifier）Copy Anchor Link

L2：加自定义特征Copy Anchor Link

L3：加自定义 biomeCopy Anchor Link

L4：加自定义维度Copy Anchor Link

10. 实战 L1：修改原版世界生成（最低风险，最高性价比）Copy Anchor Link

10.1 目录结构（务必正确）Copy Anchor Link

10.2 示例 1：给所有主世界 biome 加矿Copy Anchor Link

10.3 示例 2：只从指定 biome 删除某个矿Copy Anchor Link

10.4 示例 3：新增刷怪Copy Anchor Link

10.5 示例 4：删除某些实体刷怪Copy Anchor Link

10.6 示例 5：批量设置 spawn costCopy Anchor Link

10.7 示例 6：添加 carverCopy Anchor Link

10.8 验证步骤（L1）Copy Anchor Link

11. 实战 L2：自定义地物（矿脉/树/植被）并注入指定 biomeCopy Anchor Link

11.1 链路总览Copy Anchor Link

11.2 示例 A：自定义矿脉Copy Anchor Link

文件 1：configured_featureCopy Anchor Link

文件 2：placed_featureCopy Anchor Link

文件 3：注入 biomeCopy Anchor Link

11.3 示例 B：自定义地表植被 patchCopy Anchor Link

configured_featureCopy Anchor Link

placed_featureCopy Anchor Link

biome modifierCopy Anchor Link

12. 实战 L3：从 0 自定义新生物群系（Biome）并参与分布Copy Anchor Link

12.1 关键事实：注册一个 biome 不等于会自然出现Copy Anchor Link

12.2 最小 biome 模板（可运行）Copy Anchor Link

12.3 把新 biome 接入分布（自定义维度最稳）Copy Anchor Link

13. 实战 L4：完全自定义新维度 + 维度 biome 分布 + 预设Copy Anchor Link

13.1 第一步：定义 DimensionTypeCopy Anchor Link

13.2 第二步：定义维度专属 biomeCopy Anchor Link

13.3 第三步：定义 LevelStem（dimension 文件）Copy Anchor Link

13.4 第四步：定义 world presetCopy Anchor Link

13.5 维度开发最低可行验证法Copy Anchor Link

14. 进阶：自定义 BiomeModifier 类型（Java 侧扩展）Copy Anchor Link

14.1 接口实现骨架Copy Anchor Link

14.2 serializer 注册Copy Anchor Link

14.3 数据文件使用Copy Anchor Link

15. 进阶：地表规则（SurfaceRules）与噪声参数定制思路Copy Anchor Link

15.1 你要知道的核心事实Copy Anchor Link

15.2 定制策略建议Copy Anchor Link

15.3 何时必须自定义 noise settingsCopy Anchor Link

16. 工程化方法：如何组织 worldgen 资源与版本升级策略Copy Anchor Link

16.1 推荐目录布局Copy Anchor Link

16.2 命名策略Copy Anchor Link

16.3 版本升级策略Copy Anchor Link

17. 排错大全：从日志到根因定位（按错误类型索引）Copy Anchor Link

17.1 Unknown registry element / Failed to parseCopy Anchor Link

17.2 height has to be multiple of 16Copy Anchor Link

17.3 Feature order cycle foundCopy Anchor Link

17.4 “新 biome 不生成”Copy Anchor Link

17.5 “modifier 写了但看不到效果”Copy Anchor Link

17.6 “维度存在但创建世界界面选不到”Copy Anchor Link

目录

1. 先建立正确模型：世界生成不是一个系统，而是一串流水线

2. 先读源码再写代码：最关键入口总览（建议收藏）

2.1 注册表 key 在哪里

2.2 谁加载这些注册表数据

2.3 NeoForge world 修改入口

3. 底层原理一：注册表 + Codec + 数据加载，是世界生成的一切前提

3.1 先问“对象是谁”，再问“文件怎么写”

3.2 Codec 的本质

3.3 数据加载流程如何影响调试

4. 底层原理二：区块状态机（ChunkStatus）决定生成顺序

5. 底层原理三：BiomeModifier 如何“改原版世界”

5.1 修改不是替换，而是“拷贝 + 分阶段变更”

5.2 阶段顺序不是装饰，而是逻辑保障

5.3 内置 modifier 能做什么

6. 底层原理四：Feature 放置链（Feature -> Configured -> Placed）

6.1 Feature 周期冲突（cycle）为什么会报错

7. 底层原理五：噪声地形与生物群系分配（NoiseRouter + Climate）

7.1 地形不是“一个噪声”，而是噪声网络

7.2 RandomState 负责把“参数化图”实例化成“带 seed 的函数”

7.3 biome 分配通过 Climate 参数空间最近匹配

7.4 为什么原版 overworld biome 分布那么复杂

8. 底层原理六：维度系统（DimensionType + LevelStem + WorldPreset）

8.1 DimensionType：描述“这个宇宙的物理规则”

8.2 LevelStem：维度实例的关键组合

8.3 WorldPreset：创建世界时的维度集合

9. 方法论：四层递进开发法（L1→L4）

L1：只改原版（BiomeModifier）

L2：加自定义特征

L3：加自定义 biome

L4：加自定义维度

10. 实战 L1：修改原版世界生成（最低风险，最高性价比）

10.1 目录结构（务必正确）