Conditions

Conditions control how filters match activities. A filter will only apply if an activity matches all defined conditions.

Condition values work like parameter values - any value in the list that matches is enough.

above / below

Match by Y coordinate. Inclusive. May be combined to form a Y range.

# Ignore everything below ground
conditions {
    below=64
}

actions

List of action type keys (e.g. block-break, block-place, item-throw). Case-sensitive; keys are lowercase kebab-case.

conditions {
    actions=[block-break, block-place]
}

affected-block / cause-block

Match the block an activity affected (affected-block) or the block that caused it (cause-block).

conditions {
    affected-block {
        tags=["minecraft:dirt", "minecraft:base_stone_overworld"]
        materials=[gravel]
    }
}

affected-entity-type / cause-entity-type

Match the entity an activity affected, or the entity type that caused it.

conditions {
    cause-entity-type {
        entity-types=[creeper, tnt, wither]
    }
}

bounds

Match activities inside an axis-aligned box (inclusive). Both min and max are required; corners may be given in any order.

conditions {
    bounds {
        min { x=-100, y=0, z=-100 }
        max { x=100, y=320, z=100 }
    }
}

cause-types

Match by the category of an activity’s cause rather than a specific value.

• block — a block cause (e.g. a dispenser)
• entity — a non-player entity cause (creeper, breeze, etc.)
• named — a named/string cause (gravity, etc.)
• player — a player cause

# Ignore item-throw fired by any non-player entity
conditions {
    actions=[item-throw]
    cause-types=[entity]
}

cause-player / affected-player

Match by player name. cause-player is the acting player; affected-player is a player targeted by the action.

game-modes applies to cause-player only; it has no effect under affected-player.

conditions {
    cause-player {
        names=[Notch, jeb_]
        game-modes=[CREATIVE]
    }
}

item

Match the item material involved in an activity (e.g. drops, item use).

named-causes

List of non-player, non-entity, non-block causes such as gravity or natural causes. Matches only activities whose cause is a named/string cause.

permissions

List of permission nodes. Matches when the cause player has any listed permission. (No exclude variant.)

radius

Match activities within distance blocks of center, on each axis — i.e. a cube of center ± distance (inclusive), matching the lookup r: parameter. Both center and distance are required.

conditions {
    radius {
        center { x=0, y=64, z=0 }
        distance=150
    }
}

worlds

Match by world name. Case-sensitive (exact world folder name).