Differences

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

--- zh_cn:tutorial:crops [2021/11/09 11:16] – created breakice
+++ zh_cn:tutorial:crops [2025/04/01 12:05] (current) – fix typo solidblock
@@ Line 1: / Line 1: @@
-====== 添加你的自定义作物 ======
+====== 添加自定义作物 ======
-这篇教程会教会你如何添加一个像是小麦和胡萝卜那样的作物。如果你想创建属于你的作物的话，你需要以下物品:
+本教程将教会您如何添加像小麦和胡萝卜那样的作物。创建自定义的作物时，需要做以下这些事情：
-   * 自定义的种子
+   * 自定义的种子物品
-   * 注册你的种子和作物方块
+   * 作物方块和种子物品的注册表
-   * 作物方块的类
+   * 作物方块类
    * 为你的作物设计的方块状态和模型
 ===== 创建作物类 =====
-为了创建自定义作物我们需要先创建一个方块类。 你需要用你的作物名命名你的类并且让他继承 ''CropBlock''。 你需要添加 ''AbstractBlock.Settings'' 和创建你的作物的形状。 Each ''Block.createCubiodShape'' defines the hitbox size for each growth stage of the crop. You can configure the values to your liking.
+为创建自定义作物，我们需要先创建一个方块类。你需要用你的作物名称命名你的类，并且继承 ''CropBlock''。你还需要添加 ''AbstractBlock.Settings'' 并为作物创建形状。
 <code java [enable_line_numbers="true"]>
 public class CustomCropBlock extends CropBlock {
-    private static final VoxelShape[] AGE_TO_SHAPE = new VoxelShape[]{Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 2.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 3.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 4.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 5.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 6.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 7.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 8.0D, 16.0D),
-            Block.createCuboidShape(0.0D, 0.0D, 0.0D, 16.0D, 9.0D, 16.0D)
-    };
     public CustomCropBlock(AbstractBlock.Settings settings) {
         super(settings);
@@ Line 31: / Line 21: @@
 </code>
-Once you've configured that, you need to define your seed item and add an outline shape. We haven't added our seed item yet so you can use something else temporarily. Here is what the code should look like with your cuboid shape, seed item, and outline shape:
+配置完成后，你需要定义你的种子物品并添加外观形状。每个 ''Block.createCubiodShape'' 都为作物生长的各个阶段定义了碰撞箱的大小。你可以根据自己的喜好进行配置，或者什么也不做，而是直接使用原版继承自 ''CropBlock'' 的，会直接使用和小麦一样的形状。
+我们还没有添加种子物品，因此暂时先使用其他的。下面的代码，使用长方体形状、种子物品和外观形状应该是这样子：
 <code java [enable_line_numbers="true"]>
@@ Line 49: / Line 41: @@
     }
-    public ItemConvertible getSeedsItem() {
+    @Override
-        return TutorialMod.CUSTOM_SEEDS;
+    protected ItemConvertible getSeedsItem() {
+        return TutorialItems.CUSTOM_SEEDS;
     }
-    public VoxelShape getOutlineShape(BlockState state, BlockView world, BlockPos pos, ShapeContext context) {
+    @Override
-        return AGE_TO_SHAPE[(Integer)state.get(this.getAgeProperty())];
+    protected VoxelShape getOutlineShape(BlockState state, BlockView world, BlockPos pos, ShapeContext context) {
+        return AGE_TO_SHAPE[getAge(state)];
     }
 }
 </code>
-===== Registering your Crop and Seed Item =====
+===== 注册你的作物和种子物品 =====
-Now we need to register our crop and the item to use for our seed. The seed model and class will not be covered in this tutorial but you can refer to the [[tutorial:items|Item]] page. It is important you add ''AlisasedBockItem'' to make sure your seed item is bound to your crop block.
+现在需要注册作物和用作种子的物品。种子模型和类（包括为方便而用的静态 ''static'' 方法）本页不作介绍，请参考 [[items]] 和 [[blocks]] 页面。需要注意的是，种子虽然是作物对应的方块物品，但是其名称不是直接使用作物的名称，而是有单独的名称，因此对于 1.21.2 之前的版本使用 ''AliasedBlockItem'' 而非 ''BlockItem''，对于 1.21.2 及之后的版本需要调用 ''useItemPrefixedTranslationKey()''。
-<code java [enable_line_numbers="true"]>
+<code java [enable_line_numbers="true"] TutorialBlocks.java>
-public class TutorialMod implements ModInitializer {
+    // 对于 1.21.2 之前的版本：
+    public static final CropBlock CUSTOM_CROP = register("custom_crop", new CustomCropBlock(AbstractBlock.Settings.create().nonOpaque().noCollision().ticksRandomly().breakInstantly().sounds(BlockSoundGroup.CROP)));
+    // 对于 1.21.2 及之后的版本：
+    public static final Block CUSTOM_CROP = register("custom_crop", CustomCropBlock::new, AbstractBlock.Settings.create().nonOpaque().noCollision().ticksRandomly().breakInstantly().sounds(BlockSoundGroup.CROP));
+</code>
-	public static final CropBlock CUSTOM_CROP_BLOCK = new CustomCropBlock(AbstractBlock.Settings.of(Material.PLANT).nonOpaque().noCollision().ticksRandomly().breakInstantly().sounds(BlockSoundGroup.CROP));
+<code java [enable_line_numbers="true"] TutorialItems.java>
+    // 对于 1.21.2 之前的版本：
+    public static final Item CUSTOM_SEEDS = register("custom_seeds", new AliasedBlockItem(TutorialBlocks.CUSTOM_CROP, new Item.Settings()));
+    // 对于 1.21.2 及之后的版本：
+    public static final Item CUSTOM_SEEDS = register("custom_seeds", settings -> new BlockItem(TutorialBlocks.CUSTOM_CROP, settings), new Item.Settings().useItemPrefixedTranslationKey());
+</code>
-	public static final Item CUSTOM_SEEDS = new AliasedBlockItem(TutorialMod.CUSTOM_CROP_BLOCK, new Item.Settings().group(ItemGroup.MISC));
+> 在[[blocks|添加方块]]教程中，我们写的 ''register'' 方法默认会为每个方块创建一个对应的物品。因此这里会在创建的 ''custom_seeds'' 的同时，还注册了名为 ''custom_crop'' 的物品。如果不需要创建这个物品，可以像这样创建个不注册物品的 ''registerBlockOnly'' 方法，或者给 ''register'' 方法添加个参数以决定是否注册物品。
+> <code java TutorialBlocks.java>
+  // ...
+  public static final Block CUSTOM_CROP = registerBlockOnly("custom_crop", CustomCropBlock::new, AbstractBlock.Settings.create().nonOpaque().noCollision().ticksRandomly().breakInstantly().sounds(BlockSoundGroup.CROP));
+  // ...
+  private static Block registerBlockOnly(String path, Function<AbstractBlock.Settings, Block> factory, AbstractBlock.Settings settings) {
+    final Identifier identifier = Identifier.of("tutorial", path);
+    final RegistryKey<Block> registryKey = RegistryKey.of(RegistryKeys.BLOCK, identifier);
-	@Override
+    return Blocks.register(registryKey, factory, settings);
-	public void onInitialize() {
+  }
-		Registry.register(Registry.BLOCK, new Identifier("tutorial","custom_crop_block"), CUSTOM_CROP_BLOCK);
-		Registry.register(Registry.ITEM, new Identifier("tutorial","custom_seeds"), CUSTOM_SEEDS);
-	}
-}
 </code>
-You also probably want the ''BlockRenderMapLayer'' to give your crop a transparent cutout. Do that in your client initializer:
+你很可能还需要 ''BlockRenderMapLayer''，这样你的作物才会显示为透明裁切的格式（参见 [[blockappearance]]）。在客户端初始化器中：
-<code java [enable_line_numbers="true"]>
+<code java [enable_line_numbers="true"] TutorialModClient.class>
-public class TutorialModClient implements ClientModInitializer {
+@Environment(EnvType.CLIENT)
-       @Override
+public class ExampleModClient implements ClientModInitializer {
-       public void onInitializeClient() {
+    // ...
-               BlockRenderLayerMap.INSTANCE.putBlocks(RenderLayer.getCutout(), CUSTOM_CROP_BLOCK);
-       }
+    @Override
+    public void onInitializeClient() {
+        // ...
+        BlockRenderLayerMap.INSTANCE.putBlocks(RenderLayer.getCutout(), TutorialBlocks.CUSTOM_CROP);
+    }
 }
 </code>
-===== Creating our Blockstate and Models =====
+===== 创建方块状态和模型 =====
-Now that we have finished the registry and code, we can add our models. The example below shows a simple growth stage model that uses the ''minecraft:block/crop'' format. You may also use ''minecraft:block/cross'' for a cross model shape. You **must** have a separate model for each growth stage you will have. This example shows a singular stage but you can copy it and replace the "0" with your growth stage number.
+我们已经完成了注册和代码，现在需要添加模型。下面的例子展示了使用 ''minecraft:block/crop'' 格式的简单生长阶段模型。你也可以使用 ''minecraft:block/cross'' 以使用交叉形的模型。您**必须**为拥有的每个生长阶段创建一个单独的模型。这个例子只呈现了单一的阶段，你可以将“0”替换成对应的生长阶段的数字。
 <code JavaScript src/main/resources/assets/tutorial/models/block/custom_crop_stage0.json>
@@ Line 97: / Line 110: @@
   "parent": "minecraft:block/crop",
   "textures": {
-    "crop": "minecraft:block/custom_crop_block_stage0"
+    "crop": "tutorial:block/custom_crop_stage0"
   }
 }
 </code>
-Lastly you will want to create a blockstate for your crop which registers your model for each age of your crop:
+最后，您还需要为您的作物创建方块状态映射，以给作物的每个生长阶段都分配单独的模型。
-<code JavaScript src/main/resources/assets/tutorial/blockstates/custom_crop_block.json>
+<code JavaScript src/main/resources/assets/tutorial/blockstates/custom_crop.json>
 {
   "variants": {
     "age=0": {
-      "model": "tutorial:block/custom_crop_block_stage0"
+      "model": "tutorial:block/custom_crop_stage0"
     },
     "age=1": {
-      "model": "tutorial:block/custom_crop_block_stage0"
+      "model": "tutorial:block/custom_crop_stage0"
     },
     "age=2": {
-      "model": "tutorial:block/custom_crop_block_stage1"
+      "model": "tutorial:block/custom_crop_stage1"
     },
     "age=3": {
-      "model": "tutorial:block/custom_crop_block_stage1"
+      "model": "tutorial:block/custom_crop_stage1"
     },
     "age=4": {
-      "model": "tutorial:block/custom_crop_block_stage2"
+      "model": "tutorial:block/custom_crop_stage2"
     },
     "age=5": {
-      "model": "tutorial:block/custom_crop_block_stage2"
+      "model": "tutorial:block/custom_crop_stage2"
     },
     "age=6": {
-      "model": "tutorial:block/custom_crop_block_stage3"
+      "model": "tutorial:block/custom_crop_stage3"
     },
     "age=7": {
-      "model": "tutorial:block/custom_crop_block_stage3"
+      "model": "tutorial:block/custom_crop_stage3"
     }
   }
@@ Line 135: / Line 148: @@
 </code>
-===== Crop Block Finished! =====
+> 种子物品也需要对应的物品模型和物品模型映射（对于 1.21.4 及之后的版本），具体做法参见 [[items]]，这里不作详细描述。
+===== 战利品表 =====
+方块还需要战利品表，否则被破坏后什么也不会掉落。不过，你可以直接模仿原版的。例如，复制原版的 ''data/minecraft/loot_table/blocks/wheat.json'' 到你模组的 ''src/main/resources/data/tutorial/loot_table/blocks/custom_crop.json'' 并替换相关的 ID。也可以使用[[datagen loot|数据生成器]]生成战利品表。
+===== 大功告成！ =====
-If you completed all parts of this tutorial correctly, you should now have a working crop! Your crop will be usable with bone meal and can only be placed on farmland with your seed item.
+如果你正确完成了本教程的所有部分，那么你现在就应该有一个生效的作物了！这个作物可以用骨粉催熟，并且只能用种子物品放置在耕地上。