本篇教程的视频

本篇教程的源代码

GitHub地址：

查看源代码

矿物，或者说矿脉，它也是属于地物的，所以它也有构造特征和放置特征

需要特别注意的是：原版的世界生成逻辑都是按照区块进行的生成

矿石的生成也都是按照一个个区块来生成，而如果大家玩过GTNH（或者就纯粹的GT），它矿石的生成逻辑是被修改过的，即它是按照3*3的区块去生成，而不是按照单个区块来生成

这里需要注意这一点

构造特征

矿物的构造特征我们可以在OreFeatures类中找到

1
2

public static final ResourceKey<ConfiguredFeature<?, ?>> ORE_COAL = FeatureUtils.createKey("ore_coal");
public static final ResourceKey<ConfiguredFeature<?, ?>> ORE_COAL_BURIED = FeatureUtils.createKey("ore_coal_buried");

这里我们以煤矿为例，首先是注册键，煤矿分了两个，一个是普通的，一个是埋藏的，后者大概是埋在岩层中的，而不是直接裸露在外的

再接下来的bootstrap方法中，我们可以看到一堆RuleTest

RuleTest ruletest = new TagMatchTest(BlockTags.BASE_STONE_OVERWORLD);
RuleTest ruletest1 = new TagMatchTest(BlockTags.STONE_ORE_REPLACEABLES);
RuleTest ruletest2 = new TagMatchTest(BlockTags.DEEPSLATE_ORE_REPLACEABLES);
RuleTest ruletest3 = new BlockMatchTest(Blocks.NETHERRACK);
RuleTest ruletest4 = new TagMatchTest(BlockTags.BASE_STONE_NETHER);

这些其实就是矿物生成规则中可以用来替换的方块，我的理解是，在世界生成的过程中，
先是基本岩石先生成，比如Stone，然后矿物根据规则判断一些方块是否可以被替换，将那些方块替换为矿物

1
2
3

List<OreConfiguration.TargetBlockState> list5 = List.of(
        OreConfiguration.target(ruletest1, Blocks.COAL_ORE.defaultBlockState()), 
        OreConfiguration.target(ruletest2, Blocks.DEEPSLATE_COAL_ORE.defaultBlockState()));

接下来还有一个List，里面有两个Target，分别是普通的煤矿和深层煤矿，
Target中有一个RuleTest和一个BlockState，RuleTest就是上面提到的可以替换的方块

对于煤矿是替换STONE_ORE_REPLACEABLES和DEEPSLATE_ORE_REPLACEABLES这两个标签下的方块

1 2	FeatureUtils.register(pContext, ORE_COAL, Feature.ORE, new OreConfiguration(list5, 17)); FeatureUtils.register(pContext, ORE_COAL_BURIED, Feature.ORE, new OreConfiguration(list5, 17, 0.5F));

那么最后就是构造特征的注册

OreConfiguration中，第一个参数就是上面提到的List，第二个参数是矿物矿脉的规模，也就是一个矿脉中最多会有多少个矿石，
第三个参数为可选参数，指是矿物暴露在空气中时被丢弃的概率，值越高越容易被丢弃，毕竟矿石不能悬浮在空中吧

构造特征基本上是这样，接下来我们来看放置特征

放置特征

放置特征在OrePlacements类中

1
2

public static final ResourceKey<PlacedFeature> ORE_COAL_UPPER = PlacementUtils.createKey("ore_coal_upper");
public static final ResourceKey<PlacedFeature> ORE_COAL_LOWER = PlacementUtils.createKey("ore_coal_lower");

还是以煤矿为例，它这里分了两个，根据Wiki上的描述，煤矿有两种生成规则，我们从下面的代码来看看它们具体的生成规则

同样，也是在下面的bootstrap方法中

HolderGetter<ConfiguredFeature<?, ?>> holdergetter = pContext.lookup(Registries.CONFIGURED_FEATURE);

Holder<ConfiguredFeature<?, ?>> holder12 = holdergetter.getOrThrow(OreFeatures.ORE_COAL);
Holder<ConfiguredFeature<?, ?>> holder13 = holdergetter.getOrThrow(OreFeatures.ORE_COAL_BURIED);
  
PlacementUtils.register(pContext, ORE_COAL_UPPER, holder12, 
        commonOrePlacement(30, HeightRangePlacement.uniform(VerticalAnchor.absolute(136), VerticalAnchor.top())));
PlacementUtils.register(pContext, ORE_COAL_LOWER, holder13, 
        commonOrePlacement(20, HeightRangePlacement.triangle(VerticalAnchor.absolute(0), VerticalAnchor.absolute(192))));

这里我们就能方向它的两个生成规则了，也就是这里的两个放置特征的注册

第一个放置特征，也就是ORE_COAL_UPPER，它的生成规则是，在Y坐标为136到世界最高点之间均匀分布，
HeightRangePlacement.uniform方法中的两个参数分别是Y坐标的最小值和最大值，其效果是均匀分布，
commonOrePlacement方法的第一个参数在一个区块中，尝试生成的次数

第二个放置特征，也就是ORE_COAL_LOWER，它的生成规则是，在Y坐标为0到192之间梯形分布，
每个区块尝试生成20次，triangle方法表现的效果就是梯形分布，也就是两端分布少，中间分布多，
按照这里的参数，煤矿会在Y坐标96时，生成最多

当然，这也只是理论上（代码上）的生成规则，其实际分布还得取决于地形等因素，
看Wiki上的每十万个方块中煤矿的数量图显示，Y=45时，煤矿是分布最多的

注册矿物世界生成

注册构造特征

那么接下来我们就来写自己的矿物

首先我们回到ModConfiguredFeatures类中，写一些注册键

1
2
3

public static final ResourceKey<ConfiguredFeature<?, ?>> ICE_ETHER_ORE_KEY = createKey("ice_ether_ore");
public static final ResourceKey<ConfiguredFeature<?, ?>> NETHER_ICE_ETHER_ORE_KEY = createKey("nether_ice_ether_ore");
public static final ResourceKey<ConfiguredFeature<?, ?>> END_ICE_ETHER_ORE_KEY = createKey("end_ice_ether_ore");

今天我们就直接在三个维度中生成我们的矿石，所以直接写了3个

然后是在bootstrap方法中，先写一些替换规则

RuleTest stoneReplace = new TagMatchTest(BlockTags.STONE_ORE_REPLACEABLES);
RuleTest deepSlateReplace = new TagMatchTest(BlockTags.DEEPSLATE_ORE_REPLACEABLES);
RuleTest netherReplace = new TagMatchTest(BlockTags.BASE_STONE_NETHER);
RuleTest endReplace = new BlockMatchTest(Blocks.END_STONE);

主要分主世界的浅层和深层、下界和末地这4个部分，末地的话没有对应的方块标签，所以用BlockMatchTest传入末地石就行

接下来是写List

List<OreConfiguration.TargetBlockState> overWorldTargets = List.of(
        OreConfiguration.target(stoneReplace, ModBlocks.ICE_ETHER_ORE.get().defaultBlockState()),
        OreConfiguration.target(deepSlateReplace, ModBlocks.ICE_ETHER_ORE.get().defaultBlockState()));
List<OreConfiguration.TargetBlockState> netherTargets = List.of(
        OreConfiguration.target(netherReplace, ModBlocks.ICE_ETHER_ORE.get().defaultBlockState()));
List<OreConfiguration.TargetBlockState> endTargets = List.of(
        OreConfiguration.target(endReplace, ModBlocks.ICE_ETHER_ORE.get().defaultBlockState()));

当然，因为我们之前只写了一个矿石方块，所以三个维度下都用同一个了，大家可以按照不同维度中基本岩石的材质来注册矿石方块

然后是注册构造特征

FeatureUtils.register(context, ICE_ETHER_ORE_KEY, Feature.ORE,
        new OreConfiguration(overWorldTargets, 9));
FeatureUtils.register(context, NETHER_ICE_ETHER_ORE_KEY, Feature.ORE,
        new OreConfiguration(netherTargets, 12));
FeatureUtils.register(context, END_ICE_ETHER_ORE_KEY, Feature.ORE,
        new OreConfiguration(endTargets, 10));

这里我们用9、12、10来代表不同维度下矿石矿脉的规模，也就是一个矿脉中最多会有多少个矿石

注册放置特征

接下来我们来到ModPlacedFeatures类中，先搬两个方法过来

private static List<PlacementModifier> orePlacement(PlacementModifier pCountPlacement, PlacementModifier pHeightRange) {
  return List.of(pCountPlacement, InSquarePlacement.spread(), pHeightRange, BiomeFilter.biome());
}

private static List<PlacementModifier> commonOrePlacement(int pCount, PlacementModifier pHeightRange) {
  return orePlacement(CountPlacement.of(pCount), pHeightRange);
}

这两个方法是OrePlacements类中的，因为它是私有方法，而我们也得用，所以就直接搬过来即可

随后来注册一些注册键

1
2
3

public static final ResourceKey<PlacedFeature> ICE_ETHER_ORE_PLACED_KEY = registerKey("ice_ether_ore_placed");
public static final ResourceKey<PlacedFeature> NETHER_ICE_ETHER_ORE_PLACED_KEY = registerKey("nether_ice_ether_ore_placed");
public static final ResourceKey<PlacedFeature> END_ICE_ETHER_ORE_PLACED_KEY = registerKey("end_ice_ether_ore_placed");

然后在bootstrap方法中注册放置特征

PlacementUtils.register(context, ICE_ETHER_ORE_PLACED_KEY, holdergetter.getOrThrow(ModConfiguredFeatures.ICE_ETHER_ORE_KEY),
        commonOrePlacement(10,
                HeightRangePlacement.uniform(VerticalAnchor.absolute(-64), VerticalAnchor.absolute(128))));
PlacementUtils.register(context, NETHER_ICE_ETHER_ORE_PLACED_KEY, holdergetter.getOrThrow(ModConfiguredFeatures.NETHER_ICE_ETHER_ORE_KEY),
        commonOrePlacement(12,
                HeightRangePlacement.uniform(VerticalAnchor.absolute(20), VerticalAnchor.absolute(80))));
PlacementUtils.register(context, END_ICE_ETHER_ORE_PLACED_KEY, holdergetter.getOrThrow(ModConfiguredFeatures.END_ICE_ETHER_ORE_KEY),
        commonOrePlacement(8,
                HeightRangePlacement.uniform(VerticalAnchor.absolute(0), VerticalAnchor.absolute(80))));

这里我都选择了平均分布，每个维度下，单位区块中生成的次数大家可以按照自己的需求去编写

生物群系修改

最后我们回到ModBiomeModifiers类中，先添加一些注册键

1
2
3

public static final ResourceKey<BiomeModifier> ADD_ICE_ETHER_ORE = registerKey("add_ice_ether_ore");
public static final ResourceKey<BiomeModifier> ADD_NETHER_ICE_ETHER_ORE = registerKey("add_nether_ice_ether_ore");
public static final ResourceKey<BiomeModifier> ADD__END_ICE_ETHER_ORE = registerKey("add_end_ice_ether_ore");

然后在其中的bootstrap方法，添加下面的语句

context.register(ADD_ICE_ETHER_ORE, new ForgeBiomeModifiers.AddFeaturesBiomeModifier(
        biomes.getOrThrow(BiomeTags.IS_OVERWORLD),
        HolderSet.direct(placedFeatures.getOrThrow(ModPlacedFeatures.ICE_ETHER_ORE_PLACED_KEY)),
        GenerationStep.Decoration.UNDERGROUND_ORES));

context.register(ADD_NETHER_ICE_ETHER_ORE, new ForgeBiomeModifiers.AddFeaturesBiomeModifier(
        biomes.getOrThrow(BiomeTags.IS_NETHER),
        HolderSet.direct(placedFeatures.getOrThrow(ModPlacedFeatures.NETHER_ICE_ETHER_ORE_PLACED_KEY)),
        GenerationStep.Decoration.UNDERGROUND_ORES));

context.register(ADD__END_ICE_ETHER_ORE, new ForgeBiomeModifiers.AddFeaturesBiomeModifier(
        biomes.getOrThrow(BiomeTags.IS_END),
        HolderSet.direct(placedFeatures.getOrThrow(ModPlacedFeatures.END_ICE_ETHER_ORE_PLACED_KEY)),
        GenerationStep.Decoration.UNDERGROUND_ORES));