方块是构成 Minecraft 的基本组成“块”（并非有意双关）——与 Minecraft 中的所有事物一样，它们存储在注册表中。

准备你的方块类

如果你已经完成了创建你的第一个物品，那么这一过程会非常熟悉——你会需要创建一个注册方块以及方块物品的方法。

你应该把这个方块放在叫做 ModBlocks 的类中（也可以是其他你想要的名称）。

Mojang 对原版方块的处理方法和这个也非常相似，你可以参考 Blocks 类看看他们是怎么做的。

public class ModBlocks {
	private static Block register(String name, Function<BlockBehaviour.Properties, Block> blockFactory, BlockBehaviour.Properties settings, boolean shouldRegisterItem) {
		// Create a registry key for the block
		ResourceKey<Block> blockKey = keyOfBlock(name);
		// Create the block instance
		Block block = blockFactory.apply(settings.setId(blockKey));

		// Sometimes, you may not want to register an item for the block.
		// Eg: if it's a technical block like `minecraft:moving_piston` or `minecraft:end_gateway`
		if (shouldRegisterItem) {
			// Items need to be registered with a different type of registry key, but the ID
			// can be the same.
			ResourceKey<Item> itemKey = keyOfItem(name);

			BlockItem blockItem = new BlockItem(block, new Item.Properties().setId(itemKey).useBlockDescriptionPrefix());
			Registry.register(BuiltInRegistries.ITEM, itemKey, blockItem);
		}

		return Registry.register(BuiltInRegistries.BLOCK, blockKey, block);
	}

	private static ResourceKey<Block> keyOfBlock(String name) {
		return ResourceKey.create(Registries.BLOCK, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, name));
	}

	private static ResourceKey<Item> keyOfItem(String name) {
		return ResourceKey.create(Registries.ITEM, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, name));
	}

}

像物品一样，你需要确保类被加载，这样所有包含方块实体的静态字段都会初始化。

你可以添加一个 initialize 方法，并在模组的初始化中调用以进行静态初始化。

INFO

如果你不了解什么是静态初始化，它指的是在类中初始化静态字段的过程。 这一过程会在类被 JVM 加载时执行，且在任何类实例创建之前完成。

public class ModBlocks {
    // ...

    public static void initialize() {}
}

public class ExampleModBlocks implements ModInitializer {
	@Override
	public void onInitialize() {
		ModBlocks.initialize();
	}
}

创建并注册你的方块

和物品类似，方块会在构造函数中接收一个 BlockBehavior.Properties 类，指定了方块的属性，例如其声音效果和挖掘等级。

这里不会把所有选项都提到：可以查看类本身来看看各种选项，应该都是不言自明的。

作为示例，我们会创建一个简单的方块，其拥有和泥土相同的属性但材质不同。

• 我们创建方块设置的方式与在物品教程中创建物品设置的方法类似。
• 我们通过调用 Block 构造函数来告诉 register 方法从方块设置中创建一个 Block 实例。

TIP

可以使用 BlockBehavior.Properties.ofFullCopy(BlockBehavior block) 来复制现有方块的设置，在本例中，我们本可以使用 Blocks.DIRT 来复制泥土的设置，但出于演示目的，我们将使用构建器。

public static final Block CONDENSED_DIRT = register(
		"condensed_dirt",
		Block::new,
		BlockBehaviour.Properties.of().sound(SoundType.GRASS),
		true
);

为了自动创建方块物品，我们可以向在上一步创建的 register 方法的 shouldRegisterItem 参数中传入 true。

将你的方块的物品添加到创造模式标签页

由于 BlockItem 是自动创建和注册的，要将其添加到创造模式标签页中，必须使用 Block.asItem() 方法来获得 BlockItem 实例。

对于这个例子，我们将方块添加到 BUILDING_BLOCKS 标签页。 如果是要将方块添加到自定义的创造模式标签页，参见自定义创造模式标签页。

ItemGroupEvents.modifyEntriesEvent(CreativeModeTabs.BUILDING_BLOCKS).register((itemGroup) -> {
	itemGroup.accept(ModBlocks.CONDENSED_DIRT.asItem());
});

你应将其置于类的 initialize() 函数中。

现在你应该会注意到，你的方块已经出现在创造模式物品栏中，并且可以放置到世界里！

但是还有几个问题——方块物品没有命名，而且该方块缺少纹理、方块模型和物品模型。

添加方块翻译

要添加本地化，必须在你的本地化文件——assets/example-mod/lang/en_us.json 中创建一个本地化键（类似地，中文的本地化可添加到 assets/example-mod/lang/zh_cn.json）。

Minecraft 会在创造模式物品栏中，以及其他显示方块名称的地方（例如命令反馈）中显示这个翻译。

{
  "block.example-mod.condensed_dirt": "Condensed Dirt"
}

你可以重启游戏，或者在构建模组后按下 F3+T 来应用更改——这样你就能看到方块在创造模式物品栏以及统计信息界面等地方显示名称了。

模型和纹理

所有方块纹理都可以在 assets/example-mod/textures/block 文件夹中找到——“Condensed Dirt”方块的示例纹理可以自由使用。

下载 纹理

要在游戏中显示纹理，必须创建一个方块模型，该模型可在 assets/example-mod/models/block/condensed_dirt.json 文件中的 "Condensed Dirt" 方块中找到。 对于这个方块，我们将使用 block/cube_all 模型类型。

{
  "parent": "minecraft:block/cube_all",
  "textures": {
    "all": "example-mod:block/condensed_dirt"
  }
}

为了让方块显示在物品栏中，你需要创建一个指向方块模型的客户端物品。 在本例中，“Condensed Dirt”方块的客户端物品可在 assets/example-mod/items/condensed_dirt.json 中找到。

{
  "model": {
    "type": "minecraft:model",
    "model": "example-mod:block/condensed_dirt"
  }
}

TIP

只有在注册方块的同时注册了 BlockItem 时，才需要创建客户端物品！

载入游戏，你可能会发现模型还是缺失。 这是因为，你还需要添加方块状态定义。

创建方块状态定义

方块状态定义用于指示游戏基于当前方块的状态要渲染哪个模型。

示例方块没有复杂的方块状态，只需要定义一项。

这个方块应该位于 assets/example-mod/blockstates 文件夹内，名字应该匹配在 ModBlocks 类中注册方块时使用的方块 ID。 例如，方块 ID 是 condensed_dirt，那么文件名称就是 condensed_dirt.json。

{
  "variants": {
    "": {
      "model": "example-mod:block/condensed_dirt"
    }
  }
}

TIP

方块状态非常复杂，因此接下来将在 单独页面 中介绍。

重启游戏，或者按下F3 + T重新加载资源文件以应用更改——你应该能看到方块在物品栏内的纹理，以及在世界中呈现：

添加方块掉落物

在生存模式下破坏方块时，你可能看到方块不会掉落——你可能想要这个功能，但是要让方块被破坏时掉落为物品，必须要实现其战利品表——战利品表文件应置于 data/example-mod/loot_table/blocks/ 文件夹中。

INFO

对战利品表的更深入理解，可参考 Minecraft Wiki - 战利品表页面。

{
  "type": "minecraft:block",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "example-mod:condensed_dirt"
        }
      ],
      "conditions": [
        {
          "condition": "minecraft:survives_explosion"
        }
      ]
    }
  ]
}

这个战利品表提供了方块在被破坏以及被爆炸破坏时掉落的单个方块物品。

推荐挖掘工具

你可能也想要让方块只能被特定类型的方块挖掘——例如，可能想让你的方块用锹挖掘更快。

所有的工具标签都位于 data/minecraft/tags/block/mineable/ 文件夹内——其中文件的名称取决于使用的工具的类型，是以下之一：

• hoe.json（锄）
• axe.json（斧）
• pickaxe.json（镐）
• shovel.json（锹）

文件的内容很简单，是要添加到标签中的物品的列表。

这个例子会将“Condensed Dirt”方块添加到 shovel 标签中。

{
  "replace": false,
  "values": ["example-mod:condensed_dirt"]
}

如果希望此方块应使用工具来挖掘，则需要在方块设置中添加.requiresCorrectToolForDrops()，并添加相应的挖掘标签。

挖掘等级

类似地，data/minecraft/tags/block/ 文件夹内也可以找到挖掘等级，并遵循以下格式：

• needs_stone_tool.json - 最低需要石质工具
• needs_iron_tool.json - 最低需要铁质工具
• needs_diamond_tool.json - 最低需要钻石工具。

文件与挖掘工具文件的格式相同——要添加到标签中的物品的列表。

备注

如果将多个方块添加到你的模组中，可能需要考虑使用数据生成来自动化创建方块和物品模型、方块状态定义和战利品表。