Differences

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

--- zh_cn:tutorial:structures [2021/07/24 16:22] – 拒绝机翻，从我做起！ solidblock
+++ zh_cn:tutorial:structures [2022/09/29 05:27] (current) – 已过时 solidblock
@@ Line 1: / Line 1: @@
-====== 添加结构特征 [1.16.3] ======
-现在，往世界中注册并放置一些结构。
-入药查看原版结构的实例，可以从简单的''IglooFeature''和'IglooGenerator''开始。然而，制作新结构的上升的标准是使用拼图结构，这样更易于使用并可以让你少打一些代码。[[zh_cn:tutorial:jigsaw|这里有关于拼图结构和制作方法的教程。]]
-对于大多数基本的结构，你需要地物（feature）和生成器（generator）。地物处理注册结构并在生成世界时加载的过程。生成器处理方块的放置，或者在结构文件中加载（如果选择这样做）。
-注意本教程依赖标记为实验性的[[https://github.com/FabricMC/fabric/pull/1097|Fabric API中的生物群系修改API]]。如果API不起作用，考虑使用[[?rev=1599808070|mixin版本]]。
-==== 创建特征 ====
-要创建基本功能，我们建议创建一个扩展AbstractTempleFeature <DefaultFeatureConfig>的类。 海难，雪屋和神殿等各种原版结构都使用AbstractTempleFeature作为基础。 您将必须重写以下方法：
-   * shouldStartAt：出于测试目的，返回true。
-   * getName：您的结构的名称
-   * getRadius：结构的半径，用于放置
-   * getSeeedModifier
-您可以将DefaultFeatureConfig :: deserialize传递给构造函数进行测试。
-对于getStructureStartFactory，大多数原始结构会创建一个在其Feature类中扩展StructureStart的类：
-<code java [enable_line_numbers="true"]>
-public static class MyStructureStart extends StructureStart {
-    public MyStructureStart (StructureFeature<?> structureFeature_1, int int_1, int int_2, Biome biome_1, MutableIntBoundingBox mutableIntBoundingBox_1, int int_3, long long_1) {
-        super(structureFeature_1, int_1, int_2, biome_1, mutableIntBoundingBox_1, int_3, long_1);
-    }
-    @Override
-    public void initialize(ChunkGenerator<?> chunkGenerator, StructureManager structureManager, int chunkX, int chunkZ, Biome biome) {
-        DefaultFeatureConfig defaultFeatureConfig = chunkGenerator.getStructureConfig(biome, MyMainclass.myFeature);
-        int x = chunkX * 16;
-        int z = chunkZ * 16;
-        BlockPos startingPos = new BlockPos(x, 0, z);
-        Rotation rotation = Rotation.values()[this.random.nextInt(Rotation.values().length)];
-        MyGenerator.addParts(structureManager, startingPos, rotation, this.children, this.random, defaultFeatureConfig);
-        this.setBoundingBoxFromChildren();
-    }
-}
-</code>
-当世界尝试以新结构生成时，这称为“要素”和“生成器”之间的差距。 在您的主类中对该变量的引用尚不存在，但我们将在最后创建它。 您也可以将配置设置为等于新的DefaultFeatureConfig。 您可以在getStructureStartFactory中使用返回MyStructureStart :: new返回此函数。
-这是结构文件和直接从generate方法生成的部分方式。 有两种解决方法：
-   *如果需要，您可以简单地在Feature类中重写generate，并使用setBlockState将块直接放置在世界上。 这是一个有效的选项，在1.13之前很流行。
-   *使用结构文件和生成器。 在这一点上，这些功能非常强大，因此强烈建议使用。
-==== 创建一个生成器 ====
-您可能已经注意到，我们需要创建一个生成器。 我们将其命名为MyGenerator，并在StructureStart类的initialize方法中对其进行引用。 它不需要覆盖任何内容，但需要满足以下条件：
-*指向您的结构文件的标识符； 如果需要示例，请使用''igloo / top''。
-   *某种安装方法-addParts是一个好名字：
-<code java>
-public static void addParts(StructureManager structureManager_1, BlockPos blockPos_1, Rotation rotation_1,
-    List<StructurePiece> list_1, Random random_1, DefaultFeatureConfig featureConfig)
-}
-</code>
-在addParts方法中，您可以选择将哪些结构件添加到生成过程中。 您可以添加如下内容：
-<code java>
-list_1.add(new MyGenerator.Piece(structureManager_1, identifier, blockPos, rotation_1));
-</code>
-标识符是我们最近创建的路径。
-现在，我们将创建我们刚刚引用的作品； 创建一个名为Piece的类，该类扩展了SimpleStructurePiece//在您的生成器类中//.
-覆盖必需的方法，并添加一个接受StructureManager，Identifier，BlockPos和Rotation的构造函数。 ** toNbt不是必需的，但在需要时可用**。 我们还将使用不同的参数实现自己的setStructureData，因此它不是替代。 我们还有2个构造函数：1个构造函数，一个构造函数。 一个基本的模板是：
-<code java [enable_line_numbers="true"]>
-public static class Piece extends SimpleStructurePiece {
-    private Rotation rotation;
-    private Identifier template;
-    public Piece(StructureManager structureManager_1, Identifier identifier_1, BlockPos blockPos_1, Rotation rotation_1) {
-        super(MyModClass.myStructurePieceType, 0);
-        this.pos = blockPos_1;
-        this.rotation = rotation_1;
-        this.template = identifier_1;
-        this.setStructureData(structureManager_1);
-    }
-    public Piece(StructureManager structureManager_1, CompoundTag compoundTag_1) {
-        super(MyModClass.myStructurePieceType, compoundTag_1);
-        this.identifier = new Identifier(compoundTag_1.getString("Template"));
-        this.rotation = Rotation.valueOf(compoundTag_1.getString("Rot"));
-        this.setStructureData(structureManager_1);
-    }
-    @Override
-    protected void toNbt(CompoundTag compoundTag_1) {
-        super.toNbt(compoundTag_1);
-        compoundTag_1.putString("Template", this.template.toString());
-        compoundTag_1.putString("Rot", this.rotation.name());
-    }
-    public void setStructureData(StructureManager structureManager) {
-        Structure structure_1 = structureManager.getStructureOrBlank(this.identifier);
-        StructurePlacementData structurePlacementData_1 = (new StructurePlacementData()).setRotation(this.rotation).setMirrored(Mirror.NONE).setPosition(pos).addProcessor(BlockIgnoreStructureProcessor.IGNORE_STRUCTURE_BLOCKS);
-        this.setStructureData(structure_1, this.pos, structurePlacementData_1);
-    }
-    @Override
-    protected void handleMetadata(String string_1, BlockPos blockPos_1, IWorld iWorld_1, Random random_1, MutableIntBoundingBox mutableIntBoundingBox_1) {
-    }
-    @Override
-    public boolean generate(IWorld iWorld_1, Random random_1, MutableIntBoundingBox mutableIntBoundingBox_1, ChunkPos chunkPos_1) {
-    }
-}
-</code>
-handleMetadata是查看结构中的数据块并根据发现的内容执行任务的地方。 在原版结构中，数据块放置在箱子上方，因此可以用这种方法将它们填满战利品。
-我们将StructurePieceType设置为MyModClass.myStructurePiece类型； 这是保存您注册的结构件的变量。 在完成generate函数之后，我们将对其进行处理，该函数将设置结构的位置并生成它：
-<code java [enable_line_numbers="true"]>
-@Override
-public boolean generate(IWorld iWorld_1, Random random_1, MutableIntBoundingBox mutableIntBoundingBox_1, ChunkPos chunkPos_1) {
-    int yHeight = iWorld_1.getTop(Heightmap.Type.WORLD_SURFACE_WG, this.pos.getX() + 8, this.pos.getZ() + 8);
-    this.pos = this.pos.add(0, yHeight - 1, 0);
-    return super.generate(iWorld_1, random_1, mutableIntBoundingBox_1, chunkPos_1);
-}
-</code>
-在这种情况下，我们仅获取块中间最高块的y位置，并从该位置生成结构。
-==== 注册功能 ====
-最后一步是注册我们的功能。 我们需要注册:
-  * StructurePieceType
-  * StructureFeature<DefaultFeatureConfig>
-  * StructureFeature<?>
-我们还需要将结构添加到“结构”列表中，并将其添加到每个生物群系中，作为功能部件和生成步骤。
-注册件类型：
-<code java>
-public static final StructurePieceType myStructurePieceType = Registry.register(Registry.STRUCTURE_PIECE, "my_piece", MyGenerator.Piece::new);
-</code>
-注册功能:
-<code java>
-public static final StructureFeature<DefaultFeatureConfig> myFeature = Registry.register(Registry.FEATURE, "my_feature", new MyFeature());
-</code>
-注册结构:
-<code java>
-public static final StructureFeature<?> myStructure = Registry.register(Registry.STRUCTURE_FEATURE, "my_structure", myFeature);
-</code>
-要将功能放入功能列表，可以使用：
-<code java>
-Feature.STRUCTURES.put("My Awesome Feature", myFeature);
-</code>
-对于测试，将功能注册到每个生物群系并将生成率设置为100％是个好主意，这样您就可以确保其生成并正常工作。 您可能不希望您的结构漂浮在水中，因此我们也将其过滤掉。 通过遍历生物群系列表并将其添加为特征和生成步骤，将其添加到每个生物群系：
-<code java [enable_line_numbers="true"]>
-for(Biome biome : Registry.BIOME) {
-    if(biome.getCategory() != Biome.Category.OCEAN && biome.getCategory() != Biome.Category.RIVER) {
-        biome.addStructureFeature(myFeature, new DefaultFeatureConfig());
-        biome.addFeature(GenerationStep.Feature.SURFACE_STRUCTURES, Biome.configureFeature(myFeature, new DefaultFeatureConfig(), Decorator.CHANCE_PASSTHROUGH, new ChanceDecoratorConfig(0)));
-    }
-}
-</code>
-ChanceDecoratorConfig的参数基本上是在生成之前将跳过多少个块。 0是每个块，1是彼此，并且100是每100。
-您需要将结构添加为特征，以便您的生物群系知道其存在，然后作为生成步骤，以使其实际生成。
-加载到您的世界中，如果一切顺利，应该会遇到//很多//的雪屋。