Differences

This shows you the differences between two versions of the page.

--- zh_cn:tutorial:ores [2020/01/08 11:56] – created lightcolour
+++ zh_cn:tutorial:ores [2022/08/18 03:25] – solidblock
@@ Line 1: / Line 1: @@
-====== 在世界中添加矿石 ======
+====== 生成自定义的矿石（1.18.2） ======
-许多mod会添加自己的矿石，您需要一种将它们放置在现有生物群系中以便玩家寻找的方法。 在本教程中，我们将研究将矿石添加到现有生物群系以及其他mod添加的生物群系。 将矿石添加到生物群系需要执行2个步骤。
+许多模组会添加自己的矿石，您需要找到一种方法以将其放置在现有生物群系中让玩家寻找。在本教程中，我们将研究将矿石添加到现有生物群系以及其他模组添加的生物群系。将矿石添加到生物群系需要2个步骤。
-   *遍历生物群系注册表以将您的矿石添加到现有生物群系中。
+  * 制作一个 ConfiguredFeature（已配置的地物），定义你的矿石方块如何生成。
-   *使用RegistryEntryAddedCallback以确保您的矿石被添加到mod添加的任何生物群系中。
+  * 使用 [[https://github.com/FabricMC/fabric/pull/1097|Fabric API 中的 Biome Modification API]]以将地物添加到生物群系。
-我们假设您此时已经创建了自己的矿石。 石英矿石将替代我们，我们的目标是在整个世界生物群系中生成它。 适当时用您的矿石替换对石英矿石的引用。
+注意 Biome Modification API 仍是实验性的。如果 API 不起作用，考虑 [[?rev=1599388827|mixin 版本]]。
-==== 在群系中添加矿石 ====
+我们假设您此时已经创建了自己的矿石。本教程中，我们使用羊毛方块进行替换。你可以适时将羊毛改成你自己的矿石。
+==== 添加到主世界生物群系 ====
+本段落将会在主世界生成矿石。
-首先，我们需要创建一种方法来处理生物群系，检查其是否为有效的生物群系，然后添加矿石。
+我们需要创建一个已配置的地物，确保在 ''onInitialize'' 中注册你的已配置的地物，你可以自由地改变一些值以适应你的模组。
-<code java [enable_line_numbers="true"]>
-private void handleBiome(Biome biome) {
+<code java>
-	if(biome.getCategory() != Biome.Category.NETHER && biome.getCategory() != Biome.Category.THEEND) {
+public class ExampleMod implements ModInitializer {
-		biome.addFeature(
+  private static ConfiguredFeature<?, ?> OVERWORLD_WOOL_ORE_CONFIGURED_FEATURE = new ConfiguredFeature
-        	    GenerationStep.Feature.UNDERGROUND_ORES,
+      (Feature.ORE, new OreFeatureConfig(
-        	    Biome.configureFeature(
+          OreConfiguredFeatures.STONE_ORE_REPLACEABLES,
-        	        Feature.ORE,
+          Blocks.WHITE_WOOL.getDefaultState(),
-        		new OreFeatureConfig(
+)); // 矿脉大小
-        			OreFeatureConfig.Target.NATURAL_STONE,
-        			Blocks.NETHER_QUARTZ_ORE.getDefaultState(),
+  public static PlacedFeature OVERWORLD_WOOL_ORE_PLACED_FEATURE = new PlacedFeature(
- //Ore vein size
+      RegistryEntry.of(OVERWORLD_WOOL_ORE_CONFIGURED_FEATURE),
-        		),
+      Arrays.asList(
-        	        Decorator.COUNT_RANGE,
+          CountPlacementModifier.of(20), // 每个区块的矿脉数量
-        		new RangeDecoratorConfig(
+          SquarePlacementModifier.of(), // 水平传播
-, //Number of veins per chunk
+          HeightRangePlacementModifier.uniform(YOffset.getBottom(), YOffset.fixed(64))
-, //Bottom Offset
+      )); // 高度
-, //Min y level
-//Max y level
+  @Override
-        		)));
+  public void onInitialize() {
-	}
+    Registry.register(BuiltinRegistries.CONFIGURED_FEATURE,
+        new Identifier("tutorial", "overworld_wool_ore"), OVERWORLD_WOOL_ORE_CONFIGURED_FEATURE);
+    Registry.register(BuiltinRegistries.PLACED_FEATURE, new Identifier("tutorial", "overworld_wool_ore"),
+        OVERWORLD_WOOL_ORE_PLACED_FEATURE);
+    BiomeModifications.addFeature(BiomeSelectors.foundInOverworld(), GenerationStep.Feature.UNDERGROUND_ORES,
+        RegistryKey.of(Registry.PLACED_FEATURE_KEY,
+            new Identifier("tutorial", "overworld_wool_ore")));
+  }
 }
 </code>
-此方法通过提供的生成设置将您的矿石添加到整个世界。 随意更改值以适合您的mod。
+=== 结果 ===
+检查你的世界生成结果时，记得要创建新世界。你应该看见羊毛在主世界生成了。你可以使用下面的命令移除周围的石头方块。
+<code>
+/fill ~-8 0 ~-8 ~8 ~ ~8 minecraft:air replace minecraft:stone
+</code>
-==== 迭代生物群系注册表 ====
+{{tutorial:ores.png?800}}
-接下来，我们需要处理已注册的所有生物群系以及将来将要注册的所有生物群落（由其他模块添加）。 我们首先遍历当前注册表，然后注册一个侦听器，以供将来添加。
+==== 添加到下界生物群系 ====
+本段落将会基于前面的段落添加矿石到下界生物群系。
-<code java [enable_line_numbers="true"]>
+在下界，需要替换的方块和主世界地不同，所以需要把 ''OreConfiguredFeatures.STONE_ORE_REPLACEABLES'' 替换成 ''OreConfiguredFeatures.NETHERRACK''。
-@Override
-public void onInitialize() {
-	//Loop over existing biomes
-	Registry.BIOME.forEach(this::handleBiome);
-	//Listen for other biomes being registered
+<code java>
-	RegistryEntryAddedCallback.event(Registry.BIOME).register((i, identifier, biome) -> handleBiome(biome));
+public class ExampleMod implements ModInitializer {
+  private static ConfiguredFeature<?, ?> NETHER_WOOL_ORE_CONFIGURED_FEATURE = new ConfiguredFeature
+      (Feature.ORE, new OreFeatureConfig(
+          OreConfiguredFeatures.NETHERRACK, // 我们这里使用 OreConfiguredFeatures.NETHERRACK
+          Blocks.WHITE_WOOL.getDefaultState(),
+));
+  public static PlacedFeature NETHER_WOOL_ORE_PLACED_FEATURE = new PlacedFeature(
+      RegistryEntry.of(NETHER_WOOL_ORE_CONFIGURED_FEATURE),
+      Arrays.asList(
+          CountPlacementModifier.of(20),
+          SquarePlacementModifier.of(),
+          HeightRangePlacementModifier.uniform(YOffset.getBottom(), YOffset.fixed(64))));
+  @Override
+  public void onInitialize() {
+    Registry.register(BuiltinRegistries.CONFIGURED_FEATURE,
+        new Identifier("tutorial", "nether_wool_ore"), NETHER_WOOL_ORE_CONFIGURED_FEATURE);
+    Registry.register(BuiltinRegistries.PLACED_FEATURE, new Identifier("tutorial", "nether_wool_ore"),
+        NETHER_WOOL_ORE_PLACED_FEATURE);
+    BiomeModifications.addFeature(BiomeSelectors.foundInTheNether(), GenerationStep.Feature.UNDERGROUND_ORES,
+        RegistryKey.of(Registry.PLACED_FEATURE_KEY,
+            new Identifier("tutorial", "nether_wool_ore")));
+  }
 }
 </code>
-==== 结论 ====
+==== 添加到末地生物群系 ====
-您应该会在整个世界中看到石英矿石的生成:
+本段落将会基于主世界的代码添加矿石到末地生物群系。
+在末地，基础方块是末地石，所以需要把 ''OreConfiguredFeatures.STONE_ORE_REPLACEABLES'' 替换成 ''new BlockMatchRuleTest(Blocks.END_STONE)''。
+<code java>
+public class ExampleMod implements ModInitializer {
+  private static ConfiguredFeature<?, ?> END_WOOL_ORE_CONFIGURED_FEATURE = new ConfiguredFeature
+      (Feature.ORE, new OreFeatureConfig(
+          new BlockMatchRuleTest(Blocks.END_STONE), // 我们这里使用 new BlockMatchRuleTest(Blocks.END_STONE)
+          Blocks.WHITE_WOOL.getDefaultState(),
+));
+  public static PlacedFeature END_WOOL_ORE_PLACED_FEATURE = new PlacedFeature(
+      RegistryEntry.of(END_WOOL_ORE_CONFIGURED_FEATURE),
+      Arrays.asList(
+          CountPlacementModifier.of(20),
+          SquarePlacementModifier.of(),
+          HeightRangePlacementModifier.uniform(YOffset.getBottom(), YOffset.fixed(64))));
+  @Override
+  public void onInitialize() {
+    Registry.register(BuiltinRegistries.CONFIGURED_FEATURE,
+        new Identifier("tutorial", "end_wool_ore"), END_WOOL_ORE_CONFIGURED_FEATURE);
+    Registry.register(BuiltinRegistries.PLACED_FEATURE, new Identifier("tutorial", "end_wool_ore"),
+        END_WOOL_ORE_PLACED_FEATURE);
+    BiomeModifications.addFeature(BiomeSelectors.foundInTheEnd(), GenerationStep.Feature.UNDERGROUND_ORES,
+        RegistryKey.of(Registry.PLACED_FEATURE_KEY,
+            new Identifier("tutorial", "end_wool_ore")));
+  }
+}
+</code>
-{{https://i.imgur.com/UemsMaI.png|Quartz Ores}}