用户:MashKJo/1.21.1模组开发教程/6.1.第一个方块 - 版本历史

MashKJo：/* blockstates和模型文件 */

2025-09-07T13:50:20Z

blockstates和模型文件

←上一版本		2025年9月7日 (日) 21:50的版本
第50行：		第50行：

	事实上，任何物品都可以通过模型文件继承方块模型来获得一个方块的外观。		事实上，任何物品都可以通过模型文件继承方块模型来获得一个方块的外观。

			=== 数据生成 ===
			对应的DataProvider实现类为BlockStateProvider，同样提供了大量辅助方法如#simpleBlock、#simpleBlockWithItem等，思路和物品模型datagen类似，这里就不赘述了，读者可自行翻阅BlockStateProvider的源码。

	== 方块类型（MapCodec<? extends Block>） ==		== 方块类型（MapCodec<? extends Block>） ==

2025年9月7日 (日) 11:54 MashKJo

2025-09-07T11:54:57Z

←上一版本		2025年9月7日 (日) 19:54的版本
第11行：		第11行：
	public static final DeferredItem<BlockItem> EXAMPLE_BLOCK_ITEM = ITEMS.registerSimpleBlockItem(MyBlockClass.EXAMPLE_BLOCK);		public static final DeferredItem<BlockItem> EXAMPLE_BLOCK_ITEM = ITEMS.registerSimpleBlockItem(MyBlockClass.EXAMPLE_BLOCK);

	~~方块的本地化键名格式是block~~.<modid>.<registry_name>~~，如上述示例代码中注册的EXAMPLE_BLOCK的本地化键名为block~~.tutorialmod.~~example_block。~~		方块的本地化键名格式是<code>block.<modid>.<registry_name></code>，如上述示例代码中注册的EXAMPLE_BLOCK的本地化键名为<code>block.tutorialmod.example_block</code>。

	== blockstates和模型文件 ==		== blockstates和模型文件 ==

MashKJo：/* 方块类型（MapCodec） */

2025-09-07T11:54:11Z

方块类型（MapCodec）

←上一版本		2025年9月7日 (日) 19:54的版本
第54行：		第54行：
	你可能注意到了，原版的Block子类都定义了一个public static final的MapCodec字段（有关Codec和MapCodec，详见第10章），即所谓的“方块类型”；还覆写了#codec方法。并且这些方块类型都被注册进了注册表BuiltInRegistries.BLOCK_TYPE。		你可能注意到了，原版的Block子类都定义了一个public static final的MapCodec字段（有关Codec和MapCodec，详见第10章），即所谓的“方块类型”；还覆写了#codec方法。并且这些方块类型都被注册进了注册表BuiltInRegistries.BLOCK_TYPE。

	由于方块目前仍是固有注册项，并未数据驱动化，因此这东西其实没啥用。不过为了和原版统一，你也可以为你的Block子类加上方块类型。如果你的方块子类的构造方法只接受一个BlockBehaviour.Properties，那么可以直接用#simpleCodec来得到一个MapCodec；如果构造方法不止这一个参数，你需要使用RecordCodecBuilder#~~mapCodec来创建MapCodec，方块属性的Codec可以通过BlockBehaviour~~#~~propertiesCodec得到。~~		由于方块目前仍是固有注册项，并未数据驱动化，因此这东西其实没啥用。不过为了和原版统一，你也可以为你的Block子类加上方块类型。如果你的方块子类的构造方法只接受一个BlockBehaviour.Properties，那么可以直接用#simpleCodec来得到一个MapCodec；如果构造方法不止这一个参数，你需要使用RecordCodecBuilder#mapCodec来创建MapCodec，方块属性参数的Codec填BlockBehaviour#propertiesCodec。

MashKJo：创建页面，内容为“方块的基类是`net.minecraft.world.level.block.Block`类，和物品一样，简单的方块可以直接new这个类；拥有额外的逻辑的则需要先继承再实例化。 public static final DeferredRegister.Blocks BLOCKS = DeferredRegister.createBlocks(TutorialMod.MODID); public static final DeferredBlock EXAMPLE_BLOCK = BLOCKS.registerSimpleBlock("example_block", BlockBehaviour.Properties.of(). ...); Block类接受一个Block…”

2025-09-07T11:51:10Z

创建页面，内容为“方块的基类是<code>net.minecraft.world.level.block.Block</code>类，和物品一样，简单的方块可以直接new这个类；拥有额外的逻辑的则需要先继承再实例化。 public static final DeferredRegister.Blocks BLOCKS = DeferredRegister.createBlocks(TutorialMod.MODID); public static final DeferredBlock<Block> EXAMPLE_BLOCK = BLOCKS.registerSimpleBlock("example_block", BlockBehaviour.Properties.of(). ...); Block类接受一个Block…”

新页面

方块的基类是<code>net.minecraft.world.level.block.Block</code>类，和物品一样，简单的方块可以直接new这个类；拥有额外的逻辑的则需要先继承再实例化。

public static final DeferredRegister.Blocks BLOCKS = DeferredRegister.createBlocks(TutorialMod.MODID);

public static final DeferredBlock<Block> EXAMPLE_BLOCK = BLOCKS.registerSimpleBlock("example_block", BlockBehaviour.Properties.of(). ...);

Block类接受一个BlockBehaviour.Properties，这是方块的属性，和物品的Item.Properties类似，你可以在其中设置方块的硬度、音效、爆炸抗性等。如果有些数值你拿不准，可以去Blocks类下看看原版方块的数值都是怎么填的。

注册完方块本身，我们还需要注册方块的物品形式（BlockItem）——没错，方块放在世界中才是方块，拿在手上的是方块的物品形式，本质上是ItemStack。

public static final DeferredItem<BlockItem> EXAMPLE_BLOCK_ITEM = ITEMS.registerSimpleBlockItem(MyBlockClass.EXAMPLE_BLOCK);

方块的本地化键名格式是block.<modid>.<registry_name>，如上述示例代码中注册的EXAMPLE_BLOCK的本地化键名为block.tutorialmod.example_block。

== blockstates和模型文件 ==
我们的方块，现在放在世界中时，是一个六个面都是紫黑块的立方体。我们需要给它编写blockstates文件和模型文件。

首先在路径<code>assets/<modid>/blockstates</code>文件夹下以你的方块注册名为名创建JSON文件：

{
"variants": {
"": {
"model": "<modid>:block/<name>"
}
}
}

我们的方块只有一种方块状态（有关方块状态，请见6.3节），所以用空字符串""表示，该blockstates文件将这一唯一方块状态的模型映射到了文件<code>assets/<modid>/models/<name>.json</code>。

然后再创建这个模型文件：

{
"parent": "minecraft:block/cube_all",
"textures": {
"all": "<modid>:block/<name>"
}
}

由于我们创建的方块是一个满格的立方体，且六个面纹理相同，因此父模型设定为minecraft:block/cube_all；textures部分则将六个面的纹理映射到纹理文件<code>assets/<modid>/textures/block/<name>.png</code>。

当然，如果你不想让六个面纹理都相同，可以选择继承模型minecraft:block/cube，你可以分别指定东南西北上下六个面，以及粒子的纹理。

把提前准备好的纹理放入指定的位置，如果你没出错的话，那么启动游戏后，方块被放在世界中时，已经显示为正常的纹理了。

但是方块拿在手上时还是紫黑块，我们需要给方块的物品形式也创建一个模型文件，我们只需直接继承我们写好的方块模型即可：

{
"parent": "<modid>:block/<name>"
}

事实上，任何物品都可以通过模型文件继承方块模型来获得一个方块的外观。

== 方块类型（MapCodec<? extends Block>） ==
你可能注意到了，原版的Block子类都定义了一个public static final的MapCodec字段（有关Codec和MapCodec，详见第10章），即所谓的“方块类型”；还覆写了#codec方法。并且这些方块类型都被注册进了注册表BuiltInRegistries.BLOCK_TYPE。

由于方块目前仍是固有注册项，并未数据驱动化，因此这东西其实没啥用。不过为了和原版统一，你也可以为你的Block子类加上方块类型。如果你的方块子类的构造方法只接受一个BlockBehaviour.Properties，那么可以直接用#simpleCodec来得到一个MapCodec；如果构造方法不止这一个参数，你需要使用RecordCodecBuilder#mapCodec来创建MapCodec，方块属性的Codec可以通过BlockBehaviour#propertiesCodec得到。

用户:MashKJo/1.21.1模组开发教程/6.1.第一个方块 - 版本历史

MashKJo：​/* blockstates和模型文件 */

2025年9月7日 (日) 11:54 MashKJo

MashKJo：​/* 方块类型（MapCodec） */

MashKJo：/* blockstates和模型文件 */

MashKJo：/* 方块类型（MapCodec） */