# Triggers

Triggers are the events that will activate an ability. Examples of triggers include a player attacking another player, a mob taking damage, they can be environmental events, or a block being broken. Triggers can also have their own parameters, such as a specific type of damage or a certain block material.

Triggers are events that activate abilities in the system. When a trigger occurs, the system checks for any abilities that are set to activate on that trigger and performs the corresponding effects.

<figure><img src="https://3757509724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNDIkpfP9aokpBUK8Gs8%2Fuploads%2FsjU0JvIzjqlxrbjcl2Ig%2Fimage.gif?alt=media&#x26;token=6d99a127-30af-4f57-8caf-5c41570ad800" alt=""><figcaption><p><a href="https://mintservers.com/?utm_source=gitbook_wiki&#x26;utm_medium=banner&#x26;utm_content=gitbook"><strong>Sponsored by MintServers. AdvancedPlugins.net integration &#x26; auto updates. Unlimited RAM plan for only $9.99!</strong></a></p></figcaption></figure>

### External Triggers

Here are the external triggers, which depend on other plugins or systems to work

<table data-full-width="true"><thead><tr><th width="243">Name</th><th width="307.3333333333333">Description</th><th>For plugin</th></tr></thead><tbody><tr><td>CUSTOM_MOB_DEFENSE</td><td>Activates when a custom mob is hit</td><td>AdvancedMobs</td></tr></tbody></table>

### Internal Triggers

Here is a list of all the default available triggers, along with a brief description of each:

{% hint style="info" %}
**MINING**, **ATTACK** and **ATTACK\_MOB** triggers do not work with off-hand items.
{% endhint %}

<table data-full-width="true"><thead><tr><th width="291.5">Name</th><th>Description</th></tr></thead><tbody><tr><td>ATTACK</td><td>Activates when a player/mob hits a player</td></tr><tr><td>ATTACK_MOB</td><td>Activates when a player/mob hits a mob</td></tr><tr><td>ARROW_HIT</td><td>Activates when an arrow hits an entity</td></tr><tr><td>BOW_FIRE</td><td>Activates when a bow is fired full power</td></tr><tr><td>BITE_HOOK</td><td>Activates when fish bites fishing hook (or item gets caught on it)</td></tr><tr><td>BREW_POTION</td><td>Activates when player brews a potion (variables: %potion type%, %is extended%, %is upgraded%)</td></tr><tr><td>CATCH_FISH</td><td>Activates when a player catches a fish (does not activate with entities)</td></tr><tr><td>COMMAND</td><td>Activates when player runs a command. Specify a command at the same block as chances, cooldowns are set, example here:<br><code>chance: 100</code><br><code>cooldown: 0</code><br><code>command: exampleCommand</code></td></tr><tr><td>HOOK_ENTITY</td><td>Activates when player hooks an entity with a fishing rod</td></tr><tr><td>DEATH</td><td>Activates when a player or mob dies</td></tr><tr><td>DEFENSE</td><td>Activates when a player/mob is hit by a player</td></tr><tr><td>DEFENSE_MOB</td><td>Activates when a player/mob is hit by a mob</td></tr><tr><td>DEFENSE_MOB_PROJECTILE</td><td>Activates when a player/mob is hit by a projectile from a mob</td></tr><tr><td>DEFENSE_PROJECTILE</td><td>Activates when a player/mob is hit by a projectile from a player</td></tr><tr><td>EAT</td><td>Activates when a player eats</td></tr><tr><td>ELYTRA_FLY</td><td>Activates when an entity starts flying with an elytra</td></tr><tr><td>EXPLOSION</td><td>Activates when an entity takes explosion damage</td></tr><tr><td>FALL_DAMAGE</td><td>Activates when an entity takes fall damage</td></tr><tr><td>ELYTRA_FLY_DAMAGE</td><td>Activates when entity takes damage while flying with elytra</td></tr><tr><td>FIRE</td><td>Activates when an entity takes fire damage</td></tr><tr><td>HELD</td><td>Activates when player holds an item</td></tr><tr><td>ITEM_BREAK</td><td>Activates when a player breaks an item</td></tr><tr><td>JUMP</td><td>Activates when a player jumps</td></tr><tr><td>JOIN</td><td>Activates when any player joins (on all items)</td></tr><tr><td>QUIT</td><td>Activates when any player leaves (on all items)</td></tr><tr><td>KILL</td><td>Activates when any entity kills another entity</td></tr><tr><td>KILL_MOB</td><td>Activates when any entity kills a mob</td></tr><tr><td>KILL_PLAYER</td><td>Activates when any entity kills a player</td></tr><tr><td>MINING</td><td>Activates when a block is broken</td></tr><tr><td>PASSIVE_DEATH</td><td>Activates when an entity is struck by lightning</td></tr><tr><td>RIGHT_CLICK</td><td>Activates when a player right clicks blocks, air</td></tr><tr><td>RIGHT_CLICK_ENTITY</td><td>Activates when player right clicks entity</td></tr><tr><td>ROD_CAST</td><td>Activates when a player casts their fishing rod</td></tr><tr><td>SHOOT</td><td>Activates when a player/mob shoots a player</td></tr><tr><td>SHOOT_MOB</td><td>Activates when a player/mob shoots a mob</td></tr><tr><td>SWING</td><td>Activates when a player swings their held item</td></tr><tr><td>SHIELD_BLOCK</td><td>Activates when a player blocks with a shield</td></tr><tr><td>HORN</td><td>Activates when player blows a horn</td></tr><tr><td>EFFECT_STATIC</td><td>Activates when a player equips or unequips armor</td></tr><tr><td>REPEATING</td><td>Repeatingly activates effects. Must set <code>time</code>settings in the same block as effects list. If you don't wish the effect to apply immediately, you must set <code>instantApply</code> setting to <code>false</code> in the same block as effects list. That will respect the <code>time</code> setting for apply delay.</td></tr></tbody></table>
