Name | bell rings |
Event Lines | bell rings |
Triggers | when a bell block rings. (Requires Paper on versions lower than 1.19) |
Generated Examples | after bell rings: |
Has Player | when the ringing entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag that rung the bell, if any.
<context.location> returns the LocationTag of the bell being rung.
<context.direction> returns the ElementTag of the direction the bell was rung in. Can be "north", "west", "south", "east". Available only on MC 1.19+.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BellRingScriptEvent.java#L16 |
Name | block being built on block |
Event Lines | <block> being built (on <block>) |
Triggers | when an attempt is made to build a block on another block. Not necessarily caused by players. Does not normally fire when players place blocks. Prefer player places block for that. |
Generated Examples | after block being built:
after spruce_button being built on block: |
Has Player | when the event is triggered in relation to a player that is causing the block build. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the block the player is trying to build on.
<context.old_material> returns the MaterialTag of the block the player is trying to build on.
<context.new_material> returns the MaterialTag of the block the player is trying to build.
|
Determine | "BUILDABLE" to allow the building. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockBuiltScriptEvent.java#L17 |
Name | block burns |
Event Lines | <block> burns |
Triggers | when a block is destroyed by fire. |
Generated Examples | on light_blue_wool burns:
after diorite_stairs burns: |
Contexts | <context.location> returns the LocationTag the block was burned at.
<context.material> returns the MaterialTag of the block that was burned.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockBurnsScriptEvent.java#L13 |
Name | block cooks|smelts item into item |
Event Lines | <block> cooks|smelts <item> (into <item>) |
Triggers | when an item is smelted/cooked by a block. |
Generated Examples | after prismarine_wall smelts dead_brain_coral_block:
after sniffer_egg smelts tall_grass: |
Contexts | <context.location> returns the LocationTag of the block smelting/cooking.
<context.source_item> returns the ItemTag that is being smelted/cooked.
<context.result_item> returns the ItemTag that is the result of the smelting/cooking.
|
Determine | ItemTag to set the item that is the result of the smelting/cooking. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockCooksSmeltsItemScriptEvent.java#L13 |
Name | block dispenses item |
Event Lines | <block> dispenses <item> |
Triggers | when a block dispenses an item. |
Generated Examples | after block dispenses item:
after waxed_oxidized_cut_copper dispenses spruce_stairs: |
Contexts | <context.location> returns the LocationTag of the dispenser.
<context.item> returns the ItemTag of the item being dispensed.
<context.velocity> returns a LocationTag vector of the velocity the item will be shot at.
|
Determine | LocationTag to set the velocity the item will be shot at.
ItemTag to set the item being shot. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockDispensesScriptEvent.java#L14 |
Name | block explodes |
Event Lines | <block> explodes |
Triggers | when a block explodes (like a bed in the nether. For TNT, refer to the "entity explodes" event instead). For a block being destroyed by an explosion, refer to the "block destroyed by explosion" event instead. |
Generated Examples | on white_tulip explodes:
on bamboo explodes: |
Contexts | <context.block> returns the location of the exploding block.
<context.blocks> returns a ListTag of blocks that blew up.
<context.strength> returns an ElementTag(Decimal) of the strength of the explosion.
|
Determine | ListTag(LocationTag) to set a new lists of blocks that are to be affected by the explosion.
ElementTag(Decimal) to change the strength of the explosion. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockExplodesScriptEvent.java#L19 |
Name | block fades |
Event Lines | <block> fades |
Triggers | when a block fades, melts, or disappears based on world conditions. |
Generated Examples | after block fades:
after end_gateway fades: |
Contexts | <context.location> returns the LocationTag the block faded at.
<context.material> returns the MaterialTag of the block that faded.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockFadesScriptEvent.java#L13 |
Name | block falls |
Event Lines | <block> falls |
Triggers | when a block begins to fall. Generic form "block falls" (with a material) also fires when the block lands. |
Generated Examples | on trial_spawner falls:
after block falls: |
Contexts | <context.location> returns the location of the block.
<context.entity> returns the entity of the block that fell.
<context.old_material> returns the material that was at the location (eg 'sand' when falling, or 'air' when landing).
<context.new_material> returns the material that will be at the location (eg 'air' when falling, or 'sand' when landing).
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockFallsScriptEvent.java#L15 |
Name | block forms |
Event Lines | <block> forms |
Triggers | when a block is formed based on world conditions, EG, when snow forms in a snow storm or ice forms in a cold biome. |
Generated Examples | after block forms:
on cyan_stained_glass forms: |
Contexts | <context.location> returns the LocationTag the block that is forming.
<context.material> returns the MaterialTag of the block that is forming.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockFormsScriptEvent.java#L13 |
Name | block grows |
Event Lines | <block> grows |
Triggers | when a block grows naturally in the world, EG, when wheat, sugar canes, cacti, watermelons or pumpkins grow. |
Generated Examples | after blackstone_wall grows:
on potted_pink_tulip grows: |
Switches | from:<age> to only process the event if the material started at a specific age.
to:<age> to only process the event if the material ended at a specific age. |
Contexts | <context.location> returns the LocationTag of the block that grew (still at original material state when event fires).
<context.material> returns the MaterialTag of the block's newly grown state.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockGrowsScriptEvent.java#L15 |
Name | block ignites |
Event Lines | block ignites |
Triggers | when a block is set on fire. |
Generated Examples | on block ignites:
after block ignites: |
Switches | cause:<cause> to only process the event when it came from a specified cause. |
Contexts | <context.location> returns the LocationTag of the block that was set on fire.
<context.entity> returns the EntityTag of the entity that ignited the block (if any).
<context.origin_location> returns the LocationTag of the fire block that ignited this block (if any).
<context.cause> returns an ElementTag of the cause of the event: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/block/BlockIgniteEvent.IgniteCause.html.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockIgnitesScriptEvent.java#L15 |
Name | block shears entity |
Event Lines | <block> shears <entity> |
Triggers | when a dispenser shears a nearby sheep. |
Generated Examples | on block shears projectile:
after block shears chicken: |
Contexts | <context.location> returns the LocationTag of the dispenser.
<context.tool> returns the ItemTag of the item used to shear the entity.
<context.entity> returns the EntityTag of the sheared entity.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockShearEntityScriptEvent.java#L14 |
Name | block spreads |
Event Lines | block spreads |
Triggers | when a block spreads based on world conditions, EG, when fire spreads, or when mushrooms spread, or when vines grow. |
Generated Examples | after block spreads: |
Switches | type:<block> to only run if the block spreading matches the material input. |
Contexts | <context.source_location> returns the LocationTag of the block that spread.
<context.location> returns the LocationTag of the new block.
<context.material> returns the MaterialTag of the block that spread.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockSpreadsScriptEvent.java#L14 |
Name | block tries to dispense item |
Event Lines | <block> tries to dispense <item> |
Triggers | before a block dispenses an item.
This event fires before the dispenser fully processes a drop, allowing access to the dispensing slot and cancellation of sound effects. |
Generated Examples | on slime_block tries to dispense acacia_fence:
after tall_grass tries to dispense mud_brick_wall: |
Contexts | <context.location> returns the LocationTag of the dispenser.
<context.item> returns the ItemTag of the item about to be dispensed.
<context.slot> returns a ElementTag(Number) of the slot that will be dispensed from.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/BlockPreDispenseScriptEvent.java#L14 |
Name | brewing stand brews |
Event Lines | brewing stand brews |
Triggers | when a brewing stand brews a potion. |
Generated Examples | on brewing stand brews: |
Contexts | <context.location> returns the LocationTag of the brewing stand.
<context.inventory> returns the InventoryTag of the brewing stand's contents.
<context.fuel_level> returns an ElementTag(Number) of the brewing stand's fuel level.
<context.result> returns a ListTag(ItemTag) of the items that will be brewed.
|
Determine | "RESULT:<ListTag(ItemTag)>" to change the items that are brewed. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BrewsScriptEvent.java#L16 |
Name | brewing stand fueled with item |
Event Lines | brewing stand fueled (with <item>) |
Triggers | when a brewing stand receives an item to use as fuel. |
Generated Examples | after brewing stand fueled with item:
on brewing stand fueled: |
Contexts | <context.location> returns the LocationTag of the brewing stand.
<context.item> returns the ItemTag being inserted as fuel.
<context.fuel_power> returns the fuel power level being added. Each unit of fuel can power one brewing operation.
<context.consuming> returns a boolean indicating whether the fuel item will be consumed.
|
Determine | "FUEL_POWER:<ElementTag(Number)>" to set the fuel power level to be added.
"CONSUMING" to indicate that the fuel item should be consumed. "NOT_CONSUMING" to indicate that the fuel item should not be consumed. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BrewingStandFueledScriptEvent.java#L14 |
Name | brewing starts |
Event Lines | brewing starts |
Triggers | when a brewing stand starts brewing a potion. |
Generated Examples | after brewing starts: |
Contexts | <context.item> returns an ItemTag of the used ingredient to brew potions.
<context.location> returns a LocationTag of the brewing stand's location.
<context.brew_time> returns a DurationTag of the total time it will take to brew the potion.
|
Determine | "BREW_TIME:DurationTag" to set the total time for the potion being brewed. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BrewingStartsScriptEvent.java#L14 |
Name | cauldron level changes|raises|lowers |
Event Lines | cauldron level changes|raises|lowers |
Triggers | when a cauldron's level changes. |
Generated Examples | on cauldron level raises:
on cauldron level lowers: |
Switches | cause:<cause> to only process the event when it came from a specified cause. |
Contexts | <context.location> returns the LocationTag of the cauldron that changed.
<context.entity> returns the LocationTag of the entity that caused the cauldron level to change (if any).
<context.cause> returns the reason that the cauldron level changed, from https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/block/CauldronLevelChangeEvent.ChangeReason.html
<context.old_level> returns the previous cauldron level.
<context.new_level> returns the new cauldron level.
|
Determine | ElementTag(Number) to set the new level. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/CauldronLevelChangeScriptEvent.java#L14 |
Name | furnace burns item |
Event Lines | furnace burns <item> |
Triggers | when a furnace burns an item used as fuel. |
Generated Examples | after furnace burns purpur_stairs:
after furnace burns spruce_sign: |
Contexts | <context.location> returns the LocationTag of the furnace.
<context.item> returns the ItemTag burnt.
|
Determine | DurationTag to set the burn time for this fuel. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/FurnaceBurnsItemScriptEvent.java#L15 |
Name | furnace starts smelting item |
Event Lines | furnace starts smelting <item> |
Triggers | when a furnace starts smelting an item. |
Example |
|
Example |
|
Contexts | <context.location> returns a LocationTag of the furnace's location.
<context.item> returns an ItemTag of the item being smelted.
<context.recipe_id> returns an ElementTag of the recipe ID being used.
<context.total_cook_time> returns a DurationTag of the total time it will take to smelt the item.
|
Determine | DurationTag to set the total cook time for the item being smelted. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/FurnaceStartsSmeltingScriptEvent.java#L15 |
Name | leaves decay |
Event Lines | leaves decay
<block> decay |
Triggers | when leaves decay. |
Generated Examples | after leaves decay:
on polished_blackstone_pressure_plate decay: on leaves decay: after dead_brain_coral_block decay: |
Contexts | <context.location> returns the LocationTag of the leaves.
<context.material> returns the MaterialTag of the leaves.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/LeafDecaysScriptEvent.java#L13 |
Name | liquid spreads |
Event Lines | liquid spreads
dragon egg moves |
Triggers | when a liquid block spreads or dragon egg moves. |
Generated Examples | after liquid spreads:
after dragon egg moves: |
Switches | type:<block> to only run if the block spreading matches the material input. |
Contexts | <context.destination> returns the LocationTag the block spread to.
<context.location> returns the LocationTag the block spread location.
<context.material> returns the MaterialTag of the block that spread.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/LiquidSpreadScriptEvent.java#L14 |
Name | liquid|lava|water level changes |
Event Lines | liquid|lava|water level changes |
Triggers | when a liquid block's level changes. Note that 'liquid spreads' is fired when a liquid first spreads, and 'level changes' is usually fired when it goes down. |
Generated Examples | on lava level changes:
on water level changes: |
Contexts | <context.location> returns the LocationTag the liquid block that has its level changing.
<context.old_material> returns the original MaterialTag data.
<context.new_material> returns the new MaterialTag data. Sometimes can be a different material (such as air).
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/LiquidLevelChangeScriptEvent.java#L13 |
Name | noteblock plays note |
Event Lines | noteblock plays note |
Triggers | when a NoteBlock plays a note. |
Generated Examples | on noteblock plays note:
after noteblock plays note: |
Switches | instrument:<instrument> to only process the event if a specific instrument was played. |
Contexts | <context.location> returns the LocationTag of the note block.
<context.instrument> returns the name of the instrument played, see list at https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Instrument.html.
<context.sound> returns the name of the sound (that fits into playsound) represented by the instrument.
<context.tone> returns the note tone played (A to G).
<context.octave> returns the octave the note is played at (as a number).
<context.sharp> returns a boolean indicating whether the note is sharp.
<context.pitch> returns the computed pitch value (that fits into playsound). Note that volume is always 3.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/NoteBlockPlaysNoteScriptEvent.java#L17 |
Name | piston extends |
Event Lines | piston extends
<block> extends |
Triggers | when a piston extends. |
Generated Examples | after piston extends:
on dead_bubble_coral_block extends: on blackstone_stairs extends: |
Contexts | <context.location> returns the LocationTag of the piston.
<context.material> returns the MaterialTag of the piston.
<context.length> returns an ElementTag of the number of blocks that will be moved by the piston.
<context.blocks> returns a ListTag of all block locations about to be moved.
<context.sticky> returns an ElementTag of whether the piston is sticky.
<context.direction> returns a vector location of the direction that blocks will move.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/PistonExtendsScriptEvent.java#L16 |
Name | piston retracts |
Event Lines | piston retracts
<block> retracts |
Triggers | when a piston retracts. |
Generated Examples | after piston retracts:
on block retracts: after block retracts: |
Contexts | <context.location> returns the LocationTag of the piston.
<context.retract_location> returns the new LocationTag of the block that will be moved by the piston if it is sticky.
<context.blocks> returns a ListTag of all block locations about to be moved.
<context.material> returns the MaterialTag of the piston.
<context.sticky> returns an ElementTag of whether the piston is sticky.
<context.direction> returns a vector location of the direction that blocks will move.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/PistonRetractsScriptEvent.java#L16 |
Name | tnt primes |
Event Lines | tnt primes |
Triggers | when TNT is activated and will soon explode. |
Generated Examples | after tnt primes: |
Has Player | when the priming entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the entity that primed the TNT, if any.
<context.block> returns the location of the block that primed the TNT, if any.
<context.location> returns the location of the TNT block being primed.
<context.cause> returns the cause of the TNT being primed. Refer to https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/block/TNTPrimeEvent.PrimeCause.html
<context.reason> deprecated in favor of <context.cause> for 1.19+.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/TNTPrimesScriptEvent.java#L16 |
Name | block destroyed by explosion |
Event Lines | <block> destroyed by explosion |
Triggers | when a block is destroyed by an explosion (caused by either an entity or a block exploding). |
Generated Examples | on chiseled_quartz_block destroyed by explosion:
on block destroyed by explosion: |
Switches | source_entity:<matcher> to only fire the event if the source is an entity that matches the given type. Note that "Primed_Tnt" is an entity, not a block.
source_block:<matcher> to only fire the event if the source is a block that matches the given type. |
Contexts | <context.block> returns the block that exploded.
<context.source_location> returns the location of the source block or entity.
<context.source_entity> returns the entity that exploded, if any.
<context.strength> returns an ElementTag(Decimal) of the strength of the explosion.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Warning(s) | This event fires extremely rapidly. One single TNT detonation can destroy a hundred blocks. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockDestroyedByExplosionEvent.java#L19 |
Name | block equips item |
Event Lines | block equips <item> |
Triggers | when armor is equipped to an entity by a dispenser. |
Example |
|
Example |
|
Has Player | when the equipped entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the equipped entity is an NPC. |
Switches | on:<entity> to only process the event if the entity having the armor equipped matches the entity input. |
Contexts | <context.item> returns the ItemTag of the armor being dispensed.
<context.entity> returns the EntityTag of the entity having the armor equipped.
<context.location> returns the LocationTag of the dispenser.
|
Determine | "ITEM:<ItemTag>" to set the item being dispensed. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Warning(s) | Determined armor types must match or armor will be assigned incorrect slots (for example, if the original item was a helmet but the new item is boots, the boots will be assigned to the helmet slot and will not display properly). If you determine a non-armor item, it will be dispensed normally. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockEquipsItemScriptEvent.java#L16 |
Name | block physics |
Event Lines | <block> physics |
Triggers | when a block's physics update. |
Generated Examples | after block physics:
after beehive physics: |
Switches | adjacent:<block> to only process the event if the block or an immediately adjacent block (up/down/n/e/s/w) matches the LocationTag matcher specified. This can be useful to prevent blocks from breaking. |
Contexts | <context.location> returns a LocationTag of the block the physics is affecting.
<context.new_material> returns a MaterialTag of what the block is becoming.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/BlockPhysicsScriptEvent.java#L20 |
Name | redstone recalculated |
Event Lines | redstone recalculated |
Triggers | when a redstone wire is recalculated. |
Generated Examples | after redstone recalculated: |
Contexts | <context.location> returns the location of the block.
<context.old_current> returns what the redstone power level was.
<context.new_current> returns what the redstone power level is becoming.
|
Determine | ElementTag (Number) set the current value to a specific value. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Warning(s) | This event fires very very rapidly! |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/RedstoneScriptEvent.java#L13 |
Name | sponge absorbs water |
Event Lines | sponge absorbs water |
Triggers | when a sponge block absorbs water. |
Generated Examples | after sponge absorbs water:
on sponge absorbs water: |
Contexts | <context.location> returns the location of the sponge.
<context.blocks> returns a ListTag(LocationTag) of blocks (of water) that are being removed.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Block |
Warning(s) | this event may in some cases double-fire, requiring usage of the 'ratelimit' command (like 'ratelimit <context.location> 1t') to prevent doubling actions. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/block/SpongeAbsorbsScriptEvent.java#L13 |
Name | console output |
Event Lines | console output |
Triggers | when any message is printed to console. (Requires system.redirect_logging be set true.) |
Generated Examples | after console output: |
Contexts | <context.message> returns the message that is being printed to console.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/ConsoleOutputScriptEvent.java#L9 |
Name | custom event |
Event Lines | custom event |
Triggers | when called by a script using customevent. |
Example |
|
Has Player | When the command is used with a player link. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | When the command is used with an NPC link. |
Switches | id:<id> to only run the event if the given ID is used. This should almost always be specified.
data:<key>:<value> to only run the event if the given data key matches the given value, using advanced matchers for the given object type (note: the 'customevent' command call has to be careful about object type for this). |
Contexts | <context.id> returns the ID that was used.
<context.data> returns the MapTag of input data (if any! some events don't have context data).
<context.(key)> returns the value of the input data key, if available.
|
Determine | "OUTPUT:<Anything>" to add that value to the output list (note this is an ADD, not a SET). |
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/CustomScriptEvent.java#L16 |
Name | delta time hourly|minutely|secondly |
Event Lines | delta time hourly|minutely|secondly |
Triggers | every <count> seconds, minutes, or hours of game calculation time. Default repetitions count of 1.
This is specifically based on the rate of time advancement in the game server, which is not necessarily equivalent to the real passage of time (for example, this event may fire slower if the server is lagging). For real time, see system time. |
Generated Examples | after delta time minutely:
on delta time hourly: |
Switches | every:<count> to only run the event every *count* times (like "on delta time secondly every:5" for every 5 seconds). |
Contexts | <context.second> returns the exact delta time since system start.
|
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/DeltaTimeScriptEvent.java#L10 |
Name | pre script reload |
Event Lines | pre script reload |
Triggers | immediately before Denizen scripts are reloaded. |
Generated Examples | after pre script reload: |
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/PreScriptReloadScriptEvent.java#L7 |
Name | redis pubsub message |
Event Lines | redis pubsub message |
Triggers | when a subscribed redis connection receives a published message, see Redis. |
Generated Examples | on redis pubsub message:
after redis pubsub message: |
Switches | channel:<channel> to only fire on events advanced-matching the given channel. |
Contexts | <context.redis_id> returns the connection id that saw this message.
<context.pattern> returns the redis pattern that matched the channel.
<context.channel> returns the actual channel matched.
<context.message> returns the published message.
|
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/RedisPubSubMessageScriptEvent.java#L9 |
Name | reload scripts |
Event Lines | reload scripts
script reload |
Triggers | when Denizen scripts are reloaded. Not triggered on initial load. |
Generated Examples | on reload scripts:
after script reload: after reload scripts: |
Switches | had_error:true/false to only process the event if there either was or was not an error message. |
Contexts | <context.had_error> returns an ElementTag(Boolean) whether there was an error.
|
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/ReloadScriptsScriptEvent.java#L9 |
Name | scripts loaded |
Event Lines | scripts loaded |
Triggers | when Denizen scripts are loaded, but on reloaded and on initial load. |
Generated Examples | after scripts loaded:
on scripts loaded: |
Switches | had_error:true/false to only process the event if there either was or was not an error message. |
Contexts | <context.had_error> returns an ElementTag(Boolean) whether there was an error.
|
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/ScriptsLoadedScriptEvent.java#L9 |
Name | system time hh:mm |
Event Lines | system time <HH:MM>
system time hourly|minutely|secondly |
Triggers | when the system time changes to the specified value.
The system time is the real world time set in the server's operating system. It is not necessarily in sync with the game server time, which may vary (for example, when the server is lagging). For events based on in-game time passage, use delta time or wait. |
Example |
|
Example |
|
Example |
|
Switches | every:<count> to only run the event every *count* times (like "on system time secondly every:5" for every 5 seconds). |
Contexts | <context.hour> returns the exact hour of the system time.
<context.minute> returns the exact minute of the system time.
|
Synonyms (Search Aid) | cron |
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/SystemTimeScriptEvent.java#L11 |
Name | webserver web request |
Event Lines | webserver web request |
Triggers | when a webserver opened by webserver receives a connection request. |
Example |
|
Example |
|
Example |
|
Switches | port:<#> to only handle requests to a specific port.
path:<path> to only handle requests that match the given advanced-matcher for the path. method:<method> to only handle requests with the specific method (such as GET or POST). has_response:<true/false> to only handle requests that do or don't have a response already. |
Contexts | <context.method> returns the method that was used (such as GET or POST).
<context.path> returns the path requested (such as "/index.html").
<context.port> returns the port connected to.
<context.remote_address> returns the IP address that connected.
<context.query> returns a MapTag of the query data (if no query, returns empty map).
<context.raw_query> returns the raw query input (if no query, returns null).
<context.raw_user_info> returns the raw user info input (if any) (this is a historical HTTP system that allows sending username/password over query).
<context.headers> returns a MapTag of all input headers, where the key is the header name and the value is a ListTag of header values for that name.
<context.body> returns the text content of the body that was sent, if any. Particularly for POST requests.
<context.body_binary> returns the raw binary content body that was sent, if any. Particularly for POST requests.
<context.has_response> returns true if a response body determination (raw_text_content, file, or cached_file) was applied, or false if not.
|
Determine | "CODE:<Element(Number)>" to set a standard web response code, such as 'code:200' for 'OK', or 'code:404' for 'File Not Found'
"HEADERS": + MapTag to set a map of headers, where map keys are the header name and map values are the text of the value, for example headers:[Content-Type=text/html] ... note that header are sometimes case-sensitive. "RAW_TEXT_CONTENT:<ElementTag>" to set a raw text content body in response. You may determine only one response - raw text, raw binary, a file, or a cached file. You cannot use multiple. "RAW_BINARY_CONTENT:<BinaryTag>" to set a raw binary content body in response. "FILE:<ElementTag>" to set a path to a file to send in response. File path must be within the web-root path configured in Denizen/config.yml. Files will be read async. "CACHED_FILE:<ElementTag>" to set a path to a file to send in response. The content of the file will be cached in RAM until the server restarts. This is useful for files that definitely won't change. First file read will be sync, all others are instant. "PARSED_FILE:<ElementTag>" - like "FILE:", but this file will be parsed for tags using syntax like "<{util.pi}>" to separate tags from HTML entries. "CACHED_PARSED_FILE:<ElementTag>" - like "PARSED_FILE" and "CACHED_FILE" combined. Note that the file will be cached, but the results of tags will be handled at runtime still. |
Group | Core |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/WebserverWebRequestScriptEvent.java#L29 |
Name | script generates error |
Event Lines | script generates error |
Triggers | when a script generates an error. |
Generated Examples | after script generates error: |
Contexts | <context.message> returns the error message.
<context.queue> returns the queue that caused the error, if any.
<context.script> returns the script that caused the error, if any.
<context.line> returns the line number within the script file that caused the error, if any.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Core |
Warning(s) | Abusing this event can cause significant failures in the Denizen debug system. Use only with extreme caution. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/ScriptGeneratesErrorScriptEvent.java#L13 |
Name | server generates exception |
Event Lines | server generates exception |
Triggers | when an exception occurs on the server. |
Generated Examples | after server generates exception:
on server generates exception: |
Contexts | <context.message> returns the Exception message.
<context.full_trace> returns the full exception trace+message output details.
<context.type> returns the type of the error. (EG, NullPointerException).
<context.queue> returns the queue that caused the exception, if any.
<context.script> returns the script that caused the exception, if any.
<context.line> returns the line number within the script file that caused the exception, if any.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Core |
Warning(s) | Abusing this event can cause significant failures in the Denizen debug system. Use only with extreme caution. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/ServerGeneratesExceptionScriptEvent.java#L14 |
Name | tick |
Event Lines | tick |
Triggers | every single tick. |
Generated Examples | on tick: |
Switches | every:<count> to only run the event every *count* times (like "every:5" for every 5 ticks). |
Contexts | <context.tick> how many ticks have passed since the server started.
|
Group | Core |
Warning(s) | This event fires very rapidly and is usually not the most ideal way to handle things. Generally, prefer delta time. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/TickScriptEvent.java#L9 |
Name | creeper powered because cause |
Event Lines | creeper powered (because <cause>) |
Triggers | when a creeper is struck by lightning and turned into a powered creeper. |
Generated Examples | after creeper powered because cause:
on creeper powered because cause: |
Contexts | <context.entity> returns the EntityTag of the creeper.
<context.lightning> returns the EntityTag of the lightning.
<context.cause> returns an ElementTag of the cause for the creeper being powered. Refer to https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/CreeperPowerEvent.PowerCause.html.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/CreeperPoweredScriptEvent.java#L14 |
Name | ender_dragon changes phase |
Event Lines | ender_dragon changes phase
<entity> changes phase |
Triggers | when a dragon's combat phase changes. |
Generated Examples | on ender_dragon changes phase:
after entity changes phase: after ender_dragon changes phase: |
Switches | from:<phase> to only process the event if the dragon was previously in the specified phase.
to:<phase> to only process the event if the dragon is changing to the specified phase. |
Contexts | <context.entity> returns the EntityTag of the dragon.
<context.new_phase> returns an ElementTag of the dragon's new phase. Phases: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EnderDragon.Phase.html
<context.old_phase> returns an ElementTag of the dragon's old phase. Can be any phase or 'null' in some cases.
|
Determine | ElementTag to change the dragon's new phase. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/DragonPhaseChangeScriptEvent.java#L14 |
Name | entity breaks hanging because cause |
Event Lines | <entity> breaks <hanging> (because <cause>) |
Triggers | when a hanging entity (painting, item_frame, or leash_hitch) is broken. |
Generated Examples | after player breaks hanging:
on living breaks hanging because cause: |
Has Player | when the breaker is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the breaker is an npc. |
Contexts | <context.cause> returns the cause of the entity breaking. Causes list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/hanging/HangingBreakEvent.RemoveCause.html
<context.breaker> returns the EntityTag that broke the hanging entity, if any.
<context.hanging> returns the EntityTag of the hanging.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityBreaksHangingScriptEvent.java#L19 |
Name | entity breeds |
Event Lines | <entity> breeds |
Triggers | when two entities breed. |
Generated Examples | on projectile breeds:
on npc breeds: |
Contexts | <context.breeder> returns the EntityTag responsible for breeding, if it exists.
<context.child> returns the child EntityTag.
<context.mother> returns the parent EntityTag creating the child. The child will spawn at the mother's location.
<context.father> returns the other parent EntityTag.
<context.item> returns the ItemTag used to initiate breeding, if it exists.
<context.experience> returns the amount of experience granted by breeding.
|
Determine | ElementTag(Number) to set the amount of experience granted by breeding. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityBreedScriptEvent.java#L16 |
Name | entity casts spell |
Event Lines | <entity> casts <spell> |
Triggers | when an entity, usually an Evoker or Illusioner, casts a spell. |
Generated Examples | after entity casts spell:
on snow_golem casts spell: |
Contexts | <context.entity> returns the EntityTag of the Spellcaster entity.
<context.spell> returns an ElementTag of the spell used. Valid spells can be found at https://jd.papermc.io/paper/1.20/org/bukkit/entity/Spellcaster.Spell.html
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntitySpellCastScriptEvent.java#L13 |
Name | entity changes air level |
Event Lines | <entity> changes air level |
Triggers | when an entity's air level changes. |
Generated Examples | on monster changes air level:
on ender_dragon changes air level: |
Has Player | when the entity that's air level has changed is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that's air level has changed is an NPC. |
Contexts | <context.entity> returns the EntityTag.
<context.air_duration> returns a DurationTag of the entity's new air level.
|
Determine | DurationTag to set the entity's new air level. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | player loses oxygen, player drowns, player is drowning, oxygen depletion |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityAirLevelChangeScriptEvent.java#L17 |
Name | entity changes block into block |
Event Lines | <entity> changes <block> (into <block>) |
Triggers | when an entity changes the material of a block. |
Generated Examples | after entity changes block:
on npc changes gray_terracotta: |
Has Player | when the entity that changed the block is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag that changed the block.
<context.location> returns the LocationTag of the changed block.
<context.old_material> returns the old material of the block.
<context.new_material> returns the new material of the block.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityChangesBlockScriptEvent.java#L17 |
Name | entity changes food level |
Event Lines | <entity> changes food level |
Triggers | when an entity's food level changes. |
Generated Examples | after vehicle changes food level:
on tadpole changes food level: |
Has Player | when the entity that's food level has changed is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that's food level has changed is an NPC. |
Switches | item:<item> to only process the event if it was triggered by an item that matches the specified item. |
Contexts | <context.entity> returns the EntityTag.
<context.food> returns an ElementTag(Number) of the entity's new food level.
<context.item> returns an ItemTag of the item that triggered the event, if any.
|
Determine | ElementTag(Number) to set the entity's new food level. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | player hunger depletes |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityFoodLevelChangeScriptEvent.java#L16 |
Name | entity changes pose |
Event Lines | <entity> changes pose |
Triggers | when an entity changes its visual pose. |
Generated Examples | on hoglin changes pose:
after entity changes pose: |
Has Player | when the entity that changed its pose is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | old:<pose> to only process the event if the old pose matches the input.
new:<pose> to only process the event if the new pose matches the input. |
Contexts | <context.entity> returns the EntityTag that changed its pose.
<context.old_pose> returns the name of the old pose. See https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/Pose.html
<context.new_pose> returns the name of the new pose.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityChangesPoseScriptEvent.java#L16 |
Name | entity combusts |
Event Lines | <entity> combusts |
Triggers | when an entity catches fire. |
Generated Examples | after pillager combusts:
after wither_skull combusts: |
Has Player | when the entity that catches fire is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that catches fire is an NPC. |
Contexts | <context.entity> returns the entity that caught fire.
<context.duration> returns the length of the burn.
<context.source> returns the EntityTag or LocationTag that caused the fire, if any. NOTE: Currently, if the source is a LocationTag, the tag will return a null. It is expected that this will be fixed by Spigot in the future.
<context.source_type> returns the type of the source, which can be: ENTITY, LOCATION, NONE.
|
Determine | DurationTag set the burn duration. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityCombustsScriptEvent.java#L20 |
Name | entity creates portal |
Event Lines | <entity> creates portal |
Triggers | when an entity creates a portal. Generally, prefer portal created instead of this. |
Generated Examples | after entity creates portal:
after mob creates portal: |
Has Player | if the entity that created the portal is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag that created the portal.
<context.portal_type> returns the type of portal: CUSTOM, ENDER, or NETHER.
<context.blocks> returns a list of block locations where the portal is being created.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityCreatePortalScriptEvent.java#L18 |
Name | entity damaged by entity |
Event Lines | <entity> damaged by <entity>
<entity> damaged (by <cause>)
<entity> damages <entity> |
Triggers | when an entity is damaged. |
Example |
|
Example |
|
Example |
|
Example |
|
Has Player | when the damager or damaged entity is a player. Cannot be both. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the damager or damaged entity is an NPC. Cannot be both. |
Switches | with:<item> to only process the event when the item used to cause damage (in the damager's hand) is a specified item.
type:<entity> to only run if the entity damaged matches the entity input. block:<block-matcher> to only run if the damage came from a block that matches the given material or location matcher. |
Contexts | <context.entity> returns the EntityTag that was damaged.
<context.damager> returns the EntityTag damaging the other entity, if any.
<context.damager_block> returns the LocationTag of a block that damaged the entity, if any.
<context.cause> returns an ElementTag of reason the entity was damaged - see damage cause for causes.
<context.damage> returns an ElementTag(Decimal) of the amount of damage dealt.
<context.final_damage> returns an ElementTag(Decimal) of the amount of damage dealt, after armor is calculated.
<context.projectile> returns a EntityTag of the projectile, if one caused the event.
<context.damage_type_map> returns a MapTag the damage dealt by a specific damage type with keys: BASE, HARD_HAT, BLOCKING, ARMOR, RESISTANCE, MAGIC, ABSORPTION.
<context.was_critical> returns 'true' if the damage was a critical hit. (Warning: this value is calculated and not guaranteed to be correct if the event is altered).
|
Determine | ElementTag(Decimal) to set the amount of damage the entity receives.
"CLEAR_MODIFIERS" to zero out all damage modifiers other than "BASE", effectively making damage == final_damage. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityDamagedScriptEvent.java#L35 |
Name | entity dies|death |
Event Lines | <entity> dies|death |
Triggers | when an entity dies. Note that this fires *after* the entity dies, and thus some data may be lost from the entity.
The death can only be cancelled on Paper. |
Generated Examples | on entity dies:
after hanging dies: |
Has Player | when the entity that died is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that died is an NPC. |
Switches | by:<entity> to only process the event if the killer is known and matches the specified entity matcher.
cause:<cause> to only process the event if it was caused by a specific damage cause. |
Contexts | <context.entity> returns the EntityTag that died.
<context.damager> returns the EntityTag damaging the other entity, if any.
<context.projectile> returns the EntityTag of a projectile used to kill the entity, if one was used.
<context.message> returns an ElementTag of a player's death message.
<context.cause> returns an ElementTag of the cause of the death. See damage cause for a list of possible damage causes.
<context.drops> returns a ListTag of all pending item drops.
<context.xp> returns an ElementTag of the amount of experience to be dropped.
<context.keep_inventory> returns true if the player dying is set to keep their inventory, false if not, or null if the dying entity is not a player.
|
Determine | ElementTag to change the death message.
"NO_DROPS" to specify that any drops should be removed. "NO_XP" to specify that any XP orbs should be removed. ListTag(ItemTag) to specify new items to be dropped. ElementTag(Number) to specify the new amount of XP to be dropped. "KEEP_INV" to specify (if a player death) that the inventory should be kept. "KEEP_LEVEL" to specify (if a player death) that the XP level should be kept. "NO_MESSAGE" to hide a player death message. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityDeathScriptEvent.java#L27 |
Name | entity drops item |
Event Lines | <entity> drops <item> |
Triggers | when an entity drops an item. |
Generated Examples | on player drops mangrove_hanging_sign:
on entity drops activator_rail: |
Has Player | When the entity dropping an item is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the ItemTag.
<context.entity> returns a EntityTag of the item.
<context.dropped_by> returns the EntityTag that dropped the item.
<context.location> returns a LocationTag of the item's location.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityDropsItemScriptEvent.java#L18 |
Name | entity enters portal |
Event Lines | <entity> enters portal |
Triggers | when an entity enters a portal. That is, when the entity touches a portal block. |
Generated Examples | after skeleton enters portal:
after entity enters portal: |
Has Player | when the entity that entered the portal is a player - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that entered the portal is an NPC. |
Contexts | <context.entity> returns the EntityTag.
<context.location> returns the LocationTag of the portal block touched by the entity.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityEntersPortalScriptEvent.java#L15 |
Name | entity enters vehicle |
Event Lines | entity enters vehicle
<entity> enters <entity> |
Triggers | when an entity mounts another entity. |
Generated Examples | on entity enters vehicle:
on entity enters entity: after entity enters vehicle: on animal enters entity: |
Has Player | when the entity that mounted the vehicle is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that mounted the vehicle is an NPC. |
Contexts | <context.vehicle> returns the EntityTag of the mounted vehicle.
<context.entity> returns the EntityTag of the entering entity.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityEntersVehicleScriptEvent.java#L17 |
Name | entity exits portal |
Event Lines | <entity> exits portal |
Triggers | when an entity exits a portal. This uses Spigot 'EntityPortalExitEvent' which seems to no longer be called on modern server versions. |
Generated Examples | after entity exits portal:
after warden exits portal: |
Has Player | when the entity that exits the portal is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that exits the portal is an NPC. |
Contexts | <context.entity> returns the EntityTag.
<context.location> returns the LocationTag of the portal block touched by the entity.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityExitsPortalScriptEvent.java#L15 |
Name | entity exits vehicle |
Event Lines | entity exits vehicle
<entity> exits <entity> |
Triggers | when an entity dismounts from another entity. |
Generated Examples | after entity exits vehicle:
on monster exits pillager: after projectile exits player: |
Has Player | when the entity that dismounts the vehicle is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that dismounts the vehicle is an NPC. |
Contexts | <context.vehicle> returns the EntityTag of the mount vehicle.
<context.entity> returns the EntityTag of the exiting entity.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityExitsVehicleScriptEvent.java#L14 |
Name | entity explodes |
Event Lines | <entity> explodes |
Triggers | when an entity explodes (primed_tnt, creeper, etc). |
Generated Examples | after entity explodes:
on entity explodes: |
Contexts | <context.blocks> returns a ListTag of blocks that the entity blew up.
<context.entity> returns the EntityTag that exploded.
<context.location> returns the LocationTag the entity blew up at.
<context.strength> returns an ElementTag(Decimal) of the strength of the explosion.
|
Determine | ListTag(LocationTag) to set a new lists of blocks that are to be affected by the explosion.
ElementTag(Decimal) to change the strength of the explosion. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityExplodesScriptEvent.java#L20 |
Name | entity explosion primes |
Event Lines | <entity> explosion primes |
Triggers | when an entity decides to explode. |
Generated Examples | on mob explosion primes:
on vex explosion primes: |
Contexts | <context.entity> returns the EntityTag.
<context.radius> returns an ElementTag of the explosion's radius.
<context.fire> returns an ElementTag with a value of "true" if the explosion will create fire and "false" otherwise.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityExplosionPrimesScriptEvent.java#L15 |
Name | entity forms block |
Event Lines | <entity> forms <block> |
Triggers | when a block is formed by an entity.
For example, when a snowman forms snow. |
Generated Examples | after zombie_villager forms orange_glazed_terracotta:
on turtle forms ochre_froglight: |
Contexts | <context.location> returns the LocationTag the block.
<context.material> returns the MaterialTag of the block.
<context.entity> returns the EntityTag that formed the block.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityFormsBlockScriptEvent.java#L16 |
Name | entity goes into block |
Event Lines | <entity> goes into <block> |
Triggers | when an entity enters, and is stored in a block (eg a bee enters a bee nest).
Does not fire when a silverfish "enters" a stone block. Prefer entity changes block for that. |
Generated Examples | after entity goes into potted_azure_bluet:
after entity goes into block: |
Contexts | <context.entity> returns the EntityTag.
<context.location> returns the LocationTag of the block entered by the entity.
<context.material> returns the MaterialTag of the block entered by the entity.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityGoesIntoBlockScriptEvent.java#L16 |
Name | entity heals because cause |
Event Lines | <entity> heals (because <cause>) |
Triggers | when an entity heals. |
Generated Examples | after fish heals:
on entity heals: |
Has Player | when the entity that was healed is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that was healed was an NPC. |
Contexts | <context.amount> returns the amount the entity healed.
<context.entity> returns the EntityTag that healed.
<context.reason> returns the cause of the entity healing. Can be: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityRegainHealthEvent.RegainReason.html
|
Determine | ElementTag(Decimal) to set the amount of health the entity receives. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityHealsScriptEvent.java#L15 |
Name | entity interacts with block |
Event Lines | <entity> interacts with <block> |
Triggers | when an entity interacts with a block (EG an arrow hits a button) |
Generated Examples | after entity interacts with blue_candle:
on blaze interacts with mossy_cobblestone_wall: |
Contexts | <context.location> returns a LocationTag of the block being interacted with.
<context.entity> returns a EntityTag of the entity doing the interaction.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityInteractScriptEvent.java#L16 |
Name | entity potion effects modified |
Event Lines | <entity> potion effects modified
<entity> potion effects <change_action> |
Triggers | when an entity's potion effects change. |
Generated Examples | on camel potion effects modified:
after fish potion effects change_action: on wind_charge potion effects modified: after hanging potion effects change_action: |
Has Player | when the entity that has changed is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that has changed is an NPC. |
Switches | cause:<cause> to only process the event when it came from a specified cause.
effect:<effect type> to only process the event when a specified potion effect is applied. |
Contexts | <context.entity> returns the EntityTag.
<context.cause> returns the cause of the effect change, based on https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityPotionEffectEvent.Cause.html
<context.action> returns the action of the effect changed, which can be 'added', 'changed', 'cleared', or 'removed'
<context.override> returns whether the new potion effect will override the old.
<context.new_effect_data> returns the new potion effect (in the same format as EntityTag.effects_data) (if any).
<context.old_effect_data> returns the old potion effect (in the same format as EntityTag.effects_data) (if any).
<context.effect_type> returns the name of the modified potion effect type.
|
Determine | "OVERRIDE:<ElementTag(Boolean)>" to set whether the new potion effect should override. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityPotionEffectScriptEvent.java#L17 |
Name | entity resurrected |
Event Lines | <entity> resurrected |
Triggers | when an entity dies and is resurrected by a totem. |
Generated Examples | after living resurrected:
on npc resurrected: |
Has Player | when the entity being resurrected is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag being resurrected.
<context.hand> returns which hand the totem was in during resurrection, if any. Can be either HAND or OFF_HAND. Available only on MC 1.19+.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityResurrectScriptEvent.java#L17 |
Name | entity shoots bow |
Event Lines | entity shoots bow
<entity> shoots <item> |
Triggers | when an entity shoots something out of a bow. |
Generated Examples | after entity shoots bow:
after villager shoots chiseled_stone_bricks: after entity shoots sandstone_stairs: |
Has Player | when the entity that shot the bow is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that shot the bow is an NPC. |
Contexts | <context.entity> returns the EntityTag that shot the bow.
<context.projectile> returns a EntityTag of the projectile.
<context.bow> returns the ItemTag of the bow used to shoot.
<context.force> returns the force of the shot.
<context.item> returns an ItemTag of the shot projectile, if any.
<context.hand> returns "HAND" or "OFF_HAND" for which hand the bow was in.
|
Determine | ListTag(EntityTag) to change the projectile(s) being shot. (Note that in certain cases, determining an arrow may not be valid).
"KEEP_ITEM" to keep the projectile item on shooting it. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityShootsBowScriptEvent.java#L27 |
Name | entity tamed |
Event Lines | entity tamed
<entity> tamed
player tames entity
player tames <entity> |
Triggers | when an entity is tamed. |
Generated Examples | on entity tamed:
on firework_rocket tamed: on player tames entity: after player tames entity: after entity tamed: after player tamed: |
Has Player | when a player tames an entity and using the 'players tames entity' event. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns a EntityTag of the tamed entity.
<context.owner> returns a EntityTag of the owner.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityTamesScriptEvent.java#L15 |
Name | entity targets entity because cause |
Event Lines | <entity> targets (<entity>) (because <cause>) |
Triggers | when an entity targets a new entity (usually a hostile mob preparing to attack something), or un-targets one. |
Generated Examples | on hanging targets mob because cause:
on monster targets: |
Has Player | when the entity being targetted is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the targeting entity.
<context.reason> returns the reason the entity changed targets. Refer to https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityTargetEvent.TargetReason.html.
<context.target> returns the targeted entity, if any.
|
Determine | EntityTag to make the entity target a different entity instead. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityTargetsScriptEvent.java#L16 |
Name | entity teleports |
Event Lines | entity teleports
<entity> teleports |
Triggers | when an entity teleports. |
Generated Examples | after entity teleports:
after dolphin teleports: on entity teleports: |
Has Player | when the entity being teleported is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity being teleported is an NPC. |
Switches | cause:<cause> to only process the event when it came from a specified cause. |
Contexts | <context.entity> returns the EntityTag.
<context.origin> returns the LocationTag the entity teleported from.
<context.destination> returns the LocationTag the entity teleported to.
<context.cause> returns an ElementTag of the teleport cause - see teleport cause for causes.
|
Determine | "ORIGIN:<LocationTag>" to change the location the entity teleported from.
"DESTINATION:<LocationTag>" to change the location the entity teleports to. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityTeleportScriptEvent.java#L32 |
Name | entity toggles|starts|stops gliding |
Event Lines | <entity> toggles|starts|stops gliding |
Triggers | when an entity starts or stops gliding. |
Generated Examples | after spider stops gliding:
after entity starts gliding: |
Has Player | when the entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity is an NPC. |
Contexts | <context.entity> returns the EntityTag of this event.
<context.state> returns an ElementTag(Boolean) with a value of "true" if the entity is now gliding and "false" otherwise.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityGlideScriptEvent.java#L15 |
Name | entity toggles|starts|stops swimming |
Event Lines | <entity> toggles|starts|stops swimming |
Triggers | when an entity starts or stops swimming. |
Generated Examples | on horse starts swimming:
after furnace_minecart starts swimming: |
Has Player | when the entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity is an NPC. |
Contexts | <context.entity> returns the EntityTag of this event.
<context.state> returns an ElementTag(Boolean) with a value of "true" if the entity is now swimming and "false" otherwise.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntitySwimScriptEvent.java#L15 |
Name | entity transforms |
Event Lines | entity transforms
<entity> transforms (into <entity>) |
Triggers | when an entity transforms into different entities (including villager infections, slime splitting, etc). |
Generated Examples | on entity transforms:
after entity transforms: |
Switches | because:<reason> to only process the event if a specific reason caused the transformation. |
Contexts | <context.entity> returns the old entity that was transformed from.
<context.new_entities> returns a list of new entities that were transformed into.
<context.cause> returns the reason for transformation, from https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityTransformEvent.TransformReason.html.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityTransformScriptEvent.java#L15 |
Name | entity unleashed because reason |
Event Lines | <entity> unleashed (because <reason>) |
Triggers | when an entity is unleashed. |
Generated Examples | after interaction unleashed:
after block_display unleashed because reason: |
Has NPC | when the entity being unleashed is an NPC. |
Contexts | <context.entity> returns the EntityTag.
<context.reason> returns an ElementTag of the reason for the unleashing.
Reasons include DISTANCE, HOLDER_GONE, PLAYER_UNLEASH, and UNKNOWN
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityUnleashedScriptEvent.java#L13 |
Name | experience bottle breaks |
Event Lines | experience bottle breaks |
Triggers | when a thrown experience bottle breaks. |
Generated Examples | on experience bottle breaks:
after experience bottle breaks: |
Contexts | <context.entity> returns the EntityTag of the thrown experience bottle.
<context.experience> returns the amount of experience to be spawned.
<context.show_effect> returns whether the effect should be shown.
|
Determine | "EXPERIENCE:<ElementTag(Number)>" to specify the amount of experience to be created.
"EFFECT:<ElementTag(Boolean)>" to specify if the particle effects will be shown. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/ExperienceBottleBreaksScriptEvent.java#L14 |
Name | firework bursts |
Event Lines | firework bursts |
Triggers | when a firework bursts (explodes). |
Generated Examples | on firework bursts: |
Contexts | <context.entity> returns the firework that exploded.
<context.item> returns the firework item.
<context.location> returns the LocationTag the firework exploded at.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/FireworkBurstsScriptEvent.java#L16 |
Name | hanging breaks because cause |
Event Lines | <hanging> breaks (because <cause>) |
Triggers | when a hanging entity (painting, item_frame, or leash_hitch) is broken. |
Generated Examples | on hanging breaks:
after hanging breaks because cause: |
Contexts | <context.cause> returns the cause of the entity breaking. Causes: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/hanging/HangingBreakEvent.RemoveCause.html.
<context.entity> returns the EntityTag that broke the hanging entity, if any.
<context.hanging> returns the EntityTag of the hanging.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/HangingBreaksScriptEvent.java#L16 |
Name | horse jumps |
Event Lines | horse jumps
<entity> jumps |
Triggers | when a horse jumps. |
Generated Examples | on horse jumps:
after chicken jumps: after horse jumps: after entity jumps: |
Contexts | <context.entity> returns the EntityTag of the horse.
<context.color> returns an ElementTag of the horse's color.
<context.power> returns an ElementTag(Decimal) of the jump's power.
|
Determine | ElementTag(Decimal) to set the power of the jump. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/HorseJumpsScriptEvent.java#L16 |
Name | pig zapped |
Event Lines | pig zapped |
Triggers | when a pig is zapped by lightning and turned into a pig zombie. |
Generated Examples | on pig zapped: |
Contexts | <context.pig> returns the EntityTag of the pig.
<context.pig_zombie> returns the EntityTag of the pig zombie.
<context.lightning> returns the EntityTag of the lightning.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | pig struck by lightning, pig electrocuted, pig lightning strike, pig turns into pig zombie, pig turns into zombie pigman |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/PigZappedScriptEvent.java#L15 |
Name | piglin barter |
Event Lines | piglin barter |
Triggers | when a piglin completes a barter. |
Generated Examples | on piglin barter:
after piglin barter: |
Switches | input:<item> to only process the event if the input item matches the given item matcher. |
Contexts | <context.entity> returns the EntityTag of the piglin.
<context.input> returns the ItemTag of the input item.
<context.outcome> returns a ListTag(ItemTag) of outcome items.
|
Determine | "RESULT:<ListTag(ItemTag)>" to determine the items that are outputted. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/PiglinBarterScriptEvent.java#L15 |
Name | projectile hits |
Event Lines | <projectile> hits |
Triggers | When a projectile hits a block or an entity. |
Generated Examples | on projectile hits:
after arrow hits: |
Has Player | when the entity that was hit is a player, or when the shooter is a player if no entity was hit. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity that was hit is a npc, or when the shooter is a npc if no entity was hit. |
Switches | entity:<entity> to only process the event if an entity got hit, and it matches the specified EntityTag matcher.
block:<block> to only process the event if a block got hit, and it matches the specified LocationTag matcher. shooter:<entity> to only process the event if the projectile was shot by an entity, and it matches the specified EntityTag matcher. |
Contexts | <context.projectile> returns an EntityTag of the projectile.
<context.hit_entity> returns an EntityTag of the entity that was hit, if any.
<context.hit_block> returns a LocationTag of the block that was hit, if any.
<context.hit_face> returns a LocationTag vector of the hit normal (like '0,1,0' if the projectile hit the top of a block).
<context.shooter> returns an EntityTag of the entity that shot the projectile, if any.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | entity shoots |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/ProjectileHitScriptEvent.java#L17 |
Name | projectile hits block/entity |
Event Lines | <projectile> hits <block/entity>
<entity> shoots <material> (with <projectile>) |
Triggers | N/A - deprecated in favor of projectile hits |
Generated Examples | on projectile hits block/entity:
on player shoots material with arrow: after snowball hits block/entity: after monster shoots acacia_hanging_sign with projectile: |
Group | Entity |
Deprecated | use new 'projectile hits' unified event |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/ProjectileHitScriptEvent.java#L48 |
Name | projectile launched |
Event Lines | projectile launched
<entity> launched |
Triggers | when a projectile is launched. |
Generated Examples | on projectile launched:
on fish launched: after projectile launched: after entity launched: |
Contexts | <context.entity> returns the projectile.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/ProjectileLaunchedScriptEvent.java#L14 |
Name | sheep regrows wool |
Event Lines | sheep regrows wool |
Triggers | when a sheep regrows wool. |
Generated Examples | after sheep regrows wool: |
Contexts | <context.entity> returns the EntityTag of the sheep.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/SheepRegrowsScriptEvent.java#L13 |
Name | slime splits into # |
Event Lines | slime splits (into <#>) |
Triggers | when a slime splits into smaller slimes. |
Generated Examples | after slime splits:
on slime splits: |
Contexts | <context.entity> returns the EntityTag of the slime.
<context.count> returns an ElementTag(Number) of the number of smaller slimes it will split into.
|
Determine | ElementTag(Number) to set the number of smaller slimes it will split into. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/SlimeSplitsScriptEvent.java#L13 |
Name | spawner spawns entity |
Event Lines | spawner spawns <entity> |
Triggers | when an entity spawns from a monster spawner. |
Generated Examples | on spawner spawns bat:
on spawner spawns camel: |
Switches | spawner:<location> to only process the event if the spawner's location matches. |
Contexts | <context.entity> returns the EntityTag that spawned.
<context.location> returns the LocationTag the entity will spawn at.
<context.spawner_location> returns the LocationTag of the monster spawner.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntitySpawnerSpawnScriptEvent.java#L16 |
Name | villager acquires trade |
Event Lines | villager acquires trade |
Triggers | when a villager acquires a new trade. |
Generated Examples | after villager acquires trade: |
Contexts | <context.entity> returns the EntityTag of the villager.
<context.trade> returns the TradeTag for the new trade.
|
Determine | TradeTag to change the new trade. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/VillagerAcquiresTradeScriptEvent.java#L13 |
Name | villager changes profession |
Event Lines | villager changes profession |
Triggers | when a villager changes profession. |
Generated Examples | on villager changes profession:
after villager changes profession: |
Contexts | <context.entity> returns the EntityTag of the villager.
<context.profession> returns the name of the new profession. https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Villager.Profession.html
<context.reason> returns the reason for the change. https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/VillagerCareerChangeEvent.ChangeReason.html
|
Determine | ElementTag to change the profession. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/VillagerChangesProfessionScriptEvent.java#L15 |
Name | villager replenishes trade |
Event Lines | villager replenishes trade |
Triggers | when a villager replenishes a trade. A trade being "replenished" means its "uses" value is reset to "0". |
Generated Examples | on villager replenishes trade: |
Contexts | <context.entity> returns the EntityTag of the villager.
<context.trade> returns the TradeTag for the trade being replenished.
<context.bonus> returns the number of bonus uses added.
|
Determine | TradeTag to change the trade being replenished.
ElementTag(Number) to change the number of bonus uses added. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/VillagerReplenishesTradeScriptEvent.java#L14 |
Name | area effect cloud applies |
Event Lines | area effect cloud applies |
Triggers | when an area_effect_cloud tries to apply its effect(s) to entities within range. |
Generated Examples | on area effect cloud applies:
after area effect cloud applies: |
Contexts | <context.entity> returns the EntityTag of the area effect cloud.
<context.affected_entities> returns a ListTag of EntityTags affected by the area effect cloud. Note that this can be empty, and only lists which entities are currently being refreshed.
|
Determine | "AFFECTED_ENTITIES:<ListTag(EntityTag)>" to determine the entities that will be affected by the area effect cloud. The list should not contain non-living entities. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Entity |
Warning(s) | This runs every 5 ticks if there are any entities in the area effect cloud's bounding box. Prefer entity potion effects modified for listening to normal potion effect changes. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/AreaEffectCloudApplyScriptEvent.java#L14 |
Name | entity despawns |
Event Lines | <entity> despawns |
Triggers | when an entity despawns permanently from the world. May fire repeatedly for one entity. |
Generated Examples | after mob despawns:
after glow_squid despawns: |
Has NPC | when the entity that despawned is an NPC. |
Switches | cause:<cause> to only process the event when it came from a specified cause. |
Contexts | <context.entity> returns the entity that despawned.
<context.cause> returns the reason the entity despawned. Can be: DEATH, CHUNK_UNLOAD, CITIZENS, or OTHER
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Warning(s) | this event fires very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityDespawnScriptEvent.java#L12 |
Name | entity enters|exits area |
Event Lines | <entity> enters|exits <area> |
Triggers | when an entity enters or exits a noted area (cuboid, ellipsoid, or polygon). On Spigot servers, only fires for players. Paper is required for other mob types. |
Generated Examples | on bat enters polygon:
on monster enters area: |
Has Player | When the entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.area> returns the area object that was entered or exited.
<context.cause> returns the cause of the event. Can be: WALK, WORLD_CHANGE, JOIN, QUIT, TELEPORT, VEHICLE.
<context.to> returns the location the entity moved to (might not be available in exit events).
<context.from> returns the location the entity moved from (when available, depending on cause).
<context.entity> returns the entity that entered/exited an area.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Entity |
Warning(s) | cancelling this event will have different results depending on the cause. Teleporting the entity away 1 tick later might be safer. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/AreaEnterExitScriptEvent.java#L29 |
Name | entity killed by cause |
Event Lines | <entity> killed (by <cause>)
<entity> killed (by <entity>)
<entity> kills <entity> |
Triggers | when an entity is killed. |
Generated Examples | after fish killed:
after entity killed by entity: after interaction kills animal: after living killed by cause: after entity killed: after npc kills entity: |
Has Player | when the killer or entity that was killed is a player. Cannot be both. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the killer or entity that was killed is an NPC. Cannot be both. |
Contexts | <context.entity> returns the EntityTag that was killed.
<context.cause> returns an ElementTag of reason the entity was damaged - see damage cause for causes.
<context.damage> returns an ElementTag(Decimal) of the amount of damage dealt.
<context.final_damage> returns an ElementTag(Decimal) of the amount of damage dealt, after armor is calculated.
<context.damager> returns the EntityTag damaging the other entity.
<context.projectile> returns a EntityTag of the projectile shot by the damager, if any.
<context.damage_type_map> returns a MapTag the damage dealt by a specific damage type with keys: BASE, HARD_HAT, BLOCKING, ARMOR, RESISTANCE, MAGIC, ABSORPTION.
|
Determine | ElementTag(Decimal) to set the amount of damage the entity receives, instead of dying. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Warning(s) | This event may mis-fire in some cases, particularly with plugins or scripts modify the damage from scripts. If you need reliable death tracking, the entity death event may be better. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityKilledScriptEvent.java#L22 |
Name | entity spawns because cause |
Event Lines | <entity> spawns (because <cause>) |
Triggers | when an entity spawns. |
Generated Examples | after experience_orb spawns because cause:
after animal spawns because cause: |
Contexts | <context.entity> returns the EntityTag that spawned.
<context.location> returns the location the entity will spawn at.
<context.reason> returns the reason the entity spawned, can be ENTITY_SPAWN or any of: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/CreatureSpawnEvent.SpawnReason.html
<context.spawner_location> returns the location of the mob spawner, when reason is SPAWNER.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntitySpawnScriptEvent.java#L19 |
Name | sheep dyed color |
Event Lines | sheep dyed (<color>) |
Triggers | when a sheep is dyed. |
Generated Examples | after sheep dyed color: |
Contexts | <context.entity> returns the EntityTag of the sheep.
<context.color> returns an ElementTag of the color the sheep is being dyed.
|
Determine | ElementTag that matches DyeColor to dye it a different color. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Entity |
Warning(s) | Determine color will not update the clientside, use - wait 1t and adjust <context.entity> color:YOUR_COLOR to force-update. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/SheepDyedScriptEvent.java#L15 |
Name | inventory picks up item |
Event Lines | <inventory> picks up <item> |
Triggers | when a hopper or hopper minecart picks up an item. |
Generated Examples | on smithing picks up polished_granite_stairs:
on enchanting picks up item: |
Contexts | <context.inventory> returns the InventoryTag that picked up the item.
<context.item> returns the ItemTag.
<context.entity> returns a EntityTag of the item entity.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/InventoryPicksUpItemScriptEvent.java#L14 |
Name | item despawns |
Event Lines | <item> despawns |
Triggers | when an item entity despawns. |
Generated Examples | on green_banner despawns:
after crimson_stem despawns: |
Contexts | <context.item> returns the ItemTag of the entity.
<context.entity> returns the EntityTag.
<context.location> returns the location of the entity to be despawned.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/ItemDespawnsScriptEvent.java#L14 |
Name | item enchanted |
Event Lines | <item> enchanted |
Triggers | when an item is enchanted. |
Generated Examples | on blue_banner enchanted:
on item enchanted: |
Has Player | when the enchanter is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | enchant:<name> to only process the event if any of the enchantments being added match the given name. |
Contexts | <context.entity> returns the EntityTag of the enchanter (if applicable)
<context.location> returns the LocationTag of the enchanting table.
<context.inventory> returns the InventoryTag of the enchanting table.
<context.item> returns the ItemTag to be enchanted.
<context.button> returns which button was pressed to initiate the enchanting.
<context.cost> returns the experience level cost of the enchantment.
<context.enchants> returns a MapTag of enchantment names to the level that will be applied.
|
Determine | ElementTag(Number) to set the experience level cost of the enchantment.
"RESULT:<ItemTag>" to change the item result (only affects metadata (like enchantments), not material/quantity/etc!). "ENCHANTS:<MapTag>" to change the resultant enchantments. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/ItemEnchantedScriptEvent.java#L22 |
Name | item merges |
Event Lines | <item> merges |
Triggers | when an item entity merges into another item entity. |
Generated Examples | after item merges:
on item merges: |
Contexts | <context.item> returns the ItemTag of the entity.
<context.entity> returns the EntityTag.
<context.target> returns the EntityTag being merged into.
<context.location> returns the location of the entity to be spawned.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/ItemMergesScriptEvent.java#L15 |
Name | item moves from inventory to inventory |
Event Lines | <item> moves from <inventory> (to <inventory>) |
Triggers | when an entity or block moves an item from one inventory to another. (Hopper-style movement, not player-induced movement). |
Generated Examples | after item moves from inventory:
after cut_copper moves from location to inventory: |
Contexts | <context.origin> returns the origin InventoryTag.
<context.destination> returns the destination InventoryTag.
<context.initiator> returns the InventoryTag that initiated the item's transfer.
<context.item> returns the ItemTag that was moved.
|
Determine | ItemTag to set a different item to be moved. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/ItemMoveScriptEvent.java#L13 |
Name | item recipe formed |
Event Lines | <item> recipe formed |
Triggers | when an item's recipe is correctly formed. |
Generated Examples | on vault recipe formed:
on item recipe formed: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag of the crafting inventory.
<context.item> returns the ItemTag to be formed in the result slot.
<context.recipe> returns a ListTag of ItemTags in the recipe.
<context.recipe_id> returns the ID of the recipe that was formed.
<context.is_repair> returns an ElementTag(Boolean) of whether the event was triggered by a tool repair operation rather than a crafting recipe.
|
Determine | ItemTag to change the item that is formed in the result slot. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/ItemRecipeFormedScriptEvent.java#L23 |
Name | item spawns |
Event Lines | <item> spawns |
Triggers | when an item entity spawns. |
Generated Examples | after item spawns:
after blaze_rod spawns: |
Contexts | <context.item> returns the ItemTag of the entity.
<context.entity> returns the EntityTag.
<context.location> returns the location of the entity to be spawned.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Item |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/item/ItemSpawnsScriptEvent.java#L15 |
Name | npc opens block |
Event Lines | npc opens <block> |
Triggers | when an NPC opens a door or gate. |
Generated Examples | after npc opens block: |
Has NPC | Always. |
Switches | npc:<npc> to only process the event if the spawned NPC matches. |
Contexts | <context.location> returns the location of the door or gate opened.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | NPC |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/npc/NPCOpensScriptEvent.java#L17 |
Name | npc spawns |
Event Lines | npc spawns |
Triggers | when an NPC spawns. |
Generated Examples | after npc spawns: |
Has NPC | Always. |
Switches | npc:<npc> to only process the event if the spawned NPC matches.
reason:<reason> to only process the event if the NPC's spawn reason matches. See https://jd.citizensnpcs.co/net/citizensnpcs/api/event/SpawnReason.html for a list of reasons. |
Contexts | <context.location> returns the location the entity will spawn at.
<context.reason> returns the reason of the spawn.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | NPC |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/npc/NPCSpawnScriptEvent.java#L16 |
Name | npc stuck |
Event Lines | npc stuck |
Triggers | when an NPC's navigator is stuck. |
Generated Examples | on npc stuck:
after npc stuck: |
Has NPC | Always. |
Switches | npc:<npc> to only process the event if the spawned NPC matches. |
Contexts | <context.action> returns 'teleport' or 'none'
|
Determine | "NONE" to do nothing.
"TELEPORT" to teleport. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | NPC |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/npc/NPCStuckScriptEvent.java#L16 |
Name | npc begins|completes|cancels navigation |
Event Lines | npc begins|completes|cancels navigation |
Triggers | when an NPC begins, finishes, or cancels navigating. |
Generated Examples | on npc cancels navigation: |
Has NPC | Always. |
Switches | npc:<npc> to only process the event if the spawned NPC matches. |
Contexts | None
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | NPC |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/npc/NPCNavigationScriptEvent.java#L15 |
Name | block drops item from breaking |
Event Lines | block drops item from breaking
<block> drops <item> from breaking |
Triggers | when a items drop from a block due to a player breaking the block in survival mode. |
Generated Examples | on block drops item from breaking:
after block drops item from breaking: on block drops bolt_armor_trim_smithing_template from breaking: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag the block was broken at.
<context.material> returns the MaterialTag of the block that was broken.
<context.drop_entities> returns a ListTag of EntityTags of type DROPPED_ITEM. To get the list of ItemTags, just tack ".parse[item]" onto this context tag.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/BlockDropsItemScriptEvent.java#L19 |
Name | entity picks up item |
Event Lines | <entity> picks up <item>
<entity> takes <item> |
Triggers | when an entity picks up an item. |
Generated Examples | on horse picks up item:
on living takes pig_spawn_egg: on entity picks up item: on projectile takes mud: |
Has Player | when the entity picking up the item is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity picking up the item is an npc. |
Contexts | <context.item> returns an ItemTag of the item being picked up.
<context.entity> returns an EntityTag of the item entity being picked up.
<context.pickup_entity> returns an EntityTag of the entity picking up the item.
<context.location> returns a LocationTag of the item's location.
|
Determine | "ITEM:<ItemTag>" to change the item being picked up. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/entity/EntityPicksUpItemScriptEvent.java#L20 |
Name | player activates riptide |
Event Lines | player activates riptide |
Triggers | when a player activates the riptide effect. |
Generated Examples | after player activates riptide: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the ItemTag of the trident.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerRiptideScriptEvent.java#L15 |
Name | player animates animation |
Event Lines | player animates (<animation>) |
Triggers | when a player performs an animation. |
Generated Examples | after player animates:
after player animates animation: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only run if an item being swung by a swing animation matches the item-matcher. |
Contexts | <context.animation> returns the name of the animation, from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/event/player/PlayerAnimationType.html.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerAnimatesScriptEvent.java#L17 |
Name | player breaks block |
Event Lines | player breaks block
player breaks <material> |
Triggers | when a player breaks a block. |
Generated Examples | after player breaks block:
on player breaks material: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event when the player is breaking the block with a specified item. |
Contexts | <context.location> returns the LocationTag the block was broken at.
<context.material> returns the MaterialTag of the block that was broken.
<context.xp> returns how much XP will be dropped.
<context.should_drop_items> returns whether the event will drop items.
|
Determine | "NOTHING" to make the block drop no items.
ListTag(ItemTag) to make the block drop a specified list of items. ElementTag(Number) to set the amount of xp to drop. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | player mines block, player mines ore, player digs block |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerBreaksBlockScriptEvent.java#L21 |
Name | player breaks held item |
Event Lines | player breaks held item
player breaks held <item> |
Triggers | when a player breaks the item they are holding. |
Generated Examples | after player breaks held item:
on player breaks held rail: on player breaks held jungle_chest_boat: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the item that broke.
<context.slot> returns the slot of the item that broke.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerBreaksItemScriptEvent.java#L21 |
Name | player changes armor stand item |
Event Lines | player changes armor stand item |
Triggers | when a player modifies an armor stand entity. |
Generated Examples | after player changes armor stand item:
on player changes armor stand item: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | from:<item> to only process the event if the item on the armor stand being interacted with matches the specified item matcher.
hand:<hand> to only process the event if the player is using a specific hand to interact with the armor stand. Available only on MC versions 1.19+. to:<item> to only process the event if the item held by the player matches the specified item matcher. slot:<slot> to only process the event if the armor stand's item slot that was interacted with is the specified slot. armor_stand:<entity> to only process the event if the armor stand being interacted with matches the specified entity matcher. |
Contexts | <context.armor_stand_item> returns the ItemTag being interacted with on the armor stand.
<context.entity> returns an EntityTag of the armor stand.
<context.hand> returns an ElementTag of the hand used by the player to interact with the armor stand, can be either HAND or OFF_HAND. Available only on MC versions 1.19+.
<context.player_item> returns the ItemTag held by the player.
<context.slot> returns an ElementTag of the armor stand's item slot that was interacted with. Valid equipment slot values can be found at https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/EquipmentSlot.html.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerArmorStandManipulateScriptEvent.java#L18 |
Name | player changes gamemode to gamemode |
Event Lines | player changes gamemode (to <gamemode>) |
Triggers | when a player's gamemode is changed. |
Generated Examples | after player changes gamemode:
on player changes gamemode: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.gamemode> returns an ElementTag of the gamemode. Game Modes: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/GameMode.html
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerChangesGamemodeScriptEvent.java#L15 |
Name | player changes main hand |
Event Lines | player changes main hand |
Triggers | when a player changes their main hand. |
Generated Examples | after player changes main hand: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.old_hand> returns the player's old main hand, either LEFT or RIGHT.
<context.new_hand> returns the player's new main hand.
|
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerChangesMainHandScriptEvent.java#L15 |
Name | player changes sign |
Event Lines | player changes sign
player changes <material> |
Triggers | when a player changes a sign. |
Generated Examples | after player changes sign:
after player changes material: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the sign.
<context.new> returns the new sign text as a ListTag.
<context.old> returns the old sign text as a ListTag.
<context.material> returns the MaterialTag of the sign.
|
Determine | ListTag to change the lines. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerChangesSignScriptEvent.java#L20 |
Name | player changes world from world to world |
Event Lines | player changes world (from <world>) (to <world>) |
Triggers | when a player moves to a different world. |
Generated Examples | after player changes world:
on player changes world to survivalland: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.origin_world> returns the WorldTag that the player was previously on.
<context.destination_world> returns the WorldTag that the player is now in.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerChangesWorldScriptEvent.java#L15 |
Name | player changes xp |
Event Lines | player changes xp |
Triggers | when a player's experience amount changes. |
Generated Examples | after player changes xp: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.amount> returns the amount of changed experience.
|
Determine | ElementTag(Number) to set the amount of changed experience. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerChangesXPScriptEvent.java#L16 |
Name | player click_type clicks item in inventory |
Event Lines | player (<click_type>) clicks (<item>) in <inventory> |
Triggers | when a player clicks in an inventory. Note that you likely will also want to listen to player drags in inventory. |
Generated Examples | on player click_type clicks green_terracotta in inventory:
on player click_type clicks in npc: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event if a specified cursor item was used.
in_area:<area> replaces the default 'in:<area>' for this event. action:<action> to only process the event if a specified action occurred. slot:<slot> to only process the event if a specified slot or slot_type was clicked. For slot input options, see Slot Inputs. |
Contexts | <context.item> returns the ItemTag the player has clicked on.
<context.inventory> returns the InventoryTag (the 'top' inventory, regardless of which slot was clicked).
<context.clicked_inventory> returns the InventoryTag that was clicked in.
<context.cursor_item> returns the item the Player is clicking with.
<context.click> returns an ElementTag with the name of the click type. Click type list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/ClickType.html
<context.slot_type> returns an ElementTag with the name of the slot type that was clicked. Slot type list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryType.SlotType.html
<context.slot> returns an ElementTag with the number of the slot that was clicked.
<context.raw_slot> returns an ElementTag with the raw number of the slot that was clicked.
<context.is_shift_click> returns true if 'shift' was used while clicking.
<context.action> returns the inventory_action. See Inventory Actions.
<context.hotbar_button> returns an ElementTag of the button pressed as a number, or 0 if no number button was pressed.
|
Determine | ItemTag to set the current item for the event. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerClicksInInventoryScriptEvent.java#L70 |
Name | player closes inventory |
Event Lines | player closes inventory
player closes <inventory> |
Triggers | when a player closes an inventory. (EG, chests, not the player's main inventory.) |
Generated Examples | on player closes inventory:
after player closes inventory: after player closes grindstone: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerClosesInvScriptEvent.java#L18 |
Name | player completes advancement |
Event Lines | player completes advancement |
Triggers | when a player has completed all criteria in an advancement. |
Generated Examples | after player completes advancement: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | name:<name> to only fire if the advancement has the specified name. |
Contexts | <context.criteria> returns all the criteria present in this advancement.
<context.advancement> returns the completed advancement's minecraft ID key.
<context.message> returns an ElementTag of the advancement message (only on Paper).
|
Determine | ElementTag to change the advancement message (only on Paper).
"NO_MESSAGE" to hide the advancement message (only on Paper). |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerCompletesAdvancementScriptEvent.java#L15 |
Name | player consumes item |
Event Lines | player consumes item
player consumes <item> |
Triggers | when a player consumes (eats/drinks) an item (like food or potions). |
Generated Examples | on player consumes item:
after player consumes item: on player consumes brick_wall: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the ItemTag.
<context.hand> returns an ElementTag of the hand being used to consume the item. Can be either HAND or OFF_HAND. Requires a 1.19+ server.
|
Determine | ItemTag to change the item being consumed. Use with caution, if the player is eating a stack of items, this will replace the entire stack. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerConsumesScriptEvent.java#L21 |
Name | player crafts item |
Event Lines | player crafts item
player crafts <item> |
Triggers | when a player fully crafts an item. |
Generated Examples | on player crafts item:
after player crafts pink_shulker_box: after player crafts item: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag of the crafting inventory.
<context.item> returns the ItemTag to be crafted.
<context.amount> returns the amount of the item that will be crafted (usually 1, except when shift clicked. Can be above 64).
<context.recipe> returns a ListTag of ItemTags in the recipe.
<context.recipe_id> returns the ID of the recipe that is being crafted.
<context.click_type> returns an ElementTag with the name of the click type. Click type list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/ClickType.html
|
Determine | ItemTag to change the item that is crafted. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerCraftsItemScriptEvent.java#L25 |
Name | player damages block |
Event Lines | player damages <block> |
Triggers | when a block is damaged by a player. |
Generated Examples | on player damages block:
after player damages block: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event when the player is hitting the block with a specified item. |
Contexts | <context.location> returns the LocationTag the block that was damaged.
<context.material> returns the MaterialTag of the block that was damaged.
|
Determine | "INSTABREAK" to make the block get broken instantly. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerDamagesBlockScriptEvent.java#L16 |
Name | player drags in inventory |
Event Lines | player drags in inventory
player drags (<item>) (in <inventory>) |
Triggers | when a player drags in an inventory (that is, clicks and then holds the mouse button down while moving the mouse across multiple slots). |
Generated Examples | after player drags in inventory:
after player drags: on player drags in inventory: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | in_area:<area> replaces the default 'in:<area>' for this event.
drag_type:<type> to only run the event if the given drag type (SINGLE or EVEN) was used. |
Contexts | <context.item> returns the ItemTag the player has dragged.
<context.inventory> returns the InventoryTag (the 'top' inventory, regardless of which slot was clicked).
<context.clicked_inventory> returns the InventoryTag that was clicked in.
<context.slots> returns a ListTag of the slot numbers dragged through.
<context.raw_slots> returns a ListTag of the raw slot numbers dragged through.
<context.drag_type> returns either SINGLE or EVEN depending on whether the player used their left or right mouse button.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerDragsInInvScriptEvent.java#L25 |
Name | player edits book |
Event Lines | player edits book
player signs book |
Triggers | when a player edits or signs a book. |
Generated Examples | on player edits book:
after player signs book: after player edits book: on player signs book: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.title> returns the name of the book, if any.
<context.pages> returns the number of pages in the book.
<context.book> returns the book item being edited, containing the new page contents.
<context.old_book> returns the book item being edited, containing the old page contents.
<context.signing> returns whether the book is about to be signed.
|
Determine | "NOT_SIGNING" to prevent the book from being signed.
ScriptTag to set the book information to set it to instead. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerEditsBookScriptEvent.java#L23 |
Name | player empties bucket |
Event Lines | player empties bucket
player empties <item> |
Triggers | when a player empties a bucket. |
Generated Examples | after player empties bucket:
on player empties crimson_fungus: on player empties bucket: after player empties item: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the ItemTag of the bucket being emptied (just material, other properties are lost - use 'player.item_in_hand' if you need full data).
<context.location> returns the LocationTag of the block clicked with the bucket.
<context.relative> returns the LocationTag of the block in front of the clicked block.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerEmptiesBucketScriptEvent.java#L17 |
Name | player enters bed |
Event Lines | player enters bed |
Triggers | when a player enters a bed. |
Generated Examples | after player enters bed: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the bed.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerEntersBedScriptEvent.java#L15 |
Name | player fills bucket |
Event Lines | player fills bucket
player fills <item> |
Triggers | when a player fills a bucket. |
Generated Examples | after player fills bucket:
after player fills cave_spider_spawn_egg: on player fills bucket: on player fills bread: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the ItemTag of the filled bucket.
<context.location> returns the LocationTag of the block clicked with the bucket.
<context.material> returns the MaterialTag of the LocationTag.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerFillsBucketScriptEvent.java#L17 |
Name | player fishes entity while state |
Event Lines | player fishes (<entity>) (while <state>)
player fishes (<item>) (while <state>) |
Triggers | when a player uses a fishing rod. |
Generated Examples | on player fishes giant while state:
after player fishes furnace: on player fishes while state: after player fishes cooked_chicken while state: |
Has Player | If the fisher or the caught entity is a player (in most cases, the fisher can be assumed to be a real player). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | If the fisher or the caught entity is an NPC. |
Switches | with:<item> to only process the event if the fishing rod is a specified item. |
Contexts | <context.hook> returns an EntityTag of the hook.
<context.state> returns an ElementTag of the fishing state. Valid states: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/player/PlayerFishEvent.State.html
<context.entity> returns an EntityTag of the entity that got caught.
<context.item> returns an ItemTag of the item gotten, if any.
<context.xp> returns the amount of experience that will drop.
|
Determine | "CAUGHT:<ItemTag>" to change the item that was caught (only if an item was already being caught).
"XP:<ElementTag(Number)>" to change how much experience will drop. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerFishesScriptEvent.java#L21 |
Name | player hears sound |
Event Lines | player hears sound |
Triggers | when a player receives a sound packet from the server. |
Generated Examples | on player hears sound:
after player hears sound: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | key:<sound_key> to only process the event if the sound matches the modern Minecraft sound key. |
Contexts | <context.sound_key> returns an ElementTag of the modern Minecraft sound key.
<context.sound_name> returns an ElementTag of the sound's Bukkit name.
<context.category> returns the name of the category the sound is from.
<context.is_custom> returns 'true' if the sound is custom, otherwise false.
<context.source_entity> returns the entity this sound came from (if any).
<context.location> returns the location the sound will play at.
<context.volume> returns the volume level.
<context.pitch> returns the pitch.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerHearsSoundScriptEvent.java#L21 |
Name | player item takes damage |
Event Lines | player item takes damage
player <item> takes damage |
Triggers | when the player damages an item. |
Generated Examples | after player item takes damage:
on player orange_glazed_terracotta takes damage: on player black_bed takes damage: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.damage> returns the amount of damage the item has taken.
<context.original_damage> returns the original amount of damage the item would have taken, before any modifications such as the unbreaking enchantment (only on Paper).
<context.item> returns the item that has taken damage.
<context.slot> returns the slot of the item that has taken damage. This value is a bit of a hack and is not reliable.
|
Determine | ElementTag(Number) to set the amount of damage the item will take. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | item durability changes |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerItemTakesDamageScriptEvent.java#L20 |
Name | player joins |
Event Lines | player joins
player join |
Triggers | when a player joins the server. |
Generated Examples | after player joins:
after player join: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.message> returns an ElementTag of the join message.
|
Determine | ElementTag to change the join message.
"NONE" to cancel the join message. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerJoinsScriptEvent.java#L16 |
Name | player kicked for flying |
Event Lines | player kicked (for flying) |
Triggers | when a player is kicked from the server. |
Generated Examples | after player kicked for flying:
on player kicked: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.message> returns an ElementTag of the kick message sent to all players.
<context.reason> returns an ElementTag of the kick reason.
<context.flying> returns whether the player is being automatically kicked for flying.
|
Determine | "MESSAGE:<ElementTag>" to change the kick message.
"REASON:<ElementTag>" to change the kick reason. "FLY_COOLDOWN:<DurationTag>" to cancel the automatic fly kick and set its next cooldown. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerKickedScriptEvent.java#L19 |
Name | player leashes entity |
Event Lines | player leashes entity
player leashes <entity> |
Triggers | when a player leashes an entity. |
Generated Examples | on player leashes entity:
after player leashes entity: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag of the leashed entity.
<context.holder> returns the EntityTag that is holding the leash.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerLeashesEntityScriptEvent.java#L15 |
Name | player leaves bed |
Event Lines | player leaves bed |
Triggers | when a player leaves a bed. |
Generated Examples | after player leaves bed: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the bed.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerLeavesBedScriptEvent.java#L15 |
Name | player levels up from level to level |
Event Lines | player levels up (from <level>) (to <level>) |
Triggers | when a player levels up. |
Generated Examples | after player levels up from level:
on player levels up to level: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.new_level> returns an ElementTag of the player's new level.
<context.old_level> returns an ElementTag of the player's old level.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerLevelsUpScriptEvent.java#L16 |
Name | player locale change |
Event Lines | player locale change |
Triggers | when a player changes their locale in their client settings. |
Generated Examples | after player locale change: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.new_locale> returns an ElementTag of the player's new locale.
|
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerLocaleChangeScriptEvent.java#L14 |
Name | player mends item |
Event Lines | player mends item
player mends <item> |
Triggers | when an XP orb is used to repair an item with the Mending enchantment in the player's inventory. |
Generated Examples | after player mends item:
on player mends prismarine_brick_stairs: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.item> returns the item that is repaired.
<context.repair_amount> returns how much durability the item recovers.
<context.xp_orb> returns the XP orb that triggered the event.
<context.slot> returns the slot of the item that has been repaired. This value is a bit of a hack and is not reliable.
|
Determine | ElementTag(Number) to set the amount of durability the item recovers. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerMendsItemScriptEvent.java#L18 |
Name | player opens inventory |
Event Lines | player opens inventory
player opens <inventory> |
Triggers | when a player opens an inventory. (EG, chests, not the player's main inventory.) |
Generated Examples | on player opens inventory:
after player opens loom: after player opens inventory: on player opens grindstone: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerOpensInvScriptEvent.java#L16 |
Name | player picks up launched arrow |
Event Lines | player picks up launched arrow |
Triggers | when a player picks up a launched arrow projectile entity that is embedded into the ground. Will not necessarily fire for creative players. |
Generated Examples | on player picks up launched arrow: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.arrow> returns the arrow entity.
<context.item> returns the item of the arrow.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerPickupArrowScriptEvent.java#L15 |
Name | player places block |
Event Lines | player places block
player places <item> |
Triggers | when a player places a block. |
Example |
|
Example |
|
Example |
|
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | using:<hand_type> to only process the event if the player is using the specified hand type (HAND or OFF_HAND).
against:<location> to only process the event if block that this new block is being placed against matches the specified LocationTag matcher. type:<material> to only process the event if the block placed matches the MaterialTag matcher input. |
Contexts | <context.location> returns the LocationTag of the block that was placed.
<context.material> returns the MaterialTag of the block that was placed.
<context.old_material> returns the MaterialTag of the block that was replaced.
<context.item_in_hand> returns the ItemTag of the item in hand.
<context.hand> returns the name of the hand that the block was in (HAND or OFF_HAND).
<context.against> returns the LocationTag of the block this block was placed against.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerPlacesBlockScriptEvent.java#L18 |
Name | player places hanging |
Event Lines | player places <hanging> |
Triggers | when a hanging entity (painting or itemframe) is placed. |
Generated Examples | on player places hanging:
after player places hanging: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | item:<item> to only process the event when the hangable item matches the given ItemTag matcher. |
Contexts | <context.hanging> returns the EntityTag of the hanging.
<context.location> returns the LocationTag of the block the hanging was placed on.
<context.item> returns the ItemTag that was placed.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerPlacesHangingScriptEvent.java#L17 |
Name | player prepares item enchant |
Event Lines | player prepares item enchant
player prepares <item> enchant |
Triggers | when a player prepares to enchant an item. |
Generated Examples | on player prepares item enchant:
after player prepares coal_ore enchant: after player prepares item enchant: on player prepares diamond enchant: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the enchanting block.
<context.item> returns the ItemTag to be enchanted.
<context.bonus> returns an ElementTag(Number) of the enchanting bonus available (number of bookshelves).
<context.offers> returns a ListTag of the available enchanting offers, each as a MapTag with keys 'cost', 'enchantment_type', and 'level'.
|
Determine | "OFFERS:<ListTag>" of MapTags to set the offers available. Cannot be a different size list than the size of context.offers. |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerPreparesEnchantScriptEvent.java#L20 |
Name | player quits |
Event Lines | player quits
player quit |
Triggers | when a player quit the server. |
Generated Examples | on player quits:
on player quit: after player quits: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.message> returns an ElementTag of the quit message.
|
Determine | ElementTag to change the quit message.
"NONE" to cancel the quit message. |
Synonyms (Search Aid) | player disconnects, player logs off, player leaves |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerQuitsScriptEvent.java#L16 |
Name | player receives commands |
Event Lines | player receives commands |
Triggers | when the list of available server commands is sent to the player for tab completion. |
Generated Examples | after player receives commands: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.commands> returns a ListTag of received commands.
|
Determine | ListTag to set the player's available commands. NOTE: It is not possible to add entries to the command list, only remove them. |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerReceivesCommandsScriptEvent.java#L15 |
Name | player receives tablist update |
Event Lines | player receives tablist update |
Triggers | when a player receives a tablist update. |
Generated Examples | after player receives tablist update: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | mode:add/update/remove to only trigger if the tablist update is the specified mode. |
Contexts | <context.mode> returns the update mode: 'add', 'remove', 'initialize_chat', 'update_gamemode', 'update_latency', 'update_listed', or 'update_display'. As of 1.19.3, you can also receive update combos like "update_gamemode|update_latency".
<context.uuid> returns the packet's associated UUID.
<context.name> returns the packet's associated name (if any).
<context.display> returns the packet's associated display name (if any).
<context.latency> returns the packet's associated latency (if any).
<context.gamemode> returns the packet's associated gamemode (if any).
<context.skin_blob> returns the packet's associated skin blob (if any).
<context.listed> returns true if the entry should be listed in the tab list, or false if not.
|
Determine | "LATENCY:<ElementTag(Number)>" to change the latency.
"NAME:<ElementTag>" to change the name. "DISPLAY:<ElementTag>" to change the display name. 'name', 'display' and 'cancelled' determinations require 'Allow restricted actions' in Denizen/config.yml "GAMEMODE:<ElementTag>" to change the gamemode. "SKIN_BLOB:<ElementTag>" to change the skin blob. "LISTED:<ElementTag(Boolean)>" to change whether the entry is listed. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerReceivesTablistUpdateScriptEvent.java#L20 |
Name | player respawns at bed |
Event Lines | player respawns (at bed)
player respawns elsewhere |
Triggers | when a player respawns. |
Generated Examples | after player respawns at bed:
on player respawns elsewhere: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns a LocationTag of the respawn location.
<context.is_bed_spawn> returns a boolean indicating whether the player is about to respawn at their bed.
|
Determine | LocationTag to change the respawn location. |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerRespawnsScriptEvent.java#L17 |
Name | player scrolls their hotbar |
Event Lines | player scrolls their hotbar
player holds item |
Triggers | when a player scrolls through their hotbar. |
Generated Examples | after player scrolls their hotbar:
on player holds item: on player scrolls their hotbar: after player holds item: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | item:<item> to only process the event when the player is going to hold a specified item. |
Contexts | <context.new_slot> returns the number of the new inventory slot.
<context.previous_slot> returns the number of the old inventory slot.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/HotbarScrollScriptEvent.java#L15 |
Name | player selects stonecutter recipe |
Event Lines | player selects stonecutter recipe |
Triggers | when a player selects a recipe in a stonecutter. |
Generated Examples | on player selects stonecutter recipe:
after player selects stonecutter recipe: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | recipe_id:<recipe_id> to only process the event if the recipe matches the recipe ID. |
Contexts | <context.inventory> returns the InventoryTag of the stonecutter inventory.
<context.input> returns an ItemTag of the item in the input slot.
<context.result> returns an ItemTag of the item in the result slot.
<context.recipe_id> returns the ID of the recipe that was selected.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerSelectsStonecutterRecipeScriptEvent.java#L16 |
Name | player shears entity |
Event Lines | player shears <entity>
player shears <color> sheep |
Triggers | when a player shears an entity. |
Generated Examples | after player shears tnt:
on player shears color sheep: after player shears player: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag of the sheep.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerShearsScriptEvent.java#L17 |
Name | player smiths item |
Event Lines | player smiths item
player smiths <item> |
Triggers | when a player upgrades an item on a smithing table. |
Generated Examples | after player smiths item:
after player smiths purple_terracotta: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag of the smithing table inventory.
<context.item> returns the ItemTag after upgrading.
|
Determine | ItemTag to change the item that results from the upgrade. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerSmithsItemScriptEvent.java#L19 |
Name | player stands on material |
Event Lines | player stands on material
player stands on (<material>) |
Triggers | when a player stands on a physical-interactable block (such as a pressure plate, tripwire, or redstone ore). |
Generated Examples | after player stands on material:
on player stands on material: on player stands on petrified_oak_slab: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag the player is interacting with.
<context.material> returns the MaterialTag the player is interacting with.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerStandsOnScriptEvent.java#L17 |
Name | player statistic increments |
Event Lines | player statistic increments
player statistic <statistic> increments |
Triggers | when a player's statistics increment. |
Generated Examples | on player statistic increments:
after player statistic statistic increments: after player statistic increments: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.statistic> returns the statistic that incremented. Statistic names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Statistic.html
<context.previous_value> returns the old value of the statistic.
<context.new_value> returns the new value of the statistic.
<context.qualifier> returns the qualifier (EntityTag/MaterialTag) if any.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerStatisticIncrementsScriptEvent.java#L18 |
Name | player steers entity |
Event Lines | player steers entity
player steers <entity> |
Triggers | every tick that a player is controlling a vehicle. |
Generated Examples | on player steers entity:
after player steers entity: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag being steered by the player.
<context.sideways> returns an ElementTag(Decimal) where a positive number signifies leftward movement.
<context.forward> returns an ElementTag(Decimal) where a positive number signifies forward movement.
<context.jump> returns an ElementTag(Boolean) that signifies whether the player is attempting to jump with the entity.
<context.dismount> returns an ElementTag(Boolean) that signifies whether the player is attempting to dismount.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerSteersEntityScriptEvent.java#L17 |
Name | player stops damaging block |
Event Lines | player stops damaging <block> |
Triggers | when a block stops being damaged by a player. |
Example |
|
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event when the player stops hitting the block with a specified item. |
Contexts | <context.location> returns the LocationTag the block no longer being damaged.
<context.material> returns the MaterialTag of the block no longer being damaged.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerStopsDamagingBlockScriptEvent.java#L17 |
Name | player swaps items |
Event Lines | player swaps items |
Triggers | when a player swaps the items in their main and off hands. |
Generated Examples | on player swaps items:
after player swaps items: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | main:<item> to only process the event if the item being put into the main hand matches the input item.
offhand:<item> to only process the event if the item being put into the off-hand matches the input item. |
Contexts | <context.main> returns the ItemTag switched to the main hand.
<context.offhand> returns the ItemTag switched to the off hand.
|
Determine | "MAIN:<ItemTag>" to set the item in the main hand.
"OFFHAND:<ItemTag>" to set the item in the off hand. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerSwapsItemsScriptEvent.java#L17 |
Name | player takes item from furnace |
Event Lines | player takes item from furnace
player takes <item> from furnace |
Triggers | when a player takes an item from a furnace. |
Generated Examples | on player takes item from furnace:
on player takes cake from furnace: after player takes item from furnace: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the furnace.
<context.item> returns the ItemTag taken out of the furnace.
|
Determine | ElementTag(Number) to set the amount of experience the player will get. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerTakesFromFurnaceScriptEvent.java#L17 |
Name | player takes item from lectern |
Event Lines | player takes item from lectern
player takes <item> from lectern |
Triggers | when a player takes a book from a lectern. |
Generated Examples | on player takes item from lectern:
on player takes blue_shulker_box from lectern: after player takes item from lectern: after player takes painting from lectern: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the lectern.
<context.item> returns the book ItemTag taken out of the lectern.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerTakesFromLecternScriptEvent.java#L17 |
Name | player throws hatching|non-hatching egg |
Event Lines | player throws (hatching|non-hatching) egg |
Triggers | when a player throws an egg - this event specifically fires when the egg hits, for the initial throw event use projectile launched. |
Generated Examples | after player throws egg:
on player throws non-hatching egg: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.egg> returns the EntityTag of the egg.
<context.is_hatching> returns an ElementTag with a value of "true" if the egg will hatch and "false" otherwise.
|
Determine | EntityTag to set the type of the hatching entity. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerThrowsEggScriptEvent.java#L17 |
Name | player toggles flying |
Event Lines | player toggles flying
player starts flying
player stops flying |
Triggers | when a player starts or stops flying. |
Generated Examples | after player toggles flying:
on player starts flying: on player stops flying: on player toggles flying: after player starts flying: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.state> returns an ElementTag(Boolean) with a value of "true" if the player is now flying and "false" otherwise.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerFlyingScriptEvent.java#L15 |
Name | player toggles|starts|stops sneaking |
Event Lines | player toggles|starts|stops sneaking |
Triggers | when a player starts or stops sneaking. |
Generated Examples | after player toggles sneaking:
on player toggles sneaking: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.state> returns an ElementTag(Boolean) with a value of "true" if the player is now sneaking and "false" otherwise.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerSneakScriptEvent.java#L15 |
Name | player toggles|starts|stops sprinting |
Event Lines | player toggles|starts|stops sprinting |
Triggers | when a player starts or stops sprinting. |
Generated Examples | on player toggles sprinting:
on player starts sprinting: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.state> returns an ElementTag(Boolean) with a value of "true" if the player is now sprinting and "false" otherwise.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerSprintScriptEvent.java#L15 |
Name | player triggers raid |
Event Lines | player triggers raid |
Triggers | when a player triggers a village raid. |
Generated Examples | after player triggers raid: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.raid> returns the raid data. See Raid Event Data.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerTriggersRaidScriptEvent.java#L12 |
Name | player uses portal |
Event Lines | player uses portal |
Triggers | when a player enters a portal. |
Generated Examples | on player uses portal:
after player uses portal: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | from:<block> to only process the event if the block the player teleported from matches the LocationTag matcher provided.
to:<block> to only process the event if the block the player teleported to matches the LocationTag matcher provided. |
Contexts | <context.from> returns the location teleported from.
<context.to> returns the location teleported to (can sometimes be null).
<context.can_create> returns whether the server will attempt to create a destination portal.
<context.creation_radius> returns the radius that will be checked for a free space to create the portal in.
<context.search_radius> returns the radius that will be checked for an existing portal to teleport to.
|
Determine | LocationTag to change the destination.
"CAN_CREATE:<ElementTag(Boolean)>" to set whether the server will attempt to create a destination portal. "CREATION_RADIUS:<ElementTag(Number)>" to set the radius that will be checked for a free space to create the portal in. "SEARCH_RADIUS:<ElementTag(Number)>" to set the radius that will be checked for an existing portal to teleport to. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerUsesPortalScriptEvent.java#L17 |
Name | player walks over notable |
Event Lines | player walks over notable
player walks over <location> |
Triggers | when a player walks over a noted location. In most cases, it is preferable to use player enters area with a small cuboid. |
Generated Examples | on player walks over notable:
on player walks over location: after player walks over notable: after player walks over location: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.notable> returns an ElementTag of the notable location's name.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerWalksOverScriptEvent.java#L18 |
Name | resource pack status |
Event Lines | resource pack status |
Triggers | when a player accepts, denies, successfully loads, or fails to download a resource pack. |
Generated Examples | on resource pack status: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | status:<status> to only process the event when a specific status is returned. Same status names as returned by 'context.status'. |
Contexts | <context.status> returns an ElementTag of the status. Can be: SUCCESSFULLY_LOADED, DECLINED, FAILED_DOWNLOAD, ACCEPTED.
|
Group | Player |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/ResourcePackStatusScriptEvent.java#L13 |
Name | player chats |
Event Lines | player chats |
Triggers | when a player chats. |
Generated Examples | after player chats: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | message:<matcher> to only process the event if the chat message matches an advanced matcher. |
Contexts | <context.message> returns the player's message as an Element.
<context.format> returns the chat message's raw format.
<context.full_text> returns the full text of the chat message (ie, the written message with the format applied to it).
<context.recipients> returns a list of all players that will receive the chat.
|
Determine | ElementTag to change the message.
"FORMAT:<ScriptTag>" to set the format script the message should use. "RAW_FORMAT:<ElementTag>" to set the format directly (without a format script). (Use with caution, avoid if possible). "RECIPIENTS:<ListTag(PlayerTag)>" to set the list of players that will receive the message. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | Using this will forcibly sync the chat thread. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/ChatScriptEvent.java#L28 |
Name | player enters|exits biome |
Event Lines | player enters|exits biome |
Triggers | when a player enters or exits a biome. |
Generated Examples | on player exits biome:
on player enters biome: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | biome:<name> to only process the event when a specific biome is being entered. |
Contexts | <context.from> returns the block location moved from.
<context.to> returns the block location moved to.
<context.old_biome> returns the biome being left.
<context.new_biome> returns the biome being entered.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | Cancelling this event will fire a similar event immediately after. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/BiomeEnterExitScriptEvent.java#L20 |
Name | player exhaustion level increases |
Event Lines | player exhaustion level increases |
Triggers | when a player does an activity that increases their exhaustion level, which increases the rate of hunger. |
Generated Examples | on player exhaustion level increases: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | reason:<reason> to only process the event if the reason matches a specific reason. |
Contexts | <context.exhaustion> returns the amount of exhaustion added to the player.
<context.reason> returns the reason of exhaustion. See https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityExhaustionEvent.ExhaustionReason.html for a list of valid reasons.
|
Determine | ElementTag(Decimal) to change the amount of exhaustion that will be added to the player. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerIncreasesExhaustionLevelScriptEvent.java#L15 |
Name | player jumps |
Event Lines | player jumps |
Triggers | when a player jumps. |
Generated Examples | after player jumps: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the location the player jumped from.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | On Spigot servers, this event and its data are inaccurate and unreliable. This event works more stably on Paper servers. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerJumpScriptEvent.java#L16 |
Name | player logs in for the first time |
Event Lines | player logs in (for the first time)
player (first) login |
Triggers | when a player logs in to the server. This is during the authentication process, and should NOT be confused with player joins. |
Generated Examples | after player logs in:
after player login: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.hostname> returns an ElementTag of the player's IP address.
<context.server_hostname> returns an ElementTag of the server address that the player used to connect to the server.
|
Determine | "KICKED" to kick the player from the server.
"KICKED:<ElementTag>" to kick the player and specify a message to show. |
Group | Player |
Warning(s) | Generally avoid this event. This is not a way to get a 'first join' event. This is an internal technical event, with specific uses (eg custom whitelisting). |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerLoginScriptEvent.java#L17 |
Name | player prelogin |
Event Lines | player prelogin |
Triggers | when a player starts to log in to the server.
This is during the EARLY authentication process, and should NOT be confused with player joins. |
Generated Examples | after player prelogin:
on player prelogin: |
Has Player | When the player has previously joined (and thus the UUID is valid). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.hostname> returns an ElementTag of the player's hostname.
<context.name> returns an ElementTag of the player's name.
<context.uuid> returns an ElementTag of the player's UUID.
|
Determine | QueueTag to cause the event to wait until the queue is complete.
"KICKED" to kick the player from the server. "KICKED <ElementTag>" to kick the player and specify a message to show. |
Group | Player |
Warning(s) | This is a very special-case handler, that delays logins until the events are handled on the main thread.
Generally, prefer on player logs in. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerPreLoginScriptEvent.java#L27 |
Name | player prepares anvil craft item |
Event Lines | player prepares anvil craft item
player prepares anvil craft <item> |
Triggers | when a player prepares an anvil to craft an item. |
Generated Examples | after player prepares anvil craft item:
on player prepares anvil craft acacia_wood: on player prepares anvil craft item: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag of the anvil inventory.
<context.item> returns the ItemTag to be crafted.
<context.repair_cost> returns an ElementTag(Number) of the repair cost.
<context.new_name> returns an ElementTag of the new name.
|
Determine | ElementTag(Number) to set the repair cost.
ItemTag to change the item that is crafted. |
Group | Player |
Warning(s) | The player doing the crafting is estimated and may be inaccurate. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerPreparesAnvilCraftScriptEvent.java#L19 |
Name | player prepares smithing item |
Event Lines | player prepares smithing item
player prepares smithing <item> |
Triggers | when a player prepares to upgrade an item on a smithing table. |
Generated Examples | on player prepares smithing item:
after player prepares smithing golden_helmet: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag of the smithing table inventory.
<context.item> returns the ItemTag after upgrading.
|
Determine | ItemTag to change the item that results from the upgrade. |
Group | Player |
Warning(s) | The player doing the smithing is estimated and may be inaccurate. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayersPrepareSmithingTableScriptEvent.java#L18 |
Name | player raises|lowers|toggles item |
Event Lines | player raises|lowers|toggles <item> |
Triggers | when a player starts or stops holding up an item, such as a shield, spyglass, or crossbow. |
Generated Examples | on player lowers item:
on player raises exposed_chiseled_copper: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | reason:<reason> to only process the event if the reason matches the input. |
Contexts | <context.state> returns an ElementTag(Boolean) of whether the player raised or lowered the item.
<context.held_for> returns a DurationTag of how long the player held the item up for (only on Paper).
<context.hand> returns an ElementTag of the hand that the player is raising or lowering (only on Paper).
<context.item> returns an ItemTag of the item that the player is raising or lowering (only on Paper).
<context.reason> returns the reason for a state change. Can be: raise, lower, swap, hold, drop, quit, death.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Synonyms (Search Aid) | player raises shield, player raises spyglass |
Group | Player |
Warning(s) | For 'lowers', the item may be tracked incorrectly. Prefer 'player lowers item' (the generic item form) for a 'lowers' event (similar for 'toggles').
Also be aware this event may misfire in some cases. This event and its data are more accurate on Paper servers. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerRaiseLowerItemScriptEvent.java#L28 |
Name | player receives actionbar |
Event Lines | player receives actionbar |
Triggers | when a player receives any actionbar from the server. |
Generated Examples | on player receives actionbar: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.message> returns an ElementTag of the actionbar.
<context.raw_json> returns an ElementTag of the raw JSON used for the actionbar.
|
Determine | "MESSAGE:<ElementTag>" to change the actionbar.
"RAW_JSON:<ElementTag>" to change the JSON used for the actionbar. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Warning(s) | Triggering new actionbar messages in this event will cause it to re-fire. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerReceivesActionbarScriptEvent.java#L5 |
Name | player receives message |
Event Lines | player receives message |
Triggers | when a player receives any chat message from the server. This does not normally include *player* chat, instead prefer player chats for that. |
Generated Examples | after player receives message: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.message> returns an ElementTag of the message.
<context.raw_json> returns an ElementTag of the raw JSON used for the message.
<context.system_message> returns true if the message is a system message (not player chat).
|
Determine | "MESSAGE:<ElementTag>" to change the message.
"RAW_JSON:<ElementTag>" to change the JSON used for the message. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Warning(s) | Using this will forcibly sync the chat thread. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerReceivesMessageScriptEvent.java#L18 |
Name | player receives packet |
Event Lines | player receives packet |
Triggers | when a player receives a packet from the server. |
Generated Examples | on player receives packet:
after player receives packet: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | class:<classname-matcher> to only process the event when the packet class name matches a given classname matcher. |
Contexts | <context.class> returns an ElementTag of the packet's class name. Note that these are spigot-mapped names, not Mojang-mapped.
<context.reflect_packet> returns a JavaReflectedObjectTag of the packet object.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Warning(s) | This event will fire extremely rapidly. Use with caution. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerReceivesPacketScriptEvent.java#L16 |
Name | player right clicks entity |
Event Lines | player right clicks <entity> |
Triggers | when a player right clicks on an entity. |
Generated Examples | on player right clicks entity: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event when the player is holding a specified item.
type:<entity> to only run if the entity clicked matches the entity input. |
Contexts | <context.entity> returns the EntityTag the player is clicking on.
<context.item> returns the ItemTag the player is clicking with.
<context.hand> returns "offhand" or "mainhand" to indicate which hand was used to fire the event. Some events fire twice - once for each hand.
<context.click_position> returns a LocationTag of the click position (as a world-less vector, relative to the entity's center). This is only available when clicking armor stands.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | this event may in some cases double-fire, requiring usage of the 'ratelimit' command (like 'ratelimit <player> 1t') to prevent doubling actions. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerRightClicksEntityScriptEvent.java#L21 |
Name | player sends packet |
Event Lines | player sends packet |
Triggers | when a player sends a packet to the server. |
Generated Examples | after player sends packet:
on player sends packet: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | class:<classname-matcher> to only process the event when the packet class name matches a given classname matcher. |
Contexts | <context.class> returns an ElementTag of the packet's class name. Note that these are spigot-mapped names, not Mojang-mapped.
<context.reflect_packet> returns a JavaReflectedObjectTag of the packet object.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Player |
Warning(s) | This event will fire extremely rapidly. Use with caution. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerSendPacketScriptEvent.java#L16 |
Name | player steps on block |
Event Lines | player steps on block
player steps on <material> |
Triggers | when a player steps onto a specific block material. |
Generated Examples | after player steps on block:
after player steps on bamboo_fence_gate: on player steps on block: after player steps on music_disc_relic: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns a LocationTag of the block the player is stepping on.
<context.previous_location> returns a LocationTag of where the player was before stepping onto the block.
<context.new_location> returns a LocationTag of where the player is now.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerStepsOnScriptEvent.java#L17 |
Name | player walks |
Event Lines | player walks |
Triggers | when a player moves in the slightest. |
Generated Examples | after player walks:
on player walks: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.old_location> returns the location of where the player was.
<context.new_location> returns the location of where the player is.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | This event fires very very rapidly! |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerWalkScriptEvent.java#L15 |
Name | player right|left clicks block |
Event Lines | player (right|left) clicks <block> |
Triggers | when a player clicks on a block or in the air. |
Generated Examples | after player clicks gray_shulker_box:
after player clicks redstone_ore: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event if a specified item was held.
using:hand/off_hand/either_hand to only process the event if the specified hand was used to click. type:<material> to only run if the block clicked matches the material input. |
Contexts | <context.item> returns the ItemTag the player is clicking with.
<context.location> returns the LocationTag the player is clicking on.
<context.relative> returns a LocationTag of the air block in front of the clicked block.
<context.click_type> returns an ElementTag of the Spigot API click type https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/block/Action.html.
<context.hand> returns an ElementTag of the used hand.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Warning(s) | this event may in some cases double-fire, requiring usage of the 'ratelimit' command (like 'ratelimit <player> 1t') to prevent doubling actions.
this sometimes fires at unexpected times, eg when dropping an item. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerClicksBlockScriptEvent.java#L22 |
Name | player chooses arrow |
Event Lines | player chooses arrow |
Triggers | when a player chooses an arrow to load a bow/crossbow. |
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | arrow:<item> to only process the event when the players chosen arrow matches the input.
bow:<item> to only process the event when the players bow matches the input. |
Contexts | <context.arrow> returns the ItemTag of the arrow that was chosen.
<context.bow> returns the ItemTag of the bow that is about to get loaded.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerChoosesArrowScriptEvent.java#L17 |
Name | player prepares grindstone craft item |
Event Lines | player prepares grindstone craft <item> |
Triggers | when a player prepares to grind an item. |
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.inventory> returns the InventoryTag of the grindstone inventory.
<context.result> returns the ItemTag to be crafted.
|
Determine | "RESULT:<ItemTag>" to change the item that is crafted. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Player |
Requires | Paper |
Warning(s) | The player doing the grinding is estimated and may be inaccurate. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerPreparesGrindstoneCraftScriptEvent.java#L18 |
Name | server list ping |
Event Lines | server list ping |
Triggers | when the server is pinged for a client's server list. |
Generated Examples | on server list ping: |
Contexts | <context.motd> returns the MOTD that will show.
<context.max_players> returns the number of max players that will show.
<context.num_players> returns the number of online players that will show.
<context.address> returns the IP address requesting the list.
<context.hostname> returns an ElementTag of the server address that is being pinged. Available only on MC 1.19+.
<context.protocol_version> returns the protocol ID of the server's version (only on Paper).
<context.version_name> returns the name of the server's version (only on Paper).
<context.client_protocol_version> returns the client's protocol version ID (only on Paper).
|
Determine | "MAX_PLAYERS:<ElementTag(Number)>" to change the max player amount that will show.
"ICON:<ElementTag>" of a file path to an icon image, to change the icon that will display. "PROTOCOL_VERSION:<ElementTag(Number)>" to change the protocol ID number of the server's version (only on Paper). "VERSION_NAME:<ElementTag>" to change the server's version name (only on Paper). "EXCLUDE_PLAYERS:<ListTag(PlayerTag)>" to exclude a set of players from showing in the player count or preview of online players (only on Paper). "ALTERNATE_PLAYER_TEXT:<ListTag>" to set custom text for the player list section of the server status (only on Paper). (Requires "Allow restricted actions" in Denizen/config.yml). Usage of this to present lines that look like player names (but aren't) is forbidden. "MOTD:<ElementTag>" to change the MOTD that will show. |
Group | Server |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/server/ListPingScriptEvent.java#L26 |
Name | server start |
Event Lines | server start |
Triggers | when the server starts. |
Generated Examples | on server start: |
Group | Server |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/server/ServerStartScriptEvent.java#L7 |
Name | tab complete |
Event Lines | tab complete |
Triggers | when a player or the console is sent a list of available tab completions. |
Generated Examples | on tab complete: |
Has Player | when the tab completion is done by a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | command:<command_name> to only process the event if the command matches the input name. |
Contexts | <context.buffer> returns the full raw command buffer.
<context.command> returns the command name.
<context.current_arg> returns the current argument for completion.
<context.completions> returns a list of available tab completions.
<context.server> returns true if the tab completion was triggered from the console.
|
Determine | ListTag to set the list of available tab completions. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Server |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/server/TabCompleteScriptEvent.java#L18 |
Name | command |
Event Lines | command
<command_name> command |
Triggers | when a player, console, or command block/minecart runs a Bukkit command. This happens before
any code of established commands, allowing scripts to 'override' existing commands. Note that for the sake of the event line, escaping is used, so 'bukkit:plugins' becomes 'bukkit&coplugins' |
Generated Examples | after command:
after command_name command: |
Has Player | when source_type is player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.command> returns the command name as an ElementTag.
<context.raw_args> returns any args used, unmodified as plaintext.
<context.args> returns a ListTag of the arguments.
<context.source_type> returns the source of the command. Can be: PLAYER, SERVER, COMMAND_BLOCK, or COMMAND_MINECART.
<context.command_block_location> returns the command block's location (if the command was run from one).
<context.command_minecart> returns the EntityTag of the command minecart (if the command was run from one).
|
Determine | "FULFILLED" to tell Bukkit the command was handled. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Server |
Warning(s) | This event is to override existing commands, and should not be used to create new commands - use a command script instead. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/server/CommandScriptEvent.java#L27 |
Name | internal bukkit event |
Event Lines | internal bukkit event |
Triggers | when the specified internal Bukkit event fires. Useful for testing/debugging, or for interoperation with external plugins that have their own Bukkit events. Get the raw event via 'context.reflect_event'. |
Generated Examples | on internal bukkit event:
after internal bukkit event: |
Switches | event:<path> (required) to specify the Bukkit event path to use (like "event:org.bukkit.event.block.BlockBreakEvent") |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Server |
Warning(s) | This exists primarily for testing/debugging, and is almost never a good idea to include in a real script. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/server/InternalEventScriptEvent.java#L23 |
Name | server prestart |
Event Lines | server prestart |
Triggers | before the server finishes starting... fired after some saves are loaded, but before other data is loaded. Use with extreme caution. |
Example |
|
Group | Server |
Warning(s) | This event uses special pre-loading tricks to fire before everything else. Use extreme caution. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/server/ServerPrestartScriptEvent.java#L9 |
Name | shutdown |
Event Lines | shutdown |
Triggers | when the server is shutting down. |
Example |
|
Group | Server |
Warning(s) | not all plugins will be loaded and delayed scripts will be dropped.
Also note that this event is not guaranteed to always run (eg if the server crashes). |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/events/core/ShutdownScriptEvent.java#L7 |
Name | vehicle collides with block |
Event Lines | vehicle collides with block
vehicle collides with <material>
<vehicle> collides with block
<vehicle> collides with <material> |
Triggers | when a vehicle collides with a block. |
Generated Examples | after vehicle collides with block:
on vehicle collides with light_blue_wall_banner: on vehicle collides with block: on minecart collides with guster_pottery_sherd: after vehicle collides with orange_tulip: on horse collides with zombie_head: |
Contexts | <context.vehicle> returns the EntityTag of the vehicle.
<context.location> returns the LocationTag of the block.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Vehicle |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/vehicle/VehicleCollidesBlockScriptEvent.java#L14 |
Name | vehicle collides with entity |
Event Lines | vehicle collides with entity
vehicle collides with <entity>
<vehicle> collides with entity
<vehicle> collides with <entity> |
Triggers | when a vehicle collides with an entity. |
Example |
|
Example |
|
Example |
|
Has Player | when a vehicle collides with a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when a vehicle collides with an NPC. |
Switches | type:<entity> to only process the event if the colliding entity matches the EntityTag matcher input. |
Contexts | <context.vehicle> returns the EntityTag of the vehicle.
<context.entity> returns the EntityTag of the entity the vehicle has collided with.
<context.pickup> returns whether the vehicle can pick up the entity.
|
Determine | "PICKUP:<ElementTag(Boolean)>" to set whether the vehicle is allowed to pick up the entity or not. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Vehicle |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/vehicle/VehicleCollidesEntityScriptEvent.java#L16 |
Name | vehicle created |
Event Lines | vehicle created
<vehicle> created |
Triggers | when a vehicle is created. |
Generated Examples | after vehicle created:
on horse created: |
Contexts | <context.vehicle> returns the EntityTag of the vehicle.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Vehicle |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/vehicle/VehicleCreatedScriptEvent.java#L13 |
Name | vehicle damaged |
Event Lines | <vehicle> damaged
<entity> damages <vehicle> |
Triggers | when a vehicle is damaged. |
Example |
|
Example |
|
Example |
|
Has NPC | when the entity that damaged the vehicle is an NPC. |
Switches | type:<vehicle> to only run if the vehicle damaged matches the EntityTag matcher input. |
Contexts | <context.vehicle> returns the EntityTag of the vehicle.
<context.entity> returns the EntityTag of the attacking entity.
<context.damage> returns the amount of damage to be received.
|
Determine | ElementTag(Decimal) to set the value of the damage received by the vehicle. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Vehicle |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/vehicle/VehicleDamagedScriptEvent.java#L15 |
Name | vehicle destroyed |
Event Lines | vehicle destroyed
<vehicle> destroyed
entity destroys vehicle
<entity> destroys vehicle
entity destroys <vehicle>
<entity> destroys <vehicle> |
Triggers | when a vehicle is destroyed. |
Generated Examples | on vehicle destroyed:
on minecart destroyed: after entity destroys vehicle: on entity destroys vehicle: after player destroys vehicle: after minecart destroyed: after monster destroys vehicle: on wind_charge destroys vehicle: |
Has NPC | when the entity that destroyed the vehicle is an NPC. |
Contexts | <context.vehicle> returns the EntityTag of the vehicle.
<context.entity> returns the EntityTag of the attacking entity.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Vehicle |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/vehicle/VehicleDestroyedScriptEvent.java#L14 |
Name | vehicle moves |
Event Lines | vehicle moves
<vehicle> moves |
Triggers | when a vehicle moves in the slightest. |
Generated Examples | on vehicle moves:
on minecart moves: after vehicle moves: after horse moves: |
Contexts | <context.vehicle> returns the EntityTag of the vehicle.
<context.from> returns the location of where the vehicle was.
<context.to> returns the location of where the vehicle is.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Vehicle |
Warning(s) | This event fires very very rapidly! |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/vehicle/VehicleMoveScriptEvent.java#L13 |
Name | generic game event |
Event Lines | generic game event |
Triggers | when the minecraft world experiences a generic minecraft game event. This is normally used for sculk sensors. |
Generated Examples | after generic game event: |
Switches | type:<game_event_name> to only process the event when a specific game event is fired. |
Contexts | <context.location> returns the location of the event.
<context.entity> returns the entity that triggered the event, if any.
<context.game_event> returns the name of the Minecraft game event, for example "minecraft:block_change". See https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/GameEvent.html.
<context.radius> returns the radius, in blocks, that the event is broadcast to.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/GenericGameEventScriptEvent.java#L16 |
Name | lightning strikes |
Event Lines | lightning strikes |
Triggers | when lightning strikes in a world. |
Generated Examples | after lightning strikes: |
Contexts | <context.lightning> returns the EntityTag of the lightning.
<context.location> returns the LocationTag where the lightning struck.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/LightningStrikesScriptEvent.java#L13 |
Name | lingering potion splash|splashes |
Event Lines | lingering potion splash|splashes
lingering <item> splash|splashes |
Triggers | when a lingering splash potion breaks open |
Generated Examples | on lingering potion splash:
after lingering torchflower_seeds splashes: on lingering birch_stairs splashes: |
Contexts | <context.potion> returns an ItemTag of the potion that broke open.
<context.location> returns the LocationTag the splash potion broke open at.
<context.entity> returns an EntityTag of the splash potion.
<context.cloud> returns the EntityTag of the area of effect cloud.
<context.radius> returns the radius of the effect cloud.
<context.duration> returns the lingering duration of the effect cloud.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/LingeringPotionSplashScriptEvent.java#L16 |
Name | loot generates |
Event Lines | loot generates |
Triggers | when loot is generated somewhere in the world (like a vanilla chest being opened for the first time). |
Generated Examples | after loot generates: |
Has Player | when the linked entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | for:<type> to only process the event if a certain inventory type is receiving loot (like 'for:chest'). |
Contexts | <context.entity> returns an entity that caused loot generation, if any.
<context.inventory> returns the InventoryTag that loot is generating into.
<context.items> returns a ListTag of the items being generated.
<context.loot_table_id> returns an element indicating the minecraft key for the loot-table that was generated.
|
Determine | "LOOT:<ListTag(ItemTag)>" to change the list of items that will generate as loot. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/LootGenerateScriptEvent.java#L22 |
Name | portal created because reason |
Event Lines | portal created (because <reason>) |
Triggers | when a portal is created. |
Generated Examples | on portal created because reason:
on portal created: |
Contexts | <context.entity> returns the EntityTag that created the portal.
<context.world> returns the WorldTag the portal was created in.
<context.reason> returns an ElementTag of the reason the portal was created. (FIRE, NETHER_PAIR, END_PLATFORM)
<context.blocks> returns a ListTag of all the blocks that will become portal blocks.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/PortalCreateScriptEvent.java#L17 |
Name | potion splash|splashes |
Event Lines | potion splash|splashes
<item> splash|splashes |
Triggers | when a splash potion breaks open. |
Example |
|
Contexts | <context.potion> returns an ItemTag of the potion that broke open.
<context.entities> returns a ListTag of affected entities.
<context.location> returns the LocationTag the splash potion broke open at.
<context.entity> returns an EntityTag of the splash potion.
<context.intensity> returns an ListTag(MapTag) of the intensity for all affected entities.
|
Determine | INTENSITY:<ListTag(MapTag)>" to set the intensity of specified entities. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/PotionSplashScriptEvent.java#L25 |
Name | raid finishes |
Event Lines | raid finishes |
Triggers | when a village raid finishes normally. |
Generated Examples | after raid finishes:
on raid finishes: |
Contexts | <context.raid> returns the raid data. See Raid Event Data.
<context.winners> returns the ListTag of players who completed the raid. This is separate from the raid's heroes in that the winners are guaranteed to be online.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/RaidFinishesScriptEvent.java#L13 |
Name | raid spawns wave |
Event Lines | raid spawns wave |
Triggers | when a village raid spawns a new wave of raiders. |
Generated Examples | after raid spawns wave: |
Contexts | <context.raid> returns the raid data. See Raid Event Data.
<context.leader> returns the EntityTag of the patrol leader of the wave.
<context.new_raiders> returns the ListTag of all new raiders.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/RaidSpawnsWaveScriptEvent.java#L13 |
Name | raid stops |
Event Lines | raid stops |
Triggers | when a village raid stops for any reason. |
Generated Examples | on raid stops:
after raid stops: |
Switches | reason:<reason> to only process the event if the raid stopped for a certain reason. |
Contexts | <context.raid> returns the raid data. See Raid Event Data.
<context.reason> returns the reason for stopping. See https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/event/raid/RaidStopEvent.Reason.html.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/RaidStopsScriptEvent.java#L11 |
Name | spawn changes |
Event Lines | spawn changes |
Triggers | when the world's spawn point changes. |
Generated Examples | after spawn changes: |
Switches | for:<world> to only process the event when a specified world's spawn changes. |
Contexts | <context.world> returns the WorldTag that the spawn point changed in.
<context.old_location> returns the LocationTag of the old spawn point.
<context.new_location> returns the LocationTag of the new spawn point.
|
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/SpawnChangeScriptEvent.java#L13 |
Name | structure/plant grows naturally |
Event Lines | <structure/plant> grows (naturally)
<structure/plant> grows from bonemeal |
Triggers | when a structure (a tree or a mushroom) grows in a world. |
Generated Examples | after structure/plant grows:
on structure/plant grows from bonemeal: on structure/plant grows naturally: |
Has Player | when a player caused the structure growth to occur (eg with bonemeal). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.world> returns the WorldTag the structure grew in.
<context.location> returns the LocationTag the structure grew at.
<context.structure> returns an ElementTag of the structure's type. Refer to https://hub.spigotmc.org/javadocs/spigot/org/bukkit/TreeType.html.
<context.blocks> returns a ListTag of all block locations to be modified.
<context.new_materials> returns a ListTag of the new block materials, to go with <context.blocks>.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/StructureGrowsScriptEvent.java#L20 |
Name | thunder changes|begins|clears |
Event Lines | thunder changes|begins|clears |
Triggers | when thunder starts or stops in a world. |
Generated Examples | on thunder changes:
on thunder begins: |
Switches | in:<world> to only run the event if it applies to a specific world. |
Contexts | <context.world> returns the WorldTag the thunder changed in.
<context.thunder> returns true if thunder is starting, or false if thunder is stopping.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/ThunderChangesScriptEvent.java#L13 |
Name | time changes in world |
Event Lines | time changes (in <world>)
time <0-23> (in <world>) |
Triggers | when the current time changes in a world (once per mine-hour). |
Generated Examples | after time changes:
on time 0-23 in world_the_end: on time 0-23 in world: |
Contexts | <context.time> returns the current time (the hour, as a number from 0 to 23).
<context.world> returns the world.
|
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/TimeChangeScriptEvent.java#L11 |
Name | weather changes|rains|clears in world |
Event Lines | weather changes|rains|clears (in <world>) |
Triggers | when weather changes in a world. |
Generated Examples | after weather rains in world_the_end:
on weather clears: |
Contexts | <context.world> returns the WorldTag the weather changed in.
<context.weather> returns an ElementTag with the name of the new weather (rains or clears).
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/WeatherChangesScriptEvent.java#L13 |
Name | world initializes |
Event Lines | <world> initializes |
Triggers | when a world is initialized. |
Generated Examples | after world_the_end initializes:
after space initializes: |
Contexts | <context.world> returns the WorldTag that was initialized.
|
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/WorldInitsScriptEvent.java#L12 |
Name | world loads |
Event Lines | <world> loads |
Triggers | when a world is loaded. |
Generated Examples | on world_nether loads:
on space loads: |
Contexts | <context.world> returns the WorldTag that was loaded.
|
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/WorldLoadsScriptEvent.java#L12 |
Name | world saves |
Event Lines | <world> saves |
Triggers | when a world is saved. |
Generated Examples | on world saves:
after world saves: |
Contexts | <context.world> returns the WorldTag that was saved.
|
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/WorldSavesScriptEvent.java#L12 |
Name | world unloads |
Event Lines | <world> unloads |
Triggers | when a world is unloaded. |
Generated Examples | on space unloads:
after world unloads: |
Contexts | <context.world> returns the WorldTag that was unloaded.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | World |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/WorldUnloadsScriptEvent.java#L12 |
Name | chunk loads entities |
Event Lines | chunk loads entities |
Triggers | when a chunk loads in its entities. |
Generated Examples | on chunk loads entities: |
Switches | entity_type:<type-matcher> to only fire in the chunk contains an entity that matches the given entity matcher.
include_empty:<true/false> defaults to false, set to 'true' to include chunks loading an empty set of entities. |
Contexts | <context.chunk> returns the loading chunk.
<context.entities> returns a ListTag of all entities to be loaded.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Warning(s) | This event will fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/ChunkLoadEntitiesScriptEvent.java#L15 |
Name | chunk loads for the first time |
Event Lines | chunk loads (for the first time) |
Triggers | when a new chunk is loaded |
Generated Examples | after chunk loads:
on chunk loads for the first time: |
Contexts | <context.chunk> returns the loading chunk.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Warning(s) | This event will fire *extremely* rapidly and often when using 'for the first time'.
When not using that, it will fire so rapidly that lag is almost guaranteed. Use with maximum caution. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/ChunkLoadScriptEvent.java#L12 |
Name | chunk unloads |
Event Lines | chunk unloads |
Triggers | when a chunk is unloaded |
Generated Examples | after chunk unloads: |
Contexts | <context.chunk> returns the unloading chunk.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Warning(s) | This event will fire *extremely* rapidly and often! |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/ChunkUnloadScriptEvent.java#L12 |
Name | chunk unloads entities |
Event Lines | chunk unloads entities |
Triggers | when a chunk unloads in its entities. Note that this is basically a notification - it's already too late to change entity data. |
Generated Examples | on chunk unloads entities: |
Switches | entity_type:<type-matcher> to only fire in the chunk contains an entity that matches the given entity matcher.
include_empty:<true/false> defaults to false, set to 'true' to include chunks loading an empty set of entities. |
Contexts | <context.chunk> returns the unloading chunk.
<context.entities> returns a ListTag of all entities being unloaded.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | World |
Warning(s) | This event will fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/events/world/ChunkUnloadEntitiesScriptEvent.java#L15 |
Name | clientizen event |
Event Lines | clientizen event |
Triggers | When the server receives an event from a clientizen client, this requires config option 'Clientizen.process events' in the Depenizen config. |
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | id:<id> to only process the event if the identifier received from the client matches the specified matcher. |
Contexts | <context.id> returns an ElementTag of the event identifier received from the client.
<context.data> returns the context MapTag received from the client as a map of keys to ElementTags.
<context.(key)> returns the ElementTag value of the input key in the context map, if available.
|
Group | Clientizen |
Warning(s) | The client can send any data it wants, so should very carefully verify any input before using it. |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/clientizen/ClientizenEventScriptEvent.java#L15 |
Name | areashop shop bought |
Event Lines | areashop <shop> bought |
Triggers | when an AreaShop is bought. |
Generated Examples | after areashop shop bought:
on areashop shop bought: |
Has Player | Always (the buyer). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.shop> returns the AreaShop that's being bought.
|
Group | Depenizen |
Requires | Depenizen, AreaShop |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/areashop/AreaShopBoughtScriptEvent.java#L15 |
Name | areashop shop expires |
Event Lines | areashop <shop> expires |
Triggers | when an AreaShop's rent expires. |
Generated Examples | after areashop shop expires: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.shop> Returns the AreaShop that's expiring.
|
Group | Depenizen |
Requires | Depenizen, AreaShop |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/areashop/AreaShopExpiresScriptEvent.java#L15 |
Name | areashop shop rented |
Event Lines | areashop <shop> rented |
Triggers | when an AreaShop is rented. |
Generated Examples | after areashop shop rented: |
Has Player | Always (the renter). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.shop> returns the AreaShop that's being rented.
<context.extended> returns true if the region has been extended, false if this is the first time buying the region.
|
Group | Depenizen |
Requires | Depenizen, AreaShop |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/areashop/AreaShopRentedScriptEvent.java#L16 |
Name | areashop shop resold |
Event Lines | areashop <shop> resold |
Triggers | when an AreaShop is resold. |
Generated Examples | after areashop shop resold: |
Has Player | Always (the buyer). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.shop> returns the AreaShop that's being resold.
<context.seller> returns the player that has resold the shop.
|
Group | Depenizen |
Requires | Depenizen, AreaShop |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/areashop/AreaShopResoldScriptEvent.java#L15 |
Name | areashop shop sold |
Event Lines | areashop <shop> sold |
Triggers | when an AreaShop is resold. |
Generated Examples | after areashop shop sold:
on areashop shop sold: |
Has Player | Always (the old buyer). - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.shop> returns the AreaShop that's being sold.
|
Group | Depenizen |
Requires | Depenizen, AreaShop |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/areashop/AreaShopSoldScriptEvent.java#L15 |
Name | arikeys key pressed |
Event Lines | arikeys key pressed |
Triggers | When a key is pressed by a client running AriKeys, if that key is in the AriKeys config. |
Generated Examples | on arikeys key pressed: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | id:<id> to only process the event if the key ID matches the given text matcher. |
Contexts | <context.id> Returns the ID of the key that was pressed according to the AriKeys config, as a namespaced key.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, AriKeys |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/arikeys/AriKeysKeyPressScriptEvent.java#L14 |
Name | arikeys key released |
Event Lines | arikeys key released |
Triggers | When a key stops being pressed by a client running AriKeys, if that key is in the AriKeys config. |
Generated Examples | after arikeys key released:
on arikeys key released: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | id:<id> to only process the event if the key ID matches the given text matcher. |
Contexts | <context.id> Returns the ID of the key that was released according to the AriKeys config, as a namespaced key.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, AriKeys |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/arikeys/AriKeysKeyReleaseScriptEvent.java#L14 |
Name | bigdoors door toggles|opens|closes |
Event Lines | bigdoors door toggles|opens|closes |
Triggers | when a Big Doors door opens or closes. |
Generated Examples | after bigdoors door opens: |
Switches | door:<id> to only process the event if the door matches the input. |
Contexts | <context.door> returns the Big Doors door being toggled.
<context.state> returns the Big Doors open state ('open' or 'close').
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Big Doors |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bigdoors/BigDoorsDoorTogglesScriptEvent.java#L15 |
Name | bungee player joins network |
Event Lines | bungee player joins network |
Triggers | when a player joins the Bungee network (but has not yet entered a server). |
Generated Examples | after bungee player joins network:
on bungee player joins network: |
Has Player | when the player has been on this specific server before. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.name> returns the connecting player's name.
<context.uuid> returns the connecting player's UUID.
<context.ip> returns the connecting player's IP address.
<context.hostname> returns the virtual hostname that the player is connecting to.
|
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeePlayerJoinsScriptEvent.java#L16 |
Name | bungee player leaves network |
Event Lines | bungee player leaves network |
Triggers | when a player leaves the Bungee network. |
Generated Examples | after bungee player leaves network:
on bungee player leaves network: |
Has Player | when the player has been on this specific server before. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.name> returns the leaving player's name.
<context.uuid> returns the leaving player's UUID.
<context.ip> returns the leaving player's IP address.
|
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeePlayerQuitsScriptEvent.java#L16 |
Name | bungee player switches to server |
Event Lines | bungee player switches to server |
Triggers | when a player switches to a new server on the Bungee network. |
Generated Examples | on bungee player switches to server:
after bungee player switches to server: |
Has Player | when the player has been on this specific server before. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.name> returns the switching player's name.
<context.uuid> returns the switching player's UUID.
<context.server> returns the name of the server being switched to.
|
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeePlayerServerSwitchScriptEvent.java#L16 |
Name | bungee server connects |
Event Lines | bungee server connects |
Triggers | when another server on the Bungee network becomes connected. |
Generated Examples | after bungee server connects: |
Contexts | <context.server> returns the name of the newly connected server.
|
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeeServerConnectScriptEvent.java#L11 |
Name | bungee server disconnects |
Event Lines | bungee server disconnects |
Triggers | when another server on the Bungee network becomes disconnected. |
Generated Examples | on bungee server disconnects:
after bungee server disconnects: |
Contexts | <context.server> returns the name of the previously connected server.
|
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeeServerDisconnectScriptEvent.java#L11 |
Name | crackshot landmine triggered |
Event Lines | crackshot landmine triggered |
Triggers | when a CrackShot landmine is triggered by an entity walking through it. |
Generated Examples | after crackshot landmine triggered: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the weapon name of the landmine.
<context.victim> returns the entity that triggered the landmine.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotLandmineTriggerEvent.java#L15 |
Name | crackshot player finishes reloading weapon |
Event Lines | crackshot player finishes reloading weapon |
Triggers | when a player finishes reloading their CrackShot weapon. |
Generated Examples | after crackshot player finishes reloading weapon:
on crackshot player finishes reloading weapon: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon.
|
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerFinishesReloadingWeaponEvent.java#L14 |
Name | crackshot player fires automatic weapon |
Event Lines | crackshot player fires automatic weapon |
Triggers | while a player is firing a fully automatic CrackShot weapon. |
Generated Examples | after crackshot player fires automatic weapon: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon.
<context.fire_rate> returns the weapon fire rate.
|
Determine | "FIRE_RATE:<ElementTag(Number)>" to set the fire rate. |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerFiresAutomaticWeaponEvent.java#L16 |
Name | crackshot player fires projectile |
Event Lines | crackshot player fires projectile |
Triggers | just before a projectile is launched from a CrackShot weapon. |
Generated Examples | after crackshot player fires projectile: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon about to fire.
<context.bullet_spread> returns the spread of the projectiles being fired.
<context.left_click> returns whether the fire was a left click.
<context.shot_sounds> returns a list of the shot sounds.
|
Determine | "BULLET_SPREAD:<ElementTag(Number)>" to set the bullet spread.
"SHOT_SOUNDS:<ElementTag>" to set the shot sounds. Use "NONE" to have no sound. https://github.com/Shampaggon/CrackShot/wiki/The-Complete-Guide-to-CrackShot#sounds |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerFiresProjectileEvent.java#L19 |
Name | crackshot player places landmine |
Event Lines | crackshot player places landmine |
Triggers | when a player places a landmine. |
Generated Examples | after crackshot player places landmine:
on crackshot player places landmine: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.landmine> returns the EntityTag for the landmine.
|
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerPlacesLandmineEvent.java#L14 |
Name | crackshot player starts firing weapon |
Event Lines | crackshot player starts firing weapon |
Triggers | when a player tries to start firing a CrackShot weapon. |
Generated Examples | on crackshot player starts firing weapon: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerStartsFiringWeaponEvent.java#L14 |
Name | crackshot player starts reloading weapon |
Event Lines | crackshot player starts reloading weapon |
Triggers | when a player starts reloading their CrackShot weapon. |
Generated Examples | after crackshot player starts reloading weapon:
on crackshot player starts reloading weapon: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon.
<context.reload_speed> returns the rate at which the weapon is reloaded.
<context.reload_time> returns the time taken to reload in ticks.
<context.reload_sounds> returns a ListTag of the reload sounds.
|
Determine | "RELOAD_SPEED: <ElementTag(Number)>" to set the reload speed.
The reload speed can be scaled with a decimal ranging from zero to infinity. For example, 0 is instantaneous, 1 is normal and 2 will double the reload time. "RELOAD_TIME:<DurationTag>" to set the time taken to reload in ticks. "RELOAD_SOUNDS:<ElementTag>" to set the reload sounds. Use "NONE" to have no sound. https://github.com/Shampaggon/CrackShot/wiki/The-Complete-Guide-to-CrackShot#sounds |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerStartsReloadingWeaponEvent.java#L20 |
Name | crackshot player toggles weapon attachment |
Event Lines | crackshot player toggles weapon attachment |
Triggers | when a player toggles an attachment on a CrackShot weapon. |
Generated Examples | after crackshot player toggles weapon attachment: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon.
<context.delay> returns the delay between toggles.
|
Determine | "TOGGLE_DELAY:<ElementTag(Number)>" to set the time between toggles. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerTogglesWeaponAttachmentEvent.java#L17 |
Name | crackshot player zooms weapon scope |
Event Lines | crackshot player zooms weapon scope |
Triggers | when a player zooms their CrackShot weapon scope. |
Generated Examples | after crackshot player zooms weapon scope: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.weapon> returns the name of the weapon.
<context.zoomed> returns whether the player zoomed in.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotPlayerZoomsWeaponScopeEvent.java#L14 |
Name | crackshot weapon causes explosion |
Event Lines | crackshot weapon causes explosion |
Triggers | when a CrackShot weapon explodes, splits or airstrikes. |
Generated Examples | after crackshot weapon causes explosion: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag for where the explosion occurred.
<context.weapon> returns the weapon name that caused the explosion.
<context.split> returns whether the explosion was a cluster bomb splitting.
<context.airstrike> returns whether the explosion was an airstrike call.
|
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotWeaponCausesExplosionEvent.java#L15 |
Name | crackshot weapon damages entity |
Event Lines | crackshot weapon damages entity |
Triggers | when an entity is damaged by a CrackShot weapon. |
Generated Examples | on crackshot weapon damages entity:
after crackshot weapon damages entity: |
Has Player | Always - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.damager> returns the entity that did the damage. This can be a projectile, or TNT.
<context.weapon> returns the name of the weapon that did the damage.
<context.victim> returns the entity that was damaged.
<context.damage> returns the amount of damage dealt.
<context.backstab> returns if the attack was a back-stab.
<context.critical> returns if the attack was a critical hit.
<context.headshot> returns if the attack was a head-shot.
|
Determine | ElementTag(Decimal) to set damage dealt. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, CrackShot |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/crackshot/CrackShotWeaponDamageEntityEvent.java#L16 |
Name | essentials player balance changes |
Event Lines | essentials player balance changes |
Triggers | when a player's balance changes, when using Essentials economy. |
Generated Examples | after essentials player balance changes: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.old_balance> Returns the balance before changes are made.
<context.new_balance> Returns the balance after changes are made.
<context.cause> returns the reason for the balance change, refer to https://github.com/EssentialsX/Essentials/blob/2.x/Essentials/src/main/java/net/ess3/api/events/UserBalanceUpdateEvent.java#L73-L78.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, Essentials |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/essentials/PlayerBalanceChangeScriptEvent.java#L14 |
Name | gp claim changed |
Event Lines | gp claim changed |
Triggers | when a Grief Prevention claim is modified. |
Generated Examples | after gp claim changed:
on gp claim changed: |
Has Player | when source_type is player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.old_claim> returns the GriefPreventionClaimTag of the old claim.
<context.new_claim> returns the GriefPreventionClaimTag of the new claim.
<context.source_type> returns the source of the change. Can be: PLAYER, SERVER, or AUTO_DEEPEN.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, GriefPrevention |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/griefprevention/GPClaimChangedScriptEvent.java#L19 |
Name | gp claim created |
Event Lines | gp claim created |
Triggers | when a Grief Prevention claim is created. |
Generated Examples | on gp claim created: |
Has Player | when source_type is player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.claim> returns the GriefPreventionClaimTag that is being created.
<context.source_type> returns the source of the creation. Can be PLAYER or SERVER.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, GriefPrevention |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/griefprevention/GPClaimCreatedScriptEvent.java#L17 |
Name | gp claim deleted |
Event Lines | gp claim deleted |
Triggers | when a Grief Prevention claim is deleted. |
Generated Examples | on gp claim deleted:
after gp claim deleted: |
Contexts | <context.claim> returns the GriefPreventionClaimTag being deleted.
|
Group | Depenizen |
Requires | Depenizen, GriefPrevention |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/griefprevention/GPClaimDeletedScriptEvent.java#L12 |
Name | jobs player earns exp for job |
Event Lines | jobs player earns exp for <job> |
Triggers | when a player performs an action that would cause them to earn Jobs exp for a certain job. |
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | action:<action> to only process the event if it came from a specified action. |
Contexts | <context.job> Returns a JobsJobTag of the job that the player is gaining exp for.
<context.experience> Returns an ElementTag(Decimal) of the amount of exp the player will earn.
<context.action> Returns an ElementTag of the name of the action being paid for, which can be any of the strings from: https://github.com/Zrips/Jobs/blob/master/src/main/java/com/gamingmesh/jobs/container/ActionType.java.
<context.entity> Returns an EntityTag of the entity involved with this event, if any.
<context.block> Returns a LocationTag of the block involved with this event, if any.
|
Determine | "EXP:<ElementTag(Decimal)>" to change the amount of Jobs exp this action should provide. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Jobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/jobs/JobsJobsExpGainScriptEvent.java#L19 |
Name | jobs player earns money for job |
Event Lines | jobs player earns money for <job> |
Triggers | when a player performs an action that would cause them to be paid for a certain job. |
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | action:<action> to only process the event if it came from a specified action. |
Contexts | <context.job> Returns an JobsJobTag of the job that the player is being paid for.
<context.money> Returns an ElementTag(Decimal) of the amount of money the player will be paid.
<context.points> Returns an ElementTag(Decimal) of the amount of points the player will be paid.
<context.action> Returns an ElementTag the name of the action being paid for, which can be any of the strings from: https://github.com/Zrips/Jobs/blob/master/src/main/java/com/gamingmesh/jobs/container/ActionType.java.
<context.entity> Returns an EntityTag of the entity involved with this event, if any.
<context.block> Returns a LocationTag of the block involved with this event, if any.
|
Determine | "MONEY:<ElementTag(Decimal)>" to change the amount of money this action should provide.
"POINTS:<ElementTag(Decimal)>" to change the amount of Jobs points this action should provide. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Jobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/jobs/JobsJobsPaymentScriptEvent.java#L19 |
Name | jobs player joins job |
Event Lines | jobs player joins <job> |
Triggers | when a player joins the specified job. |
Generated Examples | after jobs player joins job: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.job> Returns the job that the player is joining.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Jobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/jobs/JobsJobsJoinScriptEvent.java#L15 |
Name | jobs player leaves job |
Event Lines | jobs player leaves <job> |
Triggers | when a player joins the specified job. |
Generated Examples | after jobs player leaves job: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.job> Returns the job that the player is joining.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Jobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/jobs/JobsJobsLeaveScriptEvent.java#L15 |
Name | jobs player levels up job |
Event Lines | jobs player levels up <job> |
Triggers | when a player levels up in the specified job. |
Generated Examples | on jobs player levels up job:
after jobs player levels up job: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.job> Returns the job that the player is levelling up in.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Jobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/jobs/JobsJobsLevelUpScriptEvent.java#L15 |
Name | libsdisguises disguise|disguises disguise |
Event Lines | libsdisguises disguise|disguises <disguise> |
Triggers | when a entity disguises. |
Generated Examples | after libsdisguises disguise disguise: |
Contexts | <context.entity> returns the entity who disguised.
<context.disguise> returns the disguise in use.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, LibsDisguises |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/libsdisguises/EntityDisguisesScriptEvent.java#L15 |
Name | libsdisguises undisguise|undisguises disguise |
Event Lines | libsdisguises undisguise|undisguises <disguise> |
Triggers | when a entity undisguises. |
Generated Examples | on libsdisguises undisguise disguise:
after libsdisguises undisguise disguise: |
Contexts | <context.entity> returns the entity who undisguised.
<context.disguise> returns the disguise in use.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, LibsDisguises |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/libsdisguises/EntityUndisguisesScriptEvent.java#L15 |
Name | magicspells entity casts spell |
Event Lines | magicspells <entity> casts <spell> |
Triggers | when an entity starts to casts a spell. |
Generated Examples | after magicspells breeze casts spell:
after magicspells fish casts spell: |
Has Player | When the caster is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.spell_name> returns the name of the spell.
<context.caster> returns the entity that casted the spell.
<context.power> returns an ElementTag(Decimal) of the power of the spell.
<context.cast_time> returns an ElementTag(Number) of the cast time of the spell.
<context.cooldown> returns an ElementTag(Decimal) of the cooldown of the spell.
<context.spell_reagent_TYPE> returns an ElementTag(Number) of the reagent cost for the given type. Valid types are: mana, health, hunger, experience, levels, durability, money
<context.spell_reagent_variables> returns a ListTag in the form variable/cost|...
<context.spell_reagent_items> returns a ListTag of ItemTags of reagent cost.
|
Determine | "POWER:<ElementTag(Number)>" to change the power of the spell.
"CAST_TIME:<ElementTag(Decimal)>" to change the cast time. "COOLDOWN:<ElementTag(Number)>" to change the cooldown. "REAGENT:<TYPE>:<ElementTag(Number)>" to change the reagent cost of the given type. Valid types are: mana, health, hunger, experience, levels, durability, money "REAGANT:VARIABLE:<NAME>:<ElementTag(Decimal)>" to change the reagant cost for the given variable name. "REAGENT:ITEMS:<ListTag(ItemTag)>" to change the reagent item cost. "CLEAR_REAGENTS" to clear away all reagent costs. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, MagicSpells |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/magicspells/SpellCastScriptEvent.java#L26 |
Name | magicspells entity completes spell |
Event Lines | magicspells entity completes spell
magicspells <entity> completes spell |
Triggers | when the spell is done and everything has been handled. |
Generated Examples | on magicspells entity completes spell:
on magicspells piglin completes spell: after magicspells entity completes spell: |
Has Player | When the caster is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.spell_name> returns the name of the spell.
<context.caster> returns the entity that casted the spell.
<context.power> returns an ElementTag(Decimal) of the power of the spell.
<context.cooldown> returns an ElementTag(Decimal) of the cooldown of the spell.
|
Group | Depenizen |
Requires | Depenizen, MagicSpells |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/magicspells/SpellCastedScriptEvent.java#L15 |
Name | magicspells player learns spell |
Event Lines | magicspells player learns spell |
Triggers | when a player is about to learn a spell. |
Generated Examples | after magicspells player learns spell:
on magicspells player learns spell: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.spell_name> returns the name of the spell.
<context.source> returns the source. Can either be SPELLBOOK, TEACH, TOME or OTHER
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, MagicSpells |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/magicspells/SpellLearnScriptEvent.java#L15 |
Name | magicspells player mana change |
Event Lines | magicspells player mana change |
Triggers | when a player's mana value changes. |
Generated Examples | on magicspells player mana change:
after magicspells player mana change: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.old_mana> returns the old amount of mana.
<context.new_mana> returns the new amount of mana.
<context.max_mana> returns maximum mana the player can have.
<context.reason> returns the reason of the change. Can either be POTION, REGEN, SPELL_COST or OTHER
|
Determine | ElementTag(Number) to set a new mana value. |
Group | Depenizen |
Requires | Depenizen, MagicSpells |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/magicspells/ManaChangeScriptEvent.java#L15 |
Name | mcmmo player activates ability for skill |
Event Lines | mcmmo player activates <ability> for <skill> |
Triggers | when a player activates mcmmo ability. |
Generated Examples | after mcmmo player activates ability for skill:
on mcmmo player activates ability for skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill> returns the name of the skill that the ability comes from.
(Based on the mcMMO language file).
<context.ability> returns the name of the ability.
<context.skill_level> returns the skill level of the skill from the ability.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, mcMMO |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mcmmo/mcMMOPlayerAbilityActivateScriptEvent.java#L17 |
Name | mcmmo player deactivates ability for skill |
Event Lines | mcmmo player deactivates <ability> for <skill> |
Triggers | when a player deactivates mcmmo ability. |
Generated Examples | on mcmmo player deactivates ability for skill:
after mcmmo player deactivates ability for skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill> returns the name of the skill that the ability comes from.
(Based on the mcMMO language file).
<context.ability> returns the name of the ability.
<context.skill_level> returns the skill level from the ability.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, mcMMO |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mcmmo/mcMMOPlayerAbilityDeactivateScriptEvent.java#L17 |
Name | mcmmo player gains xp for skill |
Event Lines | mcmmo player gains xp for <skill> |
Triggers | when a player gains mcMMO xp. |
Generated Examples | on mcmmo player gains xp for skill:
after mcmmo player gains xp for skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill> returns the name of the skill that the player gained xp for.
(Based on the mcMMO language file).
<context.xp> returns the amount of xp gained.
<context.cause> returns the cause of the xp gain.
Will be one of: 'PVP', 'PVE', 'VAMPIRISM', 'SHARED_PVP', 'SHARED_PVE', 'COMMAND', 'UNKNOWN'.
|
Determine | ElementTag(Decimal) to set the XP gained. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, mcMMO |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mcmmo/mcMMOPlayerGainsXPScriptEvent.java#L17 |
Name | mcmmo player levels down skill |
Event Lines | mcmmo player levels down <skill> |
Triggers | when a player loses levels for an mcMMO skill. |
Generated Examples | on mcmmo player levels down skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill> returns the name of the skill that lost levels. (Based on the mcMMO language file).
<context.levels_lost> returns the number of levels lost.
<context.old_level> returns the old level of the skill.
<context.new_level> returns the new level of the skill.
<context.cause> returns the cause of the level loss.
Will be one of: 'PVP', 'PVE', 'VAMPIRISM', 'SHARED_PVP', 'SHARED_PVE', 'COMMAND', 'UNKNOWN'.
|
Determine | ElementTag(Number) to set the number of levels to gain. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, mcMMO |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mcmmo/mcMMOPlayerLevelDownScriptEvent.java#L17 |
Name | mcmmo player levels up skill |
Event Lines | mcmmo player levels up <skill> |
Triggers | when a player levels up an mcMMO skill. |
Generated Examples | after mcmmo player levels up skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill> returns the name of the skill that levelled up. (Based on the mcMMO language file).
<context.levels_gained> returns the number of levels gained.
<context.old_level> returns the old level of the skill.
<context.new_level> returns the new level of the skill.
<context.cause> returns the cause of the level gain.
Will be one of: 'PVP', 'PVE', 'VAMPIRISM', 'SHARED_PVP', 'SHARED_PVE', 'COMMAND', 'UNKNOWN'.
|
Determine | ElementTag(Number) to set the number of levels to gain. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, mcMMO |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mcmmo/mcMMOPlayerLevelUpScriptEvent.java#L17 |
Name | mcmmo player skill level changes |
Event Lines | mcmmo player <skill> level changes |
Triggers | when a player's mcmmo skill level changes. |
Generated Examples | after mcmmo player skill level changes:
on mcmmo player skill level changes: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill> returns the name of the skill that changed level. (Based on the mcMMO language file).
<context.level> returns the level the skill changed to.
<context.cause> returns the cause of the level change.
Will be one of: 'PVP', 'PVE', 'VAMPIRISM', 'SHARED_PVP', 'SHARED_PVE', 'COMMAND', 'UNKNOWN'.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, mcMMO |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mcmmo/mcMMOPlayerLevelChangeScriptEvent.java#L17 |
Name | mobarena arena ends |
Event Lines | mobarena <arena> ends |
Triggers | when a mobarena ends. |
Generated Examples | on mobarena arena ends: |
Contexts | <context.arena> Returns the arena which ended.
<context.wave> Returns the number of the final wave.
|
Group | Depenizen |
Requires | Depenizen, MobArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mobarena/MobArenaEndsScriptEvent.java#L16 |
Name | mobarena arena starts |
Event Lines | mobarena <arena> starts |
Triggers | when a mobarena starts. |
Generated Examples | after mobarena arena starts: |
Contexts | <context.arena> Returns the arena which started.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, MobArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mobarena/MobArenaStartsScriptEvent.java#L15 |
Name | mobarena arena wave changes |
Event Lines | mobarena <arena> wave changes |
Triggers | when a wave changes in a MobArena. |
Generated Examples | on mobarena arena wave changes:
after mobarena arena wave changes: |
Contexts | <context.arena> Returns the arena in which the wave change occured.
<context.wave> Returns the number of the new wave.
|
Group | Depenizen |
Requires | Depenizen, MobArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mobarena/MobArenaWaveChangesScriptEvent.java#L15 |
Name | mythicmob mob despawns |
Event Lines | mythicmob <mob> despawns |
Triggers | when a MythicMob despawns. |
Generated Examples | on mythicmob mob despawns: |
Contexts | <context.mob> Returns the MythicMob that is despawning.
<context.entity> Returns the EntityTag for the MythicMob.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, MythicMobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mythicmobs/MythicMobsDespawnEvent.java#L14 |
Name | mythicmob mob dies|death|killed |
Event Lines | mythicmob <mob> dies|death|killed |
Triggers | when a MythicMob dies. |
Generated Examples | after mythicmob mob dies: |
Switches | by:<entity> to only process the event if the killer matches a specified entity type. |
Contexts | <context.mob> Returns the MythicMob that has been killed.
<context.entity> Returns the EntityTag for the MythicMob.
<context.killer> returns the EntityTag that killed the MythicMob (if available).
<context.level> Returns the level of the MythicMob.
<context.drops> Returns a list of items dropped.
|
Determine | ListTag(ItemTag) to specify new items to be dropped. |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, MythicMobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mythicmobs/MythicMobsDeathEvent.java#L22 |
Name | mythicmob mob spawns |
Event Lines | mythicmob <mob> spawns |
Triggers | when a MythicMob spawns. |
Generated Examples | after mythicmob mob spawns:
on mythicmob mob spawns: |
Contexts | <context.mob> Returns the MythicMob that is spawning.
<context.entity> Returns the EntityTag for the MythicMob.
<context.location> Returns the LocationTag of where the MythicMob will spawn.
<context.from_spawner> Returns true if the mob was from a spawner.
<context.spawner_location> Returns the LocationTag of the spawner that spawned the mob, if any.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, MythicMobs |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mythicmobs/MythicMobsSpawnEvent.java#L17 |
Name | noteblockapi song song ends |
Event Lines | noteblockapi song (<song>) ends |
Triggers | when a song playing through NoteBlockAPI ends. |
Generated Examples | after noteblockapi song ends: |
Contexts | <context.song> returns the file name of the song.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, NoteBlockAPI |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/noteblockapi/NoteBlockAPISongEndsScriptEvent.java#L19 |
Name | player completes skyblock challenge |
Event Lines | player completes skyblock challenge |
Triggers | when a player completes a skyblock challenge. |
Generated Examples | on player completes skyblock challenge:
after player completes skyblock challenge: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.challenge> Returns the name of the challenge.
<context.xp_reward> Return the amount of experience to be rewarded.
<context.money_reward> Returns the amount of money to be rewarded.
<context.item_rewards> Returns a list of items to be awarded.
NOTE: item rewards is dependant on how the plugin handles item rewards. Untested and no guarantee of working.
|
Group | Depenizen |
Requires | Depenizen, A SkyBlock |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/askyblock/PlayerCompletesSkyBlockChallengeScriptEvent.java#L17 |
Name | player creates shopkeeper |
Event Lines | player creates shopkeeper |
Triggers | when a player creates a shopkeeper. |
Generated Examples | on player creates shopkeeper:
after player creates shopkeeper: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> Returns the LocationTag of the shopkeeper being created.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, ShopKeepers |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/shopkeepers/ShopKeeperCreatedScriptEvent.java#L14 |
Name | player exits skyblock |
Event Lines | player exits skyblock |
Triggers | when a player leaves a skyblock island. |
Generated Examples | after player exits skyblock: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.owner> Returns the owner of the island.
<context.island_location> Returns the location of the island.
<context.location> Returns the location the player exited at.
|
Group | Depenizen |
Requires | Depenizen, A SkyBlock |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/askyblock/PlayerExitsSkyBlockScriptEvent.java#L15 |
Name | player god mode enabled |
Event Lines | player god mode enabled
player god mode disabled
player god mode status changes |
Triggers | when a player's god mode status changes. |
Generated Examples | after player god mode enabled:
after player god mode disabled: after player god mode status changes: on player god mode status changes: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.status> Returns the player's god mode status.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Essentials |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/essentials/PlayerGodModeStatusScriptEvent.java#L15 |
Name | player goes afk |
Event Lines | player goes afk
player returns from afk
player afk status changes |
Triggers | when a player's afk status changes. |
Generated Examples | after player goes afk:
after player returns from afk: after player afk status changes: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.status> Returns the player's afk status.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Essentials |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/essentials/PlayerAFKStatusScriptEvent.java#L15 |
Name | player jailed |
Event Lines | player jailed
player unjailed
player un-jailed
player jail status changes |
Triggers | when a player's jail status changes. |
Generated Examples | after player jailed:
after player unjailed: after player un-jailed: after player jail status changes: on player unjailed: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.status> Returns the player's jail status.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Essentials |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/essentials/PlayerJailStatusScriptEvent.java#L15 |
Name | player muted |
Event Lines | player muted
player unmuted
player un-muted
player mute status changes |
Triggers | when a player is muted or un-muted. |
Generated Examples | on player muted:
after player unmuted: on player un-muted: after player mute status changes: after player muted: after player un-muted: on player mute status changes: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.status> Returns whether the player is muted.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Essentials |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/essentials/PlayerMuteStatusScriptEvent.java#L15 |
Name | plotsquared player claims plotsquaredplot |
Event Lines | plotsquared player claims <plotsquaredplot> |
Triggers | when a player claims a plot. |
Generated Examples | after plotsquared player claims plotsquaredplot: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.plot> returns the plot the player claimed.
<context.auto> returns true if the plot was claimed automatic.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, PlotSquared |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/plotsquared/PlayerClaimPlotScriptEvent.java#L17 |
Name | plotsquared player enters plotsquaredplot |
Event Lines | plotsquared player enters <plotsquaredplot> |
Triggers | when a player enters a plot. |
Generated Examples | after plotsquared player enters plotsquaredplot: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.plot> returns the plot the player entered.
|
Group | Depenizen |
Requires | Depenizen, PlotSquared |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/plotsquared/PlayerEntersPlotScriptEvent.java#L16 |
Name | plotsquared player leaves|exits plotsquaredplot |
Event Lines | plotsquared player leaves|exits <plotsquaredplot> |
Triggers | when a player leaves a plot. |
Generated Examples | on plotsquared player exits plotsquaredplot: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.plot> returns the plot the player left.
|
Group | Depenizen |
Requires | Depenizen, PlotSquared |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/plotsquared/PlayerLeavePlotScriptEvent.java#L16 |
Name | plotsquared plot clear|clears plotsquaredplot |
Event Lines | plotsquared plot clear|clears <plotsquaredplot> |
Triggers | when a plot is cleared. |
Generated Examples | on plotsquared plot clear plotsquaredplot:
on plotsquared plot clears plotsquaredplot: |
Contexts | <context.plot> returns the plot that is cleared.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, PlotSquared |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/plotsquared/PlotClearScriptEvent.java#L14 |
Name | proxy server command command |
Event Lines | proxy server (<command>) command |
Triggers | when a player runs a command on the bungee proxy server. |
Generated Examples | after proxy server command: |
Has Player | when the player has been on this specific server before. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.sender> returns the name of the command sender.
<context.sender_id> returns the UUID of the command sender, if available.
<context.command> returns the command executed.
|
Determine | "COMMAND:<ElementTag>" to change the command that will be ran. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeeProxyServerCommandScriptEvent.java#L18 |
Name | proxy server list ping |
Event Lines | proxy server list ping |
Triggers | when the bungeecord server is pinged and will return server details. |
Generated Examples | after proxy server list ping: |
Contexts | <context.address> returns the source address of the ping.
<context.current_players> returns the number of players listed as currently online.
<context.max_players> return the maximum number of players that can join according to the list.
<context.motd> returns the server MOTD that will be displayed.
<context.protocol> returns the protocol number that will be given to the ping requester.
<context.version> returns the name of the server version that will be given to the ping requester.
|
Determine | "MAX_PLAYERS:<ElementTag(Number)>" to change the listed maximum number of players.
"VERSION:<ElementTag>" to change the listed server version. "MOTD:<ElementTag>" to change the server MOTD that will be displayed. "PLAYERS:<List(PlayerTag)>" to set what players are displayed in the "online players sample" view of the list ping. "ALTERNATE_PLAYER_TEXT:<ListTag>" to set custom text for the player list section of the server status. (Requires "Allow restricted actions" in Denizen/config.yml). Usage of this to present lines that look like player names (but aren't) is forbidden. |
Group | Depenizen |
Requires | Depenizen, DepenizenBungee, BungeeCord |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/bungee/BungeeProxyServerListPingScriptEvent.java#L21 |
Name | pvparena player exits |
Event Lines | pvparena player exits |
Triggers | when a player exit a pvparena (won, loose, leave, disconnect etc.) |
Generated Examples | after pvparena player exits:
on pvparena player exits: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.arena> returns the arena denizen object.
|
Group | Depenizen |
Requires | Depenizen, PVPArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/pvparena/PlayerExitsPVPArenaScriptEvent.java#L14 |
Name | pvparena player joins |
Event Lines | pvparena player joins |
Triggers | when a player joins a pvparena. |
Generated Examples | on pvparena player joins:
after pvparena player joins: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.arena> returns the arena denizen object.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, PVPArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/pvparena/PlayerJoinsPVPArenaScriptEvent.java#L14 |
Name | pvparena player leaves |
Event Lines | pvparena player leaves |
Triggers | when a player leaves a pvparena. |
Generated Examples | after pvparena player leaves: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.arena> returns the arena denizen object.
|
Group | Depenizen |
Requires | Depenizen, PVPArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/pvparena/PlayerLeavesPVPArenaScriptEvent.java#L14 |
Name | pvparena starts |
Event Lines | pvparena starts |
Triggers | when a pvparena starts. |
Generated Examples | on pvparena starts:
after pvparena starts: |
Contexts | <context.fighters> returns a list of all fighters in the arena.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, PVPArena |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/pvparena/PVPArenaStartsScriptEvent.java#L17 |
Name | quests player changes quest stage |
Event Lines | quests player changes <quest> stage |
Triggers | when a player changes stage in a quest from the Quests plugin. Note that stages don't have unique IDs. |
Generated Examples | on quests player changes quest stage:
after quests player changes quest stage: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.quest> returns the ID of the quest.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Quests |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/quests/PlayerQuestStageChangeScriptEvent.java#L16 |
Name | quests player completes quest |
Event Lines | quests player completes <quest> |
Triggers | when a player completes a quest from the Quests plugin. |
Generated Examples | after quests player completes quest: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.quest> returns the ID of the quest.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Quests |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/quests/PlayerCompletesQuestScriptEvent.java#L16 |
Name | quests player fails quest |
Event Lines | quests player fails <quest> |
Triggers | when a player fails a quest from the Quests plugin. |
Generated Examples | after quests player fails quest:
on quests player fails quest: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.quest> returns the ID of the quest.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Quests |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/quests/PlayerFailsQuestScriptEvent.java#L16 |
Name | quests player starts quest |
Event Lines | quests player starts <quest> |
Triggers | when a player starts a quest from the Quests plugin. |
Generated Examples | on quests player starts quest:
after quests player starts quest: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.quest> returns the ID of the quest.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Quests |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/quests/PlayerStartsQuestScriptEvent.java#L16 |
Name | residence deleted |
Event Lines | residence deleted |
Triggers | when a Residence gets deleted. |
Generated Examples | after residence deleted:
on residence deleted: |
Has Player | only when the cause is PLAYER_DELETE. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | cause:<cause> to only process the event if the cause of deletion matches. |
Contexts | <context.cause> Returns the cause of deletion. Can be: PLAYER_DELETE, OTHER or LEASE_EXPIRE
<context.residence> Returns the ResidenceTag of the deleted residence.
|
Group | Depenizen |
Requires | Depenizen, Residence |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/residence/ResidenceDeletedScriptEvent.java#L15 |
Name | residence player creates residence |
Event Lines | residence player creates residence |
Triggers | when a player creates a Residence. |
Generated Examples | after residence player creates residence: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.residence> Returns the created ResidenceTag.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Residence |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/residence/PlayerCreatesResidenceScriptEvent.java#L14 |
Name | residence player enters residence |
Event Lines | residence player enters <residence> |
Triggers | when a player enters a Residence. |
Generated Examples | after residence player enters residence: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.residence> Returns the Residence the player entered.
|
Group | Depenizen |
Requires | Depenizen, Residence |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/residence/PlayerEntersResidenceScriptEvent.java#L14 |
Name | residence player exits residence |
Event Lines | residence player exits <residence> |
Triggers | when a player exits a Residence. |
Generated Examples | on residence player exits residence:
after residence player exits residence: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.residence> Returns the Residence the player exited.
|
Group | Depenizen |
Requires | Depenizen, Residence |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/residence/PlayerExitsResidenceScriptEvent.java#L14 |
Name | residence raid ends |
Event Lines | residence raid ends |
Triggers | when a Residence raid ends. |
Generated Examples | after residence raid ends: |
Switches | residence:<residence> to only process the event if the residence matches the input. |
Contexts | <context.residence> Returns a ResidenceTag of the residence that was being raided.
|
Group | Depenizen |
Requires | Depenizen, Residence |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/residence/ResidenceRaidEndsScriptEvent.java#L13 |
Name | residence raid starts |
Event Lines | residence raid starts |
Triggers | when players start raiding a Residence. |
Generated Examples | after residence raid starts: |
Switches | residence:<residence> to only process the event if the residence matches the input. |
Contexts | <context.residence> Returns a ResidenceTag of the residence that is being attacked.
<context.defenders> Returns a ListTag(PlayerTag) of the players defending the Residence.
<context.attackers> Returns a ListTag(PlayerTag) of the players attacking the Residence.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Residence |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/residence/ResidenceRaidStartsScriptEvent.java#L15 |
Name | sentinel npc attacks |
Event Lines | sentinel npc attacks |
Triggers | when a Sentinel-powered NPC attacks a target. |
Generated Examples | after sentinel npc attacks: |
Has Player | When the attacked entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | Always. |
Switches | entity:<entity> to only fire the event if the target entity matches the given entity matcher. |
Contexts | <context.entity> returns the entity that the NPC is attacking.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, Sentinel |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/sentinel/SentinelAttackScriptEvent.java#L16 |
Name | sentinel npc has no more targets |
Event Lines | sentinel npc has no more targets |
Triggers | when a Sentinel-powered NPC has no more targets to fight and can return to normal idle behavior. |
Generated Examples | after sentinel npc has no more targets:
on sentinel npc has no more targets: |
Has NPC | Always. |
Group | Depenizen |
Requires | Depenizen, Sentinel |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/sentinel/SentinelNoMoreTargetsScriptEvent.java#L13 |
Name | shopkeeper trade |
Event Lines | shopkeeper trade |
Triggers | when a trade with a shopkeeper is completed. |
Generated Examples | after shopkeeper trade:
on shopkeeper trade: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.recipe> Returns a ListTag(ItemTag) of the recipe for this trade.
<context.shopkeeper> Returns the ShopKeeperTag of the ShopKeeper that the trade occurred with.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, ShopKeepers |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/shopkeepers/ShopKeeperTradeScriptEvent.java#L15 |
Name | skillapi player downgrades skill |
Event Lines | skillapi player downgrades <skill> |
Triggers | when a player downgrades a skill in SkillAPI. |
Generated Examples | after skillapi player downgrades skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.level> returns the level the player went down to.
<context.refund> returns how much the the player was refunded.
<context.skill_name> returns the name of the skill downgraded.
|
Determine | None |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, SkillAPI |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/skillapi/SkillAPIPlayerDowngradesSkillScriptEvent.java#L17 |
Name | skillapi player levels up |
Event Lines | skillapi player levels up |
Triggers | when a player levels up in SkillAPI. |
Generated Examples | after skillapi player levels up: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.level> returns the level the player went up to.
<context.gained> returns how many levels the player gained.
<context.class> returns the SkillAPIClass the player is leveling up in.
|
Determine | None |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, SkillAPI |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/skillapi/SkillAPIPlayerLevelsUpScriptEvent.java#L17 |
Name | skillapi player unlocks skill |
Event Lines | skillapi player unlocks <skill> |
Triggers | when a player unlocks a skill in SkillAPI. |
Generated Examples | after skillapi player unlocks skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.skill_name> returns the name of the skill unlocked.
|
Determine | None |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, SkillAPI |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/skillapi/SkillAPIPlayerUnlocksSkillScriptEvent.java#L17 |
Name | skillapi player upgrades skill |
Event Lines | skillapi player upgrades <skill> |
Triggers | when a player upgrades a skill in SkillAPI. |
Generated Examples | on skillapi player upgrades skill:
after skillapi player upgrades skill: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.level> returns the level the player went up to.
<context.cost> returns how much the upgrade cost.
<context.skill_name> returns the name of the skill upgraded.
|
Determine | None |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, SkillAPI |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/skillapi/SkillAPIPlayerUpgradesSkillScriptEvent.java#L17 |
Name | skyblock island created |
Event Lines | skyblock island created |
Triggers | when a new skyblock is created. |
Generated Examples | on skyblock island created:
after skyblock island created: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> Returns the location of the island.
<context.schematic> Returns the name of the schematic used for the island.
|
Group | Depenizen |
Requires | Depenizen, A SkyBlock |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/askyblock/SkyBlockCreatedScriptEvent.java#L16 |
Name | skyblock island reset |
Event Lines | skyblock island reset |
Triggers | when a new skyblock is reset. |
Generated Examples | on skyblock island reset:
after skyblock island reset: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> Returns the location of the island.
|
Group | Depenizen |
Requires | Depenizen, A SkyBlock |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/askyblock/SkyBlockResetScriptEvent.java#L15 |
Name | skyblock player enters skyblock |
Event Lines | skyblock player enters skyblock |
Triggers | when a player goes to a skyblock island. |
Generated Examples | after skyblock player enters skyblock: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.owner> Returns the owner of the island.
<context.island_location> Returns the location of the island.
<context.location> Returns the location the player entered at.
|
Group | Depenizen |
Requires | Depenizen, A SkyBlock |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/askyblock/PlayerEntersSkyBlockScriptEvent.java#L15 |
Name | towny player claims plot |
Event Lines | towny player claims plot |
Triggers | when a player tries to claim a new Towny plot or outpost. |
Generated Examples | on towny player claims plot:
after towny player claims plot: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.is_outpost> Returns whether the new plot is an outpost (not connected to the main town).
<context.is_new_town> Returns whether this is a new town. New towns may not have certain tags available.
<context.town> Returns a TownTag of the town.
<context.cuboid> Returns the cuboid that will be claimed by the town.
|
Determine | "CANCEL_MESSAGE:<ElementTag>" to set the message Towny sends when cancelled. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/PlayerClaimsPlotScriptEvent.java#L16 |
Name | towny player creates town |
Event Lines | towny player creates town |
Triggers | when a player tries to create a Towny town. |
Generated Examples | after towny player creates town: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.town_name> Returns the name of the town the player is creating.
<context.cuboid> Returns the cuboid that will be claimed by the town.
|
Determine | "CANCEL_MESSAGE:<ElementTag>" to set the message Towny sends when cancelled. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/PlayerCreatesTownScriptEvent.java#L16 |
Name | towny player enters town |
Event Lines | towny player enters <town> |
Triggers | when a player enters a Towny Town. |
Generated Examples | after towny player enters town: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.town> Returns the town the player entered.
|
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/PlayerEntersTownScriptEvent.java#L15 |
Name | towny player exits town |
Event Lines | towny player exits <town> |
Triggers | when a player exits a Towny Town. |
Generated Examples | on towny player exits town:
after towny player exits town: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.town> Returns the town the player exited.
|
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/PlayerExitsTownScriptEvent.java#L15 |
Name | towny player joins town |
Event Lines | towny player joins town |
Triggers | when a player joins a Towny town. |
Generated Examples | after towny player joins town: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.town> returns the TownTag that the player is joining.
|
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/PlayerJoinsTownScriptEvent.java#L15 |
Name | towny player leaves town |
Event Lines | towny player leaves town |
Triggers | when a player is removed from a Towny town or when a Towny town is dissolved. |
Generated Examples | after towny player leaves town:
on towny player leaves town: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.town> returns the TownTag that player is leaving.
|
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/PlayerLeavesTownScriptEvent.java#L15 |
Name | towny town created |
Event Lines | towny town created |
Triggers | after all checks are complete and a Towny town is fully created. |
Generated Examples | after towny town created: |
Contexts | <context.town> Returns the town that was created.
|
Group | Depenizen |
Requires | Depenizen, Towny |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/towny/TownCreatedScriptEvent.java#L12 |
Name | votifier vote |
Event Lines | votifier vote |
Triggers | when a Votifier vote is made. |
Generated Examples | after votifier vote:
on votifier vote: |
Has Player | When the vote is made using a recognized username. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.time_sent> returns the time the vote was sent.
<context.service> returns what service was used to send the vote.
<context.username> returns the username input with the vote.
|
Group | Depenizen |
Requires | Depenizen, Votifier |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/votifier/VotifierVoteScriptEvent.java#L24 |
Name | gp player enters|exits gpclaim |
Event Lines | gp player enters|exits <gpclaim> |
Triggers | when a player enters or exits a Grief Prevention claim. |
Generated Examples | after gp player exits gpclaim:
after gp player enters gpclaim: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.from> returns the block location moved from.
<context.to> returns the block location moved to.
<context.new_claim> returns the gpclaim being entered.
<context.old_claim> returns the gpclaim being exited.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Depenizen |
Requires | Depenizen, GriefPrevention |
Warning(s) | Cancelling this event will fire a similar event immediately after. |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/griefprevention/GPClaimEnterEvent.java#L20 |
Name | mythickeys key pressed |
Event Lines | mythickeys key pressed |
Triggers | When a key is pressed by a client running MythicKeys, if that key is in the MythicKeys config. |
Generated Examples | after mythickeys key pressed:
on mythickeys key pressed: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | id:<id> to only process the event if the key ID matches the given text matcher. |
Contexts | <context.id> Returns the ID of the key that was pressed according to the MythicKeys config, as a namespaced key.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, MythicKeys |
Warning(s) | For 1.19+ servers use AriKeysPlugin. |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mythickeys/MythicKeysKeyPressScriptEvent.java#L18 |
Name | mythickeys key released |
Event Lines | mythickeys key released |
Triggers | When a key stops being pressed by a client running MythicKeys, if that key is in the MythicKeys config. |
Generated Examples | after mythickeys key released:
on mythickeys key released: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | id:<id> to only process the event if the key ID matches the given text matcher. |
Contexts | <context.id> Returns the ID of the key that was released according to the MythicKeys config, as a namespaced key.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Depenizen |
Requires | Depenizen, MythicKeys |
Warning(s) | For 1.19+ servers use AriKeysPlugin. |
Source | https://github.com/DenizenScript/Depenizen/blob/master/src/main/java/com/denizenscript/depenizen/bukkit/events/mythickeys/MythicKeysKeyReleaseScriptEvent.java#L16 |
Name | discord application|slash|message|user command |
Event Lines | discord application|slash|message|user command |
Triggers | when a Discord user uses an application command. |
Generated Examples | on discord application command:
after discord user command: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. name:<command_name> to only process the event for a specified Discord application command. Spaces are replaced with underscores. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.interaction> returns the DiscordInteractionTag.
<context.command> returns the DiscordCommandTag.
<context.options> returns the supplied options as a MapTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordApplicationCommandScriptEvent.java#L8 |
Name | discord button clicked |
Event Lines | discord button clicked |
Triggers | when a Discord user clicks a button. |
Generated Examples | on discord button clicked:
after discord button clicked: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. id:<button_id> to only process the event for a specified Discord button. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.interaction> returns the DiscordInteractionTag.
<context.button> returns the DiscordButtonTag.
<context.message> returns the relevant message the button was on.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordButtonClickedScriptEvent.java#L10 |
Name | discord channel created |
Event Lines | discord channel created |
Triggers | when a Discord channel is created. |
Generated Examples | after discord channel created: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. type:<type> to only process the event if the channel is a specific channel_type. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.channel> returns the new DiscordChannelTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordChannelCreateScriptEvent.java#L11 |
Name | discord channel deleted |
Event Lines | discord channel deleted |
Triggers | when a Discord channel is created. |
Generated Examples | on discord channel deleted:
after discord channel deleted: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.channel> returns the DiscordChannelTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordChannelDeleteScriptEvent.java#L11 |
Name | discord command autocomplete |
Event Lines | discord command autocomplete |
Triggers | when a Discord user queries a slash command option that can be autocompleted. |
Example |
|
Example |
|
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. name:<command_name> to only process the event for a specified Discord application command. Spaces are replaced with underscores. option:<option_name> to only process the event for a specified autocompletable option. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.interaction> returns the DiscordInteractionTag.
<context.command> returns the DiscordCommandTag.
<context.options> returns the supplied options as a MapTag.
<context.focused_option> returns the name of the focused option.
|
Determine | "CHOICES:<ListTag>" to suggest values to the Discord client. Up to 25 suggestions are allowed to be sent. Each entry can be an ElementTag which controls both the value and display of the choice or a MapTag with "name" and "value" keys to control both separately. |
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordCommandAutocompleteScriptEvent.java#L18 |
Name | discord message deleted |
Event Lines | discord message deleted |
Triggers | when a Discord user deletes a message. |
Generated Examples | after discord message deleted: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.old_message_valid> returns whether the old message is available (it may be lost due to caching).
<context.old_message> returns the original DiscordMessageTag (data may be missing if not cached).
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordMessageDeletedScriptEvent.java#L18 |
Name | discord message modified |
Event Lines | discord message modified |
Triggers | when a Discord user modified a message. |
Generated Examples | on discord message modified:
after discord message modified: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.new_message> returns the message as it now exists, as a DiscordMessageTag.
<context.old_message_valid> returns whether the old message is available (it may be lost due to caching).
<context.old_message> returns the original DiscordMessageTag (data may be missing if not cached).
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordMessageModifiedScriptEvent.java#L20 |
Name | discord message reaction added |
Event Lines | discord message reaction added |
Triggers | when a Discord user added a reaction to a message. |
Generated Examples | on discord message reaction added:
after discord message reaction added: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.message> returns the message.
<context.user> returns the user that added the reaction.
<context.reaction> returns the new reaction.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordMessageReactionAddScriptEvent.java#L10 |
Name | discord message reaction removed |
Event Lines | discord message reaction removed |
Triggers | when a Discord user removes a reaction from a message. |
Generated Examples | after discord message reaction removed: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.message> returns the DiscordMessageTag.
<context.user> returns the DiscordUserTag that removed the reaction.
<context.reaction> returns the old DiscordReactionTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordMessageReactionRemoveScriptEvent.java#L10 |
Name | discord message received |
Event Lines | discord message received |
Triggers | when a Discord bot receives a message. |
Generated Examples | on discord message received: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. message:<message> to only process the event if the message matches some matcher text, like 'message:*hello*' to match any message that contains the word 'hello'. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.new_message> returns the message received, as a DiscordMessageTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordMessageReceivedScriptEvent.java#L19 |
Name | discord modal submitted |
Event Lines | discord modal submitted |
Triggers | when a Discord user submits a modal. |
Generated Examples | on discord modal submitted: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. name:<modal_name> to only process the event for a specified Discord modal. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.interaction> returns the DiscordInteractionTag.
<context.name> returns the name of the modal.
<context.values> returns a MapTag of the values submitted by the user.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordModalSubmittedScriptEvent.java#L18 |
Name | discord selection used |
Event Lines | discord selection used |
Triggers | when a Discord user uses a selection menu. |
Generated Examples | after discord selection used:
on discord selection used: |
Switches | for:<bot> to only process the event for a specified Discord bot.
channel:<channel_id> to only process the event when it occurs in a specified Discord channel. group:<group_id> to only process the event for a specified Discord group. id:<menu_id> to only process the event for a specified Discord selection menu. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.channel> returns the DiscordChannelTag.
<context.group> returns the DiscordGroupTag.
<context.interaction> returns the DiscordInteractionTag.
<context.menu> returns the selection menu as a DiscordSelectionTag.
<context.option> returns the selected option as a MapTag.
<context.message> returns the relevant message the selection was on.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordSelectionUsedScriptEvent.java#L11 |
Name | discord user joins |
Event Lines | discord user joins |
Triggers | when a Discord user joins a guild. |
Generated Examples | after discord user joins:
on discord user joins: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.user> returns the DiscordUserTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordUserJoinsScriptEvent.java#L11 |
Name | discord user leaves |
Event Lines | discord user leaves |
Triggers | when a Discord user leaves a guild. |
Generated Examples | on discord user leaves:
after discord user leaves: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.user> returns the DiscordUserTag.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordUserLeavesScriptEvent.java#L11 |
Name | discord user nickname changes |
Event Lines | discord user nickname changes |
Triggers | when a Discord user's nickname change. |
Generated Examples | after discord user nickname changes: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.user> returns the DiscordUserTag.
<context.old_name> returns the user's previous nickname (if any).
<context.new_name> returns the user's new nickname (if any).
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordUserNicknameChangeScriptEvent.java#L12 |
Name | discord user role changes |
Event Lines | discord user role changes |
Triggers | when a Discord user's roles change. |
Generated Examples | after discord user role changes:
on discord user role changes: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.user> returns the DiscordUserTag.
<context.old_roles> returns a ListTag of the user's previous DiscordRoleTag set.
<context.new_roles> returns a ListTag of the user's new DiscordRoleTag set.
<context.added_roles> returns a ListTag of the user's added DiscordRoleTag set.
<context.removed_roles> returns a ListTag of the user's removed DiscordRoleTag set.
|
Group | Discord |
Requires | dDiscordBot |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordUserRoleChangeScriptEvent.java#L18 |
Name | discord thread archived |
Event Lines | discord thread archived |
Triggers | when a Discord thread is archived. |
Generated Examples | after discord thread archived: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. parent:<channel_id> to only process the event for a specific parent channel ID. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.thread> returns the thread DiscordChannelTag.
|
Group | Discord |
Requires | dDiscordBot |
Warning(s) | Not currently function. Will likely function in the future. |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordThreadArchivedScriptEvent.java#L11 |
Name | discord thread revealed |
Event Lines | discord thread revealed |
Triggers | when a Discord thread is pulled out of archive. |
Generated Examples | after discord thread revealed: |
Switches | for:<bot> to only process the event for a specified Discord bot.
group:<group_id> to only process the event for a specified Discord group. parent:<channel_id> to only process the event for a specific parent channel ID. |
Contexts | <context.bot> returns the relevant DiscordBotTag.
<context.group> returns the DiscordGroupTag.
<context.thread> returns the thread DiscordChannelTag.
|
Group | Discord |
Requires | dDiscordBot |
Warning(s) | Not currently function. Will likely function in the future. |
Source | https://github.com/DenizenScript/dDiscordBot/blob/master/src/main/java/com/denizenscript/ddiscordbot/events/DiscordThreadRevealedScriptEvent.java#L11 |
Name | anvil block damaged|breaks |
Event Lines | anvil block damaged|breaks |
Triggers | when an anvil is damaged from being used. |
Generated Examples | after anvil block damaged: |
Switches | state:<state> to only process the event if the anvil's new damage state matches the specified state. |
Contexts | <context.state> returns an ElementTag of the anvil's new damage state. Refer to https://jd.papermc.io/paper/1.19/com/destroystokyo/paper/event/block/AnvilDamagedEvent.DamageState.html.
<context.break> returns an ElementTag(Boolean) that signifies whether the anvil will break.
<context.inventory> returns the InventoryTag of the anvil's inventory.
|
Determine | "STATE:<ElementTag>" to set the anvil's new damage state.
"BREAK:<ElementTag(Boolean)>" to set weather the anvil will break. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/AnvilBlockDamagedScriptEvent.java#L17 |
Name | command unknown |
Event Lines | command unknown |
Triggers | when an unknown command is processed by the server. |
Generated Examples | after command unknown:
on command unknown: |
Has Player | when source_type is player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.message> returns an ElementTag of the message to be shown to the command sender.
<context.command> returns the command name as an Element.
<context.raw_args> returns any args used as an Element.
<context.args> returns a ListTag of the arguments.
<context.source_type> returns the source of the command. Can be: PLAYER, SERVER, COMMAND_BLOCK, or COMMAND_MINECART.
<context.command_block_location> returns the command block's location (if the command was run from one).
<context.command_minecart> returns the EntityTag of the command minecart (if the command was run from one).
|
Determine | ElementTag to change the message returned to the command sender.
"NONE" to cancel the message. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/UnknownCommandScriptEvent.java#L25 |
Name | creeper ignites |
Event Lines | creeper ignites |
Triggers | when a creeper is ignited by flint and steel, or by certain plugin-based activations. |
Generated Examples | after creeper ignites:
on creeper ignites: |
Contexts | <context.entity> returns the EntityTag of the creeper.
<context.ignited> returns true if the creeper is ignited, or false if not. NOTE: In most cases, this will return true.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/CreeperIgnitesScriptEvent.java#L13 |
Name | entity added to world |
Event Lines | <entity> added to world |
Triggers | any time an entity is added to the world for any reason, including chunks loading pre-existing entities. |
Generated Examples | after dolphin added to world:
on living added to world: |
Contexts | <context.entity> returns the EntityTag that will be added. Note that this entity will not necessarily be fully spawned yet, so usage will be limited.
<context.location> returns the LocationTag that the entity will be added at.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityAddToWorldScriptEvent.java#L15 |
Name | entity knocks back entity |
Event Lines | <entity> knocks back <entity> |
Triggers | when an entity is knocked back from the hit of another entity. |
Generated Examples | after monster knocks back player:
on entity knocks back entity: |
Has Player | when the damager or damaged entity is a player. Cannot be both. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the damager or damaged entity is an NPC. Cannot be both. |
Switches | with:<item> to only process the event when the item used to cause damage (in the damager's hand) is a specified item. |
Contexts | <context.entity> returns the EntityTag that was knocked back.
<context.damager> returns the EntityTag of the one who knocked.
<context.acceleration> returns the knockback applied as a vector.
|
Determine | LocationTag as a vector to change the acceleration applied. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityKnocksbackEntityScriptEvent.java#L16 |
Name | entity loads crossbow |
Event Lines | <entity> loads crossbow |
Triggers | when a living entity loads a crossbow with a projectile. |
Generated Examples | on monster loads crossbow:
on giant loads crossbow: |
Has Player | when the entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity is an NPC. |
Switches | crossbow:<item> to only process the event if the crossbow is a specified item. |
Contexts | <context.entity> returns the EntityTag that is loading the crossbow.
<context.crossbow> returns the ItemTag of the crossbow.
<context.consumes> returns true if the loading will consume a projectile item, otherwise false.
<context.hand> returns "HAND" or "OFF_HAND" depending on which hand is holding the crossbow item.
|
Determine | "KEEP_ITEM" to keep the projectile item in the shooter's inventory. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityLoadCrossbowScriptEvent.java#L17 |
Name | entity pathfinds |
Event Lines | <entity> pathfinds |
Triggers | when an entity starts pathfinding towards a location or entity. |
Generated Examples | after hanging pathfinds:
on player pathfinds: |
Has Player | when the target entity is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the target entity is an NPC. |
Switches | to:<area> to only process the event if the entity is pathfinding into a specified area.
at:<entity> to only process the event when the entity is pathfinding at a specified entity. |
Contexts | <context.entity> returns the EntityTag that is pathfinding.
<context.location> returns the LocationTag that is being pathfound to.
<context.target> returns the EntityTag that is being targeted, if any.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityPathfindScriptEvent.java#L16 |
Name | entity removed from world |
Event Lines | <entity> removed from world |
Triggers | any time an entity is removed from the world for any reason, including chunks unloading. |
Generated Examples | after entity removed from world:
on breeze_wind_charge removed from world: |
Contexts | <context.entity> returns the EntityTag that will be removed. Note that this entity will not necessarily be fully spawned at time of firing, so usage will be limited.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityRemoveFromWorldScriptEvent.java#L14 |
Name | entity teleported by portal |
Event Lines | <entity> teleported by portal |
Triggers | When an entity is about to be teleported by a portal (currently only fires for nether portals). |
Generated Examples | on entity teleported by portal: |
Switches | to:<world> to only process the event if the world the entity is being teleported to matches the specified WorldTag matcher.
portal_type:<type> to only process the event if the portal's type matches the specified portal type. |
Contexts | <context.entity> returns an EntityTag of the entity being teleported.
<context.target_world> returns a WorldTag of the world the entity is being teleported to.
<context.portal_type> returns an ElementTag of the portal's type. Will be one of https://jd.papermc.io/paper/1.19/org/bukkit/PortalType.html.
|
Determine | "TARGET_WORLD:<WorldTag>" to set the world the entity will be teleported to.
"REMOVE_TARGET_WORLD" to remove the target world. Should usually cancel the event instead of using this. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityTeleportedByPortalScriptEvent.java#L14 |
Name | experience orbs merge |
Event Lines | experience orbs merge |
Triggers | when two experience orbs are about to merge. |
Generated Examples | after experience orbs merge:
on experience orbs merge: |
Contexts | <context.target> returns the EntityTag of the orb that will absorb the other experience orb.
<context.source> returns the EntityTag of the orb that will be removed and merged into the target.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/ExperienceOrbMergeScriptEvent.java#L15 |
Name | gamerule changes in world |
Event Lines | gamerule changes (in <world>) |
Triggers | when a gamerule changes. |
Generated Examples | after gamerule changes in world:
on gamerule changes in world_the_end: |
Has Player | when the sender of the command is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | gamerule:<gamerule> to only process the event if the gamerule matches a specific gamerule. |
Contexts | <context.gamerule> returns the name of the GameRule which was changed. Refer to https://jd.papermc.io/paper/1.19/org/bukkit/GameRule.html.
<context.value> returns the new value of the GameRule.
<context.world> returns the world where the GameRule is applied.
<context.source_type> returns type of source. Can be: PLAYER, COMMAND_BLOCK, COMMAND_MINECART, SERVER.
<context.command_block_location> returns the command block's location (if the command was run from one).
<context.command_minecart> returns the EntityTag of the command minecart (if the command was run from one).
|
Determine | "VALUE:<ElementTag(Number)>" or ElementTag(Boolean) to set the value of the GameRule. |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/WorldGameRuleChangeScriptEvent.java#L25 |
Name | player absorbs experience |
Event Lines | player absorbs experience |
Triggers | when a player is absorbing an experience orb. |
Generated Examples | on player absorbs experience: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag of the experience orb.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerAbsorbsExperienceScriptEvent.java#L15 |
Name | player beacon effect applied |
Event Lines | player beacon effect applied |
Triggers | when a beacon applies an effect to a player. |
Generated Examples | after player beacon effect applied: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.location> returns the LocationTag of the beacon applying an effect.
<context.effect_data> returns a MapTag of the potion effect (in the same format as EntityTag.effects_data).
<context.effect_type> returns an ElementTag of the effect type.
<context.is_primary> returns an ElementTag(Boolean) of whether the beacon effect is the primary effect.
|
Determine | ElementTag to change the applied potion effect (in the same format as EntityTag.list_effects). |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerBeaconEffectScriptEvent.java#L18 |
Name | player boosts elytra |
Event Lines | player boosts elytra |
Triggers | when a player boosts their elytra with a firework rocket while gliding. |
Generated Examples | on player boosts elytra:
after player boosts elytra: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event if the firework item used matches the specified item.
elytra:<item> to only process the event if the elytra used matches the specified item. |
Contexts | <context.item> returns the firework item used to boost.
<context.entity> returns the firework entity that was spawned.
<context.should_keep> returns whether the firework item gets consumed.
|
Determine | "KEEP:<ElementTag(Boolean)>" to set whether the firework item should be kept. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerElytraBoostScriptEvent.java#L18 |
Name | player changes framed item |
Event Lines | player changes framed <item> |
Triggers | when a player interacts with an item frame by adding, removing, or rotating the item held in it. |
Generated Examples | after player changes framed mushroom_stem:
on player changes framed item: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | frame:<entity> to only process the event if the item frame entity being matches the input.
action:<action> to only process the event if the change matches the input. |
Contexts | <context.frame> returns the EntityTag of the item frame.
<context.item> returns the ItemTag of the item held in the item frame.
<context.action> returns the ElementTag of the action being performed, based on https://jd.papermc.io/paper/1.20/io/papermc/paper/event/player/PlayerItemFrameChangeEvent.ItemFrameChangeAction.html
|
Determine | "ITEM:<ItemTag>" to change the item held by the item frame. If there is an item already in the frame, it will be replaced. To remove the item, set it to air. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerChangesFramedItemScriptEvent.java#L16 |
Name | player client options change |
Event Lines | player client options change |
Triggers | when a player changes their client options. |
Generated Examples | after player client options change: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.server_listings_enabled> returns a ElementTag(Boolean) of whether the player has server listings enabled. Available only on MC 1.19+.
<context.chat_visibility> returns an ElementTag of the player's chat visibility. Valid chat visibility options can be found at https://jd.papermc.io/paper/1.20/com/destroystokyo/paper/ClientOption.ChatVisibility.html
<context.locale> returns an ElementTag of the player's current locale.
<context.main_hand> returns a ElementTag of the player's main hand. Can either be LEFT or RIGHT.
<context.skin_parts> returns a MapTag of whether the player's skin parts are enabled or not. For example: [cape=true;jacket=false;left_sleeve=true;right_sleeve=false;left_pants=true;right_pants=false;hat=true]
<context.view_distance> returns a ElementTag(Number) of the player's view distance.
<context.server_listings_changed> returns a ElementTag(Boolean) of whether the player's server listings have changed. Available only on MC 1.19+.
<context.chat_colors> returns a ElementTag(Boolean) of whether the player has chat colors enabled.
<context.chat_colors_changed> returns a ElementTag(Boolean) of whether the player has toggled their chat colors.
<context.chat_visibility_changed> returns a ElementTag(Boolean) of whether the player's chat visibility has changed. Available only on MC 1.19+.
<context.locale_changed> returns a ElementTag(Boolean) of whether the player's locale has changed.
<context.main_hand_changed> returns a ElementTag(Boolean) of whether the player's main hand has changed.
<context.skin_parts_changed> returns a ElementTag(Boolean) of whether the player's skin parts have changed.
<context.text_filtering_changed> returns a ElementTag(Boolean) of whether the player's text filtering has changed. Available only on MC 1.19+.
<context.text_filtering_enabled> returns a ElementTag(Boolean) of whether the player has text filtering enabled. Available only on MC 1.19+.
<context.view_distance_changed> returns a ElementTag(Boolean) of whether the player's view distance has changed.
|
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerClientOptionsChangeScriptEvent.java#L18 |
Name | player deep sleeps |
Event Lines | player deep sleeps |
Triggers | when a player has slept long enough in a bed to count as being in deep sleep and thus skip the night. Cancelling the event prevents the player from qualifying to skip the night. |
Generated Examples | on player deep sleeps:
after player deep sleeps: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerDeepSleepScriptEvent.java#L12 |
Name | player flips lectern page |
Event Lines | player flips lectern page |
Triggers | when the player flips to a page in a lectern. |
Example |
|
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | book:<item> to only process the event if the book on the lectern matches the given item. |
Contexts | <context.book> returns an ItemTag of the book in the lectern.
<context.lectern> returns a LocationTag of the lectern.
<context.old_page> returns an ElementTag(Number) of the last page the player was on.
<context.new_page> returns an ElementTag(Number) of the new page that the player flipped to.
<context.flip_direction> returns the direction in which the player flips the lectern book page, can be either LEFT or RIGHT.
|
Determine | "PAGE:<ElementTag(Number)>" to set the page that the player will flip to. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerLecternPageChangeScriptEvent.java#L17 |
Name | player granted advancement criterion |
Event Lines | player granted advancement criterion |
Triggers | when a player is granted a single criterion for an advancement.
To fire when ALL the criteria for an advancement is met, use player completes advancement |
Example |
|
Example |
|
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | advancement:<name> to only fire if the advancement for the criterion has the specified name.
criterion:<name> to only fire if the criterion being granted has the specified name. |
Contexts | <context.advancement> returns the advancement's minecraft ID key.
<context.criterion> returns the criterion minecraft ID key.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerGrantedAdvancementCriterionScriptEvent.java#L15 |
Name | player inventory slot changes |
Event Lines | player inventory slot changes |
Triggers | when the item in a slot of a player's inventory changes.
Note that this fires for every item in the player's inventory when they join. |
Generated Examples | on player inventory slot changes: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | from:<item> to only process the event if the previous item in the slot matches the specified item.
to:<item> to only process the event if the new item in the slot matches the specified item. slot:<slot> to only process the event if a specific slot was clicked. For slot input options, see Slot Inputs. |
Contexts | <context.new_item> returns an ItemTag of the new item in the slot.
<context.old_item> returns an ItemTag of the previous item in the slot.
<context.slot> returns an ElementTag(Number) of the slot that was changed.
<context.raw_slot> returns an ElementTag(Number) of the raw number of the slot that was changed.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerInventorySlotChangeScriptEvent.java#L16 |
Name | player opens sign |
Event Lines | player opens sign |
Triggers | When a player opens a sign (eg after placing a sign, or by clicking on it to edit it). |
Generated Examples | after player opens sign:
on player opens sign: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.side> returns an ElementTag of the side of the sign that was clicked (FRONT or BACK).
<context.cause> returns an ElementTag of reason the sign was opened - see https://jd.papermc.io/paper/1.20/io/papermc/paper/event/player/PlayerOpenSignEvent.Cause.html.
<context.location> returns a LocationTag of the sign's location.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerOpenSignScriptEvent.java#L15 |
Name | player right|left clicks fake entity |
Event Lines | player (right|left) clicks fake entity |
Triggers | when a player clicks a fake entity, one that is only shown to the player and not tracked by the server. |
Generated Examples | after player left clicks fake entity:
on player clicks fake entity: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the EntityTag of the entity that was clicked. Note that this entity is not being tracked by the server, so many operations may not be possible on it.
This will return null if the player clicks a fake entity that was not spawned via fakespawn.
<context.hand> returns an ElementTag of the hand used to click.
<context.click_type> returns an ElementTag of the click type (left/right).
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerClicksFakeEntityScriptEvent.java#L16 |
Name | player selects loom pattern |
Event Lines | player selects loom pattern |
Triggers | when a player selects a loom pattern. |
Example |
|
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | type:<pattern> to only process the event if the specified pattern is selected. |
Contexts | <context.loom> returns an InventoryTag of the loom.
<context.pattern> returns an ElementTag of the selected pattern. Valid pattern types can be found at: https://jd.papermc.io/paper/1.19/org/bukkit/block/banner/PatternType.html
|
Determine | "PATTERN:<ElementTag>" to set the pattern type of the loom. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerLoomPatternSelectScriptEvent.java#L18 |
Name | player shield disables |
Event Lines | player shield disables |
Triggers | When a players shield is disabled. |
Generated Examples | on player shield disables:
after player shield disables: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.damager> returns an EntityTag of the attacker who disabled the shield.
<context.cooldown> returns a DurationTag of the cooldown the shield is disabled for.
|
Determine | "COOLDOWN:<DurationTag>" to change the cooldown. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerShieldDisableScriptEvent.java#L16 |
Name | player spectates entity |
Event Lines | player spectates <entity> |
Triggers | when a player starts spectating an entity. |
Generated Examples | after player spectates interaction:
on player spectates living: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the entity that is being spectated.
<context.old_entity> returns the entity that was previously being spectated (or the player themself if they weren't spectating anything).
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerSpectatesEntityScriptEvent.java#L14 |
Name | player stops spectating entity |
Event Lines | player stops spectating (<entity>) |
Triggers | when a player stops spectating an entity. |
Generated Examples | after player stops spectating:
on player stops spectating: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns the entity that was being spectated.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerStopsSpectatingScriptEvent.java#L14 |
Name | player trades with merchant |
Event Lines | player trades with merchant |
Triggers | when a player trades with a merchant (villager). |
Generated Examples | after player trades with merchant: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | result:<result> to only process the event if the player received a specific result item. |
Contexts | <context.merchant> returns the villager that was traded with, if any (may be null for example with 'opentrades' command usage).
<context.trade> returns a TradeTag of the trade that was done.
|
Determine | TradeTag to change the trade that should be processed. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerTradesWithMerchantScriptEvent.java#L17 |
Name | player tries to attack entity |
Event Lines | player tries to attack <entity> |
Triggers | when the player tries to attack an entity. This occurs before any of the damage logic, so cancelling this event will prevent any sort of sounds from being played when attacking. |
Generated Examples | after player tries to attack vindicator:
after player tries to attack living: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Switches | with:<item> to only process the event if the player attacks the entity with the specified item. |
Contexts | <context.entity> returns the entity that was attacked in this event.
<context.will_attack> returns whether this entity would be attacked normally.
Entities like falling sand will return false because their entity type does not allow them to be attacked.
Note: there may be other factors (invulnerability, etc.) that will prevent this entity from being attacked that this event does not cover.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PrePlayerAttackEntityScriptEvent.java#L16 |
Name | player uses recipe book |
Event Lines | player uses recipe book |
Triggers | when a player interacts with their recipe book. |
Generated Examples | on player uses recipe book:
after player uses recipe book: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.recipe> returns the key of the recipe that was clicked.
<context.is_all> returns 'true' if the player is trying to make the maximum amount of items from the recipe, otherwise 'false'.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerClicksInRecipeBookScriptEvent.java#L14 |
Name | projectile collides with entity |
Event Lines | <projectile> collides with <entity> |
Triggers | when a projectile entity collides with an entity (before any damage calculations are done). |
Generated Examples | on arrow collides with hanging:
on projectile collides with chest_boat: |
Has Player | When the entity collided with is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | When the entity collided with is a NPC. |
Contexts | <context.projectile> returns the projectile that is colliding.
<context.entity> returns the entity that was collided with.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Deprecated | Use projectile hits with the 'entity' switch on versions above 1.19. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/ProjectileCollideScriptEvent.java#L17 |
Name | server resources reloaded |
Event Lines | server resources reloaded |
Triggers | when vanilla resources (such as datapacks) are reloaded (by vanilla commands or by plugins). If you mess with datapacks often, it may be helpful to run reload in this event. |
Generated Examples | after server resources reloaded: |
Switches | cause:<cause> to only process the event if the cause of the resource reload matches the specified cause. |
Contexts | <context.cause> Returns the cause of the resource reload. Refer to https://jd.papermc.io/paper/1.19/io/papermc/paper/event/server/ServerResourcesReloadedEvent.Cause.html
|
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/ServerResourcesReloadedScriptEvent.java#L12 |
Name | skeleton horse trap |
Event Lines | skeleton horse trap |
Triggers | when a player gets too close to a trapped skeleton horse and triggers the trap. |
Generated Examples | after skeleton horse trap: |
Contexts | <context.entity> returns an EntityTag of the skeleton horse.
<context.players> returns a ListTag(PlayerTag) of the players involved in the trap.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/SkeletonHorseTrapScriptEvent.java#L16 |
Name | target block hit |
Event Lines | target block hit |
Triggers | when a target block is hit by a projectile such as an arrow. |
Generated Examples | after target block hit:
on target block hit: |
Has Player | when the shooter is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the shooter is a npc. |
Contexts | <context.projectile> returns an EntityTag of the projectile.
<context.hit_block> returns a LocationTag of the block that was hit.
<context.hit_face> returns a LocationTag vector of the hit normal (like '0,1,0' if the projectile hit the top of a block).
<context.shooter> returns an EntityTag of the entity that shot the projectile, if any.
<context.strength> returns a ElementTag of the emitted redstone strength.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/TargetBlockHitScriptEvent.java#L17 |
Name | warden changes anger level |
Event Lines | warden changes anger level |
Triggers | when a warden changes its anger level. (In practice, only fires when increasing). |
Example |
|
Has Player | when the entity who triggered the change is a player. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Has NPC | when the entity who triggered the change is an NPC. |
Contexts | <context.entity> returns the EntityTag of the warden which changed its anger level.
<context.new_anger> returns an ElementTag(Number) of the new anger level.
<context.old_anger> returns an ElementTag(Number) of the old anger level.
<context.target> returns the EntityTag who triggered the change (if any). (In practice, always present).
|
Determine | "ANGER:<ElementTag(Number)>" to set the value of the anger level. Value must be between 0 and 150. |
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/WardenChangesAngerLevelScriptEvent.java#L15 |
Name | entity prespawns because cause |
Event Lines | <entity> prespawns (because <cause>) |
Triggers | before a mob spawns and before the mob is created for spawning. Note that this has a limited number of use cases.
The intent of this event is to save server resources for blanket mob banning/limiting scripts. Use the entity spawn event as a backup. |
Generated Examples | after entity prespawns:
on entity prespawns because cause: |
Contexts | <context.entity> returns the EntityTag that will be spawned. Note that this entity will not be spawned yet, so usage will be limited.
<context.location> returns the LocationTag the entity will spawn at.
<context.reason> returns an ElementTag of the reason for spawning. Currently, this event only fires for NATURAL and SPAWNER reasons.
<context.spawner_location> returns the LocationTag of the spawner's location if this mob is spawning from a spawner.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Warning(s) | This event may fire very rapidly, and only fires for NATURAL and SPAWNER reasons. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PreEntitySpawnScriptEvent.java#L17 |
Name | entity steps on block |
Event Lines | entity steps on block
<entity> steps on <material> |
Triggers | when a non-player entity steps onto a specific block material. For players, use player steps on block. |
Example |
|
Example |
|
Example |
|
Contexts | <context.entity> returns an EntityTag of the entity stepping onto the block.
<context.location> returns a LocationTag of the block the entity is stepping on.
<context.previous_location> returns a LocationTag of where the entity was before stepping onto the block.
<context.new_location> returns a LocationTag of where the entity is now.
|
Cancellable | True - This adds <context.cancelled> and determine 'cancelled' or 'cancelled:false' |
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/EntityStepsOnScriptEvent.java#L15 |
Name | player equips|unequips armor|helmet|chestplate|leggings|boots |
Event Lines | player equips|unequips armor|helmet|chestplate|leggings|boots
player equips|unequips <item> |
Triggers | when a player (un)equips armor. |
Generated Examples | after player unequips boots:
after player unequips item: after player equips leggings: after player equips pufferfish: |
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.new_item> returns the ItemTag that is now in the slot.
<context.old_item> returns the ItemTag that used to be in the slot.
<context.slot> returns the name of the slot.
|
Group | Paper |
Requires | Paper |
Warning(s) | This event is not reliable, and may miss some types of equipment changes or fire when equipment hasn't actually changed. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerEquipsArmorScriptEvent.java#L22 |
Name | player tracks|untracks entity |
Event Lines | player tracks|untracks <entity> |
Triggers | when a player starts or stops tracking an entity. An entity is tracked/untracked by a player's client when the player moves in/out of its EntityTag.tracking_range. |
Example |
|
Example |
|
Has Player | Always. - this adds switches 'flagged:<flag name>' + 'permission:<node>', in addition to the '<player>' link. |
Contexts | <context.entity> returns an EntityTag of the entity being tracked or untracked.
|
Has Location | True - This adds the switches 'in:<area>', 'location_flagged:<flag>', ... |
Group | Paper |
Requires | Paper |
Warning(s) | This event may fire very rapidly. |
Source | https://github.com/DenizenScript/Denizen/blob/dev/paper/src/main/java/com/denizenscript/denizen/paper/events/PlayerTracksEntityScriptEvent.java#L16 |