Fabric Wiki

User Tools

Site Tools

Trace:
zh_cn:tutorial:crops

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
zh_cn:tutorial:crops [2022/12/16 02:44] – solidblockzh_cn:tutorial:crops [2025/04/01 12:05] (current) – fix typo solidblock
Line 10: Line 10:
 ===== 创建作物类 ===== ===== 创建作物类 =====
  
-为创建自定义作物，我们需要先创建一个方块类。你需要用你的作物名称命名你的类，并且继承 ''CropBlock''。你还需要添加 ''AbstractBlock.Settings'' 并为作物创建形状。每个 ''Block.createCubiodShape'' 都定义了作物在各生长阶段的碰撞箱大小。你可以根据自己的喜好来配置这些值。+为创建自定义作物，我们需要先创建一个方块类。你需要用你的作物名称命名你的类，并且继承 ''CropBlock''。你还需要添加 ''AbstractBlock.Settings'' 并为作物创建形状。
  
 <code java [enable_line_numbers="true"]> <code java [enable_line_numbers="true"]>
 public class CustomCropBlock extends CropBlock { 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) {     public CustomCropBlock(AbstractBlock.Settings settings) {
         super(settings);         super(settings);
Line 31: Line 21:
 </code> </code>
  
-配置完成后，你需要定义你的种子物品并添加外观性状。我们还没有添加种子物品，因此暂时先使用其他的。下面的代码，使用长方体形状、种子物品和外观形状应该是这样子：+配置完成后，你需要定义你的种子物品并添加外观形状。每个 ''Block.createCubiodShape'' 都为作物生长的各个阶段定义了碰撞箱的大小。你可以根据自己的喜好进行配置，或者什么也不做，而是直接使用原版继承自 ''CropBlock'' 的，会直接使用和小麦一样的形状。 
 + 
 +我们还没有添加种子物品，因此暂时先使用其他的。下面的代码，使用长方体形状、种子物品和外观形状应该是这样子：
  
 <code java [enable_line_numbers="true"]> <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> </code>
  
-===== 注册您的作为和种子物品 =====+===== 注册你的作物和种子物品 =====
  
-现在需要注册作物和用作种子的物品。本教程不介绍种子模型和类，请参考 [[items]] 页面。特别要注意，要添加 ''AliasedBlockItem'' 以确保您的种子物品绑定到作物方块上。+现在需要注册作物和用作种子的物品。种子模型和类（包括为方便而用的静态 ''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(Registries.BLOCK, new Identifier("tutorial","custom_crop_block"), CUSTOM_CROP_BLOCK); +
- Registry.register(Registries.ITEM, new Identifier("tutorial","custom_seeds"), CUSTOM_SEEDS); +
- +
- } +
-}+
 </code> </code>
  
-你很可能还需要 ''BlockRenderMapLayer''，这样你的作物才会显示为透明裁切的格式。在客户端初始化器中：+你很可能还需要 ''BlockRenderMapLayer''，这样你的作物才会显示为透明裁切的格式（参见 [[blockappearance]]）。在客户端初始化器中：
  
-<code java [enable_line_numbers="true"]>+<code java [enable_line_numbers="true"] TutorialModClient.class>
 @Environment(EnvType.CLIENT) @Environment(EnvType.CLIENT)
-public class TutorialModClient implements ClientModInitializer { +public class ExampleModClient implements ClientModInitializer { 
-       @Override +    // ... 
-       public void onInitializeClient() { +     
-               BlockRenderLayerMap.INSTANCE.putBlocks(RenderLayer.getCutout(), CUSTOM_CROP_BLOCK); +    @Override 
-       }+    public void onInitializeClient() { 
 +        // ... 
 +        BlockRenderLayerMap.INSTANCE.putBlocks(RenderLayer.getCutout(), TutorialBlocks.CUSTOM_CROP); 
 +    }
 } }
 </code> </code>
Line 98: Line 110:
   "parent": "minecraft:block/crop",   "parent": "minecraft:block/crop",
   "textures": {   "textures": {
-    "crop": "minecraft:block/custom_crop_block_stage0"+    "crop": "tutorial:block/custom_crop_stage0"
   }   }
 } }
 </code> </code>
  
-最后，您还需要为您的作物创建方块状态，以给作物的每个生长阶段都注册单独的模型。+最后，您还需要为您的作物创建方块状态映射，以给作物的每个生长阶段都分配单独的模型。
  
-<code JavaScript src/main/resources/assets/tutorial/blockstates/custom_crop_block.json>+<code JavaScript src/main/resources/assets/tutorial/blockstates/custom_crop.json>
 { {
   "variants": {   "variants": {
     "age=0": {     "age=0": {
-      "model": "tutorial:block/custom_crop_block_stage0"+      "model": "tutorial:block/custom_crop_stage0"
     },     },
     "age=1": {     "age=1": {
-      "model": "tutorial:block/custom_crop_block_stage0"+      "model": "tutorial:block/custom_crop_stage0"
     },     },
     "age=2": {     "age=2": {
-      "model": "tutorial:block/custom_crop_block_stage1"+      "model": "tutorial:block/custom_crop_stage1"
     },     },
     "age=3": {     "age=3": {
-      "model": "tutorial:block/custom_crop_block_stage1"+      "model": "tutorial:block/custom_crop_stage1"
     },     },
     "age=4": {     "age=4": {
-      "model": "tutorial:block/custom_crop_block_stage2"+      "model": "tutorial:block/custom_crop_stage2"
     },     },
     "age=5": {     "age=5": {
-      "model": "tutorial:block/custom_crop_block_stage2"+      "model": "tutorial:block/custom_crop_stage2"
     },     },
     "age=6": {     "age=6": {
-      "model": "tutorial:block/custom_crop_block_stage3"+      "model": "tutorial:block/custom_crop_stage3"
     },     },
     "age=7": {     "age=7": {
-      "model": "tutorial:block/custom_crop_block_stage3"+      "model": "tutorial:block/custom_crop_stage3"
     }     }
   }   }
 } }
 </code> </code>
 +
 +> 种子物品也需要对应的物品模型和物品模型映射（对于 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|数据生成器]]生成战利品表。
  
 ===== 大功告成！ ===== ===== 大功告成！ =====
  
 如果你正确完成了本教程的所有部分，那么你现在就应该有一个生效的作物了！这个作物可以用骨粉催熟，并且只能用种子物品放置在耕地上。 如果你正确完成了本教程的所有部分，那么你现在就应该有一个生效的作物了！这个作物可以用骨粉催熟，并且只能用种子物品放置在耕地上。
zh_cn/tutorial/crops.1671158648.txt.gz · Last modified: 2022/12/16 02:44 by solidblock