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
effects:
- 'FIRE: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.
Effect List
There are many different types of effects that can be used in our ability system. Some of the effects available are:
Usage
Description
ACTION_BAR:<TEXT>
Send an actionbar message
ADD_DURABILITY_CURRENT_ITEM
Modify durability of main item
ADD_DURABILITY
Repair item
ADD_DURABILITY_ITEM
Repair item
ADD_FOOD:<AMOUNT>
Modify player's food level
ADD_HEALTH:<HEALTH>
Add health to entity
AIR:<AMOUNT>
Modify player's remaining air
BLEED:<TICKS>
Steal entity bleed
BLOOD
Display blood effect
BOOST:[DIRECTION]:[AMOUNT]
Boost entity up in air
BREAK_BLOCK
Break block
BREAK_TREE
Break a whole tree at once
BURN:<SECONDS>
Set an entity on fire
CACTUS
Display cactus effect
CANCEL_EVENT
Cancel Event, e.g. an attack
CANCEL_USE:<MATERIAL>:<TICKS>
Cancel use of a material, e.g. ENDER_PEARL
CONSOLE_COMMAND:<COMMAND>
Run command through console
CURE:<POTION>
Remove non-permanent potion effect
CURE_PERMANENT:<POTION>
Remove permanent potion effect
DAMAGE_ARMOR
Damage Armor
DECREASE_DAMAGE:<AMOUNT>
Decrease damage by percentage
DISABLE_ACTIVATION:<NAME>:<SECONDS>
Disable activation for seconds
DISABLE_KNOCKBACK:<TICKS>
Disable entity's knockback for time
DISARM
Disarm Entity
DO_HARM:<HEALTH>
Harm an entity by doing health damage. This does not ignore armor and dealt damage may be reduced depending on armor
REMOVE_HEALTH:<HEALTH>
Take entity's health away, ignores armor and does not play damage animation for player
REMOVE_HEALTH_DAMAGE:<HEALTH>
Take entity's health away, ignore armor play damage animation for player
DOUBLE_DAMAGE
Double damage
DROP_HEAD
Drop player or mob head
EXP:<AMOUNT>
Drop Experience Orbs
EXPLODE:<POWER>:<FIRE (true/false)>:<BREAK BLOCKS (true/false>
Create an explosion
EXTINGUISH
Extinguish an entity
FIREBALL
Shoot a fireball
FLY
Toggle player's flight
FREEZE:<TICKS>
Freeze Entity
GUARD:<TYPE>:<NAME>
Spawn a guard to protect an entity
HALF_DAMAGE
Half damage effect
IGNORE_ARMOR_DAMAGE
Cancel armor durability reduction
IGNORE_ARMOR_PROTECTION
Ignores armor damage reduction
INCREASE_DAMAGE:<AMOUNT>
Increase damage by percentage
INVINCIBLE
Toggle entity's invincibility
KILL
Kill an entity
KEEP_ON_DEATH
Keep item on death
LIGHTNING
Strike a lightning
MESSAGE:<TEXT>
Send a message
MORE_DROPS:<AMOUNT>
Multiply drops. We recommend that you set a whitelist for materials, otherwhise this will multiply all drops (e.g. diamond_block) Settings​
NEGATE_DAMAGE:<AMOUNT>
Negate a specified amount of damage
PARTICLE:<PARTICLE>:<AMOUNT>:<OFFSET>
Play particles at a location
PARTICLE_LINE:<PARTICLE>:<AMOUNT>:<OFFSET>
Play particles in straight line
PERMISSION:<TEXT>
Toggle player's permission
PLANT_SEEDS:<RADIUS>:<SEEDS>
Plant seeds in radius. Seed types: SEEDS, POTATO, MELON, PUMPKIN, CARROT, BEETROOT, NETHER_WART
PLAYER_COMMAND:<COMMAND>
Run command through player
PLAY_SOUND:<SOUND>:[PITCH]:[VOLUME]
Play sound for a specific player
PLAY_SOUND_OUTLOUD:<SOUND>:[PITCH]:[VOLUME]
Play sound at a location
POTION:<POTION>:<LEVEL>:[TICKS]
Add potion effect
POTION_OVERRIDE:<POTION>:<LEVEL>:[TICKS]
Force-add potion effect
PULL_AWAY:<DISTANCE>
Pull away an entity
PULL_CLOSER:<AMOUNT>
Pull an entity closer
PUMPKIN:<TICKS>
Put a pumpkin on entity's head
REACH:<DISTANCE>
Hit players/mobs up to distance away
REMOVE_ARMOR:<ARMOR TYPE>
Remove a specific armor piece
REMOVE_RANDOM_ARMOR
Remove a random armor piece
REPAIR
Repair item
REVIVE
Revive an entity
SET_AIR:<AMOUNT>
Set player's remaining air
SET_BLOCK:<MATERIAL>
Set block to a type
SET_MAX_CATCH_TIME:<TICKS>
Set max. Time for fishing
SET_MIN_CATCH_TIME:<TICKS>
Set min. Time for fishing
SHUFFLE_HOTBAR
Shuffle player's hotbar
SMELT
Smelt drops
SNOWBLIND
Cancel Event, e.g. an attack
SPAWN_ARROWS
Spawn flood of arrows from above
STEAL_EXP:<AMOUNT>
Steal EXP from one person for another
STEAL_HEALTH:<HEALTH>
Steal health from one entity for another
STEAL_MONEY:<AMOUNT>
Steal Money from one person for another
STOP_KNOCKBACK
Stop entity's knockback
SUBTITLE:<TEXT>
Send a subtitle
TAKE_AWAY:<MATERIAL>:<AMOUNT>
Take item away from player
TELEPORT_BEHIND
Teleport behind other entity
TELEPORT
Teleport to location
TITLE:<TEXT>
Send a title
TNT:[DAMAGE]:[RADIUS]
Create a TNT explosion
TP_DROPS
Teleport drops to inventory
DELETE_ITEM:[amount]
Delete x amount of current item from inventory
SPAWN_ENTITY:<TYPE>
Spawn an entity at a location (req. EntityType)
PROJECTILE:<TYPE>
Spawn a shooting projectile with velocity (req. EntityType Projectile)
WEB_WALKER
Walk fast through cobwebs
LAVA_WALKER
Walk on lava
WATER_WALKER
Walk on water
OPEN_CRAFTING_TABLE
Open a virtual crafting table
OPEN_ENDERCHEST
Open virtual enderchest
DROP_HELD_ITEM
Drop item in hand
INVERT_VARIABLE:<NAME>
Invert a custom variable's boolean.
SET_VARIABLE:<NAME><VALUE>
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. customVar%attacker name%. Read more here.​
Plugin-specific effects
AdvancedEnchantments:
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:
Usage
Description
ADD_EXP_MCMMO:<SKILL>:<AMOUNT>
Add mcmmo skill experience

Usage	Description
`ACTION_BAR:<TEXT>`	Send an actionbar message
`ADD_DURABILITY_CURRENT_ITEM`	Modify durability of main item
`ADD_DURABILITY`	Repair item
`ADD_DURABILITY_ITEM`	Repair item
`ADD_FOOD:<AMOUNT>`	Modify player's food level
`ADD_HEALTH:<HEALTH>`	Add health to entity
`AIR:<AMOUNT>`	Modify player's remaining air
`BLEED:<TICKS>`	Steal entity bleed
`BLOOD`	Display blood effect
`BOOST:[DIRECTION]:[AMOUNT]`	Boost entity up in air
`BREAK_BLOCK`	Break block
`BREAK_TREE`	Break a whole tree at once
`BURN:<SECONDS>`	Set an entity on fire
`CACTUS`	Display cactus effect
`CANCEL_EVENT`	Cancel Event, e.g. an attack
`CANCEL_USE:<MATERIAL>:<TICKS>`	Cancel use of a material, e.g. ENDER_PEARL
`CONSOLE_COMMAND:<COMMAND>`	Run command through console
`CURE:<POTION>`	Remove non-permanent potion effect
`CURE_PERMANENT:<POTION>`	Remove permanent potion effect
`DAMAGE_ARMOR`	Damage Armor
`DECREASE_DAMAGE:<AMOUNT>`	Decrease damage by percentage
`DISABLE_ACTIVATION:<NAME>:<SECONDS>`	Disable activation for seconds
`DISABLE_KNOCKBACK:<TICKS>`	Disable entity's knockback for time
`DISARM`	Disarm Entity
`DO_HARM:<HEALTH>`	Harm an entity by doing health damage. This does not ignore armor and dealt damage may be reduced depending on armor
`REMOVE_HEALTH:<HEALTH>`	Take entity's health away, ignores armor and does not play damage animation for player
`REMOVE_HEALTH_DAMAGE:<HEALTH>`	Take entity's health away, ignore armor play damage animation for player
`DOUBLE_DAMAGE`	Double damage
`DROP_HEAD`	Drop player or mob head
`EXP:<AMOUNT>`	Drop Experience Orbs
`EXPLODE:<POWER>:<FIRE (true/false)>:<BREAK BLOCKS (true/false>`	Create an explosion
`EXTINGUISH`	Extinguish an entity
`FIREBALL`	Shoot a fireball
`FLY`	Toggle player's flight
`FREEZE:<TICKS>`	Freeze Entity
`GUARD:<TYPE>:<NAME>`	Spawn a guard to protect an entity
`HALF_DAMAGE`	Half damage effect
`IGNORE_ARMOR_DAMAGE`	Cancel armor durability reduction
`IGNORE_ARMOR_PROTECTION`	Ignores armor damage reduction
`INCREASE_DAMAGE:<AMOUNT>`	Increase damage by percentage
`INVINCIBLE`	Toggle entity's invincibility
`KILL`	Kill an entity
`KEEP_ON_DEATH`	Keep item on death
`LIGHTNING`	Strike a lightning
`MESSAGE:<TEXT>`	Send a message
`MORE_DROPS:<AMOUNT>`	Multiply drops. We recommend that you set a whitelist for materials, otherwhise this will multiply all drops (e.g. diamond_block) Settings
`NEGATE_DAMAGE:<AMOUNT>`	Negate a specified amount of damage
`PARTICLE:<PARTICLE>:<AMOUNT>:<OFFSET>`	Play particles at a location
`PARTICLE_LINE:<PARTICLE>:<AMOUNT>:<OFFSET>`	Play particles in straight line
`PERMISSION:<TEXT>`	Toggle player's permission
`PLANT_SEEDS:<RADIUS>:<SEEDS>`	Plant seeds in radius. Seed types: SEEDS, POTATO, MELON, PUMPKIN, CARROT, BEETROOT, NETHER_WART
`PLAYER_COMMAND:<COMMAND>`	Run command through player
`PLAY_SOUND:<SOUND>:[PITCH]:[VOLUME]`	Play sound for a specific player
`PLAY_SOUND_OUTLOUD:<SOUND>:[PITCH]:[VOLUME]`	Play sound at a location
`POTION:<POTION>:<LEVEL>:[TICKS]`	Add potion effect
`POTION_OVERRIDE:<POTION>:<LEVEL>:[TICKS]`	Force-add potion effect
`PULL_AWAY:<DISTANCE>`	Pull away an entity
`PULL_CLOSER:<AMOUNT>`	Pull an entity closer
`PUMPKIN:<TICKS>`	Put a pumpkin on entity's head
`REACH:<DISTANCE>`	Hit players/mobs up to distance away
`REMOVE_ARMOR:<ARMOR TYPE>`	Remove a specific armor piece
`REMOVE_RANDOM_ARMOR`	Remove a random armor piece
`REPAIR`	Repair item
`REVIVE`	Revive an entity
`SET_AIR:<AMOUNT>`	Set player's remaining air
`SET_BLOCK:<MATERIAL>`	Set block to a type
`SET_MAX_CATCH_TIME:<TICKS>`	Set max. Time for fishing
`SET_MIN_CATCH_TIME:<TICKS>`	Set min. Time for fishing
`SHUFFLE_HOTBAR`	Shuffle player's hotbar
`SMELT`	Smelt drops
`SNOWBLIND`	Cancel Event, e.g. an attack
`SPAWN_ARROWS`	Spawn flood of arrows from above
`STEAL_EXP:<AMOUNT>`	Steal EXP from one person for another
`STEAL_HEALTH:<HEALTH>`	Steal health from one entity for another
`STEAL_MONEY:<AMOUNT>`	Steal Money from one person for another
`STOP_KNOCKBACK`	Stop entity's knockback
`SUBTITLE:<TEXT>`	Send a subtitle
`TAKE_AWAY:<MATERIAL>:<AMOUNT>`	Take item away from player
`TELEPORT_BEHIND`	Teleport behind other entity
`TELEPORT`	Teleport to location
`TITLE:<TEXT>`	Send a title
`TNT:[DAMAGE]:[RADIUS]`	Create a TNT explosion
`TP_DROPS`	Teleport drops to inventory
`DELETE_ITEM:[amount]`	Delete x amount of current item from inventory
`SPAWN_ENTITY:<TYPE>`	Spawn an entity at a location (req. EntityType)
`PROJECTILE:<TYPE>`	Spawn a shooting projectile with velocity (req. EntityType Projectile)
`WEB_WALKER`	Walk fast through cobwebs
`LAVA_WALKER`	Walk on lava
`WATER_WALKER`	Walk on water
`OPEN_CRAFTING_TABLE`	Open a virtual crafting table
`OPEN_ENDERCHEST`	Open virtual enderchest
`DROP_HELD_ITEM`	Drop item in hand
`INVERT_VARIABLE:<NAME>`	Invert a custom variable's boolean.
`SET_VARIABLE:<NAME><VALUE>`	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. `customVar%attacker name%.` Read more here.

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

Usage	Description
ADD_EXP_MCMMO:<SKILL>:<AMOUNT>	Add mcmmo skill experience

Last modified 10d ago