🧾Trigger-data Conditions

Every registered condition on this page is documented as an independent reference entry. All entries also support the common condition fields documented on the Power Conditions page.

Registry keys on this page

• damage_value

• damage_cause

• damage_origin

• spawn_reason

• combust_duration

• regain_amount

• explosion_yield

• explosion_radius

• target_reason

• interaction_action

• input_type

• event_state

• food_change

• air_change

• state_value

• combust_origin

• knockback_cause

• knockback_reason

• exhaustion_reason

• villager_trade

• cooldown

• cooldown_material

---

damage_value

Purpose: Checks the current mutable damage result.

Context: Requires a damage-backed trigger and result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive numeric range.
compare / value	unset	Alternative numeric comparison.

Example

type: damage_value
min: 1
max: 10

Behavior and limits

• When evaluated after earlier modifiers, it reads the already-modified result.

• Unrelated triggers do not match.

---

damage_cause

Purpose: Matches the captured Bukkit EntityDamageEvent.DamageCause.

Context: Requires damage-cause event context.

Fields

Field	Default	Description
value	empty	Single damage-cause enum name.
values	empty	Accepted cause names.

Example

type: damage_cause
values:
  - PROJECTILE
  - ENTITY_ATTACK

Behavior and limits

• Matching is case-insensitive after the plugin's value normalization.

• The condition fails when no damage cause is available.

---

damage_origin

Purpose: Classifies damage by its captured origin.

Context: Requires damage-origin context.

Fields

Field	Default	Description
value	ANY	ANY, ENTITY, BLOCK, or OTHER.

Example

type: damage_origin
value: ENTITY

Behavior and limits

• OTHER means neither entity-origin nor block-origin.

• Unknown values behave as ANY in the shared implementation.

---

spawn_reason

Purpose: Matches an entity's Bukkit spawn reason.

Context: Default target: TARGET; the selected entity must expose a spawn reason.

Fields

Field	Default	Description
target	TARGET	Entity selector.
reason	empty	Single CreatureSpawnEvent.SpawnReason.
reasons	empty	Accepted reason list.

Example

type: spawn_reason
target: SOURCE
reasons:
  - NATURAL
  - REINFORCEMENTS

Behavior and limits

• Values are compared with enum names.

• The entity's stored spawn reason may be inspected outside the spawn trigger.

---

combust_duration

Purpose: Checks the current combustion-duration result.

Context: Requires a combust-event result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive numeric range.
compare / value	unset	Alternative numeric comparison.

Example

type: combust_duration
min: 1
max: 10

Behavior and limits

• When evaluated after earlier modifiers, it reads the already-modified result.

• Unrelated triggers do not match.

---

regain_amount

Purpose: Checks the current health-regain result.

Context: Requires a regain-event result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive numeric range.
compare / value	unset	Alternative numeric comparison.

Example

type: regain_amount
min: 1
max: 10

Behavior and limits

• When evaluated after earlier modifiers, it reads the already-modified result.

• Unrelated triggers do not match.

---

explosion_yield

Purpose: Checks the current explosion-yield result.

Context: Requires an entity-explosion result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive numeric range.
compare / value	unset	Alternative numeric comparison.

Example

type: explosion_yield
min: 1
max: 10

Behavior and limits

• When evaluated after earlier modifiers, it reads the already-modified result.

• Unrelated triggers do not match.

---

explosion_radius

Purpose: Checks the current primed-explosion radius.

Context: Requires an explosion-prime result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive numeric range.
compare / value	unset	Alternative numeric comparison.

Example

type: explosion_radius
min: 1
max: 10

Behavior and limits

• When evaluated after earlier modifiers, it reads the already-modified result.

• Unrelated triggers do not match.

---

target_reason

Purpose: Matches the captured Bukkit entity-target reason.

Context: Requires target/untag event context.

Fields

Field	Default	Description
value	empty	Single reason enum name.
values	empty	Accepted reason list.

Example

type: target_reason
values:
  - CLOSEST_PLAYER
  - TARGET_ATTACKED_ENTITY

Behavior and limits

• Matching is case-insensitive after normalization.

• The condition fails when no target reason is present.

---

interaction_action

Purpose: Matches a PlayerInteractEvent.Action.

Context: Requires PlayerInteractEvent, normally from on-interact.

Fields

Field	Default	Description
action	empty	Single action enum name.
actions	empty	Accepted action list.

Example

type: interaction_action
actions:
  - RIGHT_CLICK_AIR
  - RIGHT_CLICK_BLOCK

Behavior and limits

• At least one action is required.

---

input_type

Purpose: Matches active, newly pressed, or released Paper player-input controls.

Context: Requires PlayerInputEvent.

Fields

Field	Default	Description
input	empty	Single input: FORWARD, BACKWARD, LEFT, RIGHT, JUMP, SNEAK, or SPRINT.
inputs	empty	Accepted input list.
state	ACTIVE	ACTIVE, PRESSED, or RELEASED.

Example

type: input_type
inputs:
  - FORWARD
  - SPRINT
state: PRESSED

Behavior and limits

• PRESSED and RELEASED compare event input with the player's previous/current input state.

• Unknown state values fall back to ACTIVE.

---

event_state

Purpose: Matches a PlayerFishEvent.State.

Context: Requires PlayerFishEvent, normally from on-fish.

Fields

Field	Default	Description
state	empty	Single fishing state.
states	empty	Accepted fishing-state list.

Example

type: event_state
states:
  - BITE
  - CAUGHT_FISH

Behavior and limits

• At least one state is required.

---

food_change

Purpose: Checks the pending food-level delta.

Context: Requires FoodLevelChangeEvent for a player and a mutable food result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive delta range; positive increases food and negative decreases it.
compare / value	unset	Alternative numeric comparison.

Example

type: food_change
compare: '<'
value: 0

Behavior and limits

• The value is pending result food level minus the player's current food level.

---

air_change

Purpose: Checks the pending remaining-air delta.

Context: Requires EntityAirChangeEvent for a player and a mutable air result.

Fields

Field	Default	Description
min / max	unbounded	Inclusive delta range; positive increases air and negative decreases it.
compare / value	unset	Alternative numeric comparison.

Example

type: air_change
compare: '<'
value: 0

Behavior and limits

• The value is the current mutable air result minus {previous_air}, captured before the event.

• Earlier power modifiers affect the delta read here; unrelated triggers do not match.

---

state_value

Purpose: Reads a numeric state saved by the state ability that has not expired.

Context: Requires the same power, owner, key, and per-target settings used when the state was written.

Fields

Field	Default	Description
owner	SOURCE	Entity selector for the state owner. Use PLAYER when sharing player state across triggers.
key	default	State-pool name matching the state ability.
per-target	false	Whether the current target participates in the state key; must match the writer.
min / max	unbounded	Inclusive saved-state range. Missing and expired states read as 0.
compare / value	unset	Alternative numeric comparison.

Example

type: state_value
owner: PLAYER
key: lava-entry-immunity
min: 1

Behavior and limits

• State is isolated by power ID, so another enchantment or custom item may safely reuse the same key.

• A different owner, key, or per-target setting reads a different state pool.

---

combust_origin

Purpose: Matches whether combustion was caused by an entity, block, or other source.

Context: Requires EntityCombustEvent context.

Fields

Field	Default	Description
origin	empty	Single value: ENTITY, BLOCK, or OTHER.
origins	empty	Accepted origin list.

Example

type: combust_origin
origins:
  - ENTITY
  - BLOCK

Behavior and limits

• Subclass checks distinguish EntityCombustByEntityEvent and EntityCombustByBlockEvent.

---

knockback_cause

Purpose: Matches Paper EntityKnockbackEvent.Cause.

Context: Requires EntityKnockbackEvent.

Fields

Field	Default	Description
cause / causes	empty	Accepted cause name(s).
reason / reasons	empty	Aliases merged into the same accepted set.

Example

type: knockback_cause
causes:
  - ENTITY_ATTACK

Behavior and limits

• At least one configured value is required.

---

knockback_reason

Purpose: Alias of knockback_cause.

Context: Requires EntityKnockbackEvent.

Fields

Field	Default	Description
cause / causes	empty	Accepted cause name(s).
reason / reasons	empty	Accepted aliases.

Example

type: knockback_reason
reason: ENTITY_ATTACK

Behavior and limits

• Uses exactly the same implementation as knockback_cause.

---

exhaustion_reason

Purpose: Matches Bukkit EntityExhaustionEvent.ExhaustionReason.

Context: Requires EntityExhaustionEvent.

Fields

Field	Default	Description
reason	empty	Single reason.
reasons	empty	Accepted reason list.

Example

type: exhaustion_reason
reasons:
  - SPRINT
  - JUMP_SPRINT

Behavior and limits

• At least one reason is required.

---

villager_trade

Purpose: Distinguishes an actual villager trade from another Paper purchase event.

Context: Requires PlayerPurchaseEvent.

Fields

Field	Default	Description
value	true	true requires PlayerTradeEvent; false requires another purchase-event subtype.

Example

type: villager_trade
value: true

Behavior and limits

• This checks the event subtype, not recipe contents.

---

cooldown

Purpose: Acquires a condition-scoped runtime cooldown and matches only when it can be acquired.

Context: Requires a non-null power context; with positive seconds it also requires SOURCE.

Fields

Field	Default	Description
seconds	0	Cooldown length in seconds; non-positive values always match.

Example

type: cooldown
seconds: 5

Behavior and limits

• The key includes power identity and this condition's configuration path.

• This condition changes state; it is not a read-only check.

---

cooldown_material

Purpose: Matches the material involved in Paper PlayerItemCooldownEvent.

Context: Requires PlayerItemCooldownEvent.

Fields

Field	Default	Description
material	empty	Single Bukkit material name or namespaced key.
materials	empty	Accepted material list.

Example

type: cooldown_material
materials:
  - ENDER_PEARL
  - minecraft:shield

Behavior and limits

• The event material is compared by enum name and uppercase namespaced key.

---