Fabric Wiki

User Tools

Site Tools

Trace: • 添加方块
zh_cn:tutorial:blocks

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:blocks [2024/08/26 01:21] – solidblockzh_cn:tutorial:blocks [2025/04/02 01:11] (current) – [给予方块外观] solidblock
Line 1: Line 1:
 ====== 添加方块 ====== ====== 添加方块 ======
  
-将方块添加到你的模组过程与[[zh_cn:tutorial:items|添加物品]]类似。你可以创建 ''Block'' 或自定义类的实例，然后将其注册到 ''Registries.BLOCK''（1.19.3 以上版本）或 ''Registry.BLOCK'' （1.19.2 以下）注册表。你还需要提供纹理和方块状态或模型文件以提供方块外观。如需了解方块模型格式的更多信息，请参考[[https://zh.minecraft.wiki/模型|Minecraft Wiki 模型页面]]。+将方块添加到你的模组过程与[[zh_cn:tutorial:items|添加物品]]类似。你可以创建 ''Block'' 或自定义类的实例，然后将其注册到 ''Registries.BLOCK''（1.19.3 以上版本）或 ''Registry.BLOCK''（1.19.2 以下）注册表。你还需要提供纹理和方块状态或模型文件以提供方块外观。如需了解方块模型格式的更多信息，请参考[[https://zh.minecraft.wiki/模型|Minecraft Wiki 模型页面]]。
  
-===== 创建方块 =====+===== 创建方块（1.21.2 之前） ===== 
 +> :!: 如果使用的是 1.21.2 或者之后的版本，请直接看 [[#在 1.21.2+ 中注册方块]]。
  
 首先创建 ''Block'' 的实例。该实例可以存储在任何地方，但是我们会在 ''ModInitializer'' 的顶部开始。''Block'' 构造器函数需要一个 ''AbstractBlock.Settings'' 实例，也就是用于配置方块属性的构造器。Fabric 提供一个 ''FabricBlockSettings'' 构造器类以及更多可用的选项。 首先创建 ''Block'' 的实例。该实例可以存储在任何地方，但是我们会在 ''ModInitializer'' 的顶部开始。''Block'' 构造器函数需要一个 ''AbstractBlock.Settings'' 实例，也就是用于配置方块属性的构造器。Fabric 提供一个 ''FabricBlockSettings'' 构造器类以及更多可用的选项。
Line 22: Line 23:
     // 对于 1.20 以下版本：     // 对于 1.20 以下版本：
     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.of(Material.METAL).strength(4.0f));     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.of(Material.METAL).strength(4.0f));
 +    
     // 对于 1.20.5 以下版本：     // 对于 1.20.5 以下版本：
     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.create().strength(4.0f));     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.create().strength(4.0f));
-    // 对于自 1.20.5 之后的版本：+     
 +    // 对于自 1.20.5 之后、1.21.2 以前的版本：
     public static final Block EXAMPLE_BLOCK = new Block(Block.Settings.create().strength(4.0f));     public static final Block EXAMPLE_BLOCK = new Block(Block.Settings.create().strength(4.0f));
          
Line 33: Line 36:
 } }
 </code> </code>
-===== 注册方块 =====+===== 注册方块（1.21.2 之前） =====
  
 方块应该注册在 ''Registries.BLOCK'' 注册表中。和 [[items|物品]] 类似，调用 ''Registry.//register//'' 并传递适当的参数。你可以直接在 ''onInitialize'' 方法中注册方块，也可以在静态部分创建方块实例时将其注册，因为 ''register'' 方法会返回这个方块实例自身。 方块应该注册在 ''Registries.BLOCK'' 注册表中。和 [[items|物品]] 类似，调用 ''Registry.//register//'' 并传递适当的参数。你可以直接在 ''onInitialize'' 方法中注册方块，也可以在静态部分创建方块实例时将其注册，因为 ''register'' 方法会返回这个方块实例自身。
Line 46: Line 49:
     // 对于 1.20.5 以下版本：     // 对于 1.20.5 以下版本：
     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.create().strength(4.0f));     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.create().strength(4.0f));
-    // 对于自 1.20.5 之后的版本：+    // 对于自 1.20.5 之后、1.21.2 以前的版本：
     public static final Block EXAMPLE_BLOCK = new Block(Block.Settings.create().strength(4.0f));     public static final Block EXAMPLE_BLOCK = new Block(Block.Settings.create().strength(4.0f));
          
Line 61: Line 64:
 你的自定义方块不能作为物品存入背包，但可以通过使用 ''/setblock <位置> tutorial:example_block'' 在游戏中看到。 你的自定义方块不能作为物品存入背包，但可以通过使用 ''/setblock <位置> tutorial:example_block'' 在游戏中看到。
  
-==== 为方块注册物品 ====+==== 为方块注册物品（1.21.2 之前） ====
  
 在大多数情况下，您希望能够拿着物品放置方块。为此，您需要在物品注册表中注册一个相应的物品。您可以通过在 ''Registries.ITEM'' 下注册 ''BlockItem'' 的实例来执行此操作。该物品的注册表名称通常应与该方块的注册表名称相同。 在大多数情况下，您希望能够拿着物品放置方块。为此，您需要在物品注册表中注册一个相应的物品。您可以通过在 ''Registries.ITEM'' 下注册 ''BlockItem'' 的实例来执行此操作。该物品的注册表名称通常应与该方块的注册表名称相同。
Line 72: Line 75:
     // 对于 1.20.5 以下版本：     // 对于 1.20.5 以下版本：
     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.create().strength(4.0f));     // public static final Block EXAMPLE_BLOCK = new Block(FabricBlockSettings.create().strength(4.0f));
-    // 对于自 1.20.5 之后的版本：+    // 对于自 1.20.5 之后、1.21.2 之前的版本：
     public static final Block EXAMPLE_BLOCK = new Block(Block.Settings.create().strength(4.0f));     public static final Block EXAMPLE_BLOCK = new Block(Block.Settings.create().strength(4.0f));
          
Line 88: Line 91:
 </code> </code>
  
-===== 注册方块的最佳实践 =====+===== 注册方块的最佳实践（1.21.2 之前） ===== 
 +:!: 本段不适用于 1.21.2 之后的版本。 
 有时你的模组有许多方块。如果这样注册，你会为每个方块都写这样复杂的代码，代码就会显乱。所以，类似于注册物品，我们为方块创建单独的类，以及一个实用方法以注册方块和物品。 有时你的模组有许多方块。如果这样注册，你会为每个方块都写这样复杂的代码，代码就会显乱。所以，类似于注册物品，我们为方块创建单独的类，以及一个实用方法以注册方块和物品。
  
Line 113: Line 118:
         TutorialBlocks.initialize();         TutorialBlocks.initialize();
     }     }
 +}
 +</code>
 +
 +===== 在 1.21.2+ 中注册方块 =====
 +在 1.21.2+ 中，要把 ''RegistryKey'' 添加到方块的 ''AbstractBlock.Settings'' 中，和物品的 ''Item.Settings'' 一起。看上去有点麻烦，不过好在 Minecraft 的 ''Blocks.//register//'' 和 ''Items.//register//'' 可以帮你做这些。这里我们使用单独的类 ''TutorialBlocks'' 存放所有的方块对象，并在模组初始化器中引用这个类，使其字段被静态加载。
 +
 +<code java TutorialBlocks.java>
 +public class TutorialBlocks {
 +  public static final Block EXAMPLE_BLOCK = register("example_block", Block::new, Block.Settings.create().strength(4.0f));
 +
 +  private static Block register(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);
 +
 +    final Block block = Blocks.register(registryKey, factory, settings);
 +    Items.register(block);
 +    return block;
 +  }
 +
 +  public static void init() {
 +  }
 +}
 +</code>
 +
 +上面的代码中，''Blocks.//register//'' 会帮助你将注册表键先写到 ''AbstractBlock.Settings'' 中，然后创建方块实例再注册。''Items.//register//'' 会直接创建简单的 ''BlockItem'' 实例，使用和方块一样的 ID，然后注册。如果需要更加复杂的制作，例如创建 ''BlockItem'' 的子类，可以调用其他一些也叫做 ''Items.//register//'' 但是有不同方法签名的方法。
 +
 +别忘了要在模组初始化器中静态加载这个类：
 +<code java ExampleMod.java>
 +public class ExampleMod implements ModInitializer {
 +
 +  @Override
 +  public void onInitialize() {
 +    // ...
 +    
 +    TutorialBlocks.init();
 +  }
 } }
 </code> </code>
Line 120: Line 161:
 你可能已经注意到，新的方块只是游戏中紫色和黑色棋盘格图案。这表明 Minecraft 加载方块资源或外观时出错。运行客户端时，完整的问题列表会输出在你的日志中。你需要以下文件来给予方块外观： 你可能已经注意到，新的方块只是游戏中紫色和黑色棋盘格图案。这表明 Minecraft 加载方块资源或外观时出错。运行客户端时，完整的问题列表会输出在你的日志中。你需要以下文件来给予方块外观：
  
-  * 方块状态文件 +  * 方块状态映射 
-  * 方块模型文件 +  * 方块烘焙模型 
-  * 纹理 +  * 方块纹理 
-  * 物品模型文件（如果方块有与之关联的物品）+  * //1.21.3 及之前的版本：//物品模型（如果方块有与之关联的物品） 
 +  * //1.21.4 及之后的版本：//物品模型映射（如果方块有与之关联的物品）
  
 这些文件位于： 这些文件位于：
  
-  * 方块状态：''src/main/resources/assets/tutorial/blockstates/example_block.json'' +  * 方块状态映射：''src/main/resources/assets/tutorial/blockstates/example_block.json'' 
-  * 方块模型：''src/main/resources/assets/tutorial/models/block/example_block.json'' +  * 方块烘焙模型：''src/main/resources/assets/tutorial/models/block/example_block.json''
-  * 物品模型：''src/main/resources/assets/tutorial/models/item/example_block.json''+
   * 方块纹理：''src/main/resources/assets/tutorial/textures/block/example_block.png''   * 方块纹理：''src/main/resources/assets/tutorial/textures/block/example_block.png''
 +  * //1.21.3 及之前的版本：//物品模型：''src/main/resources/assets/tutorial/models/item/example_block.json''
 +  * //1.21.4 及之后的版本：//物品模型映射：''src/main/resources/assets/tutorial/items/example_block.json''
  
-方块状态文件根据其方块装填确定该方块应使用的模型。由于我们的方块没有所谓状态，所以我们用空字符串表示所有：+方块状态映射会根据其方块状态确定该方块应使用的模型。由于方块没有属性，只有一个状态，所以用空字符串表示所有：
  
 <code JavaScript src/main/resources/assets/tutorial/blockstates/example_block.json> <code JavaScript src/main/resources/assets/tutorial/blockstates/example_block.json>
Line 142: Line 185:
 </code> </code>
  
-方块模型文件定义了方块的形状和纹理。我们将使用block/cube_all作为父模型，这将使我们能够轻松地在方块的所有面上设置相同的纹理。+方块烘焙模型定义了方块的形状和纹理。我们将使用 ''block/cube_all'' 作为父模型，这将使我们能够轻松地在方块的所有面上设置相同的纹理。
  
 <code JavaScript src/main/resources/assets/tutorial/models/block/example_block.json> <code JavaScript src/main/resources/assets/tutorial/models/block/example_block.json>
Line 153: Line 196:
 </code> </code>
  
-在大多数情况下，您想让方块作为物品时外观还是这个方块。为此，您可以制作一个从方块模型文件继承的项目文件，这会使得该物品外观和方块相同：+在大多数情况下，您想让方块作为物品时外观还是这个方块。 
 + 
 +对于 1.21.3 以及之前的版本，可以为物品创建对应的物品模型，该物品模型直接继承方块模型，这会使得该物品外观和方块相同：
  
 <code JavaScript src/main/resources/assets/tutorial/models/item/example_block.json> <code JavaScript src/main/resources/assets/tutorial/models/item/example_block.json>
 { {
   "parent": "tutorial:block/example_block"   "parent": "tutorial:block/example_block"
 +}
 +</code>
 +
 +对于 1.21.4 以及之后的版本，可以为物品创建对应的物品模型映射，让物品直接使用方块的模型：
 +<code JavaScript src/main/resources/assets/tutorial/items/example_block.json>
 +{
 +  "model": {
 +    "type": "minecraft:model",
 +    "model": "tutorial:block/example_block"
 +  }
 } }
 </code> </code>
Line 195: Line 250:
 在 1.17，破坏方块有所改变，定义采集工具和采集等级需要使用标签，请参考[[zh_cn:tutorial:tags|标签教程]]。我们需要将方块添加到以下标签： 在 1.17，破坏方块有所改变，定义采集工具和采集等级需要使用标签，请参考[[zh_cn:tutorial:tags|标签教程]]。我们需要将方块添加到以下标签：
  
- * 采集工具：''src/main/resources/data/minecraft/tags/**block**/mineable/<tooltype>.json''，其中 ''<tooltype>'' 可以是 ''axe''、''pickaxe''、''shovel''、''hoe''（对于 1.21 以下的版本，把“//**block**//”替换为“//**blocks**//”） +  * 采集工具：''src/main/resources/data/minecraft/tags/**block**/mineable/<tooltype>.json''，其中 ''<tooltype>'' 可以是 ''axe''、''pickaxe''、''shovel''、''hoe''（对于 1.21 以下的版本，把“//**block**//”替换为“//**blocks**//”） 
- * 采集等级：''src/main/resources/data/minecraft/tags/**block**/needs_<tier>_tool.json''，其中 ''<tier>'' 可以是：''stone''、''iron''、''diamond''（//不包括// ''netherite''）（对于 1.21 以下的版本，把“//**block**//”替换为“//**blocks**//”）+  * 采集等级：''src/main/resources/data/minecraft/tags/**block**/needs_<tier>_tool.json''，其中 ''<tier>'' 可以是：''stone''、''iron''、''diamond''（//不包括// ''netherite''）（对于 1.21 以下的版本，把“//**block**//”替换为“//**blocks**//”）
  
 <code JavaScript src/main/resources/data/minecraft/tags/blocks/mineable/pickaxe.json> <code JavaScript src/main/resources/data/minecraft/tags/blocks/mineable/pickaxe.json>
Line 295: Line 350:
   *    * 
 ===== 下一步 ===== ===== 下一步 =====
-[[zh_cn:tutorial:blockstate|向方块添加简单状态，例如整数和布尔值]]。 +  * [[blockstate|向方块添加简单状态，例如整数和布尔值]]。 
- +  * [[blockentity|给块方块实体，使之能有物品栏之类的高级状态]]。此外，还需要像 GUI 和自定义方块渲染。 
-[[zh_cn:tutorial:blockentity|给块方块实体，使之能有物品栏之类的的高级状态]]。此外，还需要像 GUI 和自定义方块渲染。+  * [[datagen_model|使用数据生成器为方块和物品生成方块模型、方块状态映射、物品模型映射]]。 
 +  * [[datagen_tags|使用数据生成器为方块生成标签]]。 
 +  * 别忘了，你的方块不能够没有[[lang|可翻译的名字]]。
  
 要让方块可燃（也就是说，可以被火燃烧），可使用 ''FlammableBlockRegistry''。 要让方块可燃（也就是说，可以被火燃烧），可使用 ''FlammableBlockRegistry''。
zh_cn/tutorial/blocks.1724635278.txt.gz · Last modified: 2024/08/26 01:21 by solidblock