地物生成

前置知识

请先确保你已经完成了数据生成设置流程。

Minecraft 世界中的地物生成可分为 3 个部分：

• 已配置地物：定义地物是什么；例如，一棵单独的树
• 已放置地物：定义地物应如何分布，包括方向、相对位置等；例如，森林中树木的分布方式
• 生物群系修改：定义地物会被放置在世界中的什么位置；例如，整片森林所在的坐标范围

INFO

Minecraft 中的地物是世界中的自然或生成图案，例如树木、花、矿石或湖泊。 地物不同于结构（例如村庄、神殿等），后者可以通过 /locate 命令查找。

设置

首先，我们需要创建自己的 provider。 创建一个继承 FabricDynamicRegistryProvider 的类，并补全基础方法：

public class ExampleModWorldgenProvider extends FabricDynamicRegistryProvider {
	public ExampleModWorldgenProvider(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registriesFuture) {
		super(output, registriesFuture);
	}

	@Override
	protected void configure(HolderLookup.Provider registries, Entries entries) {
	}

	@Override
	public String getName() {
		return "";
	}
}

然后，在你的 DataGeneratorEntrypoint 类的 onInitializeDataGenerator 方法中添加该 provider：

接下来，为已配置地物和已放置地物分别创建一个类。 这些类不需要继承任何内容。

已配置地物类和已放置地物类都应包含一个公共方法，用于注册并定义你的地物。 该方法的参数（这里我们将其命名为 context）对于已配置地物应为 BootstrapContext<ConfiguredFeature<?, ?>>，对于已放置地物则应为 BootstrapContext<PlacedFeature>。

在你的 DataGeneratorEntrypoint 类中，将下面的代码行添加到 buildRegistry 方法中，并将方法名替换为你自己选择的名称：

registryBuilder.add(Registries.CONFIGURED_FEATURE, ExampleModWorldConfiguredFeatures::configure);
registryBuilder.add(Registries.PLACED_FEATURE, ExampleModWorldPlacedFeatures::configure);

如果你还没有 buildRegistry 方法，请创建它，并使用 @Override 注解标注。

已配置地物

若要让一个地物自然生成在世界中，我们应先在已配置地物类中定义一个已配置地物。 这里我们添加一个用于钻石矿脉的自定义已配置地物。

首先，在你的已配置地物类中注册 ConfiguredFeature 的键：

public static final ResourceKey<ConfiguredFeature<?, ?>> DIAMOND_BLOCK_VEIN_CONFIGURED_KEY =
		ResourceKey.create(
			Registries.CONFIGURED_FEATURE,
			Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "diamond_block_vein")
		);

TIP

Identifier 的第二个参数（在本例中为 diamond_block_vein）就是你通过 /place 命令生成该结构时使用的名称，这对于调试很有帮助。

矿石

接下来，我们会创建一个 RuleTest，用于控制你的地物可以替换哪些方块。 例如，下面这个 RuleTest 允许替换带有 DEEPSLATE_ORE_REPLACEABLES 标签的所有方块：

RuleTest deepslateReplaceableRule = new TagMatchTest(BlockTags.DEEPSLATE_ORE_REPLACEABLES);

接下来，我们需要创建 OreConfiguration，它会告诉游戏应将方块替换成什么。

List<OreConfiguration.TargetBlockState> diamondBlockOreConfig =
		List.of(
				OreConfiguration.target(deepslateReplaceableRule, Blocks.DIAMOND_BLOCK.defaultBlockState())
		);

你可以在列表中加入多个情况，以支持不同变体。 例如，我们可以为普通石头和深板岩设置不同的变体：

List<OreConfiguration.TargetBlockState> ironAndDiamondBlockOreConfig =
		List.of(
				OreConfiguration.target(deepslateReplaceableRule, Blocks.DIAMOND_BLOCK.defaultBlockState()),
				OreConfiguration.target(stoneReplaceableRule, Blocks.IRON_BLOCK.defaultBlockState())
		);

最后，我们需要将已配置地物注册到游戏中！

context.register(
		DIAMOND_BLOCK_VEIN_CONFIGURED_KEY,
		new ConfiguredFeature<>(
			Feature.ORE,
			new OreConfiguration(diamondBlockOreConfig, 10)) // 10 is the blocks per vein
);

树木

若要创建自定义树木，首先需要创建一个 TreeConfiguration：

TreeConfiguration diamondTree = new TreeConfiguration.TreeConfigurationBuilder(
		// Trunk / Logs
		BlockStateProvider.simple(Blocks.DIAMOND_BLOCK),
		new StraightTrunkPlacer(4, 2, 0),
		// Leaves
		BlockStateProvider.simple(Blocks.GOLD_BLOCK),
		new BlobFoliagePlacer(ConstantInt.of(2), ConstantInt.of(0), 3),

		new TwoLayersFeatureSize(0, 0, 0)
).build();

各参数的含义如下：

1. 指定树干的方块类型；例如钻石块
2. 使用树干放置器配置树干的形状和高度行为
3. 指定树叶的方块类型；例如金块
4. 使用树叶放置器定义树冠的形状和大小
5. 控制树干在不同高度处如何收束，主要用于较大的树干

TIP

我们强烈建议你自行调整这些值，制作出让你满意的自定义树木！

你可以参考原版树木中内置的树干放置器和树叶放置器。

接下来，我们需要在 ExampleModWorldConfiguredFeatures 的 configure 方法中添加以下代码行，以注册我们的树木：

context.register(DIAMOND_TREE_CONFIGURED_KEY, new ConfiguredFeature<>(Feature.TREE, diamondTree));

已放置地物

向游戏添加地物的下一步，是创建它的已放置地物。

在你的已放置地物类的 configure 方法中，创建如下变量：

HolderGetter<ConfiguredFeature<?, ?>> configuredFeatures = context.lookup(Registries.CONFIGURED_FEATURE);

在你的已放置地物类中，定义已放置地物的键。

public static final ResourceKey<PlacedFeature> DIAMOND_BLOCK_ORE_PLACED_KEY =
		ResourceKey.create(
			Registries.PLACED_FEATURE,
			Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "diamond_block_ore_placed")
		);

放置修饰器

接下来，我们需要定义放置修饰器。它们是在生成地物时设置的属性， 可以是任意内容：从生成频率，到起始 y 层级都可以。 你可以按需要设置任意数量的修饰器。

List<PlacementModifier> diamondBlockVeinModifiers = List.of(
		CountPlacement.of(6),
			BiomeFilter.biome(),
			InSquarePlacement.spread(),
		HeightRangePlacement.of(BiasedToBottomHeight.of(VerticalAnchor.BOTTOM, VerticalAnchor.absolute(0), 3))
);

上面列出的各修饰器作用如下：

• CountPlacement：大致表示每个区块中该地物实例的数量；在本例中即矿脉数量
• BiomeFilter：允许我们控制该地物会在哪些生物群系或维度中生成；稍后我们会进一步使用它
• InSquarePlacement：使地物以更接近伪随机的方式分散分布
• HeightRangePlacement：指定地物可生成的 y 坐标范围；它支持三种主要分布类型：

  1. Uniform： 范围内所有 y 值生成该地物的概率相同。 如果你不确定该用哪种，就使用这一种。

  2. Trapezoid： 越接近中位 y 值的位置，生成该地物的概率越高。

  3. Biased-Bottom： 使用对数尺度，使较低的 y 值更容易生成该地物。 它接收一个起始 y 坐标，低于该坐标时地物绝不会生成。 第二个参数是地物可以生成的最大高度。 第三个参数定义一个以方块为单位的范围，用于延伸最大概率区间。

TIP

树木和其他地表结构应使用 PlacedFeatures.WORLD_SURFACE_WG_HEIGHTMAP 修饰器，而不是 HeightRangePlacement，以确保树木生成在地表上。

现在我们已经有了修饰器，可以注册已放置地物了：

context.register(
		DIAMOND_BLOCK_ORE_PLACED_KEY,
		new PlacedFeature(
			configuredFeatures.getOrThrow(ExampleModWorldConfiguredFeatures.DIAMOND_BLOCK_VEIN_CONFIGURED_KEY),
			diamondBlockVeinModifiers
		)
);

生物群系修改

最后，我们需要在模组初始化期间将已放置地物添加到 BiomeModifications 中。 可以在模组初始化器中添加以下代码：

// Spawns everywhere in the overworld
BiomeModifications.addFeature(
		BiomeSelectors.foundInOverworld(),
		GenerationStep.Decoration.UNDERGROUND_ORES,
		ExampleModWorldPlacedFeatures.DIAMOND_BLOCK_ORE_PLACED_KEY
);

TIP

对于树木，第二个参数应设置为 GenerationStep.Decoration.VEGETAL_DECORATION,

指定生物群系生成

通过修改 BiomeSelectors 参数，可以让地物只在特定类型的生物群系中生成：

// Spawns in forest biomes only
BiomeModifications.addFeature(
		BiomeSelectors.tag(BiomeTags.IS_FOREST),
		GenerationStep.Decoration.VEGETAL_DECORATION,
		ExampleModWorldPlacedFeatures.DIAMOND_TREE_PLACED_KEY
);

这样，该地物只会生成在带有 minecraft:is_forest 生物群系标签的生物群系中。

运行数据生成

现在运行数据生成后，对于你添加的每个已配置地物，都应能在 src/main/generated/data/example-mod/worldgen/configured_feature 下看到一个 .json 文件；对于每个已放置地物，也应能在 src/main/generated/data/example-mod/worldgen/placed_feature 下看到对应文件！

已配置地物生成文件

{
  "type": "minecraft:ore",
  "config": {
    "discard_chance_on_air_exposure": 0.0,
    "size": 10,
    "targets": [
      {
        "state": {
          "Name": "minecraft:diamond_block"
        },
        "target": {
          "predicate_type": "minecraft:tag_match",
          "tag": "minecraft:deepslate_ore_replaceables"
        }
      }
    ]
  }
}

已放置地物生成文件

{
  "feature": "example-mod:diamond_block_vein",
  "placement": [
    {
      "type": "minecraft:count",
      "count": 6
    },
    {
      "type": "minecraft:biome"
    },
    {
      "type": "minecraft:in_square"
    },
    {
      "type": "minecraft:height_range",
      "height": {
        "type": "minecraft:biased_to_bottom",
        "inner": 3,
        "max_inclusive": {
          "absolute": 0
        },
        "min_inclusive": {
          "above_bottom": 0
        }
      }
    }
  ]
}