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.26.10",
    "minecraft:block": {
        "description": {
            "identifier": "wiki:custom_slab",
            "menu_category": {
                "category": "construction",
                "group": "minecraft: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.

Entries in the permutations array are still required for this state to make a functional difference, with conditions querying

q.block_state('minecraft:vertical_half')

List of Traits ​

Connection ​

Allows for fence-like connection permutations by updating cardinal connection states based on adjacent blocks.

Requires format version 1.26.0 or later.

• enabled_states — Array
  • May only contain "minecraft:cardinal_connections", which enables all of the following states.

Provided States ​

"minecraft:connection": {
    "enabled_states": ["minecraft:cardinal_connections"]
}

Placement Direction ​

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

Requires format version 1.26.0 or later.

• enabled_states — Array
  • May contain any of the states from the table below (excluding minecraft:corner), enabling only the states specified.
  • Alternatively, may contain "minecraft:corner_and_cardinal_direction" which enables both minecraft:corner and minecraft:cardinal_direction.
• y_rotation_offset — Integer (optional)
  • 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).
• blocks_to_corner_with — Array (optional)
  • Lists the blocks (as an array of block descriptors) that the block can create corners with.
  • This parameter may only be specified when "minecraft:corner_and_cardinal_direction" is included in the enabled_states array.

Provided States ​

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

Placement Position ​

Contains information about where the player placed the block.

Requires format version 1.20.20 or later.

• enabled_states — Array
  • May contain any of the states from the table below, enabling only the states specified.

Provided States ​

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