# Effects

Effects are the actions that will be performed when an ability is activated. Examples of effects include damaging an entity, healing an entity, or teleporting an entity. There are many different types of effects available, each with their own unique properties and parameters.

## Effect examples

```yaml
effects:
- 'BURN:40'
- 'MESSAGE:<random word>Hello,Hi,Greetings</random word> %victim name%!'
```

In this example, when the trigger occurs, the victim will be set on fire for 2 seconds, a random greeting will be sent to the victim with their name.

<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>

## Effect List

There are many different types of effects that can be used in our ability system. Some of the effects available are:

<table data-full-width="true"><thead><tr><th width="439">Usage</th><th>Description</th></tr></thead><tbody><tr><td><code>ACTION_BAR:&#x3C;TEXT></code></td><td>Send an actionbar message</td></tr><tr><td><code>ADD_DURABILITY_CURRENT_ITEM:&#x3C;AMOUNT></code></td><td>Modify durability of main item</td></tr><tr><td><code>ADD_DURABILITY_ARMOR:&#x3C;AMOUNT></code></td><td>Armor durability: <code>− = damage</code>, <code>+ = repair</code>. Ex: <code>ADD_DURABILITY_ARMOR:-10</code></td></tr><tr><td><code>ADD_DURABILITY_ITEM:&#x3C;SLOT>:&#x3C;AMOUNT></code></td><td>Repair item</td></tr><tr><td><code>ADD_FLY_SPEED</code></td><td>Adds to the player's fly speed (from -1 to 1)</td></tr><tr><td><code>ADD_FOOD:&#x3C;AMOUNT></code></td><td>Modify player's food level</td></tr><tr><td><code>ADD_HEALTH:&#x3C;HEALTH></code></td><td>Add health to entity</td></tr><tr><td><code>ADD_MONEY:&#x3C;AMOUNT></code></td><td>Add money to player account</td></tr><tr><td><code>ADD_WALK_SPEED</code></td><td>Adds to the player's walk speed (from -1 to 1)</td></tr><tr><td><code>AIR:&#x3C;AMOUNT></code></td><td>Modify player's remaining air</td></tr><tr><td><code>AUTO_REEL</code></td><td>Auto reel in fish from fishing rod (for BITE_HOOK trigger only)</td></tr><tr><td><code>BLEED:&#x3C;DAMAGE>:&#x3C;TICKS>:&#x3C;INTERVAL_TICKS></code></td><td>Steal entity bleed</td></tr><tr><td><code>BLOOD</code></td><td>Display blood effect</td></tr><tr><td><code>BOOST:[DIRECTION]:[AMOUNT]</code></td><td>Boost entity up in air</td></tr><tr><td><code>BREAK_BLOCK</code></td><td>Break block</td></tr><tr><td><code>BREAK_TREE:[MAX_LOGS]:[MAX_LEAVES]</code></td><td>Break a whole tree at once</td></tr><tr><td><code>BURN:&#x3C;SECONDS></code></td><td>Set an entity on fire</td></tr><tr><td><code>CACTUS</code></td><td>Display cactus effect</td></tr><tr><td><code>CANCEL_EVENT</code></td><td>Cancel Event, e.g. an attack</td></tr><tr><td><code>CANCEL_USE:&#x3C;MATERIAL>:&#x3C;TICKS></code></td><td>Cancel use of a material, e.g. ENDER_PEARL</td></tr><tr><td><code>CONSOLE_COMMAND:&#x3C;COMMAND></code></td><td>Run command through console</td></tr><tr><td><code>CURE:&#x3C;POTION></code></td><td>Remove non-permanent potion effect</td></tr><tr><td><code>CURE_PERMANENT:&#x3C;POTION></code></td><td>Remove permanent potion effect</td></tr><tr><td><del><code>DAMAGE_ARMOR</code></del></td><td>Removed. Use <strong>ADD_DURABILITY_ARMOR</strong> effect</td></tr><tr><td><code>DECREASE_DAMAGE:&#x3C;AMOUNT></code></td><td>Decrease damage by percentage</td></tr><tr><td><code>DISABLE_ACTIVATION:&#x3C;NAME>:&#x3C;SECONDS></code></td><td>Disable activation for seconds</td></tr><tr><td><code>DISABLE_KNOCKBACK:&#x3C;TICKS></code></td><td>Disable entity's knockback for time</td></tr><tr><td><code>DISARM</code></td><td>Disarm Entity</td></tr><tr><td><code>DO_HARM:&#x3C;HEALTH></code></td><td>Harm an entity by doing health damage. This does not ignore armor and dealt damage may be reduced depending on armor</td></tr><tr><td><code>REMOVE_HEALTH:&#x3C;HEALTH></code></td><td>Take entity's health away, ignores armor and <strong>does not play damage animation for player</strong></td></tr><tr><td><code>REMOVE_HEALTH_DAMAGE:&#x3C;HEALTH></code></td><td>Take entity's health away, ignore armor <strong>play damage animation for player</strong></td></tr><tr><td><code>REMOVE_HEALTH_TOTEM</code></td><td>Remove health from an entity while allowing the use of totem, "%e:&#x3C;HEALTH>"</td></tr><tr><td><code>REMOVE_HEALTH_DAMAGE_TOTEM</code></td><td>Remove health from an entity with damage effect while allowing the use of totem, "%e:&#x3C;HEALTH>"</td></tr><tr><td><code>DOUBLE_DAMAGE</code></td><td>Double damage</td></tr><tr><td><code>DROP_HEAD</code></td><td>Drop player or mob head</td></tr><tr><td><code>EXP:&#x3C;AMOUNT></code></td><td>Drop Experience Orbs</td></tr><tr><td><code>EXPLODE:&#x3C;POWER>:&#x3C;FIRE (true/false)>:&#x3C;BREAK BLOCKS (true/false></code></td><td>Create an explosion</td></tr><tr><td><code>EXTINGUISH</code></td><td>Extinguish an entity</td></tr><tr><td><code>FIREBALL</code></td><td>Shoot a fireball</td></tr><tr><td><code>FIREWORK:[COLOR]:[FADE_COLOR]:[TYPE]:[POWER]:[TRAIL]:[FLICKER]</code></td><td>Spawns a firework. Examples:<br><code>- FIREWORK:RED:ORANGE:BALL:1:true:true</code><br><code>- FIREWORK:255,0,255:0,255,0:BURST:3:false:true</code><br></td></tr><tr><td><code>FLY:[TICKS]</code></td><td>Toggle player's flight</td></tr><tr><td><code>FLY_SPEED:&#x3C;SPEED></code></td><td>Sets the player's fly speed (from -1 to 1)</td></tr><tr><td><code>FREEZE:&#x3C;TICKS></code></td><td>Freeze Entity</td></tr><tr><td><code>GUARD:&#x3C;ENTITY>:&#x3C;SECONDS>:&#x3C;AMOUNT>:&#x3C;NAME>:&#x3C;SWITCH_ROLES></code></td><td>Spawn a guard to protect an entity. Use baby version of supported mobs by adding <code>BABY_</code> prefix to the type, e.g. <code>BABY_ZOMBIE</code>. <code>SWITCH_ROLES</code> is used to anger the guard at the target instead of protecting him</td></tr><tr><td><code>GIVE_ITEM:&#x3C;MATERIAL>:[AMOUNT]</code></td><td>Give items to user/location</td></tr><tr><td><code>HALF_DAMAGE</code></td><td>Half damage effect</td></tr><tr><td><code>IGNORE_ARMOR_DAMAGE</code></td><td>Cancel armor durability reduction</td></tr><tr><td><code>IGNORE_ARMOR_PROTECTION</code></td><td>Ignores armor damage reduction</td></tr><tr><td><code>INCREASE_DAMAGE:&#x3C;AMOUNT></code></td><td>Increase damage by percentage</td></tr><tr><td><code>INVINCIBLE</code></td><td>Toggle entity's invincibility</td></tr><tr><td><code>KILL</code></td><td>Kill an entity</td></tr><tr><td><code>KEEP_ON_DEATH</code></td><td>Keep item on death</td></tr><tr><td><code>LIGHTNING:[BOOLEAN]</code></td><td>Strike a lightning. Optional argument if true, will cause block damage and harm players around, if false, will only play a visual lightning effect. Default is true.</td></tr><tr><td><code>MESSAGE:&#x3C;TEXT></code></td><td>Send a message</td></tr><tr><td><code>MORE_DROPS:&#x3C;AMOUNT></code></td><td>Multiplies item drops by the value set in &#x3C;AMOUNT>. We recommend that you set a whitelist for materials, otherwhise this will multiply all drops (e.g. diamond_block) <a href="settings">Settings</a></td></tr><tr><td><code>NEGATE_DAMAGE:&#x3C;AMOUNT></code></td><td>Negate a specified amount of damage</td></tr><tr><td><code>PARTICLE:&#x3C;PARTICLE>:&#x3C;AMOUNT>:&#x3C;OFFSET></code></td><td>Play particles at a location <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html">ParticleEffectTypes</a></td></tr><tr><td><code>PARTICLE_LINE:&#x3C;PARTICLE>:&#x3C;AMOUNT>:&#x3C;POINTS></code></td><td>Play particles in straight line. Amount = number of particles in each point, Points = number of points between two locations that particles will be shown at.</td></tr><tr><td><code>PERMISSION:&#x3C;TEXT></code></td><td>Toggle player's permission</td></tr><tr><td><code>PLANT_SEEDS:&#x3C;RADIUS>:&#x3C;SEEDS></code></td><td>Plant seeds in radius. Seed types: SEEDS, POTATO, MELON, PUMPKIN, CARROT, BEETROOT, NETHER_WART</td></tr><tr><td><code>PLAYER_COMMAND:&#x3C;COMMAND></code></td><td>Run command through player</td></tr><tr><td><code>PLAY_SOUND:&#x3C;SOUND>:[PITCH]:[VOLUME]</code></td><td>Play sound for a specific player</td></tr><tr><td><code>PLAY_SOUND_OUTLOUD:&#x3C;SOUND>:[PITCH]:[VOLUME]</code></td><td>Play sound at a location</td></tr><tr><td><code>POTION:&#x3C;POTION>:&#x3C;LEVEL>:[TICKS]</code></td><td>Add potion effect <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html">PotionEffectTypes</a></td></tr><tr><td><code>POTION_OVERRIDE:&#x3C;POTION>:&#x3C;LEVEL>:[TICKS]</code></td><td>Force-add potion effect</td></tr><tr><td><code>PULL_AWAY:&#x3C;DISTANCE></code></td><td>Pull away an entity</td></tr><tr><td><code>PULL_CLOSER:&#x3C;AMOUNT></code></td><td>Pull an entity closer</td></tr><tr><td><code>PUMPKIN:&#x3C;TICKS></code></td><td>Put a pumpkin on entity's head</td></tr><tr><td><code>REMOVE_ARMOR:&#x3C;ARMOR TYPE></code></td><td>Remove a specific armor piece</td></tr><tr><td><code>REMOVE_RANDOM_ARMOR</code></td><td>Remove a random armor piece</td></tr><tr><td><code>REMOVE_MONEY:&#x3C;AMOUNT></code></td><td>Remove money from player account</td></tr><tr><td><code>REPAIR</code></td><td>Repair item</td></tr><tr><td><code>REVIVE</code></td><td>Revive an entity</td></tr><tr><td><code>SET_AIR:&#x3C;AMOUNT></code></td><td>Set player's remaining air</td></tr><tr><td><code>SET_BLOCK:&#x3C;MATERIAL></code></td><td>Set block to a type</td></tr><tr><td><code>SET_MAX_CATCH_TIME:&#x3C;TICKS></code></td><td>Set max. Time for fishing</td></tr><tr><td><code>SET_MIN_CATCH_TIME:&#x3C;TICKS></code></td><td>Set min. Time for fishing</td></tr><tr><td><code>SHUFFLE_HOTBAR</code></td><td>Shuffle player's hotbar</td></tr><tr><td><code>SMELT</code></td><td>Smelt drops</td></tr><tr><td><code>SNOWBLIND</code></td><td>Cancel Event, e.g. an attack</td></tr><tr><td><code>SPAWN_ARROWS</code></td><td>Spawn flood of arrows from above</td></tr><tr><td><code>SPAWN_BLOCKS:&#x3C;MATERIAL>:&#x3C;DAMAGE></code></td><td>Spawn falling blocks from above player and to cause damage</td></tr><tr><td><code>STEAL_EXP:&#x3C;AMOUNT></code></td><td>Steal EXP from one person for another</td></tr><tr><td><code>STEAL_HEALTH:&#x3C;HEALTH></code></td><td>Steal health from one entity for another</td></tr><tr><td><code>STEAL_MONEY:&#x3C;AMOUNT></code></td><td>Steal Money from one person for another</td></tr><tr><td><code>STOP_KNOCKBACK</code></td><td>Stop entity's knockback</td></tr><tr><td><code>SUBTITLE:&#x3C;TEXT></code></td><td>Send a subtitle</td></tr><tr><td><code>TAKE_AWAY:&#x3C;MATERIAL>:&#x3C;AMOUNT></code></td><td>Take item away from player</td></tr><tr><td><code>TELEPORT_BEHIND</code></td><td>Teleport behind other entity</td></tr><tr><td><code>TELEPORT</code></td><td>Teleport to location</td></tr><tr><td><code>TITLE:&#x3C;TEXT></code></td><td>Send a title</td></tr><tr><td><code>TNT:[DAMAGE]:[RADIUS]</code></td><td>Create a TNT explosion</td></tr><tr><td><code>TP_DROPS</code></td><td>Teleport drops to inventory</td></tr><tr><td><code>DELETE_ITEM:[amount]</code></td><td>Delete x amount of current item from inventory</td></tr><tr><td><code>SPAWN_ENTITY:&#x3C;TYPE></code></td><td>Spawn an entity at a location (req. EntityType)</td></tr><tr><td><code>PROJECTILE:&#x3C;TYPE></code></td><td>Spawn a shooting projectile with velocity (req. EntityType Projectile)</td></tr><tr><td><code>WEB_WALKER</code></td><td>Walk fast through cobwebs</td></tr><tr><td><code>LAVA_WALKER</code></td><td>Walk on lava</td></tr><tr><td><code>WATER_WALKER</code></td><td>Walk on water</td></tr><tr><td><code>WALK_SPEED:&#x3C;SPEED></code></td><td>Sets the player's fly speed (from -1 to 1)</td></tr><tr><td><code>OPEN_CRAFTING_TABLE</code></td><td>Open a virtual crafting table</td></tr><tr><td><code>OPEN_ENDERCHEST</code></td><td>Open virtual enderchest</td></tr><tr><td><code>DROP_HELD_ITEM</code></td><td>Drop item in hand</td></tr><tr><td><code>INVERT_VARIABLE:&#x3C;NAME></code></td><td>Invert a custom variable's boolean.</td></tr><tr><td><code>SET_VARIABLE:&#x3C;NAME>&#x3C;VALUE></code></td><td>Create a custom variable globally, not per user. To create a variable that could be user for a user, you can include user's name in the variable's name, e.g. <code>customVar%attacker name%.</code> <a href="scripting">Read more here.</a></td></tr><tr><td><code>SCREEN_FREEZE:&#x3C;ticks></code></td><td>Slow player down and show freeze effect on player's screen for defined amount of ticks (1 second = 20 ticks!)</td></tr><tr><td><code>WAIT:&#x3C;ticks></code></td><td>Wait for the next effect to activate.</td></tr><tr><td></td><td></td></tr></tbody></table>

## Plugin-specific effects

### <mark style="color:purple;">AdvancedEnchantments</mark>:

| Usage                         | Description               |
| ----------------------------- | ------------------------- |
| `ADD_ENCHANT:<ENCHANT>:<LVL>` | Add an enchant to item    |
| `REMOVE_ENCHANT:<ENCHANT>`    | Remove enchant from item  |
| `ADD_SOULS:<amount>`          | Add souls to an item      |
| `REMOVE_SOULS:<amount>`       | Remove souls from an item |

### McMMO:

<table><thead><tr><th>Usage</th><th>Description</th></tr></thead><tbody><tr><td><pre><code>ADD_EXP_MCMMO:&#x3C;SKILL>:&#x3C;AMOUNT>
</code></pre></td><td></td></tr><tr><td></td><td></td></tr><tr><td></td><td>Add mcmmo skill experience</td></tr></tbody></table>
