Skip to main content

All Triggers

Triggered effects require a trigger, these are the events/actions that cause the effects to run.

Triggers can also produce a value, and some produce an alt-value, you can reference these using their to scale multipliers, level up EcoSkills/Jobs/Pets, or send messages in chat.

PlaceholderValueAliases
%trigger_value%The value passed by the trigger%triggervalue%, %trigger%, %value%, %tv%, %v%, %t%
%alt_trigger_value%The alt-value passed by the trigger%alttriggervalue%, %alttrigger%, %altvalue%, %atv%, %av%, %at%

Internal Triggers

IDDescriptionValue(s)
alt_clickTriggered when using Right Click on most items, Left Click on those that have a default right click functionalityvalue: 1
beacon_effectTriggered when a player gains effects from a beacon Requires Papervalue: 1
biteTriggered when a fish bites on your rodvalue: 1
block_item_dropTriggered when a mined block drops lootvalue: The amount of items dropped
bonemeal_cropTriggered when using bonemeal on a crop Supports CustomCropsvalue: 1
bow_attackTriggered when shooting an entity with a bow and arrow (or crossbow)value: The damage dealt
breedTriggered when breeding entities togethervalue: The experience received
brewTriggered when brewing a potion in a brewing standvalue: 1
brew_ingredientSame as brew, but passes the ingredient as the itemvalue: 1
cast_rodTriggered when casting a fishing linevalue: 1
catch_entityTriggered when hooking onto an entity with a fishing rodvalue: 1
catch_fishTriggered when catching a fishvalue: The experience dropped
catch_fish_failTriggered when failing to catch a fishvalue: 1
change_armorTriggered when changing armorvalue: 1
change_chunkTriggered when changing chunkvalue: 1
change_worldTriggered when changing worldvalue: 1
click_blockTriggered when right-clicking on a blockvalue: 1
click_entityTriggered when right-clicking on an entityvalue: 1
complete_advancementTriggered when completing an advancementvalue: 1
consumeTriggered on item consumptionvalue: 1
craftTriggered when crafting an itemvalue: The amount of items crafted
damage_itemTriggered when damaging an itemvalue: The damage
deathTriggered on death from any sourcesvalue: 1
deploy_elytraTriggered when the player starts elytra glidingvalue: 1
disableTriggered when an item / enchant / etc disablesvalue: 1
drop_itemTriggered when dropping an itemvalue: The amount of items
elytra_boostTriggered when a player boosts an elytra Requires Papervalue: 1
empty_bucketTriggered when emptying a bucketvalue: 1
enableTriggered when an item / enchant / etc enablesvalue: 1
enchant_itemTriggered when enchanting an item in an enchanting tablevalue: The xp cost
enter_bedTriggered when entering a bedvalue: 1
entity_break_doorTriggered when an entity breaks a doorvalue: 1
entity_catch_fire_from_blockTriggered when an entity catches fire from a blockvalue: 1
entity_catch_fire_from_entityTriggered when an entity catches fire from an entityvalue: 1
entity_damageTriggered when an entity takes damagevalue: The damage taken
entity_damage_by_entityTriggered when an entity takes damage from another entityvalue: The damage taken
entity_deathTriggered when an entity diesvalue: 1
entity_item_dropTriggered when a killed entity drops lootvalue: The amount of items dropped
entity_spawnTriggered when an entity spawnsvalue: 1
entity_targetTriggered when an entity targets another entityvalue: 1
entity_teleportTriggered when an entity teleportsvalue: 1
fall_damageTriggered when taking fall damagevalue: The damage taken
fill_bucketTriggered when filling a bucketvalue: 1
gain_hungerTriggered when gaining hunger pointsvalue: The hunger gained
gain_xpTriggered when gaining experience pointsvalue: The xp gained
global_static_%interval%Run every x ticks for the server, eg global_static_20 would run every secondvalue: 1
headshotTriggered when hitting an enemy with a projectile in the headvalue: The damage dealt
healTriggered when regaining healthvalue: The health regained
hold_itemTriggered when changing your held itemvalue: 1
hook_in_groundTriggered when a fishing rod hook hits the groundvalue: 1
item_breakTriggered when breaking any item in your inventory (durability)value: 1
joinTriggered when joining the servervalue: 1
jumpTriggered when Jumping (pressing space)value: 1
killTriggered when a player kills a player or entityvalue: The victim's max health
leash_entityTriggered when leashing an entityvalue: 1
leaveTriggered when leaving the servervalue: 1
leave_bedTriggered when leaving a bedvalue: 1
leave_landTriggered when leaving a Townvalue: 1
level_up_itemTriggered when levelling up an itemvalue: The new item level
level_up_xpTriggered when levelling up XPvalue: The new level
lose_hungerTriggered when losing hungervalue: The hunger lost
lose_potion_effectTriggered when losing a potion effectvalue: 1
melee_attackTriggered when injuring an entity with a melee attackvalue: The damage dealt
mine_blockTriggered when mining a blockvalue: 1
mine_block_progressTriggered when damaging a blockvalue: 1
moveTriggered on all movement: looking around, walkingvalue: The distance moved
pick_up_itemTriggered when picking up an itemvalue: The amount of items
place_blockTriggered when placing a blockvalue: 1
potion_effectTriggered when gaining a potion effectvalue: 1
projectile_hitTriggered when hitting a block or an entity with a projectile (arrow, trident, splash potion, egg, snowball)value: 1
projectile_launchTriggered when launching a projectile (arrow, trident, splash potion, egg, snowball)value: 1
reel_inTriggered when reeling in a fishing rodvalue: 1
rename_entityTriggered when a player renames an entity using a name tag Requires Papervalue: 1
respawnTriggered when respawningvalue: 1
ring_bellTriggered when ringing a bellvalue: 1
run_commandTriggered when running a commandvalue: 1
sell_itemTriggered when selling an item in a shopvalue: The price
send_messageTriggered when sending a messagevalue: 1
shear_entityTriggered when shearing an entityvalue: 1
shield_blockTriggered when blocking an attack with a shieldvalue: The damage blocked
shoot_bowTriggered when shooting a bowvalue: The force the bow was shot at between 0 and 1
smeltTriggered when smelting an item in a furnacevalue: The amount of items smelted
smith_itemTriggered when smithing an item in a smithing tablevalue: 1
static_%interval%Run every x ticks, eg static_20 would run every secondvalue: 1
swap_handsTriggered when swapping items in hands (F by default)value: 1
swingTriggered when swinging an item, hand or weapon Requires Papervalue: 1
take_damageTriggered when taking damage from any sourcevalue: The damage taken
take_entity_damageTriggered when taking damage from an entity or playervalue: The damage taken
tame_animalTriggered when taming an animalvalue: 1
teleportTriggered when teleportingvalue: 1
toggle_flightTriggered when changing the flight statevalue: 1
toggle_sneakTriggered when changing the sneak statevalue: 1
toggle_sprintTriggered when changing the sprint statevalue: 1
trident_attackTriggered on injuring an entity with a thrown trident Requires Papervalue: The damage dealt
unleash_entityTriggered when unleashing an entityvalue: 1
use_flower_potTriggered when a player insets or extracts a plant from a flower pot Requires Papervalue: 1
villager_tradeTriggered when trading with a villager Requires Papervalue: The experience the villager gains
win_raidTriggered when a player wins a raidvalue: The level of bad omen

EcoPlugin Triggers

IDDescriptionPluginValue(s)
enchant_<type>Triggered when enchanting an item with a certain type of enchantmentEcoEnchantsvalue: The xp cost
gain_job_xpTriggered when gaining job experience pointsEcoJobsvalue: The experience gained
join_jobTriggered when joining a jobEcoJobsvalue: The job level
leave_jobTriggered when leaving a jobEcoJobsvalue: The job level
level_up_jobTriggered when levelling up a jobEcoJobsvalue: The new level
gain_pet_xpTriggered when gaining pet experience pointsEcoPetsvalue: The experience gained
level_up_petTriggered when levelling up a petEcoPetsvalue: The new level
complete_taskTriggered when completing a taskEcoQuestsvalue: 1
complete_questTriggered when completing a questEcoQuestsvalue: 1
gain_task_xpTriggered when gaining task XPEcoQuestsvalue: The experience gained
start_questTriggered when starting a questEcoQuestsvalue: 1
inscribeTriggered when inscribing a scrollEcoScrollsvalue: 1
try_inscribeTriggered when attempting to inscribe a scrollEcoScrollsvalue: 1
buy_itemTriggered when buying an item in a shopEcoShopvalue: The price
gain_skill_xpTriggered when gaining skill experience pointsEcoSkillsvalue: The experience gained
level_up_skillTriggered when levelling upEcoSkillsvalue: The new level
regen_magicTriggered when regenerating magicEcoSkillsvalue: 1

External Integration Triggers

IDDescriptionPluginValue(s)
collect_envoyTriggered when collecting an envoy crateAxEnvoyvalue: 1
player_tradeTriggered when trading with a playerAxTradevalue: The total amount of items traded
left_click_npcTriggered when left-clicking an NPCCitizens
FancyNpcs
value: 1
right_click_npcTriggered when right-clicking an NPCCitizens
FancyNpcs
value: 1
bonemeal_cropTriggered when using bonemeal on a cropCustomCropsvalue: 1
harvest_custom_cropTriggered when harvesting a custom cropCustomCropsvalue: 1
plant_custom_cropTriggered when planting a custom cropCustomCropsvalue: 1
use_fertilizerTriggered when using fertilizerCustomCropsvalue: 1
use_watering_canTriggered when using a watering canCustomCropsvalue: 1
change_town_roleTriggered when changing town roleHuskTownsvalue: 1
create_townTriggered when creating a TownHuskTownsvalue: 1
disband_townTriggered when disbanding a TownHuskTownsvalue: 1
join_townTriggered when joining a TownHuskTownsvalue: 1
leave_townTriggered when leaving a TownHuskTownsvalue: 1
enter_claimTriggered when entering a claimed areaHuskTowns
HuskClaims
value: 1
claimTriggered when claiming an areaHuskTowns
HuskClaims
Lands
value: 1
exit_claimTriggered when exiting a claimed areaHuskTowns
HuskClaims
Lands
value: 1
unclaimTriggered when unclaiming an areaHuskTowns
HuskClaims
Lands
value: 1
jobs_level_upTriggered when levelling up a jobJobs Rebornvalue: The new level
join_landTriggered when joining a LandLandsvalue: 1
lands_bank_depositTriggered when depositing into the Lands bankLandsvalue: The value deposited
alt-value: The new balance
lands_bank_withdrawTriggered when withdrawing from the Lands bankLandsvalue: The value withdrawn
alt-value: The new balance
lands_spawn_teleportTriggered when teleporting to Lands spawnLandsvalue: 1
gain_mcmmo_xpTriggered when gaining McMMO xpMcMMOvalue: The xp gained
level_down_mcmmoTriggered when levelling down McMMO skillMcMMOvalue: The new level
level_up_mcmmoTriggered when levelling up McMMO skillMcMMOvalue: The new level
mcmmo_ability_activateTriggered when an McMMO ability is activatedMcMMOvalue: 1
mcmmo_ability_deactivateTriggered when an McMMO ability is deactivatedMcMMOvalue: 1
scyther_auto_collectTriggered when autocollecting crops with a scyther hoeScythervalue: 1
scyther_auto_sellTriggered when autoselling crops with a scyther hoeScythervalue: 1
register_voteTriggered when a player votes for the serverVotifiervalue: 1
enter_regionTriggered when entering a regionWorldGuardvalue: 1
leave_regionTriggered when leaving a regionWorldGuardvalue: 1
claim_battlepass_rewardTriggered when claiming a battlepass rewardxBattlepassvalue: 1
complete_battlepass_taskTriggered when completing a battlepass taskxBattlepassvalue: 1
gain_battlepass_xpTriggered when gaining battlepass XPxBattlepassvalue: The experience gained
tier_up_battlepassTriggered when tiering up the battlepassxBattlepassvalue: The new level