Block Traits

Applying Traits #

Block traits can be used to apply vanilla block states (such as direction) to your custom blocks easily, without the need for events and triggers.

{
  "format_version": "1.20.60",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_slab",
      "menu_category": {
        "category": "construction",
        "group": "itemGroup.name.slab"
      },
      "traits": {
        "minecraft:placement_position": {
          "enabled_states": ["minecraft:vertical_half"]
        }
      }
    },
    "components": { ... },
    "permutations": [ ... ]
  }
}

This example will set the minecraft:vertical_half block state when placed to either 'top' or 'bottom' - depending on where the player is looking.

Permutations are still required for this state to make a functional difference, with conditions querying

q.block_state('minecraft:vertical_half')

Placement Direction #

Contains information about the player's rotation when the block was placed.

Released from experiment Upcoming Creator Features for format versions 1.20.60 and higher.

May enable the following states:

Additional parameters:

• y_rotation_offset - This rotation offset only applies to the horizontal state values (north, south, east, west) . Only axis-aligned angles may be specified (e.g. 90, 180, -90).

"minecraft:placement_direction": {
  "enabled_states": ["minecraft:cardinal_direction"],
  "y_rotation_offset": 180
}

Placement Position #

Contains information about where the player placed the block.

Released from experiment Upcoming Creator Features for format versions 1.20.60 and higher.

May enable the following states:

This trait has no additional parameters.

"minecraft:placement_position": {
  "enabled_states": [
    "minecraft:block_face",
    "minecraft:vertical_half"
  ]
}