Forge自定义矿物生成不生效？

Question

在使用Forge进行Minecraft模组开发时，常有开发者遇到“自定义矿物生成不生效”的问题：已正确注册矿石区块并配置了BiomeModifier，但在世界中完全无法生成。常见原因包括：未正确实现DeferredRegister注册、遗漏在数据生成器中添加特征放置（Placement Modifier）、维度或生物群系过滤器配置错误，以及Forge版本更新后废弃了旧的WorldGenRegistries用法。此外，若未在服务加载器（如IModBusEvent）中正确绑定生成逻辑，也会导致注册失败。排查时应检查日志是否报错、确认特征已加载，并使用调试工具验证矿石是否被正确添加至目标生物群系。

Answer 1

一、问题现象与初步排查

在使用Forge进行Minecraft模组开发时，开发者常遇到“自定义矿物生成不生效”的问题。尽管矿石区块已通过DeferredRegister注册，并配置了BiomeModifier，但在新生成的世界中仍无法找到该矿石。此时应首先检查游戏启动日志是否包含注册相关的错误或警告信息。

• 确认控制台输出中是否存在RegistryObject not bound等异常提示
• 查看ModLoadingStage阶段是否完整通过
• 使用/forge registry dump命令验证矿石方块是否成功注册到方块注册表

若日志无明显报错，则需进一步深入代码逻辑和数据生成流程。

二、核心注册机制分析：DeferredRegister 的正确实现

DeferredRegister是Forge推荐的延迟注册方式，用于确保对象在正确的生命周期阶段注入注册表。常见错误包括：

1. 未将DeferredRegister实例绑定至Mod总线（ModEventBus）
2. 注册时机过早或过晚，导致被忽略
3. 命名空间或注册名拼写错误

public class ModBlocks {
    public static final DeferredRegister<Block> BLOCKS = 
        DeferredRegister.create(Registries.BLOCK, MODID);

    public static final RegistryObject<Block> CUSTOM_ORE = 
        BLOCKS.register("custom_ore", () -> new Block(BlockBehaviour.Properties.of().mapColor(MapColor.STONE)));

    public static void register(IEventBus modEventBus) {
        BLOCKS.register(modEventBus); // 必须显式调用
    }
}

务必确保在主类中调用了ModBlocks.register(modbuseventbus)。

三、特征生成配置：Feature 与 PlacedFeature 注册

Minecraft 1.18+ 使用PlacedFeature系统替代旧版WorldGenRegistries。开发者必须同时注册ConfiguredFeature和PlacedFeature，并通过数据生成器输出JSON。

组件	作用	是否必需
ConfiguredFeature	定义矿石的生成规则（如矿脉大小、高度范围）	是
PlacedFeature	附加放置修饰符（如count、in_square、height_range）	是
BiomeModifier	将PlacedFeature绑定到特定生物群系或维度	是

遗漏任一环节都会导致生成失败。

四、数据生成器实现细节

Forge要求通过BuiltinDataProvider机制生成configured_feature和placed_feature的JSON资源文件。示例如下：

public class ModWorldGenProvider implements BiomeModificationProvider {
    @Override
    public void accept(Consumer<Pair<BiomeSelection, Configuration>> consumer) {
        BiomeSelection selection = BiomeSelectors.includeByKey(
            BiomeKeys.DESERT, BiomeKeys.PLAINS
        );
        PlacementModifier count = CountPlacement.of(10);
        List<PlacementModifier> modifiers = List.of(count, InSquarePlacement.spread(), HeightRangePlacement.uniform(VerticalAnchor.bottom(), VerticalAnchor.top()));
        
        PlacedFeature placedFeature = new PlacedFeature(
            Feature.ORE.configured(new OreConfiguration(
                List.of(OreConfiguration.target(OreFeatures.STONE_ORE_REPLACEABLES, ModBlocks.CUSTOM_ORE.get().defaultBlockState())),
                9 // vein size
            )),
            List.copyOf(modifiers)
        );

        consumer.accept(Pair.of(selection, new Modification((context) -> context.getGenerationSettings().addFeature(GenerationStep.Decoration.UNDERGROUND_ORES, placedFeature))));
    }
}

此过程必须在data/modid/worldgen/biome_modifier/路径下生成有效JSON。

五、服务加载器与事件总线绑定

从Forge 40+开始，IModBusEvent等接口要求明确注册数据生成器和服务提供者。需在mod.toml中声明：

[[mods]]
modId="mymod"
...
[[eventbus]]
side="CLIENT"
value="com.example.mod.client.ClientModEvents"

[[eventbus]]
side="COMMON"
value="com.example.mod.world.ModWorldGenSetup"

并在初始化类中注册：

@Mod.EventBusSubscriber(bus = Mod.EventBusSubscriber.Bus.MOD)
public class ModWorldGenSetup {
    @SubscribeEvent
    public static void onRegisterBiomeModifiers(Register<BiomeModifier> event) {
        event.getRegistry().register(new CustomOreBiomeModifier());
    }
}

六、调试与验证工具链

为快速定位问题，可采用以下方法验证矿石是否真正加入世界生成逻辑：

1. 使用/locate biome minecraft:desert进入目标群系
2. 执行/setblock ~ ~ ~ mymod:custom_ore手动测试方块存在性
3. 启用debug.log中的BiomeLoading事件日志
4. 利用Amidst或Chunky预览地形生成情况
5. 添加断点调试LevelChunk::postPlace调用栈

graph TD
    A[启动游戏] --> B{日志有无注册错误?}
    B -- 是 --> C[检查DeferredRegister绑定]
    B -- 否 --> D[确认PlacedFeature生成]
    D --> E[检查BiomeModifier应用]
    E --> F[验证维度与生物群系匹配]
    F --> G[使用调试工具扫描区块]
    G --> H[确认矿石是否实际生成]