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.21.70",
    "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.

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

q.block_state('minecraft:vertical_half')

List of Traits ​

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.20 and higher.

Provided 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.20 and higher.

Provided States ​

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