# 简单矿物生成
如有问题请及时指出，谢谢阅读！
*****
## 序
游戏里的世界地壳蕴藏着大量矿物，如煤矿石，1.17前矿脉还并未加入，但有**团簇**，他们是以团簇的形式生成的，一个团簇聚合着几个矿石。那么模组中的矿物应该如何加入到世界中去呢？本教程将以羊毛为例子教你添加矿物**地形特征**，以及简单的生成参数。
## 地形特征
地形特征会在世界中生成，上述的团簇便是一种地形特征，在源码中类路径为`net.minecraft.world.gen.feature.Feature`，这个类中声明了大量的地形特征，其中`ORE`便是生成矿物的特征了，其声明如下：`public static final Feature ORE = register("ore", newOreFeature(OreFeatureConfig::deserialize));`如果你善于看源码，通过查找用法不难发现它的创建方法，在`net.minecraft.world.biome.DefaultBiomeFeatures`类中提供了大量方便的默认方法，可以看出这些地形特征都是指定生物群系加入的，其中`addDefaultOres`方法为某群系添加默认的矿物，代码如下：
```
public static void addDefaultOres(Biome biome) {
biome.addFeature(GenerationStep.Feature.UNDERGROUND_ORES, Feature.ORE
.configure(new OreFeatureConfig(OreFeatureConfig.Target.NATURAL_STONE, COAL_ORE, 17))
.createDecoratedFeature(Decorator.COUNT_RANGE.configure(new RangeDecoratorConfig(20, 0, 0, 128))));
//...
}
```
源码通过调用`biome`对象的`addFeature`方法，将地形特征加入其中，第一个参数是类型，地下矿物传入`GenerationStep.Feature.UNDERGROUND_ORES`即可；第二个是欲添加的地形特征，需要一个**已配置的地形特征（ConfiguredFeature）**，这便是我们所关注的了，源码通过调用`Feature`类的`configure`方法创建已配置的地形特征，需要一个对应的特征配置，这里是`OreFeatureConfig`，下面是它的构造器方法参数列表：
| 参数 | 解释 |
| --- | --- |
| `OreFeatureConfig.Target target` | 生成该矿物可替换掉的方块，只有两种值可用：<br>`NATURAL_STONE`：主世界地壳方块；<br>`NETHERRACK`：下界地壳方块。 |
| `BlockState state` | 矿物方块，调用`block.getDefaultState()`获取。 |
| `int size` | 每个矿簇最大的方块数量。 |
接下来连续调用createDecoratedFeature来为之添加装饰器，以设置矿簇在地壳中的发布状况，需要传入一个**已配置的装饰器（ConfiguredDecorator）**，和地形特征一样，为选好的装饰器调用configure方法传入对应配置创建即可。下面是常见的矿物装饰器及其配置：
| 装饰器类型 | 配置及构造器 |
| --- | --- |
| `COUNT_RANGE`<br>每个区块最大数量和范围 | `RangeDecoratorConfig`<br>构造器：<br>`int count`：每个区块生成的最大数量<br>`int bottomOffset`：最低生成高度<br>`int topOffset`：最高高度偏移<br>`int maximum`：最高生成高度（实际最高高度为`maximum - topOffset`，可能是为结构预留的高度） |
| `COUNT_DEPTH_AVERAGE`<br>每个区块最大数量和平均位置 | `CountDepthDecoratorConfig`<br>构造器：<br>`int count`<br>`int baseline`：平均高度<br>`int spread`：蔓延范围 |
| `EMERALD_ORE`<br>绿宝石矿石专用 | 固定为 `DecoratorConfig.DEFAULT` |
这便是地形特征的创建方式，以下是我们的羊毛矿代码：
```
private static final ConfiguredFeature WOOL_ORE = Feature.ORE.configure(new OreFeatureConfig(OreFeatureConfig.Target.NATURAL_STONE, Blocks.WOOL.getDefaultState(), 6)).createDecoratedFeature(Decorator.COUNT_RANGE.configure(new RangeDecoratorConfig(20, 0, 0, 64)));
```
## 添加到世界
上述源码中使用biome.addFeature方法将地形特征加入到某群系中，我们可用通过 Fabric 提供的注册表方法遍历现有群系，然后注册一个侦听器，以供将来添加。
```
@Override
public void onInitialize() {
Registry.BIOME.forEach(this::handleBiome);
RegistryEntryAddedCallback.event(Registry.BIOME).register((i, identifier, biome) -> handleBiome(biome));
//...
}
```
```
private static void handleBiome(Biome biome) {
if(biome.getCategory() != Biome.Category.NETHER && biome.getCategory() != Biome.Category.THEEND) {
biome.addFeature(GenerationStep.Feature.UNDERGROUND_ORES, WOOL\_ORE);
}
}
```
遍历代码中使用`biome.getCategory() != Biome.Category.NETHER && biome.getCategory() != Biome.Category.THEEND`判断是否为主世界的生物群系，还可以增加判断以在不同的生物群系生成不同规模的矿簇。快创建世界看下成果吧！使用右侧指令清除石头：`/fill ~-8 0 ~-8 ~8 ~ ~8 minecraft:air replace minecraft:stone`
*Fabric Wiki 效果图*
*****
感谢阅读，编写不易，您的支持是我最大的动力！
