Skip to content

Event Args

For: advanced users reading trigger payloads.

Every trigger carries event args, read with <args:index>. The trigger list lives in Run Timing.

Tag Meaning
<args:index> Trigger's event arg by index; bare <args> reads 0; a missing index yields null.
<ismobhostile:type> true when the entity type is hostile (pair with <args:0> on ON_MOB_KILLED).

Each trigger carries its own event args, read with <args:index>. A missing index yields null; a non-numeric index warns and yields null:

Trigger Args
ON_START None: every index is null.
INTERVAL 0: the seconds actually waited for this firing.
ON_MOB_KILLED 0: the killed mob's entity type name (e.g. ZOMBIE).
ON_PLAYER_KILLS, ON_HUNTER_KILLS, ON_SPEEDRUNNER_KILLS 0: the exact name of the killer (vanilla or struggle-attributed, so lava deaths after combat count). 1: the exact name of the killed player.
ON_NETHER_ENTER, ON_END_ENTER, ON_FIRST_NETHER_ENTER, ON_FIRST_END_ENTER 0: the origin world name, 1: the destination world name.
ON_EVERY_ADVANCEMENT 0: the advancement's namespaced key (e.g. minecraft:nether/root).
ON_RESPAWN, ON_SPEEDRUNNER_RESPAWN, ON_HUNTER_RESPAWN 0: the death location as one list, [x, y, z, world, pitch, yaw].
ON_DAMAGE_TAKEN 0: the damaged player's name. 1: damage taken in half hearts. 2: the damage dealer's name, or null for mobs and the environment. 3: the Bukkit damage cause name (FALL, PROJECTILE, ENTITY_ATTACK, ...). 4: attacker distance in blocks, or null with no attacker.
ON_DEATH 0: the exact name of the player who died. 1: the exact name of the killer (vanilla or struggle-attributed), or null for natural and self deaths. 2: the victim's former role (HUNTER or SPEEDRUNNER).
ON_DISCONNECT 0: the quitter name. 1: the quitter role at disconnect.
ON_ELIM, ON_SPEEDRUNNER_ELIM, ON_HUNTER_ELIM 0: the exact name of the eliminated player. 1: the former role (HUNTER or SPEEDRUNNER).

<ismobhostile:type> answers whether an entity type is hostile to players (the platform hostile marker, so ghasts, slimes, and shulkers count alongside zombies): pair it with <args:0> on ON_MOB_KILLED to count hostile kills only. Names match case-blind with an optional minecraft: prefix; unknown names warn and read false, malformed tags warn and yield null.

Next Steps