Block Behavior¶

文档版本：1.21.0.24

The minecraft block behavior specification.

架构¶

block:
{
  format_version "format_version"
  blocks "minecraft:block"
}

format_version：format_version

format_version:
string

minecraft:block：blocks

blocks:
{
  object "description" : opt
  {
    identifier "identifier"
    object "menu_category" : opt
    {
      creative_category "category"
      item_group "group"
      boolean "is_hidden_in_commands" : opt
    }
    object "states" : opt
    {
      enum "^([a-zA-Z0-9_]+:[a-zA-Z0-9_\-]+)$"
      integer_range "^([a-zA-Z0-9_]+:[a-zA-Z0-9_\-]+)$"
    }
    object "traits" : opt
    {
      placement_direction "minecraft:placement_direction"
      placement_position "minecraft:placement_position"
    }
  }
  events "events"
  object "components" : opt
  {
    collision_box "minecraft:collision_box"
    crafting_table "minecraft:crafting_table"
    destructible_by_explosion "minecraft:destructible_by_explosion"
    destructible_by_mining "minecraft:destructible_by_mining"
    display_name "minecraft:display_name"
    flammable "minecraft:flammable"
    friction "minecraft:friction"
    geometry "minecraft:geometry"
    light_dampening "minecraft:light_dampening"
    light_emission "minecraft:light_emission"
    loot "minecraft:loot"
    map_color "minecraft:map_color"
    material_instances "minecraft:material_instances"
    placement_filter "minecraft:placement_filter"
    selection_box "minecraft:selection_box"
    transformation "minecraft:transformation"
    on_fall_on "minecraft:on_fall_on"
    on_interact "minecraft:on_interact"
    on_placed "minecraft:on_placed"
    on_player_destroyed "minecraft:on_player_destroyed"
    on_player_placing "minecraft:on_player_placing"
    on_step_off "minecraft:on_step_off"
    on_step_on "minecraft:on_step_on"
    random_ticking "minecraft:queued_ticking"
    random_ticking "minecraft:random_ticking"
    object "tag:.+" : opt
    {
    }
  }
  array "permutations" : opt
  {
    object "<any array element>" : opt
    {
      0 "condition"
      object "components" : opt
      {
      }
    }
  }
}

description：object: The description for this block.

description

identifier：identifier: The identifier for this block. The name must include a namespace and must not use the Minecraft namespace unless overriding a Vanilla block.

identifier:
string

menu_category：object: Specifies the menu category and group for the block, which determine where this block is placed in the inventory and crafting table container screens. If this field is omitted, the block will not appear in the inventory or crafting table container screens.

menu_category

category：creative_category

creative_category:
string

group：item_group

item_group:
string

is_hidden_in_commands：boolean: Determines whether or not this item can be used with commands such as /give and /setblock. Commands can use blocks by default

states：object: Block states are variables that can be set to different values in order to change how your block looks or behaves.

states

^([a-zA-Z0-9_]+:[a-zA-Z0-9_\-]+)$：enum: The key defines the name of a state, which must be properly namespaced. Each value is an array that contains all of the possible values of that state or an object defining a range of integers.

enum:
array
{
  boolean "<any array element>" : opt
}

<any array element>：boolean

enum:
array
{
  integer "<any array element>" : opt
}

<any array element>：integer

enum:
array
{
  string "<any array element>" : opt
}

<any array element>：string

^([a-zA-Z0-9_]+:[a-zA-Z0-9_\-]+)$：integer_range: The key defines the name of a state, which must be properly namespaced. Each value is an array that contains all of the possible values of that state or an object defining a range of integers.

integer_range:
{
  object "values" : opt
  {
    integer "min" : opt
    integer "max" : opt
  }
}

values：object

values

min：integer: The lowest integer this state supports. This is also used as the default state value.

max：integer: The highest integer this state supports. This cannot be more than 15 above the minimum.

traits：object: A shortcut for creators to use Vanilla block states without needing to define and manage a series of events or triggers on custom blocks

traits

minecraft:placement_direction：placement_direction

placement_direction:
{
  array "enabled_states" : opt
  {
    string "<any array element>" : opt
  }
  number "y_rotation_offset" : opt
}

enabled_states：array: Block states you wish to enable

enabled_states

<any array element>：string

y_rotation_offset：number: This rotation offset only applies to the horizontal state values

minecraft:placement_position：placement_position

placement_position:
{
  array "enabled_states" : opt
  {
    string "<any array element>" : opt
  }
}

enabled_states：array: Block states you wish to enable

enabled_states

<any array element>：string

events：events

events:
{
  object "minecraft:on_fall_on" : opt
  {
    string "condition" : opt
    string "event" : opt
    string "target" : opt
  }
  object "minecraft:on_interact" : opt
  {
  }
  object "minecraft:on_placed" : opt
  {
  }
  object "minecraft:on_player_destroyed" : opt
  {
  }
  object "minecraft:on_player_placing" : opt
  {
  }
  object "minecraft:on_step_off" : opt
  {
  }
  object "minecraft:on_step_on" : opt
  {
  }
}

minecraft:on_fall_on：object: UNDOCUMENTED.

minecraft:on_fall_on

condition：string: The condition of event to be executed on the block.

event：string: The event executed on the block.

target：string: The target of event executed on the block.

minecraft:on_interact：object: UNDOCUMENTED.

minecraft:on_interact

minecraft:on_placed：object: UNDOCUMENTED.

minecraft:on_placed

minecraft:on_player_destroyed：object: UNDOCUMENTED.

minecraft:on_player_destroyed

minecraft:on_player_placing：object: UNDOCUMENTED.

minecraft:on_player_placing

minecraft:on_step_off：object: UNDOCUMENTED.

minecraft:on_step_off

minecraft:on_step_on：object: UNDOCUMENTED.

minecraft:on_step_on

components：object: UNDOCUMENTED.

components

minecraft:collision_box：collision_box: minecraft:collision_box组件。UNDOCUMENTED.

minecraft:crafting_table：crafting_table: minecraft:crafting_table组件。UNDOCUMENTED.

minecraft:destructible_by_explosion：destructible_by_explosion: minecraft:destructible_by_explosion组件。UNDOCUMENTED.

minecraft:destructible_by_mining：destructible_by_mining: minecraft:destructible_by_mining组件。UNDOCUMENTED.

minecraft:display_name：display_name: minecraft:display_name组件。UNDOCUMENTED.

minecraft:flammable：flammable: minecraft:flammable组件。UNDOCUMENTED.

minecraft:friction：friction: minecraft:friction组件。UNDOCUMENTED.

minecraft:geometry：geometry: minecraft:geometry组件。UNDOCUMENTED.

minecraft:light_dampening：light_dampening: minecraft:light_dampening组件。UNDOCUMENTED.

minecraft:light_emission：light_emission: minecraft:light_emission组件。UNDOCUMENTED.

minecraft:loot：loot: minecraft:loot组件。UNDOCUMENTED.

minecraft:map_color：map_color: minecraft:map_color组件。UNDOCUMENTED.

minecraft:material_instances：material_instances: minecraft:material_instances组件。UNDOCUMENTED.

minecraft:placement_filter：placement_filter: minecraft:placement_filter组件。UNDOCUMENTED.

minecraft:selection_box：selection_box: minecraft:selection_box组件。UNDOCUMENTED.

minecraft:transformation：transformation: minecraft:transformation组件。UNDOCUMENTED.

minecraft:on_fall_on：on_fall_on: minecraft:on_fall_on组件。UNDOCUMENTED.

minecraft:on_interact：on_interact: minecraft:on_interact组件。UNDOCUMENTED.

minecraft:on_placed：on_placed: minecraft:on_placed组件。UNDOCUMENTED.

minecraft:on_player_destroyed：on_player_destroyed: minecraft:on_player_destroyed组件。UNDOCUMENTED.

minecraft:on_player_placing：on_player_placing: minecraft:on_player_placing组件。UNDOCUMENTED.

minecraft:on_step_off：on_step_off: minecraft:on_step_off组件。UNDOCUMENTED.

minecraft:on_step_on：on_step_on: minecraft:on_step_on组件。UNDOCUMENTED.

minecraft:queued_ticking：random_ticking: minecraft:queued_ticking组件。UNDOCUMENTED.

minecraft:random_ticking：random_ticking: minecraft:random_ticking组件。UNDOCUMENTED.

tag:.+：object: Applies a tag to the block, using the key without the "tag:" prefix as the tag name.

tag:.+

permutations：array: UNDOCUMENTED.

permutations

<any array element>：object: UNDOCUMENTED.

<any array element>

condition：0: A Molang expression that evaluates to true or false to determine if this permutation should be used. For permutation conditions you are limited to using one Molang query: "query.block_state()"

0:
string

0:
boolean

components：object: UNDOCUMENTED.

components