Activators Descriptions / GIFs

PLAYER_ACTIVE_FLY:

  • Description: Activates when the player starts and stops flying.

  • Example Situations:

    • When you start flying, the activator activates. If you stop flying, the activator activates again.

This activator will still not run even if you have the ability to fly if you haven't toggled flight by pressing the space-bar twice.

PLAYER_ACTIVE_SNEAK

  • Description: Activates when the player starts sneaking.

  • Example Situations:

    • When you press the keyboard button to sneak, the activator activates.

PLAYER_ACTIVE_SPRINT

  • Description: Activates when the player starts sprinting.

  • Example Situations:

    • When you press the keyboard button to sprint or double-press the forward walk, the activator activates.

PLAYER_ALL_CLICK

  • Description: Activates when the player presses the left or right-click

  • Example Situations:

    • When you press any of the 2 buttons in your mouse (left or right click), it will run

Specifics options

➤ In-game editing :

Option Type Target:

  • ONLYAIR

  • ONLYBLOCK

  • NO TYPE TARGET

➤ File editing:

onlyAirClick: false
onlyBlockClick: true

If you have chosen BLOCKONLY you will have access to features:

  • blockCommands, it will allow you to run command for the block clicked.

  • detailedBlocks, the activator will work only when the type of the clicked block is in this list. (No list = All block types accepted)

blockCommands:
 - SETBLOCK DIAMOND_BLOCK
detailedBlocks:
 - DIRT
 - SPONGE
 - STONE

PLAYER_BED_ENTER

  • Description: Activates when the player right-clicks a bed.

  • Example Situations:

    • When the player right-clicks the bed and enters the bed, the activator will activate

    • When the time is day and the player attempts to right-click the bed, the activator will activate even if the player didn't lay down on the bed.

PLAYER_BED_LEAVE

  • Description: Activates when the player leaves the bed.

  • Example Situations:

    • When the player leaves the bed while laying in the bed, the activator will activate.

PLAYER_BEFORE_DEATH

  • Description: Saves the player from certain death and activates.

  • Example Situations:

    • When the player is ran into multiple enemies, the ei item saves the player from certain death.

Totems activate this activator when the totems are activated

This activator does not check armor protection so if your target's HP is 20 and your damage is 20 or higher, you will still trigger your target's EI item even though your target is supposed to survive.

This activator is useless when using PaperSpigot (You can directly use PLAYER_DEATH)

It only works when the death is caused by mobs for the moment

PLAYER_BLOCK_BREAK

  • Description: Activates when the player mines/breaks a block.

  • Example Situations:

    • When the player breaks some stone with a ei pickaxe, the activator will activate.

    • If the detailedSlot attribute is enabled on all slots, even if you are not holding the ei item, as long as you break a block, the activator will activate.

  • Options/Attributes specifically for this activator:

    • ➤ blockCommands

    • ➤ detailedBlocks

    • ➤ desactiveDrops

Specifics options

In this activator you will have access to features:

  • blockCommands, it will allow you to run command for the block clicked.

  • detailedBlocks, the activator will work only when the type of the clicked block is in this list. (No list = All block types accepted)

  • desactiveDrops, to remove the drop of the block broken

blockCommands:
 - SETBLOCK DIAMOND_BLOCK
detailedBlocks:
 - DIRT
 - SPONGE
 - STONE
desactiveDrops: true

PLAYER_BLOCK_PLACE

  • Description: Activates when the player places a block.

  • Example Situations:

    • When the player places some torch with a ei pickaxe, the activator will activate.

    • If the detailedSlot attribute is enabled on all slots, even if you are not holding the ei item, as long as you place a block, the activator will activate.

  • Options/Attributes specifically for this activator:

    • ➤ blockCommands

    • ➤ detailedBlocks

Specifics options

In this activator you will have access to features:

  • blockCommands, it will allow you to run command for the block clicked.

  • detailedBlocks, the activator will work only when the type of the clicked block is in this list. (No list = All block types accepted)

blockCommands:
 - SETBLOCK DIAMOND_BLOCK
detailedBlocks:
 - DIRT
 - SPONGE
 - STONE

PLAYER_CHANGE_WORLD

  • Description: Activates when the player moves to a different world.

  • Example Situations:

    • When you travel from the overworld to the nether, this activator will activate.

    • When you travel from one multiverse to another (Multiverse Plugin), this activator will activate.

PLAYER_CLICK_ON_ENTITY

  • Description: Activates when the player clicks on entities and Citizens NPCs.

  • Example Situations:

    • When the player hits a cow with the ei item, the activator will run.

  • Options/Attributes specifically for this activator:

    • ➤ entityCommands

    • ➤ detailedEntities

    • ➤ detailedClick

Specifics options

In this activator you will have access to features:

  • entityCommands, it will allow you to run command for the clicked entity.

  • detailedEntities, the activator will work only when the type of the clicked entity is in this list. (No list = All entity types accepted)

  • detailedClick, Chose the click accepted for this activator

    • RIGHT

    • LEFT

    • RIGHTORLEFT

entityCommands:
 - SETGLOW
detailedEntities:
 - ZOMBIE
 - SKELETON
 - BLAZE
detailedClick: RIGHT

PLAYER_CLICK_ON_PLAYER

  • Description: Activates when the player click on a player.

  • Example Situations:

    • When a player left-clicks another player the activator will activate. (IT WILL NOT WORK FOR THOSE WHO ARE IN CREATIVE)

    • When a player right-clicks another player even in creative mode, it will activate.

  • Options/Attributes specifically for this activator:

    • ➤ targetCommands

    • ➤ detailedClick

Specifics options

In this activator you will have access to features:

  • targetCommands, it will allow you to run command for the clicked player.

  • detailedClick, Chose the click accepted for this activator

    • RIGHT

    • LEFT

    • RIGHTORLEFT

targetCommands:
 - SENDMESSAGE Someone click on you !
detailedClick: RIGHT

PLAYER_CONNECTION

  • Description: Activates when the player log into the server. (Does not activate when you log out)

  • Example Situations:

    • The player left the server and logged back on and the activator activates.

PLAYER_CONSUME

  • Description: Activates when the player successfully eat/consume the item.

  • Example Situations:

    • The player eats a steak and the activator activates

PLAYER_DEATH

  • Description: Activates when the player dies.

  • Example Situations:

    • When the player dies, the activator activates.

    • If the EI's material is a totem of undying, triggering the totem will activate the activator.

If you want cancel the death of the player and you use Spigot, use PLAYER_BEFORE DEATH instead of this activator.

PLAYER_DECONNECTION

  • Description: Activates when the players disconnect from the game

  • Example Situations:

    • If you log out, the activator activates

PLAYER_DESACTIVE_SNEAK

  • Description: Activates when the player stops sneaking.

  • Example Situations:

    • When the player presses the keyboard button to sneak, then release it, the activator activates.

PLAYER_DESACTIVE_SPRINT

  • Description: Activates when the player stops sprinting.

  • Example Situations:

    • When the player stops sprinting, the activator activates.

PLAYER_DESELECT_THE_EI

  • Description: Activates if you deselect the EI item in the hot-bar.

  • Example Situations:

    • When the player deselects the item, the activator activates.

PLAYER_DISMOUNT

  • Description: Activates when the player dismounts from any entity

  • Example Situations:

    • If you go down from riding a pig with a saddle, the activator activates

PLAYER_DROP_ITEM

  • Description: Activates when the player drops an item. It will activate as long as you drop any item

  • Example Situations:

    • If you drop any item as long as the ei item is present in your inventory, the activator will activate

PLAYER_DROP_THE_EI

  • Description: Activates when the player drops the EI item.

  • Example Situations:

    • When you drop the EI item even in any slot, it will activate.

PLAYER_EDIT_BOOK

  • Description: Activates when the player made changes to the book and quill and pressed done or sign the book.

  • Example Situations:

    • If the player writes anything in the book and presses done, the activator activates.

    • If the player writes anything in the book and signs it, the activator activates.

    • If the player writes anything and does not press done, the activator will not activate.

PLAYER_EI_BREAK

  • Description: Activates when the player breaks the executableItem by making it loose all its durability.

PLAYER_EQUIP_THE_EI

  • Description: Activates if the layer puts the armor-piece in the armor slot or when using the HEAD custom command

  • Example Situations:

    • If you place the EI item in your head slot manually, the activator activates.

    • If you try using the HEAD command to put the item in the head slot, the activator activates.

A Fabric addon can bypass the the setting cancelEvent, so even if you have it on true, the player can potentialy equip the EI.

PLAYER_ENTER_IN_HIS_PLOT

  • Description: Activates if the player enters their plot

  • Example Situations:

    • If you enter your plot, the activator activates.

PLAYER_FERTILIZE_BLOCK

Not compatible with the 1.12 version

  • Description: Activates if the player fertilizes blocks with bone meal

  • Example Situations:

    • If you try to speed up sapling growth by right clicking the sapling, the activator activates.

    • If you try to bone meal grass blocks to spawn grass.

PLAYER_FILL_BUCKET

  • Description: Activates when the player attempts to pickup water or lava with a bucket.

  • Example Situations:

    • When the person attempts to pickup the water in creative, the activator activates.

    • When the player attempts to pickup the water even if cancelEvent is set to true, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ blockCommands

    • ➤ detailedBlocks

  • NOTE

    • IN THE GIF, YOU WILL SEE THE 2ND TIME THE PLAYER PICKS UP WATER WITH THE BUCKET, NO MESSAGE APPEARS BECAUSE WHEN THE EI PICKS UP WATER USING A BUCKET, IT TURNS INTO A VANILLA WATER BUCKET. PLACING DOWN THE WATER FROM THE BUCKET WILL JUST REVERT IT BACK TO A VANILLA BUCKET.

PLAYER_FISH_BLOCK

  • (NOT COMPATIBLE WITH VERSION 1.12)

  • Description: Activates when the player right-clicks the fishing rod when the fishing rod bobber is on top of a block.

  • Example Situations:

    • When the fishing bobber is on top of a block and the player right-clicks the rod, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ blockCommands

    • ➤ detailedBlocks

PLAYER_FISH_ENTITY

  • Description: Activates when the player right-clicks the fishing rod when the fishing rod bobber is on an entity or on a Citizens NPC.

  • Example Situations:

    • When the fishing bobber is on an entity and the player right-clicks the rod, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ entityCommands

    • ➤ detailedEntities

PLAYER_FISH_FISH

  • Description: Activates when the player right-clicks the fishing rod when the fishing rod bobber catches something.

  • Example Situations:

    • When the fishing bobber catches something (extra splashes and the bobber sinks a bit), the player right-clicks the rod and the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ desactiveDrops

PLAYER_FISH_NOTHING

  • Description: Activates when the player fishes nothing.

  • Example Situations:

    • When the fishing bobber is on a player and the player right-clicks the rod, the activator will not activate.

    • When the fishing bobber has yet to hold onto something and the player right-clicks to retract the bober, the activator activates.

PLAYER_FISH_PLAYER

  • Description: Activates when the player right-clicks the fishing rod when the fishing rod bobber is on a player.

  • Example Situations:

    • When the fishing bobber is on a player and the player right-clicks the rod, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ targetCommands

    • ➤ detailedClick

PLAYER_HIT_ENTITY

  • Description: Activates when the player hits an entity.

  • Example Situations:

    • If the entity received damage because the hit landed, the activator runs

    • If the entity didn't receive hits because it has the invulnerable nbt, the activator will not run

      • HOWEVER, if you are in creative, you can hit invulnerable mobs, making the activator run

PLAYER_HIT_PLAYER

  • Description: Activates when the player hits a player.

  • Example Situations:

    • If the hits manages to land, causing the player target to take damage, the activator runs

    • If the player attempts to hit its target on a region where pvp is disabled, the activator will not run

    • If the player attempts to hit its target even though the target's in creative, the activator will not run

    • Options/Attributes specifically for this activator:

      • ➤ targetCommands

      • ➤ detailedClick

PLAYER_ITEM_BREAK

  • Description: Activates when the player breaks the item by making it loose all its durability.

  • Example Situations:

    • When the player uses the diamond pickaxe and making the pickaxe loose all of its durability and break, the activator activates.

PLAYER_JUMP

  • Description: Activates when the player jumps.

  • Example Situations:

    • When the player auto-jumps, the activator will still activate because in the end, the player jumped.

In 1.21.2+, it's now possible for it to trigger even if the player attempted to jump mid-air

PLAYER_KILL_ENTITY

  • Description: Activates when the player kills an entity or a Citizens NPC.

  • Example Situations:

    • When the player kills a cow with an enchanted diamond sword, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ entityCommands

    • ➤ detailedEntities

    • ➤ desactiveDrops

This activator gets triggered when you kill mobs using the MOB_AROUND + DAMAGE ei cmd. Same goes to using MOB_AROUND + DAMAGE on mobCommands

PLAYER_KILL_PLAYER

  • Description: Activates when the player kills a player.

  • Example Situations:

    • When the player kills another player with an enchanted diamond sword, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ targetCommands

    • ➤ detailedClick

    • ➤ desactiveDrops

PLAYER_LAUNCH_PROJECTILE

  • Description: Activates when the player shoots a projectile.

  • Example Situations:

    • When the player throws a snowball, the activator activates.

    • If the player shoots an arrow with a bow, the activator activates.

Keep in mind that if you use this activator in a trident, the trident will be practically thrown BUT the trident will retain, duping the tridents.

For example, you have 2 PLAYER_LAUNCH_PROJECTILE activators, the last/bottom one in the config will always be superior to who decides if the event is cancelled or not

PLAYER_LEAVE_HIS_PLOT

  • Description: Activates if the player leaves their plot

  • Example Situations:

    • If you leave your plot, the activator activates.

PLAYER_LEFT_CLICK

  • Description: Activates when the player left-clicks the item.

  • Example Situations:

    • When the person presses the left-click button of the mouse, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ onlyAirClick

    • ➤ onlyBlockClick

    • ➤ blockCommands

      • (IT WILL ONLY APPEAR IN THE GUI IF YOU SELECT THE TYPE TARGET TO ONLY BLOCK IN THE TYPE TARGET IN THE GUI)

    • ➤ detailedBlocks

      • (IT WILL ONLY APPEAR IN THE GUI IF YOU SELECT THE TYPE TARGET TO ONLY BLOCK IN THE TYPE TARGET IN THE GUI)

PLAYER_WALK

  • Description: Activates when the player walks.

  • Example Situations:

    • When the person walks, the activator activates.

The activator in the GIF has a cool down of 1. If the activator doest have cooldown, it will be runned every tick if the player is moving. So becareful with that !

PLAYER_WRITE_COMMAND

  • Description: Activates when the player enters commands

  • Example Situations:

    • When the player writes a command, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ detailedCommands REQUIRED FOR IT TO WORK

Enabling cancelEvent prevents the "unknown command" message from showing up when the activator activates

PLAYER_RECEIVE_HIT_BY_ENTITY

  • Description: Activates when the player gets hit by anything from an entity or a Citizens NPC.

  • Example Situations:

    • When the player gets hit by the husk, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ detailedDamageCauses

If the entity is a projectile, you can use the projectile placeholders in the activator. Check the example below:

# This config allow to run custom things if the player receive 
# an hit by a custom EI projectile, in this example the custom projectile
# is named 'ak'
activator3:
    activator: PLAYER_RECEIVE_HIT_BY_ENTITY
    displayName: Activator name
    usageModification: 0
    usePerDay: -1
    cancelEventIfMaxUsePerDay: false
    autoUpdateItem: false
    commands:
    - 'SENDMESSAGE §6You received a projectile named &eak'
    conditions:
      placeholdersConditions:
        plchC1:
          type: PLAYER_STRING
          part1: '%projectile_name%'
          comparator: EQUALS
          messageIfNotValid: '&e'
          cancelEventIfNotValid: false
          part2: ak
    silenceOutput: false
    entityCommands: []
    entity:
     - PROJECTILE
    cancelEventIfInvalidRequiredExecutableItems: false
    cancelEvent: false
    detailedSlots: []

PLAYER_RECEIVE_HIT_BY_PLAYER

  • Description: Activates when the player gets hit by anything from a player.

  • Example Situations:

    • When the player gets hit by another player, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ detailedDamageCauses

PLAYER_RECEIVE_HIT_GLOBAL

  • Description: Activates when the player gets hit by something.

  • Example Situations:

    • When the player gets damaged by hugging a cactus, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ detailedDamageCauses

LogoEntityDamageEvent.DamageCause (Spigot-API 1.18.2-R0.1-SNAPSHOT API)

PLAYER_RESPAWN

  • Description: Activates when the player respawns.

  • Example Situations:

    • When the player kills himself/herself via /kill command and respawns, the activator runs.

  • NOTE: THE ITEM MUST STAY IN THE INVENTORY WHEN THE PLAYER DIES AND RESPAWN. IF THE PLAYER LOOSES THE ITEM WHEN DYING, THE ACTIVATOR WILL NOT ACTIVATE.

PLAYER_RIGHT_CLICK

  • Description: Activates when the player right-clicks the item.

  • Example Situations:

    • When the person presses the right-click button of the mouse to use the shield, the activator activated.

  • Options/Attributes specifically for this activator:

    • ➤ onlyAirClick

    • ➤ onlyBlockClick

    • ➤ blockCommands

      • (IT WILL ONLY APPEAR IN THE GUI IF YOU SELECT THE TYPE TARGET TO ONLY BLOCK IN THE TYPE TARGET IN THE GUI)

    • ➤ detailedBlocks

      • (IT WILL ONLY APPEAR IN THE GUI IF YOU SELECT THE TYPE TARGET TO ONLY BLOCK IN THE TYPE TARGET IN THE GUI)

If the type of target is ONLY_AIR you MUST HAVE AN ITEM ON YOUR HAND OR THE ACTIVATOR IS NOT REGISTERED BY SPIGOT. (It can't be fixed by our side)

PLAYER_SELECT_THE_EI

  • Description: Activates if you select the EI item in the hotbar.

  • Example Situations:

    • The player scrolls through the hotbar and selects the EI item then the activator activates.

PLAYER_TARGETED_BY_AN_ENTITY

  • Description: Activates when an entity sets it's sights and targets you

  • Example Situations:

    • When you roam around your world and a random zombie sees you and decides to fight you, the activator activates

  • Options/Attributes specifically for this activator:

    • ➤ entityCommands

    • ➤ detailedEntities

PLAYER_TRAMPLE_CROP

  • Description: Activates when the player tramples a crop

  • Example Situations:

    • When you are in your Minecraft garden, and jump above a wheat, it gets trample after falling equals the activator gets activated.

    • When you managed to successfully destroy the farmland after 1 or more jumps, the activator runs

  • Options/Attributes specifically for this activator:

    • ➤detailedBlocks

PLAYER_SHEAR_ENTITY

  • Description: Activates when the player shears an entity.

  • Example Situations:

    • The player right-clicks the sheep and the mushroom with the shears to shear them and the activator activates.

PLAYER_UNEQUIP_THE_EI

  • Description: Activates if you un-equip the EI.

  • Example Situations:

    • The player takes off the EI armor from the armorslot and the activator activates.

PROJECTILE_ENTER_LIQUID

  • Description: Activates if the launched projectile enters and stays long enough in water

  • Example Situations:

    • If you try to throw the snowball into a shallow water, the activator will not run

    • If you try to throw your projectile to lava, the activator will not run

    • If you throw a snowball into the ocean, the activator will run after under a second.

    • If you throw 5 snowballs into the air and enters the ocean almost in the same time, the activator will run 5 times instantly.

PROJECTILE_HIT_BLOCK

  • Description: Activates when the projectile of the player hits a block.

  • Example Situations:

    • When the player throws the snowball and it hits a block, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ detailedBlocks

    • ➤ blockCommands

PROJECTILE_HIT_ENTITY

  • Description: Activates when the projectile of the player hits an entity or a Citizens NPC.

  • Example Situations:

    • When the player throws the snowball and it hits a cow, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ detailedEntities

    • ➤ entityCommands

PROJECTILE_HIT_PLAYER

  • Description: Activates when the projectile of the player hits a player.

  • Example Situations:

    • When the player throws the snowball and it hits a player, the activator activates.

  • Options/Attributes specifically for this activator:

    • ➤ targetCommands

INVENTORY_CLICK

  • Description: Activates when the player clicks the item in its inventory.

  • Example Situations:

    • When you click the dirt in your inventory, the activator activates.

    • When you wear the EI boots and pressed the drop button, the activator activates. (detailedClick MUST BE RIGHTORLEFT).

  • Options/Attributes specifically for this activator:

    • ➤ detailedClick

  • NOTE: IT WILL ONLY WORK AT SURVIVAL.

LOOP

  • Description: Activates in repeat as long as the item is in the player's inventory.

  • Example Situations:

    • When you keep the item in your inventory, the activator will run in repeat.

  • Options/Attributes specifically for this activator:

    • ➤ delay

    • ➤ delayTick

PreviousList of the ActivatorsNextActivators features

Last updated