Differences

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

--- zh_cn:tutorial:blockstate [2019/12/19 03:12] – [为方块状态添加模型] lightcolour
+++ zh_cn:tutorial:blockstate [2025/04/01 09:21] (current) – solidblock
@@ Line 1: / Line 1: @@
-===== 给一个方块状态 ======
+====== 赋予方块状态 =======
-Minecraft中的每种类型的区方块都由一个单独的“区块”实例表示。
+Minecraft 中的每种类型的方块都由一个单独的 ''Block'' 实例表示。这样就无法仅通过更改 ''Block'' 实例的状态来更改特定方块的状态，因为该类型的其他所有方块都会受到影响！但是，如果您想给出一个单一的方块状态，以便它可以根据某些条件改变，该怎么办？这就是方块状态的目的。
-这样就无法仅通过更改方块实例的状态来更改特定方块的状态，
-因为该类型的其他所有方块都会受到影响！
+===== 方块状态属性 =====
-但是，如果您想给出一个单一的方块状态，以便它可以根据某些条件改变，该怎么办？
-这就是''BlockState''的目的。
+每个方块都可以有 0 个、1 个或更多个**方块状态属性**，每个方块状态属性都可以有至少 2 个值。原版已有的属性，可以在 ''Properties''（''net.minecraft.state.property.Properties''）中找到。当然，许多方块比较简单，没有方块状态属性，因此这些方块的方块状态是唯一的。
-假设我们希望方块的硬度通常为''0.5''，但是如果我们在尝试破坏它之前右键单击它，
-它会变得更硬并获得“2”的硬度。
+我们来看几个例子：
+  * [[directionalblock|制作带朝向的方块]]，使用的方块状态属性是 ''Properties.HORIZONTAL_FACING''，其值可以是 4 个水平方向
+  * [[waterloggable|制作可含水的方块]]，使用的方块状态属性是 ''Properties.WATERLOGGED''，其值可以是 true 和 false
+===== 自定义方块状态属性：以可充能方块为例 =====
+假设我们希望一个方块仅在充能后能够召唤闪电。
-首先，我们定义方块的boolean属性-是否很难（小心不要导入错误的BooleanProperty！）：
+首先，我们定义方块的布尔值属性——是否充能（小心不要导入错误的 ''BooleanProperty''），并在模组初始化的地方将其注册。（如果你直接在 ''ChargeableBlock'' 类的静态字段中注册，模组初始化器可能会忽略它，如果这个类没有被初始化的话。）
+如果你需要定义其他类型的属性，可以使用 ''IntProperty'' 或 ''EnumProperty''。
+先创建类：
 <code java>
-public class MyBlock extends Block {
+public class ChargeableBlock extends Block {
-    public static final BooleanProperty HARDENED = BooleanProperty.of("hardened");
+    public static final BooleanProperty CHARGED = BooleanProperty.of("charged");
+    public ChargeableBlock(Settings settings) {
+      super(settings);
+    }
 }
 </code>
-然后，我们需要通过Override''appendProperties''来注册属性：
+然后按照 [[blocks]] 中说的那样注册方块：
+<code java>
+public final class TutorialBlocks {
+    // 对于 1.21.2 之前的版本：
+    public static final ChargeableBlock CHARGEABLE_BLOCK = register("chargeable_block", new ChargeableBlock(Block.Settings.copy(Blocks.STONE)));
+    // 对于 1.21.2 以及之后的版本：
+    public static final Block CHARGEABLE_BLOCK = register("chargeable_block", ChargeableBlock::new, Block.Settings.copy(Blocks.STONE));
+    // [...]
+}
+</code>
+然后，我们需要通过覆盖 ''appendProperties'' 并加入 ''CHARGED'' 以注册属性：
 <code java>
-public class MyBlock extends Block {
+public class ChargeableBlock extends Block {
     [...]
     @Override
-    protected void appendProperties(StateManager.Builder<Block, BlockState> stateManager) {
+    protected void appendProperties(StateManager.Builder<Block, BlockState> builder) {
-        stateManager.add(HARDENED);
+        builder.add(CHARGED);
     }
 }
 </code>
-然后，我们需要在方块构造函数中设置属性的默认状态：
+然后需要注册属性的默认状态。到刚刚创建的类的构造方块，像这样修改：
 <code java>
-public class MyBlock extends Block {
+public class ChargeableBlock extends Block {
     [...]
-    public MyBlock(Settings settings) {
+    public ChargeableBlock(Settings settings) {
         super(settings);
-        setDefaultState(getStateManager().getDefaultState().with(HARDENED, false));
+        setDefaultState(getDefaultState().with(CHARGED, false));
     }
 }
 </code>
-（要设置多个属性，请链接''with()''调用）
-现在，要设置属性，我们需要调用''world.setBlockState()''：
+现在，我们需要能够通过 ''onUse'' 方法充能方块，在该方法中调用 ''world.setBlockState()''（这个 ''playSound'' 是可选的，只是让我们知道方块充能了）。
-（用方块的实例替换''MyBlocks.MY_BLOCK_INSTANCE''）
 <code java>
-public class MyBlock extends Block {
+public class ChargeableBlock extends Block {
     [...]
     @Override
-    public boolean activate(BlockState state, World world, BlockPos pos, PlayerEntity player, Hand hand, BlockHitResult blockHitResult) {
+    public ActionResult onUse(BlockState state, World world, BlockPos pos, PlayerEntity player, BlockHitResult hit) {
-        world.setBlockState(pos, MyBlocks.MY_BLOCK_INSTANCE.getDefaultState().with(HARDENED, true));
+        player.playSound(SoundEvents.BLOCK_RESPAWN_ANCHOR_CHARGE, 1, 1);
-        return true;
+        world.setBlockState(pos, state.with(CHARGED, true));
+        return ActionResult.SUCCESS;
     }
 }
 </code>
-并使用该属性，我们称为''blockState.get(<我们的属性名称>)''：
+最后，要使用 ''CHARGED'' 属性，我们调用 ''onSteppedOn''，并在里面使用 ''world.getBlockState(pos).get(CHARGED)''。
 <code java>
-public class MyBlock extends Block {
+public class ChargeableBlock extends Block {
     [...]
     @Override
-    public float getHardness(BlockState blockState, BlockView blockView, BlockPos pos) {
+    public void onSteppedOn(World world, BlockPos pos, BlockState state, Entity entity) {
-        boolean hardened = blockState.get(HARDENED);
+        if (world.getBlockState(pos).get(CHARGED)){
-        if(hardened) return 2.0f;
+            // 在方块的位置召唤闪电
-        else return 0.5f;
+            LightningEntity lightningEntity = EntityType.LIGHTNING_BOLT.create(world, SpawnReason.MOB_SUMMONED);
+            lightningEntity.refreshPositionAfterTeleport(Vec3d.ofBottomCenter(pos));
+            world.spawnEntity(lightningEntity);
+        }
+        world.setBlockState(pos, state.with(CHARGED, false));
+        super.onSteppedOn(world, pos, state, entity);
     }
 }
 </code>
-==== 为方块状态添加模型 ====
+==== 为方块状态添加模型和方块状态映射 ====
-您还可以根据状态更改方块的纹理和模型。 这是通过称为Blockstate JSON的JSON文件完成的。 所有方块都需要一个方块状态JSON，无论它们是否具有多个状态，但是JSON的内容可以根据您的喜好简单或复杂。 如果要基于状态更改方块的纹理，则将需要多个模型。
+你可能还需要使得纹理和模型能够根据状态来改变，这是通过一个叫做“**方块状态映射**（block states definitions）”的 JSON 来完成的。所有的方块都需要一个方块状态映射，无论它是否有多个方块状态，但其内容可以简单也可以复杂。如果需要根据方块状态来改变纹理，我们需要添加多个模型。
-假设您将''MyBlock''的实例注册到ID''mymod:my_block''。 Minecraft将在''src/main/resources/assets/mymod/blockstates/ my_block.json''位置查找文件以加载状态。如果您不希望方块在状态之间更改模型，则方块状态JSON可能非常简单。它看起来像这样：
+比如说，你为 ''ChargeableBlock'' 注册了 ID 为 ''tutorial:chargeable_block''。Minecraft 会加载地址 ''src/main/resources/assets/tutorial/blockstates/chargeable_block.json'' 中的方块状态映射，并根据方块状态映射分配方块模型。如果你不需要让方块根据状态更改模型，方块状态映射可以非常简单，就像这样：
-<code JavaScript resources/assets/mymod/blockstates/my_block.json>
+<code JavaScript resources/assets/tutorial/blockstates/chargeable_block.json>
 {
     "variants": {
-        "": { "model": "mymod:block/my_block" }
+        "": { "model": "tutorial:block/chargeable_block" }
     }
 }
 </code>
-让我们分解一下这个简单的例子。 JSON有几个重要的部分：
--''variants''方块将成为您的方块状态所有可能的变化形式。我们将稍作探讨。
+让我们分解一下这个简单的例子。JSON 有几个重要的部分：
--名为的变体将应用于每个方块状态的排列。如果您有变体，则JSON中不应包含任何其他变体，否则Minecraft会不高兴。
--分配给变体的对象可以添加各种属性，例如旋转或纹理处理。请查看下面的链接的“模型”页面，以获取有关可以添加哪些属性的更多文档。 所有变体都必须包含“模型”属性。
--始终在模型属性中传递“模型”属性。在这种情况下，游戏将查看位置``src/mainresources/assets/mymod/models/ block/my_block.json``。这里的ID可以是任何东西。它不需要与方块的ID相同，但是如果您只有一个变体，则可能应该相同。方块模型具有自己的设置，在下面链接的Minecraft Wiki页面上有很好的记录。您可以手工编写JSON，也可以使用[[https://blockbench.net | Blockbench]]之类的程序更轻松地生成它。
-如果想要为每个方块状态使用不同的模型，则需要添加多个变体。对于我们上面使用的相同的``src/main/resources/assets/mymod/ blockstates/my_block.json``位置，您可能看起来像这样：
+  * The ''%%"variants"%%'' 定义了每个方块状态应该使用什么模型。我们将稍作探讨。
+  * 名为 ''%%""%%''（空字符串）的变种将应用于//每个//方块状态。如果你有 ''%%""%%'' 变种，则 JSON 中不应包含任何其他变种，否则 Minecraft 会出问题。
+  * 分配给 ''%%""%%'' 变种的对象可以添加各种属性，例如旋转或纹理操作。请查看下面的链接的“模型”页面，以获取有关可以添加哪些属性的更多文档。所有变种都//必须//包含 ''%%"model"%%'' 属性。
+  * ''%%"model"%%'' 属性总是传递模型的 ID。在这个例子中，游戏将查看位置 ''src/main/resources/assets/tutorial/models/block/chargeable_block.json''。这里的 ID 可以是任何东西，//不需要//与方块的ID相同，但是如果只有一个变种，则应当要相同。方块模型具有自己的设置，在下面链接的 Minecraft Wiki 页面上有很好的记录。您可以手动编写 JSON，也可以使用 [[https://blockbench.net|Blockbench]] 之类的程序更轻松地生成它。
-<code JavaScript resources/assets/mymod/blockstates/my_block.json>
+如果//确实//想要为每个方块状态使用不同的模型，则需要添加多个变种。对于我们上面使用的同一个 ''src/main/resources/assets/tutorial/blockstates/chargeable_block.json'' 位置，你可能需要这样子：
+<code JavaScript resources/assets/tutorial/blockstates/chargeable_block.json>
 {
     "variants": {
-        "hardened=false": { "model": "mymod:block/my_block" },
+        "charged=false": { "model": "tutorial:block/chargeable_block" },
-        "hardened=true": { "model": "mymod:block/my_block_hardened" }
+        "charged=true": { "model": "tutorial:block/chargeable_block_charged" }
     }
 }
 </code>
-在此JSON中，有两种变体，一种针对我们上面定义的''HARDENED''属性的每种可能性。由于我们在Java中为属性指定了字符串''hardened''，因此我们在这里使用它。布尔值只有两种状态，但是如果您使用基于整数或枚举的属性，则会有更多的变体。
+在此方块状态映射中，有两个变种，一种针对我们上面定义的 ''CHARGED'' 属性的每种可能性。由于我们在 Java 中为属性指定了字符串 ''charged''，因此我们在这里使用它。布尔值只有两种状态，但是如果您使用基于整数或枚举的属性，则会有更多的变种。
+变种基于添加到方块中的属性的可能排列。如果需要，可以在方块状态 JSON 中完全忽略某个属性，例如在第一个方块状态 JSON 中我们忽略了 ''charged'' 属性，但如果要在一个变种中包含属性，则必须将其包含在//所有//变种。如果 ''tutorial:chargeable_block'' 还具有一个称为 ''glowing'' 的布尔属性，并且您想根据模型是否发光以及是否经过充能来更改模型，则需要四个变种：充能发光，充能不发光，不充能但发光，不充能不发光。如果需要，可以将同一模型分配给多个变种。
+这只是对方块状态映射的简单介绍。[[https://zh.minecraft.wiki/模型|Minecraft Wiki]] 中记录了有关方块模型和方块状态映射的所有技巧，以及在原版游戏中使用这些功能的示例。你也可以使用[[datagen_model|数据生成器生成模型]]。祝你好运！
+===== 关于性能的注意事项 =====
-变体基于添加到块中的属性的可能排列。如果需要，可以在块状态JSON中完全忽略属性，例如在第一个块状态JSON中我们忽略了``hardened``属性，但如果要在一个变体中包含属性，则必须将其包含在中所有变体。如果``mymod:my_block``还具有一个称为``glowing``的布尔属性，并且您想根据模型是否发光以及是否经过硬化来更改模型，则需要四个变体：harded off和发光，硬化并发光，硬化并发光，并硬化并发光。如果需要，可以将同一模型分配给多个变体。
+游戏开始时会注册方块的所有可能状态。这意味着，如果具有14个布尔属性，则该方块具有2 ^ 14 = 16384个不同的状态，并且会注册这2 ^ 14个状态。因此，方块不应包含太多的方块状态属性。相反，方块状态应主要保留用于视觉效果，需要使用更高级的状态应使用[[blockentity|方块实体]]。
-这只是对块状态JSON的简单介绍。 [[https://minecraft.gamepedia.com/Mode|Minecraft Wiki]]中记录了有关块状态和模型JSON的所有技巧，以及在香草中使用这些功能的示例。祝你好运！
+由于所有的可能的方块状态都已经构建好了，因此相等的方块状态是同一个对象，''with'' 方法会返回一个存在的对象，而不是创建一个新对象——例如，''CHARGEABLE_BLOCK.getDefaultState().with(CHARGED, true) == CHARGEABLE_BLOCK.getDefaultState().with(CHARGED, true)'' 会返回 ''true''。
-==== 关于性能的注意事项 ====
-游戏开始时会注册一个块的每个可能状态。 这意味着，如果您具有14个布尔属性，则该块具有2 ^ 14 = 16384个不同的状态，并且已注册2 ^ 14个状态。 因此，块不应包含太多的块状态属性。 相反，应该主要为视觉保留块状态，[[zh_cn:tutorial:blockentity | Block Entities]]应该用于更高级的状态。