方块文档
版本：1.18.10.4

索引#

返回顶部

方块#

方块组件#

名称	类型	默认值	描述
minecraft:aim_collision	布尔值	true	如果被设置为false，它可以禁用该方块与实体的碰撞 Experimental toggles required: Holiday Creator Features 名称 类型 默认值 描述 origin 数组 [-8.0, 0.0, -8.0] 碰撞箱的最小位置边界。Origin can't be smaller than (-8, 0, -8) and can't be more than (8, 16, 8). size 数组 [16.0, 16.0, 16.0] 该组件的箱体的每一侧的大小。When added to origin it can't make origin smaller than (-8, 0, -8) or more than (0, 16, 8).
minecraft:block_collision	布尔值 / JSON对象		Describes the collision of the block with entities and actors. 如果被设置为false，它可以禁用该方块与实体的碰撞。An origin of [-8.0, 0.0, -8.0] with a size of [16, 16, 16] is a unit cube. Experimental toggles required: Holiday Creator Features 名称 类型 默认值 描述 origin 数组 [-8.0, 0.0, -8.0] 碰撞箱的最小位置边界 size 数组 [16.0, 16.0, 16.0] 该组件的箱体的每一侧的大小
minecraft:block_light_emission	小数	0.0	该方块将会发射的光线数量，在范围[0.0, 1.0]内取值。
minecraft:block_light_filter	整数	0	该方块将会过滤的光线数量。越大的值意味着会有越多的光线被过滤掉（0 - 15）。
minecraft:breakonpush	布尔值		当被活塞推动的时候，该方块会被破坏。
minecraft:breathability	枚举器	solid	The breathing type of this block that affects the breathing state of mobs when they have their breathing points inside this block. Available values: solid, air Experimental toggles required: Holiday Creator Features
minecraft:crafting_table	JSON Object		Describes the component of a custom crafting table. This component supports only "recipe_shaped" and "recipe_shapeless" typed recipes and not others like "recipe_furnace" or "recipe_brewing_mix". If there are two recipes for one item, the recipe book will pick the first that was parsed. If two input recipes are the same, crafting may assert and the resulting item may vary. Experimental toggles required: Holiday Creator Features crafting_tags# Defines the tags recipes should define to be crafted on this table. custom_description# Defines the name in the UI of this table. If not specified, the name of the block will be used.
minecraft:creative_category	字符串		指定该方块的创造分组。
minecraft:destroy_time	小数	0.0	为该方块设置破坏时间属性。数字越大意味着挖掘时间越长。时间通过基装备以时间为单位测量。
minecraft:display_name	字符串		指定能够映射到当你的鼠标指针悬停在该方块上时将会显示的文本的语言文件键名。 需要实验性开关：假日创作者功能
minecraft:explosion_resistance	小数	0.0	为该方块设置爆炸抗性。
minecraft:flammable	JSON对象		为该方块描述可燃性属性。 名称 类型 默认值 描述 burn_odds 整数 0 当着火时，该方块将会被火焰摧毁的可能性有多大。值必须大于或等于0。 flame_odds 整数 0 当邻近一个火源时，该方块将会着火的可能性有多大。值必须大于或等于0。
minecraft:friction	小数	0.6	为该方块描述摩擦的属性，在一个[0.1, 1.0]的范围内取值。当一个实体在该方块上行进时，摩擦将影响该实体的移动速度。越大的值会造成越小的摩擦。
minecraft:geometry	字符串		要使用的几何描述标识符，该标识符必须能够匹配上一个在当前任何已经加载的资源包中存在着的几何标识符。 需要实验性开关：假日创作者功能
minecraft:immovable	布尔值		一个不可以动的方块不能被活塞推动
minecraft:loot	字符串		该战利品表相对于行为包的路径。
minecraft:map_color	字符串	#RRGGBB	以一个十六进制值表示的一种颜色。它将作为渲染一张地图时该方块使用的颜色。设置当一个方块渲染到一张地图上时该方块的颜色。该颜色以一个十六进制值以“#RRGGBB”格式表示。也可以以一个[R, G, B]从0至255的数组表达。
minecraft:material_instances	JSON对象		The material instances for a block. 将一个面或位于一个几何文件中的material_instance名称映射到一个实际的材质实例上。材质实例可以是一个完整的材质实例，也可以是一个代表另一个已经定义的实例的名称。 Experimental toggles required: Holiday Creator Features Material Instance# A material instance definition to map to a material instance in a geometry file. The material instance '*' will be used for any materials that don't have a match. Name Type Default Value Description ambient_occlusion Boolean true Should this material have ambient occlusion applied when lighting. face_dimming Boolean true Should this material be dimmed by the direction it's facing. render_method String opaque The render method to use. Must be one of 'opaque', 'double_sided', 'blend', or 'alpha_test'. texture String Texture name for the material.
minecraft:onlypistonpush	布尔值		带有这个组件的方块不会黏在stickyPistons上。
minecraft:part_visibility	JSON对象		将一个几何文件中的骨骼名映射到一个可以控制它们渲染与否的条件的上。该条件应当为一个能够使用方块属性来确定trtue或false的Molang查询。支持的查询包括‘has_block_property’、‘block_property’和其他可以在不知道该方块的游戏内位置和玩家影响的数据的情况下可以进行计算的查询。 需要实验性开关：即将到来的创作者功能
minecraft:placement_filter	JSON对象		设置在何种条件下该方块可以被放置或存活 conditions# 使该方块可以被放置或存活的条件的列表 名称 类型 默认值 描述 allowed_faces 数组 一下任意一种字符串的列表：up、down、north、south、east、west、side、all block_filter 数组 该方块可以在allowed_faces的方向上被放置在的方块的列表（可以使用标签来指定它们） 返回顶部
minecraft:preventsjumping	布尔值		该组件可以使活动对象无法于走在该方块上时跳跃
minecraft:random_ticking	JSON对象		描述了该组件将会在两个值之间的区间上定期触发一个事件 名称 类型 默认值 描述 on_tick 触发器 The event that will be triggered on ticks 名称 类型 默认值 描述 condition 字符串 1 要执行在该方块上的事件的条件。 event 字符串 set_block_property 执行在该方块上的事件的类型。 range 数组 [10, 10] 该组件将要触发其事件的范围。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:rotation	向量 [a, b, c]	rotation[0, 0, 0]	这是该方块围绕该立方体中心的旋转角（角度制）。旋转值的顺序是x-y-z。
minecraft:ticking	JSON对象		描述了该组件将会在两个值之间的区间上定期触发一个事件 名称 类型 默认值 描述 looping 布尔值 true 该事件是否循环 on_tick 触发器 The event that will be triggered on ticks 名称 类型 默认值 描述 condition 字符串 1 要执行在该方块上的事件的条件。 event 字符串 set_block_property 执行在该方块上的事件的类型。 range 数组 [10, 10] 该组件将要触发其事件的范围。 target 字符串 self 执行在该方块上的事件的目标对象。 range 数组 [10, 10] 该组件将要触发其事件的范围。
minecraft:unit_cube	JSON对象		指定在镶嵌（曲面细分）时使用一个单位立方体。 需要实验性开关：假日创作者功能
minecraft:unwalkable	布尔值	false	设置该方块为不可行走。当该值设置为true时，生物不会尝试途经其上。

返回顶部

方块定义属性#

这些属性是方块定义的一部分。这有助于系统确定如何解析和初始化该方块。

名称	类型	默认值	描述
format_version	字符串		指定制作该实体的游戏的版本。如果该版本比当前版本低，则任何对原版版本中的实体做出的变更都将应用到它身上。

代码示例

示例

{
  "format_version": "1.16.0",
  "minecraft:block": {
    "description": {
      "identifier": "design:lavenderstone"
    },
    "components": {
      "minecraft:loot": "loot_tables/chests/simple_dungeon.json",
      "minecraft:destroy_time": 4.0,
      "minecraft:friction": 0.6,
      "minecraft:map_color": "#00ff00",
      "minecraft:flammable": {
        "flame_odds": 50,
        "burn_odds": 0
    },
      "minecraft:block_light_emission": 1.0
    }
  }
}

返回顶部

方块描述属性#

名称	类型	默认值	描述
identifier	字符串		该方块的标识符。该名称必须包含一个命名空间，而且除非想要覆写一个原版方块，否则不可以使用minecraft命名空间。

返回顶部

方块事件响应#

方块触发器组件的事件响应。

名称	类型	默认值	描述
add_mob_effect	JSON对象		将生物效果应用到目标对象。 名称 类型 默认值 描述 amplifier 整数 0 该生物效果的倍率。 duration 小数 0.0 该生物效果的持续时间。 effect 字符串 要应用的生物效果。 target Minecraft过滤器 self 要对其执行的目标对象上下文。
damage	JSON对象		对该目标对象结算伤害。 名称 类型 默认值 描述 amount 整数 0 要结算的伤害的数量。 target Minecraft过滤器 self 要对其执行的目标对象上下文。 type 字符串 要结算的伤害的类型
decrement_stack	JSON对象		自减物品堆叠。
die	JSON对象		杀死目标对象。如果目标对象是self且该事件运行自一个方块，则摧毁该方块。/br> 名称 类型 默认值 描述 target Minecraft过滤器 self 要对其执行的目标对象上下文。
play_effect	JSON对象		相对于目标对象的位置生成一个粒子效果。 名称 类型 默认值 描述 data 整数 0 粒子数据值。 effect 字符串 要创建的粒子效果的名称。 target Minecraft过滤器 self 要对其执行的目标对象上下文。
play_sound	JSON对象		相对于目标对象的位置播放一个声音。 名称 类型 默认值 描述 sound 字符串 要播放的声音的名称。 target Minecraft过滤器 self 要对其执行的目标对象上下文。
remove_mob_effect	JSON对象		从目标对象上移除生物效果。 名称 类型 默认值 描述 effect 字符串 要移除的生物效果。使用‘all’以从目标对象上移除所有生物效果。 target Minecraft过滤器 self 要对其执行的目标对象上下文。
run_command	JSON对象		触发一个斜杠命令或一个斜杠命令的列表。 名称 类型 默认值 描述 command 字符串 要运行的斜杠命令。 command array 数组 要运行的斜杠命令的列表。 target Minecraft过滤器 self 要对其执行的目标对象上下文。
set_block	JSON对象		要将该方块设置为另一个方块类型。 名称 类型 默认值 描述 block_type 字符串 要设置的方块的类型。
set_block_at_pos	JSON对象		将相对于该方块的一个方块设置为另一个方块类型。 名称 类型 默认值 描述 block_offset 向量 [a, b, c] [0.0, 0.0, 0.0] 从该方块的中心的偏移量。 block_type 字符串 要设置的方块的类型。
set_block_property	JSON对象		在该方块上设置一个方块属性。 名称 类型 默认值 描述 property Molang 要在该方块上设置的方块属性。
spawn_loot	JSON对象		从方块生成一次战利品。 名称 类型 默认值 描述 table 字符串 相对于行为包的路径到该战利品表文件的文件路径
swing	JSON对象		可以造成活动对象挥摆的事件。
teleport	JSON对象		将目标对象随机传送到目的地点周围。 名称 类型 默认值 描述 avoid_water 布尔值 true 确定该次传送是否避免将目标对象放置在水中。 destination 向量 [a, b, c] [0.0, 0.0, 0.0] 该次传送的原始目的地。 land_on_block 布尔值 true 确定该次传送是否将目标对象放置在一个方块上。 max_range 向量 [a, b, c] [8.0, 8.0, 8.0] 该目标对象能够相对于原始目的地传送的最大范围。 target Minecraft过滤器 self 要对其执行的目标对象上下文。
transform_item	JSON对象		将物品转化为另一个物品。 名称 类型 默认值 描述 transform 字符串 该物品应当转化为的物品的名称。

代码示例

事件响应示例

    "minecraft:block": {
      "description": {
        "identifier": "test:on_interact_change_state_block",
        "properties": {
          "minecraft:direction": {
          }
        }
      },
      "components": {
        "minecraft:on_interact": {
          "event": "test_event"
        }
      },
      "events": {
        "test_event": {
          "set_block_property": {
            "minecraft:direction": "1"
          }
        }
      }
    }

返回顶部

方块触发器组件#

名称	类型	默认值	描述
minecraft:on_fall_on	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 min_fall_distance 小数 0.0 一个活动对象想要触发该事件所需下落的最小距离（以方块为单位）。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_interact	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_placed	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_player_destroyed	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_player_placing	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_step_off	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_step_on	JSON对象		描述了该方块的事件。 名称 类型 默认值 描述 condition 字符串 要执行在该方块上的事件的条件。 event 字符串 执行在该方块上的事件。 target 字符串 self 执行在该方块上的事件的目标对象。

返回顶部