abs

Function

Returns the absolute value of the argument, i.e. makes the argument positive.

abs(n: number)
Since
2.2
Returns
Number

Absorbed blocks

Expression

The blocks absorbed by a sponge block.

[the] absorbed blocks
Since
2.5
Supported events
sponge absorb

acos

Function

The inverse of the cosine, also called arccos. Returns result in degrees, not radians. Only returns values from 0 to 180.

acos(n: number)
Since
2.2
Returns
Number

Action Bar

Effect

Sends an action bar message to the given player(s).

send [the] action[ ]bar [with text] %text% [to %players%]
Since
2.3

Active Item

Expression

Returns the item the entities are currently using (ie: the food they're eating, the bow they're drawing back, etc.). This cannot be changed. If an entity is not using any item, this will return null.

[the] (raised|active) (tool|item|weapon) of %living entities%
%living entities%'[s] (raised|active) (tool|item|weapon)
Since
2.8.0
Requirements
Paper

Active Item Use Time

Expression

Returns the time that the entities have either spent using an item, or the time left for them to finish using an item.

If an entity is not using any item, this will return 0 seconds.

[the] [elapsed|remaining] (item|tool) us[ag]e time of %living entities%
%living entities%'[s] [elapsed|remaining] (item|tool) us[ag]e time
Since
2.8.0
Requirements
Paper

Affected Entities

Expression

The affected entities in the area cloud effect event.

[the] affected entities
Since
2.4

Age of Block/Entity

Expression

Returns the age or maximum age of blocks and age for entities (there in no maximum age for entities).

For blocks, 'Age' represents the different growth stages that a crop-like block can go through. A value of 0 indicates that the crop was freshly planted, whilst a value equal to 'maximum age' indicates that the crop is ripe and ready to be harvested.

For entities, 'Age' represents the time left for them to become adults and it's in minus increasing to be 0 which means they're adults, e.g. A baby cow needs 20 minutes to become an adult which equals to 24,000 ticks so their age will be -24000 once spawned.

[the] [max[imum]] age of %blocks/entities%
%blocks/entities%'[s] [max[imum]] age
Since
2.7

Aliases

Structure

Used for registering custom aliases for a script.

aliases
Since
1.0

All Banned Players/IPs

Expression

Obtains the list of all banned players or IP addresses.

[all [[of] the]|the] banned (players|(ips|ip addresses))
Since
2.7

All commands

Expression

Returns all registered commands or all script commands.

[(all|the|all [of] the)] [registered] [script] commands
Since
2.6

All Operators

Expression

The list of operators on the server.

[all [[of] the]|the] [server] [non(-| )]op[erator]s
Since
2.7

All Permissions

Expression

Returns all permissions of the defined player(s). Note that the modifications to resulting list do not actually change permissions.

[(all [[of] the]|the)] permissions (from|of) %players%
[(all [[of] the]|the)] %players%'[s] permissions
Since
2.2-dev33

All Scripts

Expression

Returns all of the scripts, or just the enabled or disabled ones.

[all [of the]|the] scripts [without ([subdirectory] paths|parents)]
[all [of the]|the] (enabled|loaded) scripts [without ([subdirectory] paths|parents)]
[all [of the]|the] (disabled|unloaded) scripts [without ([subdirectory] paths|parents)]
Since
2.5

All Scripts (Experimental)

New
Expression

Returns all of the scripts, or just the enabled or disabled ones.

[all [[of] the]|the] scripts
[all [[of] the]|the] (enabled|loaded) scripts
[all [[of] the]|the] (disabled|unloaded) scripts
Since
2.10

All Tags of a Type

New
Expression

Returns all the tags.

`minecraft tag` will return only the vanilla tags, `datapack tag` will return only datapack-provided tags, `paper tag` will return only Paper's custom tags (if you are running Paper), and `custom tag` will look in the "skript" namespace for custom tags you've registered.

You can also filter by tag types using "item", "block", or "entity".

[all [[of] the]|the] [minecraft|datapack|paper|custom] [item|block|entity [type]] tags
Since
2.10
Requirements
Paper (paper tags)

Allow / Prevent Leash Drop

New
Effect

Allows or prevents the leash from being dropped in an unleash event.

(force|allow) [the] (lead|leash) [item] to drop
(block|disallow|prevent) [the] (lead|leash) [item] from dropping
Since
2.10
Supported events
Unleash

Allow Aging

New
Effect

Sets whether or not living entities will be able to age.

lock age of %living entities%
prevent aging of %living entities%
prevent %living entities% from aging
unlock age of %living entities%
allow aging of %living entities%
allow %living entities% to age
Since
2.10

Alpha/Red/Green/Blue Color Value

New
Expression

The alpha, red, green, or blue value of colors. Ranges from 0 to 255.

Alpha represents opacity.

[the] (alpha|red|green|blue) (value|component) of %colors%
%colors%'[s] (alpha|red|green|blue) (value|component)
Since
2.10

Alphabetical Sort

Expression

Sorts given strings in alphabetical order.

alphabetically sorted %texts%
Since
2.2-dev18b

Alphanumeric

Condition

Checks if the given string is alphanumeric.

%texts% (is|are) alphanumeric
%texts% (isn't|is not|aren't|are not) alphanumeric
Since
2.4

Altitude

Expression

Effectively an alias of 'y-coordinate of …', it represents the height of some object above bedrock.

[the] altitude[s] of %locations%
%locations%'[s] altitude[s]
Since
1.4.3

Amount

Expression

The amount or size of something.

Please note that amount of %items% will not return the number of items, but the number of stacks, e.g. 1 for a stack of 64 torches. To get the amount of items in a stack, see the item amount expression.

Also, you can get the recursive size of a list, which will return the recursive size of the list with sublists included, e.g.

{list::*} Structure

├──── {list::1}: 1

├──── {list::2}: 2

│ ├──── {list::2::1}: 3

│ │ └──── {list::2::1::1}: 4

│ └──── {list::2::2}: 5

└──── {list::3}: 6

Where using %size of {list::*}% will only return 3 (the first layer of indices only), while %recursive size of {list::*}% will return 6 (the entire list)

Please note that getting a list's recursive size can cause lag if the list is large, so only use this expression if you need to!

[the] (amount|number|size) of %numbered thing%
[the] (amount|number|size) of %objects%
[the] recursive (amount|number|size) of %objects%
Since
1.0

Amount of Items

Expression

Counts how many of a particular item type are in a given inventory.

[the] (amount|number) of %item types% (in|of) %inventories%
Since
2.0

Angle

New
Expression

Represents the passed number value in degrees.

If radians is specified, converts the passed value to degrees. This conversion may not be entirely accurate, due to floating point precision.

%number% [in] deg[ree][s]
%number% [in] rad[ian][s]
%numbers% in deg[ree][s]
%numbers% in rad[ian][s]
Since
2.10

Anvil Repair Cost

Expression

Returns the experience cost (in levels) to complete the current repair or the maximum experience cost (in levels) to be allowed by the current repair.

The default value of max cost set by vanilla Minecraft is 40.

[the] [anvil] [item] [max[imum]] repair cost [of %inventories%]
%inventories%'[s] [anvil] [item] [max[imum]] repair cost
Since
2.8.0

Anvil Text Input

Expression

An expression to get the name to be applied to an item in an anvil inventory.

[the] anvil [inventory] (rename|text) input of %inventories%
%inventories%'[s] anvil [inventory] (rename|text) input
Since
2.7

Any Named Thing

New
Type

Something that has a name (e.g. an item).

Since
2.10

Any Numbered/Sized Thing

New
Type

Something that has an amount or size.

Since
2.10

Any Valued Thing

New
Type

Something that has a value.

Since
2.10

Anything with Contents

New
Type

Something that contains other things.

Since
2.10

Applied Beacon Effect

New
Expression

The type of effect applied by a beacon.

[the] applied [beacon] effect
Since
2.10
Requirements
Paper
Supported events
Beacon Effect

Applied Enchantments

Expression

The applied enchantments in an enchant event.

Deleting or removing the applied enchantments will prevent the item's enchantment.

[the] applied enchant[ment]s
Since
2.5
Supported events
enchant

Apply Bone Meal

Effect

Applies bone meal to a crop, sapling, or composter

apply [%number%] bone[ ]meal[s] [to %blocks%]
Since
2.8.0
Requirements
MC 1.16.2+

Apply Fishing Lure

New
Effect

Sets whether the lure enchantment should be applied, which reduces the wait time.

apply [the] lure enchantment bonus
remove [the] lure enchantment bonus
Since
2.10
Supported events
Fishing

Argument

Expression

Usable in script commands and command events. Holds the value of an argument given to the command, e.g. if the command "/tell <player> <text>" is used like "/tell Njol Hello Njol!" argument 1 is the player named "Njol" and argument 2 is "Hello Njol!".

One can also use the type of the argument instead of its index to address the argument, e.g. in the above example 'player-argument' is the same as 'argument 1'.

Please note that specifying the argument type is only supported in script commands.

[the] last arg[ument]
[the] arg[ument](-| )<(\d+)>
[the] <(\d*1)st|(\d*2)nd|(\d*3)rd|(\d*[4-90])th> arg[ument][s]
[(all [[of] the]|the)] arg[ument][s]
[the] %*type%( |-)arg[ument][( |-)<\d+>]
[the] arg[ument]( |-)%*type%[( |-)<\d+>]
Since
1.0, 2.7 (support for command events)

Arithmetic

Expression

Arithmetic expressions, e.g. 1 + 2, (health of player - 2) / 3, etc.

\(%object%\)[ ]+[ ]\(%object%\)
\(%object%\)[ ]+[ ]%object%
%object%[ ]+[ ]\(%object%\)
%object%[ ]+[ ]%object%
\(%object%\)[ ]-[ ]\(%object%\)
\(%object%\)[ ]-[ ]%object%
%object%[ ]-[ ]\(%object%\)
%object%[ ]-[ ]%object%
\(%object%\)[ ]*[ ]\(%object%\)
\(%object%\)[ ]*[ ]%object%
%object%[ ]*[ ]\(%object%\)
%object%[ ]*[ ]%object%
\(%object%\)[ ]/[ ]\(%object%\)
\(%object%\)[ ]/[ ]%object%
%object%[ ]/[ ]\(%object%\)
%object%[ ]/[ ]%object%
\(%object%\)[ ]^[ ]\(%object%\)
\(%object%\)[ ]^[ ]%object%
%object%[ ]^[ ]\(%object%\)
%object%[ ]^[ ]%object%
Since
1.4.2

Armor Slot

New
Expression

Equipment of living entities, i.e. the boots, leggings, chestplate or helmet.

Body armor is a special slot that can only be used for:

  • Horses: Horse armour (doesn't work on zombie or skeleton horses)
  • Wolves: Wolf Armor
  • Llamas (regular or trader): Carpet

[the] (((boots|shoes)|leg[ging]s|chestplate[s]|helmet[s]) [(item|slot)]|armo[u]r[s]|body armo[u]r) of %living entities%
%living entities%'[s] (((boots|shoes)|leg[ging]s|chestplate[s]|helmet[s]) [(item|slot)]|armo[u]r[s]|body armo[u]r)
Since
1.0, 2.8.0 (armor), 2.10 (body armor)

Arrow Attached Block

Expression

Returns the attached block of an arrow.

[the] (attached|hit) block of %projectiles%
%projectiles%'[s] (attached|hit) block
Since
2.8.0

Arrow Knockback Strength

Expression

An arrow's knockback strength.

[the] arrow knockback strength of %projectiles%
%projectiles%'[s] arrow knockback strength
Since
2.5.1

Arrows Stuck

Expression

The number of arrows stuck in a living entity.

[number of] arrow[s] stuck in %living entities%
Since
2.5

asin

Function

The inverse of the sine, also called arcsin. Returns result in degrees, not radians. Only returns values from -90 to 90.

asin(n: number)
Since
2.2
Returns
Number

At Time

Event

An event that occurs at a given minecraft time in every world or only in specific worlds.

at %time% [in %worlds%]
Since
1.3.4

atan

Function

The inverse of the tangent, also called arctan. Returns result in degrees, not radians. Only returns values from -90 to 90.

atan(n: number)
Since
2.2
Returns
Number

atan2

Function

Similar to atan, but requires two coordinates and returns values from -180 to 180.

The returned angle is measured counterclockwise in a standard mathematical coordinate system (x to the right, y to the top).

atan2(x: number, y: number)
Since
2.2
Returns
Number

Attack Cooldown

Expression

Returns the current cooldown for a player's attack. This is used to calculate damage, with 1.0 representing a fully charged attack and 0.0 representing a non-charged attack.

NOTE: Currently this can not be set to anything.

[the] attack cooldown of %players%
%players%'[s] attack cooldown
Since
2.6.1
Requirements
Minecraft 1.15+

Attacked

Expression

The victim of a damage event, e.g. when a player attacks a zombie this expression represents the zombie. When using Minecraft 1.11+, this also covers the hit entity in a projectile hit event.

[the] (attacked|damaged|victim) [<(.+)>]
Since
1.3, 2.6.1 (projectile hit event)
Supported events
damage, death, projectile hit

Attacker

Expression

The attacker of a damage event, e.g. when a player attacks a zombie this expression represents the player.

Please note that the attacker can also be a block, e.g. a cactus or lava, but this expression will not be set in these cases.

[the] (attacker|damager)
Since
1.3
Supported events
damage, death, destroy

Attribute Type

Type

Represents the type of an attribute. Note that this type does not contain any numerical values.See attribute types for more info.

NOTE: Minecraft namespaces are supported, ex: 'minecraft:generic.attack_damage'.

armor, armor toughness, attack damage, attack knockback, attack speed, block break speed, block interaction range, burning time, entity interaction range, explosion knockback resistance, fall damage multiplier, flying speed, follow range, generic armor, generic armor toughness, generic attack damage, generic attack knockback, generic attack speed, generic burning time, generic explosion knockback resistance, generic fall damage multiplier, generic flying speed, generic follow range, generic gravity, generic jump strength, generic knockback resistance, generic luck, generic max absorption, generic max health, generic movement efficiency, generic movement speed, generic oxygen bonus, generic safe fall distance, generic scale, generic step height, generic tempt range, generic water movement efficiency, gravity, horse jump strength, jump strength, knockback resistance, luck, max absorption, max health, mining efficiency, movement efficiency, movement speed, oxygen bonus, player block break speed, player block interaction range, player entity interaction range, player mining efficiency, player sneaking speed, player submerged mining speed, player sweeping damage ratio, safe fall distance, scale, sneaking speed, spawn reinforcements, step height, submerged mining speed, sweeping damage ratio, tempt range, water movement efficiency, zombie spawn reinforcements
Since
2.5

axisAngle

New
Function

Returns a quaternion from the given angle (in degrees) and axis (as a vector). This represents a rotation around the given axis by the given angle.

axisAngle(angle: number, axis: vector)
Since
2.10
Returns
Quaternion

Ban

Effect

Bans or unbans a player or an IP address.

If a reason is given, it will be shown to the player when they try to join the server while banned.

A length of ban may also be given to apply a temporary ban. If it is absent for any reason, a permanent ban will be used instead.

We recommend that you test your scripts so that no accidental permanent bans are applied.

Note that banning people does not kick them from the server.

You can optionally use 'and kick' or consider using the kick effect after applying a ban.

ban [and kick] %texts/offline players% [(by reason of|because [of]|on account of|due to) %text%] [for %time span%]
unban %texts/offline players%
ban [and kick] %players% by IP [(by reason of|because [of]|on account of|due to) %text%] [for %time span%]
unban %players% by IP
IP(-| )ban [and kick] %players% [(by reason of|because [of]|on account of|due to) %text%] [for %time span%]
(IP(-| )unban|un[-]IP[-]ban) %players%
Since
1.4, 2.1.1 (ban reason), 2.5 (timespan), 2.9.0 (kick)

Banner Pattern

New
Type

Represents a banner pattern.

Since
2.10

Banner Pattern

New
Expression

Creates a new banner pattern.

[a] %banner pattern type% colo[u]red %color%
Since
2.10

Banner Pattern Item

New
Expression

Gets the item from a banner pattern type.

Note that not all banner pattern types have an item.

[a[n]] %*banner pattern types% item[s]
Since
2.10

Banner Pattern Type

New
Type

Represents the various banner patterns that can be applied to a banner.

base, base banner pattern, border, border banner pattern, bordure banner pattern, bordure indented banner pattern, bottom left square banner pattern, bottom right square banner pattern, bottom stripe banner pattern, bottom triangle banner pattern, bricks, bricks banner pattern, center stripe banner pattern, circle, circle banner pattern, creeper, creeper banner pattern, creeper charged banner pattern, cross, cross banner pattern, curly border, curly border banner pattern, diagonal left, diagonal right, diagonal up left, diagonal up left banner pattern, diagonal up right, diagonal up right banner pattern, down left stripe banner pattern, down right stripe banner pattern, field masoned banner pattern, flow, flow banner pattern, flower, flower banner pattern, globe, globe banner pattern, gradient, gradient banner pattern, gradient up, gradient up banner pattern, guster, guster banner pattern, half horizontal, half horizontal bottom, half vertical, half vertical right, horizontal bottom half banner pattern, horizontal half banner pattern, left diagonal banner pattern, left stripe banner pattern, middle stripe banner pattern, mojang, mojang banner pattern, piglin, piglin banner pattern, rhombus, rhombus banner pattern, right diagonal banner pattern, right stripe banner pattern, right vertical half banner pattern, skull, skull banner pattern, small stripes, small stripes banner pattern, snout banner pattern, square bottom left, square bottom right, square top left, square top right, straight cross, straight cross banner pattern, stripe bottom, stripe center, stripe downleft, stripe downright, stripe left, stripe middle, stripe right, stripe top, tbottom triangles banner pattern, thing banner pattern, top left square banner pattern, top right square banner pattern, top stripe banner pattern, top triangle banner pattern, top triangles banner pattern, triangle bottom, triangle top, triangles bottom, triangles top, vertical half banner pattern
Since
2.10

Banner Patterns

New
Expression

Gets or sets the banner patterns of a banner.

In order to set a specific position of a banner, there needs to be that many patterns already on the banner.

This expression will add filler patterns to the banner to allow the specified position to be set.

For Example, setting the 3rd banner pattern of a banner that has no patterns on it, will internally add 3 base patterns, allowing the 3rd banner pattern to be set.

[all [[of] the]|the] banner pattern[s] of %item stacks/item types/slots/blocks%
%item stacks/item types/slots/blocks%'[s] banner pattern[s]
[the] %integer%[st|nd|rd|th] [banner] pattern of %item stacks/item types/slots/blocks%
%item stacks/item types/slots/blocks%'[s] %integer%[st|nd|rd|th] [banner] pattern
Since
2.10

Barter Drops

New
Expression

The items dropped by the piglin in a piglin bartering event.

[the] [piglin] barter[ing] drops
Since
2.10

Barter Input

New
Expression

The item picked up by the piglin in a piglin bartering event.

[the] [piglin] barter[ing] input
Since
2.10

Beacon Effects

New
Expression

The active effects of a beacon.

The secondary effect can be set to anything, but the icon in the GUI will not display correctly.

The secondary effect can only be set when the beacon is at max tier.

The primary and secondary effect can not be the same, primary will always retain the potion type and secondary will be cleared.

You can only change the range on Paper.

%blocks%['s] primary [beacon] effect
[the] primary [beacon] effect [of %blocks%]
%blocks%['s] secondary [beacon] effect
[the] secondary [beacon] effect [of %blocks%]
%blocks%['s] [beacon] range
[the] [beacon] range [of %blocks%]
%blocks%['s] [beacon] tier
[the] [beacon] tier [of %blocks%]
Since
2.10
Requirements
Paper (range)
Supported events
Beacon Effect, Beacon Toggle, Beacon Change Effect

Bed

Expression

Returns the bed location of a player, i.e. the spawn point of a player if they ever slept in a bed and the bed still exists and is unobstructed however, you can set the unsafe bed location of players and they will respawn there even if it has been obstructed or doesn't exist anymore and that's the default behavior of this expression otherwise you will need to be specific i.e. safe bed location.

NOTE: Offline players can not have their bed location changed, only online players.

[the] [((safe|valid)|(unsafe|invalid))] bed[s] [location[s]] of %offline players%
%offline players%'[s] [((safe|valid)|(unsafe|invalid))] bed[s] [location[s]]
Since
2.0, 2.7 (offlineplayers, safe bed)

Bell Is Resonating

Condition

Checks to see if a bell is currently resonating.

A bell will start resonating five game ticks after being rung, and will continue to resonate for 40 game ticks.

%blocks% (is|are) resonating
%blocks% (isn't|is not|aren't|are not) resonating
Since
2.9.0
Requirements
Spigot 1.19.4+

Bell Is Ringing

Condition

Checks to see if a bell is currently ringing. A bell typically rings for 50 game ticks.

%blocks% (is|are) ringing
%blocks% (isn't|is not|aren't|are not) ringing
Since
2.9.0
Requirements
Spigot 1.19.4+

Biome

Type

All possible biomes Minecraft uses to generate a world.

NOTE: Minecraft namespaces are supported, ex: 'minecraft:basalt_deltas'.

badlands, badlands forest, bamboo jungle, basalt deltas, beach, birch forest, black forest, cherry grove, cold beach, cold ocean, cold taiga, crimson forest, dark forest, deep cold ocean, deep dark, deep frozen ocean, deep lukewarm ocean, deep ocean, desert, dripstone caves, end barrens, end highlands, end midlands, eroded badlands, eroded mesa, flower forest, forest, frozen ocean, frozen peaks, frozen river, giant spruce taiga, giant tree taiga, gravelly mountains, grove, hell, ice plains spikes, ice plains with spikes, ice spikes, jagged peaks, jungle, jungle edge, lukewarm ocean, lush caves, mangrove swamp, marsh, meadow, mesa, mesa forest, mountains, mushroom fields, mushroom island, nether, nether wastes, ocean, old growth birch forest, old growth pine taiga, old growth spruce taiga, pale garden, plains, river, roofed forest, savanna, savanna plateau, sea, shattered savanna, sky, small end islands, snowy beach, snowy plains, snowy slopes, snowy taiga, snowy tundra, soul sand valley, sparse jungle, spiked ice plains, stone shore, stony peaks, stony shore, sunflower plains, swamp, swampland, taiga, tall birch forest, the end, the void, void, warm ocean, warped forest, windswept forest, windswept gravelly hills, windswept hills, windswept savanna, wooded badlands, wooded mesa, wooded mountains
Since
1.4.4

Biome

Expression

The biome at a certain location. Please note that biomes are only defined for x/z-columns

(i.e. the altitude (y-coordinate) doesn't matter), up until Minecraft 1.15.x.

As of Minecraft 1.16, biomes are now 3D (per block vs column).

[the] biome [(of|%direction%) %locations%]
%locations%'[s] biome
Since
1.4.4, 2.6.1 (3D biomes)

Block

Type

A block in a world. It has a location and a type, and can also have a direction (mostly a facing), an inventory, or other special properties.

Since
1.0

Block

Expression

The block involved in the event, e.g. the clicked block or the placed block.

Can optionally include a direction as well, e.g. 'block above' or 'block in front of the player'.

[the] [event-]block
Since
1.0

Block

Expression

The block involved in the event, e.g. the clicked block or the placed block.

Can optionally include a direction as well, e.g. 'block above' or 'block in front of the player'.

[the] block %direction% [%location%]
Since
1.0

Block Break Speed

Expression

Gets the speed at which the given player would break this block, taking into account tools, potion effects, whether or not the player is in water, enchantments, etc. The returned value is the amount of progress made in breaking the block each tick. When the total breaking progress reaches 1.0, the block is broken. Note that the break speed can change in the course of breaking a block, e.g. if a potion effect is applied or expires, or the player jumps/enters water.

[the] break speed[s] [of %blocks%] [for %players%]
%block%'[s] break speed[s] [for %players%]
Since
2.7
Requirements
1.17+

Block Data

Type

Block data is the detailed information about a block, referred to in Minecraft as BlockStates, allowing for the manipulation of different aspects of the block, including shape, waterlogging, direction the block is facing, and so much more. Information regarding each block's optional data can be found on Minecraft's Wiki. Find the block you're looking for and scroll down to 'Block States'. Different states must be separated by a semicolon (see examples). The 'minecraft:' namespace is optional, as well as are underscores.

Since
2.5

Block Data

New
Expression

Get the block data associated with a block.

This data can also be used to set blocks.

[the] block[ ]data of %blocks/displays%
%blocks/displays%'[s] block[ ]data
Since
2.5, 2.5.2 (set), 2.10 (block displays)

Block Hardness

Expression

Obtains the block's hardness level (also known as "strength"). This number is used to calculate the time required to break each block.

[the] [block] hardness of %item types%
%item types%'[s] [block] hardness
Since
2.6
Requirements
Minecraft 1.13+

Block Sound

New
Expression

Gets the sound that a given block, blockdata, or itemtype will use in a specific scenario.

This will return a string in the form of "SOUND_EXAMPLE", which can be used in the play sound syntax.

Check out this website for a list of sounds in Minecraft, or this one to go to the Sounds wiki page.

[the] (break|fall|hit|place|step) sound[s] of %blocks/block datas/item types%
%blocks/block datas/item types%'[s] (break|fall|hit|place|step) sound[s]
Since
2.10

Block Sphere

Expression

All blocks in a sphere around a center, mostly useful for looping.

[(all [[of] the]|the)] blocks in radius %number% [(of|around) %location%]
[(all [[of] the]|the)] blocks around %location% in radius %number%
Since
1.0

Blocks

Expression

Blocks relative to other blocks or between other blocks. Can be used to get blocks relative to other blocks or for looping.

Blocks from/to and between will return a straight line whereas blocks within will return a cuboid.

[(all [[of] the]|the)] blocks %direction% [%locations%]
[(all [[of] the]|the)] blocks from %location% [on] %direction%
[(all [[of] the]|the)] blocks from %location% to %location%
[(all [[of] the]|the)] blocks between %location% and %location%
[(all [[of] the]|the)] blocks within %location% and %location%
[(all [[of] the]|the)] blocks (in|within) %chunk%
Since
1.0, 2.5.1 (within/cuboid/chunk)

Book Author

Expression

The author of a book.

[the] [book] (author|writer|publisher) of %item types%
%item types%'[s] [book] (author|writer|publisher)
Since
2.2-dev31

Book Pages

Expression

The pages of a book (Supports Skript's chat format)

Note: In order to modify the pages of a new written book, you must have the title and author

of the book set. Skript will do this for you, but if you want your own, please set those values.

[all [[of] the]|the] [book] (pages|content) of %item types/item stacks%
%item types/item stacks%'[s] [book] (pages|content)
[book] page %number% of %item types/item stacks%
%item types/item stacks%'[s] [book] page %number%
Since
2.2-dev31, 2.7 (changers)

Book Title

Expression

The title of a book.

[the] book (name|title) of %item types%
%item types%'[s] book (name|title)
Since
2.2-dev31

Boolean

Type

A boolean is a value that is either true or false. Other accepted names are 'on' and 'yes' for true, and 'off' and 'no' for false.

true/yes/on or false/no/off
Since
1.0

Break Block

Effect

Breaks the block and spawns items as if a player had mined it

You can add a tool, which will spawn items based on how that tool would break the block

(ie: When using a hand to break stone, it drops nothing, whereas with a pickaxe it drops cobblestone)

break %blocks% [naturally] [using %item type%]
Since
2.4

Breeding Family

New
Expression

Represents family members within a breeding event.

[the] breeding mother
[the] breeding father
[the] [bred] (offspring|child)
[the] breeder
Since
2.10

Broadcast

Effect

Broadcasts a message to the server.

broadcast %objects% [(to|in) %worlds%]
Since
1.0, 2.6 (broadcasting objects), 2.6.1 (using advanced formatting)

calcExperience

Function

Calculates the total amount of experience needed to achieve given level from scratch in Minecraft.

calcExperience(level: long)
Since
2.2-dev32
Returns

Can Age

New
Condition

Checks whether or not an entity will be able to age/grow up.

%living entities% can (age|grow (up|old[er]))
%living entities% (can't|cannot|can not) (age|grow (up|old[er]))
Since
2.10

Can Breed

New
Condition

Checks whether or not a living entity can be bred.

%living entities% can (breed|be bred)
%living entities% (can't|cannot|can not) (breed|be bred)
Since
2.10

Can Fly

Condition

Whether a player is allowed to fly.

%players% can fly
%players% (can't|cannot|can not) fly
Since
2.3

Can Hold

Condition

Tests whether a player or a chest can hold the given item.

%inventories% (can hold|ha(s|ve) [enough] space (for|to hold)) %item types%
%inventories% (can(no|')t hold|(ha(s|ve) not|ha(s|ve)n't|do[es]n't have) [enough] space (for|to hold)) %item types%
Since
1.0

Can Pick Up Items

Condition

Whether living entities are able to pick up items off the ground or not.

%living entities% can pick([ ]up items| items up)
%living entities% (can't|cannot|can not) pick([ ]up items| items up)
Since
2.8.0

Can See

New
Condition

Checks whether the given players can see the provided entities.

%entities% (is|are) [visible|invisible] for %players%
%players% can see %entities%
%entities% (is|are)(n't| not) [visible|invisible] for %players%
%players% can('t| not) see %entities%
Since
2.3, 2.10 (entities)
Requirements
Minecraft 1.19+ (entities)

Can See Chat Colors

New
Condition

Checks whether a player can see chat colors.

%players% can see chat colo[u]r[s|ing]
%players% (can't|cannot|can not) see chat colo[u]r[s|ing]
Since
2.10
Requirements
Paper

Can See Messages

New
Condition

Checks whether a player can see specific message types in chat.

%player% can see all messages [in chat]
%player% can only see (commands|system messages) [in chat]
%player% can('t|[ ]not) see any (command[s]|message[s]) [in chat]
%player% can('t|[ ]not) see all messages [in chat]
%player% can('t|[ ]not) only see (commands|system messages) [in chat]
Since
2.10
Requirements
Paper

Cancel Active Item

Effect

Interrupts the action entities may be trying to complete.

For example, interrupting eating, or drawing back a bow.

(cancel|interrupt) [the] us[ag]e of %living entities%'[s] [active|current] item
Since
2.8.0
Requirements
Paper 1.16+

Cancel Command Cooldown

Effect

Only usable in commands. Makes it so the current command usage isn't counted towards the cooldown.

(cancel|ignore) [the] [current] [command] cooldown
un(cancel|ignore) [the] [current] [command] cooldown
Since
2.2-dev34

Cancel Drops

Effect

Cancels drops of items or experiences in a death or block break event. Please note that this doesn't keep items or experiences of a dead player. If you want to do that, use the Keep Inventory / Experience effect.

(cancel|clear|delete) [the] drops [of (items|[e]xp[erience][s])]
(cancel|clear|delete) [the] (item|[e]xp[erience]) drops
Since
2.4
Requirements
1.12.2 or newer (cancelling item drops of blocks)
Supported events
death, break / mine

Cancel Event

Effect

Cancels the event (e.g. prevent blocks from being placed, or damage being taken).

cancel [the] event
uncancel [the] event
Since
1.0

Case Text

Expression

Copy of given text in Lowercase, Uppercase, Proper Case, camelCase, PascalCase, Snake_Case, and Kebab-Case

%texts% in (upper|lower)[ ]case
(upper|lower)[ ]case %texts%
capitali(s|z)ed %texts%
%texts% in [(lenient|strict) ](proper|title)[ ]case
[(lenient|strict) ](proper|title)[ ]case %texts%
%texts% in [(lenient|strict) ]camel[ ]case
[(lenient|strict) ]camel[ ]case %texts%
%texts% in [(lenient|strict) ]pascal[ ]case
[(lenient|strict) ]pascal[ ]case %texts%
%texts% in [(lower|upper|capital|screaming)[ ]]snake[ ]case
[(lower|upper|capital|screaming)[ ]]snake[ ]case %texts%
%texts% in [(lower|upper|capital)[ ]]kebab[ ]case
[(lower|upper|capital)[ ]]kebab[ ]case %texts%
Since
2.2-dev16 (lowercase and uppercase), 2.5 (advanced cases)

Cat Type

Type

Represents the race/type of a cat entity.

NOTE: Minecraft namespaces are supported, ex: 'minecraft:british_shorthair'.

all black, black, british shorthair, calico, jellie, persian, ragdoll, red, siamese, tabby, white
Since
2.4
Requirements
Minecraft 1.14 or newer

ceil

Function

Rounds a number up, i.e. returns the closest integer larger than or equal to the argument.

ceil(n: number)
Since
2.2
Returns

ceiling

Function

Alias of ceil.

ceiling(n: number)
Since
2.2
Returns

Chance

Condition

A condition that randomly succeeds or fails.

Valid values are between 0% and 100%, or if the percent sign is omitted between 0 and 1.

chance of %number%[(\%)]
Since
1.0

Change: Set/Add/Remove/Delete/Reset

Effect

A very general effect that can change many expressions. Many expressions can only be set and/or deleted, while some can have things added to or removed from them.

(add|give) %objects% to %~objects%
increase %~objects% by %objects%
give %~objects% %objects%
set %~objects% to %objects%
remove (all|every) %objects% from %~objects%
(remove|subtract) %objects% from %~objects%
(reduce|decrease) %~objects% by %objects%
(delete|clear) %~objects%
reset %~objects%
Since
1.0 (set, add, remove, delete), 2.0 (remove all)

Character Codepoint

Expression

Returns the Unicode codepoint of a character

[the] [unicode|character] code([ ]point| position) of %texts%
%texts%'[s] [unicode|character] code([ ]point| position)
Since
2.9.0

Character from Codepoint

Expression

Returns the character at the specified codepoint

character (from|at|with) code([ ]point| position) %integer%
Since
2.9.0

Characters Between

Expression

All characters between two given characters, useful for generating random strings. This expression uses the Unicode numerical code of a character to determine which characters are between the two given characters. The ASCII table linked here shows this ordering for the first 256 characters.

If you would like only alphanumeric characters you can use the 'alphanumeric' option in the expression.

If strings of more than one character are given, only the first character of each is used.

[(all [[of] the]|the)] [alphanumeric] characters (between|from) %text% (and|to) %text%
Since
2.8.0

Charge Entity

New
Effect

Charges or uncharges a creeper or wither skull. A creeper is charged when it has been struck by lightning.

make %entities% [(un|not |non[-| ])](charged|powered)
[un](charge|power) %entities%
Since
2.5, 2.10 (wither skulls)

Chat Format

Expression

Can be used to get/retrieve the chat format. The sender of a message is represented by [player] or [sender], and the message by [message] or [msg].

[the] (message|chat) format[ting]
Since
2.2-dev31

Chat Recipients

Expression

Recipients of chat events where this is called.

[chat][( |-)]recipients
Since
2.2-Fixes-v7, 2.2-dev35 (clearing recipients)

Chunk

Type

A chunk is a cuboid of 16×16×128 (x×z×y) blocks. Chunks are spread on a fixed rectangular grid in their world.

Since
2.0

Chunk

Expression

Returns the chunk of a block, location or entity is in, or a list of the loaded chunks of a world.

[(all [[of] the]|the)] chunk[s] (of|%directions%) %locations%
%locations%'[s] chunk[s]
[(all [[of] the]|the)] loaded chunks (of|in) %worlds%
Since
2.0, 2.8.0 (loaded chunks)

clamp

Function

Clamps one or more values between two numbers.

clamp(values: numbers, min: number, max: number)
Since
2.8.0
Returns
Number

Click Type

Type

Click type, mostly for inventory events. Tells exactly which keys/buttons player pressed, assuming that default keybindings are used in client side.

lmb, number key, mmb, rmb, drop item, drop key, window border using left mouse button, unknown, window border using right mouse, shift+rmb, unsupported, shift+lmb, ctrl+q, swap shield, left mouse button, left mouse with shift, left mouse, 0-9, double click, double click using mouse, border using rmb, right mouse button, right mouse button with shift, border using lmb, middle mouse, drop key with control, window border using right mouse button, swap offhand, custom, q, right mouse with shift, middle mouse button, drop stack, left mouse button with shift, right mouse, creative action
Since
2.2-dev16b, 2.2-dev35 (renamed to click type)

Clicked Block/Entity/Inventory/Slot

Expression

The clicked block, entity, inventory, inventory slot, inventory click type or inventory action.

[the] (clicked [enchant[ment]] (button|option)|clicked (block|%*item type/entity type%)|clicked slot|clicked inventory|click (type|action)|inventory action)
Since
1.0, 2.2-dev35 (more clickable things)
Supported events
click, inventory click

Color

Type

Wool, dye and chat colors.

black, dark grey/dark gray, grey/light grey/gray/light gray/silver, white, blue/dark blue, cyan/aqua/dark cyan/dark aqua, light blue/light cyan/light aqua, green/dark green, light green/lime/lime green, yellow/light yellow, orange/gold/dark yellow, red/dark red, pink/light red, purple/dark purple, magenta/light purple, brown/indigo
Since

Color Items

Effect

Colors items in a given color. You can also use RGB codes if you feel limited with the 16 default colors. RGB codes are three numbers from 0 to 255 in the order (red, green, blue), where (0,0,0) is black and (255,255,255) is white. Armor is colorable for all Minecraft versions. With Minecraft 1.11 or newer you can also color potions and maps. Note that the colors might not look exactly how you'd expect.

(dye|colo[u]r|paint) %item types% %color%
(dye|colo[u]r|paint) %item types% \(%number%, %number%, %number%\)
Since
2.0, 2.2-dev26 (maps and potions)

Color of

New
Expression

The color of an item, entity, block, firework effect, or text display.

This can also be used to color chat messages with "<%color of ...%>this text is colored!".

Do note that firework effects support setting, adding, removing, resetting, and deleting; text displays support setting and resetting; and items, entities, and blocks only support setting, and only for very few items/blocks.

[the] colo[u]r[s] of %blocks/item types/entities/firework effects/displays%
%blocks/item types/entities/firework effects/displays%'[s] colo[u]r[s]
Since
1.2, 2.10 (displays)

Colored / Uncolored

Expression

Parses <color>s and, optionally, chat styles in a message or removes

any colors and chat styles from the message. Parsing all

chat styles requires this expression to be used in same line with

the send effect.

(colo[u]r-|colo[u]red )%texts%
(format-|formatted )%texts%
(un|non)[-](colo[u]r-|colo[u]red |format-|formatted )%texts%
Since
2.0

Command

Effect

Executes a command. This can be useful to use other plugins in triggers.

If the command is a bungeecord side command, you can use the [bungeecord] option to execute command on the proxy.

[execute] [the] [bungee[cord]] command[s] %texts% [by %command senders%]
[execute] [the] %command senders% [bungee[cord]] command[s] %texts%
(let|make) %command senders% execute [[the] [bungee[cord]] command[s]] %texts%
Since
1.0, 2.8.0 (bungeecord command)

Command

Expression

The command that caused an 'on command' event (excluding the leading slash and all arguments)

[the] (full|complete|whole) command
[the] command [(label|alias)]
Since
2.0, 2.7 (support for script commands)
Supported events
command

Command

Structure

Used for registering custom commands.

command <.+>
Since
1.0

Command Block Command

New
Expression

Gets or sets the command associated with a command block or minecart with command block.

[the] [command[ ]block] command of %blocks/entities%
%blocks/entities%'[s] [command[ ]block] command
Since
2.10

Command Info

Expression

Get information about a command.

[the] main command [label|name] [of [[the] command[s] %texts%]]
command[s] %texts%'[s] main command [label|name]
[the] description [of [[the] command[s] %texts%]]
command[s] %texts%'[s] description
[the] label [of [[the] command[s] %texts%]]
command[s] %texts%'[s] label
[the] usage [of [[the] command[s] %texts%]]
command[s] %texts%'[s] usage
[(all|the|all [of] the)] aliases [of [[the] command[s] %texts%]]
command[s] %texts%'[s] aliases
[the] permission [of [[the] command[s] %texts%]]
command[s] %texts%'[s] permission
[the] permission message [of [[the] command[s] %texts%]]
command[s] %texts%'[s] permission message
[the] plugin [owner] [of [[the] command[s] %texts%]]
command[s] %texts%'[s] plugin [owner]
Since
2.6

Command Sender

Type

A player or the console.

use <a href='expressions.html#LitConsole'>the console</a> for the console
see <a href='#player'>player</a> for players.
Since
1.0

Command Sender

Expression

The player or the console who sent a command. Mostly useful in commands and command events.

If the command sender is a command block, its location can be retrieved by using %block's location%

[the] [command['s]] (sender|executor)
Since
2.0
Supported events
command

Comparison

Condition

A very general condition, it simply compares two values. Usually you can only compare for equality (e.g. block is/isn't of <type>), but some values can also be compared using greater than/less than. In that case you can also test for whether an object is between two others.

Note: This is the only element where not all patterns are shown. It has actually another two sets of similar patters, but with (was|were) or will be instead of (is|are) respectively, which check different time states of the first expression.

[(neither)] %objects% ((is|are)[(n't| not| neither)] ((greater|more|higher|bigger|larger) than|above)|>) %objects%
[(neither)] %objects% ((is|are)[(n't| not| neither)] (greater|more|higher|bigger|larger|above) [than] or (equal to|the same as)|>=) %objects%
[(neither)] %objects% ((is|are)[(n't| not| neither)] ((less|smaller|lower) than|below)|<) %objects%
[(neither)] %objects% ((is|are)[(n't| not| neither)] (less|smaller|lower|below) [than] or (equal to|the same as)|<=) %objects%
[(neither)] %objects% ((is|are) (not|neither)|isn't|aren't|!=) [equal to] %objects%
[(neither)] %objects% (is|are|=) [(equal to|the same as)] %objects%
[(neither)] %objects% (is|are) between %objects% and %objects%
[(neither)] %objects% (is not|are not|isn't|aren't) between %objects% and %objects%
[(neither)] %objects% (was|were)[(n't| not| neither)] ((greater|more|higher|bigger|larger) than|above) %objects%
[(neither)] %objects% (was|were)[(n't| not| neither)] (greater|more|higher|bigger|larger|above) [than] or (equal to|the same as) %objects%
[(neither)] %objects% (was|were)[(n't| not| neither)] ((less|smaller|lower) than|below) %objects%
[(neither)] %objects% (was|were)[(n't| not| neither)] (less|smaller|lower|below) [than] or (equal to|the same as) %objects%
[(neither)] %objects% ((was|were) (not|neither)|wasn't|weren't) [equal to] %objects%
[(neither)] %objects% (was|were) [(equal to|the same as)] %objects%
[(neither)] %objects% (was|were) between %objects% and %objects%
[(neither)] %objects% (was not|were not|wasn't|weren't) between %objects% and %objects%
[(neither)] %objects% (will be|(will (not|neither) be|won't be)) ((greater|more|higher|bigger|larger) than|above) %objects%
[(neither)] %objects% (will be|(will (not|neither) be|won't be)) (greater|more|higher|bigger|larger|above) [than] or (equal to|the same as) %objects%
[(neither)] %objects% (will be|(will (not|neither) be|won't be)) ((less|smaller|lower) than|below) %objects%
[(neither)] %objects% (will be|(will (not|neither) be|won't be)) (less|smaller|lower|below) [than] or (equal to|the same as) %objects%
[(neither)] %objects% ((will (not|neither) be|won't be)|(isn't|aren't|is not|are not) (turning|changing) [in]to) [equal to] %objects%
[(neither)] %objects% (will be [(equal to|the same as)]|(is|are) (turning|changing) [in]to) %objects%
[(neither)] %objects% will be between %objects% and %objects%
[(neither)] %objects% (will not be|won't be) between %objects% and %objects%
Since
1.0

Compass Target

Expression

The location a player's compass is pointing at.

As of Minecraft 1.21.4, the compass is controlled by the resource pack and by default will not point to this compass target when used outside of the overworld dimension.

[the] compass target of %players%
%players%'[s] compass target
Since
2.0

concat

Function

Joins the provided texts (and other things) into a single text.

concat(texts: objects)
Since
2.9.0
Returns
Text

Conditional / Unconditional

New
Effect

Sets whether the provided command blocks are conditional or not.

make command block[s] %blocks% [(un|not )]conditional
Since
2.10

Conditionals

Section

Conditional sections

if: executed when its condition is true

else if: executed if all previous chained conditionals weren't executed, and its condition is true

else: executed if all previous chained conditionals weren't executed

parse if: a special case of 'if' condition that its code will not be parsed if the condition is not true

else parse if: another special case of 'else if' condition that its code will not be parsed if all previous chained conditionals weren't executed, and its condition is true

else
else [parse] if <.+>
else [parse] if (any|at least one [of])
else [parse] if [all]
[parse] if (any|at least one [of])
[parse] if [all]
[parse] if <.+>
then [run]
implicit:<.+>
Since
1.0

Config

New
Type

A configuration (or code) loaded by Skript, such as the config.sk or aliases.

Configs can be reloaded or navigated to find options.

Since
2.10

Config (Experimental)

New
Expression

The Skript config.

This can be reloaded, or navigated to retrieve options.

[the] [skript] config
Since
2.10

Connect

New
Effect

Connect a player to a server running on your proxy, or any server supporting transfers. Read below for more information.

If the server is running Minecraft 1.20.5 or above, you may specify an IP and Port to transfer a player over to that server.

When transferring players using an IP, the transfer will not complete if the `accepts-transfers` option isn't enabled in `server.properties` for the server specified.

If the port is not provided, it will default to `25565`.

connect %players% to [proxy|bungeecord] [server] %text%
send %players% to [proxy|bungeecord] server %text%
transfer %players% to server %text% [on port %number%]
Since
2.3, 2.10 (transfer)

Console

Expression

Represents the server's console which can receive messages and execute commands

[the] (console|server)
Since
1.3.1

Consume Boosting Firework

New
Effect

Prevent the firework used in an 'elytra boost' event to be consumed.

(prevent|disallow) [the] (boosting|used) firework from being consumed
allow [the] (boosting|used) firework to be consumed
Since
2.10
Requirements
Paper

Contains

Condition

Checks whether an inventory contains an item, a text contains another piece of text, a container contains something, or a list (e.g. {list variable::*} or 'drops') contains another object.

%inventories% (has|have) %item types% [in [(the[ir]|his|her|its)] inventory]
%inventories% (doesn't|does not|do not|don't) have %item types% [in [(the[ir]|his|her|its)] inventory]
%inventories/texts/objects% contain[s] %item types/texts/objects%
%inventories/texts/objects% (doesn't|does not|do not|don't) contain %item types/texts/objects%
Since
1.0

Continue

Effect

Moves the loop to the next iteration. You may also continue an outer loop from an inner one. The loops are labelled from 1 until the current loop, starting with the outermost one.

continue [this loop|[the] [current] loop]
continue [the] <-?\d+(_\d+)*>(st|nd|rd|th) loop
Since
2.2-dev37, 2.7 (while loops), 2.8.0 (outer loops)

Cooldown Time/Remaining Time/Elapsed Time/Last Usage/Bypass Permission

Expression

Only usable in command events. Represents the cooldown time, the remaining time, the elapsed time,

the last usage date, or the cooldown bypass permission.

[the] remaining [time] [of [the] (cooldown|wait) [(of|for) [the] [current] command]]
[the] elapsed [time] [of [the] (cooldown|wait) [(of|for) [the] [current] command]]
[the] ((cooldown|wait) time|[wait] time of [the] (cooldown|wait) [(of|for) [the] [current] command])
[the] last usage [date] [of [the] (cooldown|wait) [(of|for) [the] [current] command]]
[the] [cooldown] bypass perm[ission] [of [the] (cooldown|wait) [(of|for) [the] [current] command]]
Since
2.2-dev33

Coordinate

Expression

Represents a given coordinate of a location.

[the] (x|y|z)(-| )(coord[inate]|pos[ition]|loc[ation])[s] of %locations%
%locations%'[s] (x|y|z)(-| )(coord[inate]|pos[ition]|loc[ation])[s]
Since
1.4.3

Copy Into Variable

Effect

Copies objects into a variable. When copying a list over to another list, the source list and its sublists are also copied over.

Note: Copying a value into a variable/list will overwrite the existing data.

copy %~objects% [in]to %~objects%
Since
2.8.0

cos

Function

The cosine function. This is basically the sine shifted by 90°, i.e. cos(a) = sin(a + 90°), for any number a. Uses degrees, not radians.

cos(n: number)
Since
2.2
Returns
Number

Create Loot Context

New
Expression

Create a loot context.

[a] loot context %direction% %location%
Since
2.10

Creature/Entity/Player/Projectile/Villager/Powered Creeper/etc.

Expression

The entity involved in an event (an entity is a player, a creature or an inanimate object like ignited TNT, a dropped item or an arrow).

You can use the specific type of the entity that's involved in the event, e.g. in a 'death of a creeper' event you can use 'the creeper' instead of 'the entity'.

[the] [event-]<.+>
Since
1.0

Cursor Slot

Expression

The item which the player has on their inventory cursor. This slot is always empty if player has no inventory open.

[the] cursor slot of %players%
%players%'[s] cursor slot
Since
2.2-dev17

Custom Chest Inventory

Expression

Returns a chest inventory with the given amount of rows and the name. Use the open inventory effect to open it.

[a] [new] chest inventory (named|with name) %text% [with %number% row[s]]
[a] [new] chest inventory with %number% row[s] [(named|with name) %text%]
Since
2.2-dev34, 2.8.0 (chat format)
Requirements
Paper 1.16+ (chat format)

Custom Model Data

Expression

Get/set the CustomModelData tag for an item. (Value is an integer between 0 and 99999999)

[the] [custom] model data of %item types%
%item types%'[s] [custom] model data
Since
2.5
Requirements
1.14+

Damage

Expression

How much damage is done in a entity/vehicle/item damage events.

For entity damage events, possibly ignoring armour, criticals and/or enchantments (remember that in Skript '1' is one full heart, not half a heart).

For items, it's the amount of durability damage the item will be taking.

[the] damage
Since
1.3.5, 2.8.0 (item damage event)
Supported events
Damage, Vehicle Damage, Item Damage

Damage Cause

Type

The cause/type of a damage event, e.g. lava, fall, fire, drowning, explosion, poison, etc.

Please note that support for this type is very rudimentary, e.g. lava, fire and burning, as well as projectile and attack are considered different types.

sweep attack, thorns, the void, magma, a lightning, drowning, dragonfire, an attack, drown, an entity attack, melt, freeze, falling block, contact, fire, campfire, an entity explosion, lightning, a fall, entity explosion, void, a lightning strike, suffocation, suicide, wither effect, a plugin, lightning strike, entity attack, a potion, a wither, sweeping, melting, a falling block, unknown, starvation, lava, fall, hot floor, attack, a block explosion, dryout, burn, hitting wall while flying, potion, world border, flying into a wall, cramming, poison, sonic boom, suffocate, custom, kill, killed, a fire, burning, a projectile, plugin, wither potion effect, block explosion, projectile, wither, dragon's breath
Since
2.0

Damage Cause

Condition

Tests what kind of damage caused a damage event. Refer to the Damage Cause type for a list of all possible causes.

[the] damage (was|is|has)[n('|o)t] [been] (caused|done|made) by %damage cause%
Since
2.0

Damage Cause

Expression

The damage cause of a damage event. Please click on the link for more information.

[the] damage (cause|type)
Since
2.0

Damage Value/Durability

Expression

The damage value/durability of an item.

[the] (damage[s] [value[s]]|durabilit(y|ies)) of %item types/item stacks/slots%
%item types/item stacks/slots%'[s] (damage[s] [value[s]]|durabilit(y|ies))
Since
1.2, 2.7 (durability reversed)

Damage/Heal/Repair

New
Effect

Damage, heal, or repair an entity or item.

Servers running Spigot 1.20.4+ can optionally choose to specify a fake damage cause.

damage %living entities/item types/slots% by %number% [heart[s]] [with [fake] [damage] cause %damage cause%]
heal %living entities% [by %number% [heart[s]]]
repair %item types/slots% [by %number%]
Since
1.0, 2.10 (damage cause)
Requirements
Spigot 1.20.4+ (for damage cause)

Damaged Item

Expression

Directly damages an item. In MC versions 1.12.2 and lower, this can be used to apply data values to items/blocks

%item type% with (damage|data) [value] %number%
%item type% damaged by %number%
Since
2.4

date

Function

Creates a date from a year, month, and day, and optionally also from hour, minute, second and millisecond.

A time zone and DST offset can be specified as well (in minutes), if they are left out the server's time zone and DST offset are used (the created date will not retain this information).

date(year: number, month: number, day: number, hour: number = 0, minute: number = 0, second: number = 0, millisecond: number = 0, zone_offset: number = NaN, dst_offset: number = NaN)
Since
2.2
Returns
Date

Date

Type

A date is a certain point in the real world's time which can be obtained with now expression, unix date expression and date function.

See time and timespan for the other time types of Skript.

Since
1.4

Date Ago/Later

Expression

A date the specified timespan before/after another date.

%time span% (ago|in the past|before [the] [date] %date%)
%time span% (later|(from|after) [the] [date] %date%)
Since
2.2-dev33

De-queue Queue (Experimental)

New
Expression

Requires the using queues experimental feature flag to be enabled. Unrolls a queue into a regular list of values, which can be stored in a list variable. The order of the list will be the same as the order of the elements in the queue. If a list variable is set to this, it will use numerical indices. The original queue will not be changed.

(de|un)queued %queue%
unrolled %queue%
Since
2.10 (experimental)

Default Value

Expression

A shorthand expression for giving things a default value. If the first thing isn't set, the second thing will be returned.

%objects% (otherwise|?) %objects%
Since
2.2-dev36

Delay

Effect

Delays the script's execution by a given timespan. Please note that delays are not persistent, e.g. trying to create a tempban script with ban player → wait 7 days → unban player will not work if you restart your server anytime within these 7 days. You also have to be careful even when using small delays!

(wait|halt) [for] %time span%
Since
1.4

Detonate Entities

New
Effect

Immediately detonates an entity. Accepted entities are fireworks, TNT minecarts, primed TNT, wind charges and creepers.

detonate %entities%
Since
2.10

Difference

Expression

The difference between two values

Supported types include numbers, dates and times.

difference (between|of) %object% and %object%
Since
1.4

Difficulty

Type

The difficulty of a world.

normal, medium, hard, easy, peaceful
Since
2.3

Difficulty

Expression

The difficulty of a world.

[the] difficult(y|ies) of %worlds%
%worlds%'[s] difficult(y|ies)
Since
2.3

Direction

Type

A direction, e.g. north, east, behind, 5 south east, 1.3 meters to the right, etc.

Locations and some blocks also have a direction, but without a length.

Please note that directions have changed extensively in the betas and might not work perfectly. They can also not be used as command arguments.

see <a href='./expressions.html#ExprDirection'>direction (expression)</a>
Since
2.0

Direction

Expression

A helper expression for the direction type.

[%number% [(block|met(er|re))[s]] [to the]] (north[[(-| )](east|west)][(ward[(s|ly)]|er[(n|ly)])] [of]|south[[(-| )](east|west)][(ward[(s|ly)]|er[(n|ly)])] [of]|(east|west)[(ward[(s|ly)]|er[(n|ly)])] [of]|above|over|(up|down)[ward[(s|ly)]]|below|under[neath]|beneath) [%direction%]
[%number% [(block|met(er|re))[s]]] in [the] (direction|horizontal direction|facing|horizontal facing) of %entity/block% [(of|from)]
[%number% [(block|met(er|re))[s]]] in %entity/block%'[s] (direction|horizontal direction|facing|horizontal facing) [(of|from)]
[%number% [(block|met(er|re))[s]]] (in[ ]front [of]|forward[s]|behind|backwards|[to the] (right|left) [of])
[%number% [(block|met(er|re))[s]]] horizontal[ly] (in[ ]front [of]|forward[s]|behind|backwards|to the (right|left) [of])
Since
1.0 (basic), 2.0 (extended)

Display Billboard

New
Type

Represents the billboard setting of a display.

vertical pivot, horizontal, middle, horizontal pivot, center pivot, center, fixed, vertical
Since
2.10

Display Billboard

New
Expression

Returns or changes the billboard setting of displays.

This describes the axes/points around which the display can pivot.

Displays spawn with the 'fixed' billboard by default. Resetting this expression will also set it to 'fixed'.

[the] bill[ |-]board[ing] [setting] [of %displays%]
%displays%'[s] bill[ |-]board[ing] [setting]
Since
2.10

Display Brightness

New
Expression

Returns or changes the brightness override of displays.

Unmodified displays will not have a brightness override value set. Resetting or deleting this value will remove the override.

Use the 'block' or 'sky' options to get/change specific values or get both values as a list by using neither option.

NOTE: setting only one of the sky/block light overrides of a display without an existing override will set both sky and block light to the given value. Make sure to set both block and sky levels to your desired values for the best results. Likewise, you can only clear the brightness override, you cannot clear/reset the sky/block values individually.

[the] [block|sky] (light [level]|brightness) override[s] of %displays%
%displays%'[s] [block|sky] (light [level]|brightness) override[s]
Since
2.10

Display Entity

New
Type

A text, block or item display entity.

Since
2.10

Display Glow Color Override

New
Expression

Returns or changes the glowing color override of displays.

This overrides whatever color is already set for the scoreboard team of the displays.

[the] glow[ing] colo[u]r[s] override[s] [of %displays%]
%displays%'[s] glow[ing] colo[u]r[s] override[s]
Since
2.10

Display Height/Width

New
Expression

Returns or changes the height or width of displays.

The rendering culling bounding box spans horizontally width/2 from entity position, which determines the point at which the display will be frustum culled (no longer rendered because the game determines you are no longer able to see it).

If set to 0, no culling will occur on both the vertical and horizontal directions. Default is 0.0.

[the] display (height|width) [of %displays%]
%displays%'[s] display (height|width)
Since
2.10

Display Interpolation Delay/Duration

New
Expression

Returns or changes the interpolation delay/duration of displays.

Interpolation duration is the amount of time a display will take to interpolate, or shift, between its current state and a new state.

Interpolation delay is the amount of ticks before client-side interpolation will commence.Setting to 0 seconds will make it immediate.

Resetting either value will return that value to 0.

[the] interpolation (delay|duration)[s] [of %displays%]
%displays%'[s] interpolation (delay|duration)[s]
Since
2.10

Display Shadow Radius/Strength

New
Expression

Returns or changes the shadow radius/strength of displays.

[the] shadow (radius|strength) [of %displays%]
%displays%'[s] shadow (radius|strength)
Since
2.10

Display Teleport Delay/Duration

New
Expression

The teleport duration of displays is the amount of time it takes to get between locations.

0 means that updates are applied immediately.

1 means that the display entity will move from current position to the updated one over one tick.

Higher values spread the movement over multiple ticks. Max of 59 ticks.

[the] teleport[ation] duration[s] [of %displays%]
%displays%'[s] teleport[ation] duration[s]
Since
2.10
Requirements
Spigot 1.20.4+

Display Text Alignment

New
Type

Represents the text alignment setting of a text display.

middle aligned, centered, right aligned, center aligned, left aligned
Since
2.10

Display Transformation Rotation

New
Expression

Returns or changes the transformation rotation of displays.

The left rotation is applied first, with the right rotation then being applied based on the rotated axis.

[the] (left|right) [transformation] rotation [of %displays%]
%displays%'[s] (left|right) [transformation] rotation
Since
2.10

Display Transformation Scale/Translation

New
Expression

Returns or changes the transformation scale or translation of displays.

[the] (display|[display] transformation) (scale|translation) of %displays%
%displays%'[s] (display|[display] transformation) (scale|translation)
Since
2.10

Display View Range

New
Expression

Returns or changes the view range of displays.

Default value is 1.0. This value is then multiplied by 64 and the player's entity view distance setting to determine the actual range.

For example, a player with 150% entity view distance will see a block display with a view range of 1.2 at 1.2 * 64 * 150% = 115.2 blocks away.

[the] [display] view (range|radius) [of %displays%]
%displays%'[s] [display] view (range|radius)
Since
2.10

Distance

Expression

The distance between two points.

[the] distance between %location% and %location%
Since
1.0

Do If

Effect

Execute an effect if a condition is true.

<.+> if <.+>
Since
2.3

Do Respawn Anchors Work

Condition

Checks whether or not respawn anchors work in a world.

respawn anchors [do[(n't| not)]] work in %worlds%
Since
2.7
Requirements
Minecraft 1.16+

Drop

Effect

Drops one or more items.

drop %item types/experience points% [%directions% %locations%] [without velocity]
Since
1.0

Drops

Expression

Only works in death events. Holds the drops of the dying creature. Drops can be prevented by removing them with "remove ... from drops", e.g. "remove all pickaxes from the drops", or "clear drops" if you don't want any drops at all.

[the] drops
Since
1.0
Supported events
death

Drops Of Block

Expression

A list of the items that will drop when a block is broken.

[(all|the|all [of] the)] drops of %blocks% [(using|with) %item type% [(as %entity%)]]
%blocks%'s drops [(using|with) %item type% [(as %entity%)]]
Since
2.5.1
Requirements
Minecraft 1.15+ ('as %entity%')

Egg Will Hatch

Condition

Whether the egg will hatch in a Player Egg Throw event.

[the] egg (will|will not|won't) hatch
Since
2.7
Supported events
Egg Throw

Elements

Expression

The first, last, range or a random element of a set, e.g. a list variable, or a queue.

Asking for elements from a queue will also remove them from the queue, see the new queue expression for more information.

See also: random expression

[the] (first|last) element [out] of %objects%
[the] (first|last) %integer% elements [out] of %objects%
[a] random element [out] of %objects%
[the] %integer%(st|nd|rd|th) [[to] last] element [out] of %objects%
[the] elements (from|between) %integer% (to|and) %integer% [out] of %objects%
[the] (first|next|last) element (of|in) %queue%
[the] (first|last) %integer% elements (of|in) %queue%
[a] random element (of|in) %queue%
[the] %integer%(st|nd|rd|th) [[to] last] element (of|in) %queue%
[the] elements (from|between) %integer% (to|and) %integer% (of|in) %queue%
Since
2.0, 2.7 (relative to last element), 2.8.0 (range of elements)

Enable/Disable/Unload/Reload Script

New
Effect

Enables, disables, unloads, or reloads a script. Disabling a script unloads it and prepends - to its name so it will not be loaded the next time the server restarts. If the script reflection experiment is enabled: unloading a script terminates it and removes it from memory, but does not alter the file.

((enable|load)|reload|disable|unload) script [file|named] %text%
((enable|load)|reload|disable|unload) skript file %text%
((enable|load)|reload|disable|unload) %scripts%
Since
2.4, 2.10 (unloading)

Enchant Item

Expression

The enchant item in an enchant prepare event or enchant event.

It can be modified, but enchantments will still be applied in the enchant event.

[the] enchant[ed] item
Since
2.5
Supported events
enchant prepare, enchant

Enchant/Disenchant

Effect

Enchant or disenchant an existing item.

enchant %~item types% with %enchantment types%
disenchant %~item types%
Since
2.0

Enchanting Experience Cost

Expression

The cost of enchanting in an enchant event.

This is number that was displayed in the enchantment table, not the actual number of levels removed.

[the] [displayed] ([e]xp[erience]|enchanting) cost
Since
2.5
Supported events
enchant

Enchantment

Type

An enchantment, e.g. 'sharpness' or 'fortune'. Unlike enchantment type this type has no level, but you usually don't need to use this type anyway.

NOTE: Minecraft namespaces are supported, ex: 'minecraft:basalt_deltas'.

As of Minecraft 1.21 this will also support custom enchantments using namespaces, ex: 'myenchants:explosive'.

aqua affinity, bane of arthropods, binding curse, blast protection, breach, channeling, channelling, curse of binding, curse of vanishing, density, depth strider, efficiency, feather falling, fire aspect, fire protection, flame, fortune, frost walker, impaling, infinity, knockback, looting, loyalty, luck of the sea, lure, mending, multi-shot, multishot, piercing, power, projectile protection, protection, punch, quick charge, respiration, riptide, sharpness, silk touch, smite, soul speed, sweeping edge, swift sneak, thorns, unbreaking, vanishing curse, wind burst
Since
1.4.6

Enchantment Bonus

Expression

The enchantment bonus in an enchant prepare event. This represents the number of bookshelves affecting/surrounding the enchantment table.

[the] enchantment bonus
Since
2.5
Supported events
enchant prepare

Enchantment Level

Expression

The level of a particular enchantment on an item.

[the] [enchant[ment]] level[s] of %enchantments% (on|of) %item types%
[the] %enchantments% [enchant[ment]] level[s] (on|of) %item types%
%item types%'[s] %enchantments% [enchant[ment]] level[s]
%item types%'[s] [enchant[ment]] level[s] of %enchantments%
Since
2.0

Enchantment Offer

Type

The enchantmentoffer in an enchant prepare event.

Since
2.5

Enchantment Offer

Expression

The enchantment offer in enchant prepare events.

[all [of]] [the] enchant[ment] offers
enchant[ment] offer[s] %numbers%
[the] %number%(st|nd|rd|th) enchant[ment] offer
Since
2.5
Requirements
1.11 or newer
Supported events
enchant prepare

Enchantment Offer Cost

Expression

The cost of an enchantment offer. This is displayed to the right of an enchantment offer.

If the cost is changed, it will always be at least 1.

This changes how many levels are required to enchant, but does not change the number of levels removed.

To change the number of levels removed, use the enchant event.

[the] [enchant[ment]] cost of %enchantment offers%
%enchantment offers%'[s] [enchant[ment]] cost
Since
2.5
Requirements
1.11 or newer

Enchantment Type

Type

An enchantment with an optional level, e.g. 'sharpness 2' or 'fortune'.

&lt;enchantment&gt; [&lt;level&gt;]
Since
1.4.6

Ender Chest

Expression

The ender chest of a player.

[the] ender[ ]chest[s] of %players%
%players%'[s] ender[ ]chest[s]
Since
2.0

Enforce Whitelist

Effect

Enforces or un-enforce a server's whitelist.

All non-whitelisted players will be kicked upon enforcing the whitelist.

[un]enforce [the] [server] white[ ]list
Since
2.9.0
Requirements
MC 1.17+

Entities

New
Expression

All entities in all worlds, in a specific world, in a chunk, in a radius around a certain location or within two locations. e.g. all players, all creepers in the player's world, or players in radius 100 of the player.

[(all [[of] the]|the)] %*entity types% [(in|of) ([world[s]] %worlds%|%chunks%)]
[(all [[of] the]|the)] entities of type[s] %entity types% [(in|of) ([world[s]] %worlds%|%chunks%)]
[(all [[of] the]|the)] %*entity types% (within|[with]in radius) %number% [(block[s]|met(er|re)[s])] (of|around) %location%
[(all [[of] the]|the)] entities of type[s] %entity types% in radius %number% (of|around) %location%
[(all [[of] the]|the)] %*entity types% within %location% and %location%
[(all [[of] the]|the)] entities of type[s] %entity types% within %location% and %location%
Since
1.2.1, 2.5 (chunks), 2.10 (within)

Entity

Type

An entity is something in a world that's not a block, e.g. a player, a skeleton, or a zombie, but also projectiles like arrows, fireballs or thrown potions, or special entities like dropped items, falling blocks or paintings.

player, op, wolf, tamed ocelot, powered creeper, zombie, unsaddled pig, fireball, arrow, dropped item, item frame, etc.
Since
1.0

Entity AI

Expression

Returns whether an entity has AI.

[the] (ai|artificial intelligence) of %living entities%
%living entities%'[s] (ai|artificial intelligence)
Since
2.5

Entity Attribute

Expression

The numerical value of an entity's particular attribute.

Note that the movement speed attribute cannot be reliably used for players. For that purpose, use the speed expression instead.

Resetting an entity's attribute is only available in Minecraft 1.11 and above.

[the] %attribute type% [((total|final|modified))] attribute [value] of %entities%
%entities%'[s] %attribute type% [((total|final|modified))] attribute [value]
Since
2.5, 2.6.1 (final attribute value)

Entity Fire Burn Duration

New
Expression

How much time an entity will be burning for.

[the] [max[imum]] (burn[ing]|fire) (time|duration) of %entities%
%entities%'[s] [max[imum]] (burn[ing]|fire) (time|duration)
Since
2.7, 2.10 (maximum)

Entity is in Liquid

Condition

Checks whether an entity is in rain, lava, water or a bubble column.

%entities% (is|are) in (water|lava|[a] bubble[ ]column|rain)
%entities% (isn't|is not|aren't|are not) in (water|lava|[a] bubble[ ]column|rain)
Since
2.6.1
Requirements
Minecraft 1.16+ (in water), Paper 1.16+ (in rain, lava and bubble column)

Entity Is Sheared

Condition

Checks whether entities are sheared. This condition only works on cows, sheep and snowmen for versions below 1.19.4.

%living entities% (is|are) (sheared|shorn)
%living entities% (isn't|is not|aren't|are not) (sheared|shorn)
Since
2.8.0
Requirements
MC 1.13+ (cows, sheep & snowmen), Paper 1.19.4+ (all shearable entities)

Entity is Wet

Condition

Checks whether an entity is wet or not (in water, rain or a bubble column).

%entities% (is|are) wet
%entities% (isn't|is not|aren't|are not) wet
Since
2.6.1
Requirements
Paper 1.16+

Entity Owner

Expression

The owner of a tameable entity, such as a horse or wolf.

[the] (owner|tamer) of %living entities%
%living entities%'[s] (owner|tamer)
Since
2.5

Entity Potion Cause

New
Type

Represents the cause of the action of a potion effect on an entity, e.g. arrow, command

patrol captain, axolotl, death, removal by resurrection, beacon effect, potion drunk, illusion, unknown, drinking potion, expired, pillager captain, attack, villager trade, spawned spider, wither rose infliction, conversion, enter area effect cloud, conduit effect, command, food, drinking milk, plugin, converted, spider spawn, splash potion, warden, expiration, potion splash, dolphin boost, arrow infliction, turtle helmet effect
Since
2.10

Entity Snapshot

New
Type

Represents a snapshot of an entity's data.

This includes all of the data associated with an entity (its name, health, attributes, etc.), at the time this expression is used. Essentially, these are a way to create templates for entities.

Individual attributes of a snapshot cannot be modified or retrieved.

Since
2.10
Requirements
Minecraft 1.20.2+

Entity Snapshot

New
Expression

Returns the entity snapshot of a provided entity, which includes all the data associated with it (name, health, attributes, etc.) at the time this expression is used.

Individual attributes of a snapshot cannot be modified or retrieved.

[the] entity snapshot of %entities/entity types%
%entities/entity types%'[s] entity snapshot
Since
2.10
Requirements
Minecraft 1.20.2+

Entity Sound

New
Expression

Gets the sound that a given entity will make in a specific scenario.

[the] (damage|hurt) sound[s] of %living entities%
%living entities%'[s] (damage|hurt) sound[s]
[the] death sound[s] of %living entities%
%living entities%'[s] death sound[s]
[the] [(tall|high)|(low|normal)] fall damage sound[s] [from [[a] height [of]] %number%] of %living entities%
%living entities%'[s] [(tall|high)|(low|normal)] fall [damage] sound[s] [from [[a] height [of]] %number%]
[the] swim[ming] sound[s] of %living entities%
%living entities%'[s] swim[ming] sound[s]
[the] [(fast|speedy)] splash sound[s] of %living entities%
%living entities%'[s] [(fast|speedy)] splash sound[s]
[the] eat[ing] sound[s] of %living entities% [(with|using|[while] eating [a]) %item type%]
%living entities%'[s] eat[ing] sound[s]
[the] drink[ing] sound[s] of %living entities% [(with|using|[while] drinking [a]) %item type%]
%living entities%'[s] drink[ing] sound[s]
[the] ambient sound[s] of %living entities%
%living entities%'[s] ambient sound[s]
Since
2.10
Requirements
Spigot 1.19.2+

Entity Type

Type

The type of an entity, e.g. player, wolf, powered creeper, etc.

<i>Detailed usage will be added eventually</i>
Since
1.3

Entity Type with Amount

Type

An entity type with an amount, e.g. '2 zombies'. I might remove this type in the future and make a more general 'type' type, i.e. a type that has a number and a type.

&lt;<a href='#number'>number</a>&gt; &lt;entity type&gt;
Since
1.3

Entity Visibility

New
Effect

Change visibility of the given entities for the given players.

If no players are given, will hide the entities from all online players.

When reveal is used in combination of the hidden players expression and the viewers are not specified, this will default it to the given player in the hidden players expression.

Note: all previously hidden entities (including players) will be visible when a player leaves and rejoins.

hide %entities% [(from|for) %players%]
reveal %entities% [(to|for|from) %players%]
Since
2.3, 2.10 (entities)
Requirements
Minecraft 1.19+ (entities)

Equip

New
Effect

Equips or unequips an entity with the given itemtypes (usually armor).

This effect will replace any armor that the entity is already wearing.

equip [%living entities%] with %item types%
make %living entities% wear %item types%
unequip %item types% [from %living entities%]
unequip %living entities%'[s] (armo[u]r|equipment)
Since
1.0, 2.7 (multiple entities, unequip), 2.10 (wolves)

Event Cancelled

Condition

Checks whether or not the event is cancelled.

[the] event is cancel[l]ed
[the] event (is not|isn't) cancel[l]ed
Since
2.2-dev36

Executable

New
Type

Something that can be executed (run) and may accept arguments, e.g. a function.

This may also return a result.

Since
2.10

Exhaustion

Expression

The exhaustion of a player. This is mainly used to determine the rate of hunger depletion.

[the] exhaustion of %players%
%players%'[s] exhaustion
Since
2.2-dev35

Exists/Is Set

Condition

Checks whether a given expression or variable is set.

%~objects% (exist[s]|(is|are) set)
%~objects% (do[es](n't| not) exist|(is|are)(n't| not) set)
Since
1.2

Exit

Effect

Exits a given amount of loops and conditionals, or the entire trigger.

(exit|stop) [trigger]
(exit|stop) [1|a|the|this] (section|loop|conditional)
(exit|stop) <-?\d+(_\d+)*> (section|loop|conditional)s
(exit|stop) all (section|loop|conditional)s
Since
unknown (before 2.1)

exp

Function

The exponential function. You probably don't need this if you don't know what this is.

exp(n: number)
Since
2.2
Returns
Number

Experience

Type

Experience points. Please note that Bukkit only allows to give XP, but not remove XP from players. You can however change a player's level and level progress freely.

[&lt;number&gt;] ([e]xp|experience [point[s]])
Since
2.0

Experience

New
Expression

How much experience was spawned in an experience spawn or block break event. Can be changed.

[the] [(spawned|dropped)] [e]xp[erience] [orb[s]]
Since
2.1, 2.5.3 (block break event), 2.7 (experience change event), 2.10 (breeding, fishing)
Supported events
experience spawn, break / mine, experience change, entity breeding

Experience Cooldown Change Reason

New
Type

Represents a change reason of an experience cooldown change event.

plugin, pickup orb, orb pickup
Since
2.10

Experience Cooldown Change Reason

New
Expression

The experience change reason within an experience cooldown change event.

[the] (experience|[e]xp) cooldown change (reason|cause|type)
Since
2.10

Experience Pickup Cooldown

New
Expression

The experience cooldown of a player.

Experience cooldown is how long until a player can pick up another orb of experience.

The cooldown of a player must be 0 to pick up another orb of experience.

[the] (experience|[e]xp) [pickup|collection] cooldown of %players%
%players%'[s] (experience|[e]xp) [pickup|collection] cooldown
Since
2.10

Explode Creeper

Effect

Starts the explosion process of a creeper or instantly explodes it.

instantly explode [creeper[s]] %living entities%
explode [creeper[s]] %living entities% instantly
ignite creeper[s] %living entities%
start (ignition|explosion) [process] of [creeper[s]] %living entities%
stop (ignition|explosion) [process] of [creeper[s]] %living entities%
Since
2.5
Requirements
Paper 1.13 or newer/Spigot 1.14 or newer. Ignition can be stopped on Paper 1.13 or newer.

Exploded Blocks

Expression

Get all the blocks that were destroyed in an explode event. Supports add/remove/set/clear/delete blocks.

[the] exploded blocks
Since
2.5, 2.8.6 (modify blocks)
Supported events
explode

Explosion

Effect

Creates an explosion of a given force. The Minecraft Wiki has an article on explosions which lists the explosion forces of TNT, creepers, etc.

Hint: use a force of 0 to create a fake explosion that does no damage whatsoever, or use the explosion effect introduced in Skript 2.0.

Starting with Bukkit 1.4.5 and Skript 2.0 you can use safe explosions which will damage entities but won't destroy any blocks.

[(create|make)] [an] explosion (of|with) (force|strength|power) %number% [%directions% %locations%] [with fire]
[(create|make)] [a] safe explosion (of|with) (force|strength|power) %number% [%directions% %locations%]
[(create|make)] [a] fake explosion [%directions% %locations%]
[(create|make)] [an] explosion[ ]effect [%directions% %locations%]
Since
1.0

Explosion Block Yield

Expression

The percentage of exploded blocks dropped in an explosion event.

When changing the yield, a value greater than 1 will function the same as using 1.

Attempting to change the yield to a value less than 0 will have no effect.

[the] [explosion['s]] block (yield|amount)
[the] percentage of blocks dropped
Since
2.5
Supported events
explosion

Explosion Yield

Expression

The yield of the explosion in an explosion prime event. This is how big the explosion is.

When changing the yield, values less than 0 will be ignored.

Read this wiki page for more information

[the] explosion (yield|radius|size)
[the] (yield|radius|size) of [the] explosion
Since
2.5
Supported events
explosion prime

Explosive Yield

Expression

The yield of an explosive (creeper, primed tnt, fireball, etc.). This is how big of an explosion is caused by the entity.

Read this wiki page for more information

[the] explosive (yield|radius|size) of %entities%
%entities%'[s] explosive (yield|radius|size)
Since
2.5
Requirements
Minecraft 1.12 or newer for creepers

Facing

Expression

The facing of an entity or block, i.e. exactly north, south, east, west, up or down (unlike direction which is the exact direction, e.g. '0.5 south and 0.7 east')

[the] [(horizontal)] facing of %living entities/blocks%
%living entities/blocks%'[s] [(horizontal)] facing
Since
1.4

Fall Distance

Expression

The distance an entity has fallen for.

[the] fall[en] (distance|height) of %entities%
%entities%'[s] fall[en] (distance|height)
Since
2.5

Feed

Effect

Feeds the specified players.

feed [the] %players% [by %number% [beef[s]]]
Since
2.2-dev34

Fertilized Blocks

Expression

The blocks fertilized in block fertilize events.

[all] [the] fertilized blocks
Since
2.5
Requirements
Minecraft 1.13 or newer
Supported events
block fertilize

Filter

New
Expression

Filters a list based on a condition.

For example, if you ran 'broadcast "something" and "something else" where [string input is "something"]',

only "something" would be broadcast as it is the only string that matched the condition.

%objects% (where|that match) \[<.+>\]
%objects% (where|that match) \(<.+>\)
Since
2.2-dev36, 2.10 (parenthesis pattern)

Filter

New
Section

Filters a variable list based on the supplied conditions. Unlike the filter expression, this effect maintains the indices of the filtered list.

It also supports filtering based on meeting any of the given criteria, rather than all, like multi-line if statements.

filter %~objects% to match [any|all]
Since
2.10

Final Damage

Expression

How much damage is done in a damage event, considering all types of damage reduction. Can NOT be changed.

[the] final damage
Since
2.2-dev19
Supported events
damage

Firework Effect

Type

A configuration of effects that defines the firework when exploded

which can be used in the launch firework effect.

See the firework effect expression for detailed patterns.

See <a href='/classes.html#FireworkType'>Firework Types</a>
Since
2.4

Firework Effect

Expression

Represents a 'firework effect' which can be used in the launch firework effect.

[(flickering|trailing|flickering trailing|trailing flickering)] %firework type% [firework [effect]] colo[u]red %colors%
[(flickering|trailing|flickering trailing|trailing flickering)] %firework type% [firework [effect]] colo[u]red %colors% fad(e|ing) [to] %colors%
Since
2.4

Firework Type

Type

The type of a fireworkeffect.

small, ball, star shaped, large, star, creeper face, small ball, large ball, burst, ball large, creeper
Since
2.4

Fishing Approach Angle

New
Expression

Returns the angle at which the fish will approach the fishing hook, after the wait time.

The angle is in degrees, with 0 being positive Z, 90 being negative X, 180 being negative Z, and 270 being positive X.

By default, returns a value between 0 and 360 degrees.

(min[imum]|max[imum]) fish[ing] approach[ing] angle
Since
2.10
Supported events
Fishing

Fishing Bite Time

New
Expression

Returns the time it takes a fish to bite the fishing hook, after it started approaching the hook.

May return a timespan of 0 seconds. If modifying the value, it should be at least 1 tick.

fish[ing] bit(e|ing) [wait] time
Since
2.10
Requirements
Paper 1.20.6
Supported events
Fishing

Fishing Hook

New
Expression

The fishing hook in a fishing event.

[the] fish[ing] (hook|bobber)
Since
2.10
Supported events
Fishing

Fishing Hooked Entity

New
Expression

Returns the hooked entity in the hooked event.

hook[ed] entity
Since
2.10
Supported events
Fishing

Fishing Lure Applied

New
Condition

Checks if the lure enchantment is applied to the current fishing event.

lure enchantment bonus is (applied|active)
lure enchantment bonus is(n't| not) (applied|active)
Since
2.10
Supported events
Fishing

Fishing Wait Time

New
Expression

Returns the minimum and/or maximum waiting time of the fishing hook.

Default minimum value is 5 seconds and maximum is 30 seconds, before lure is applied.

(min[imum]|max[imum]) fish[ing] wait[ing] time
Since
2.10
Supported events
Fishing

Flight Mode

Expression

Whether the player(s) are allowed to fly. Use Make Fly effect to force player(s) to fly.

[the] fl(y[ing]|ight) (mode|state) of %players%
%players%'[s] fl(y[ing]|ight) (mode|state)
Since
2.2-dev34

floor

Function

Rounds a number down, i.e. returns the closest integer smaller than or equal to the argument.

floor(n: number)
Since
2.2
Returns

Food Level

Expression

The food level of a player from 0 to 10. Has several aliases: food/hunger level/meter/bar.

[the] (food|hunger)[[ ](level|met(er|re)|bar)] [of %players%]
%players%'[s] (food|hunger)[[ ](level|met(er|re)|bar)]
Since
1.0

For Each Loop (Experimental)

New
Section

A specialised loop section run for each element in a list. Unlike the basic loop, this is designed for extracting the key & value from pairs. The loop element's key/index and value can be stored in a variable for convenience. When looping a simple (non-indexed) set of values, e.g. all players, the index will be the loop counter number.

(for [each]|loop) [value] %~object% in %objects%
(for [each]|loop) (key|index) %~object% in %objects%
(for [each]|loop) [key|index] %~object%(,| and) [value] %~object% in %objects%
Since
2.10

Force Attack

Effect

Makes a living entity attack an entity with a melee attack.

make %living entities% attack %entity%
force %living entities% to attack %entity%
Since
2.5.1
Requirements
Minecraft 1.15.2+

Force Enchantment Glint

New
Effect

Forces the items to glint or not, or removes its existing enchantment glint enforcement.

(force|make) %item types% [to] [start] glint[ing]
(force|make) %item types% [to] (not|stop) glint[ing]
(clear|delete|reset) [the] enchantment glint override of %item types%
(clear|delete|reset) %item types%'s enchantment glint override
Since
2.10
Requirements
Spigot 1.20.5+

Force Respawn

Effect

Forces player(s) to respawn if they are dead. If this is called without delay from death event, one tick is waited before respawn attempt.

force %players% to respawn
Since
2.2-dev21

formatNumber

New
Function

Converts numbers to human-readable format. By default, '###,###' (e.g. '123,456,789') will be used for whole numbers and '###,###.##' (e.g. '123,456,789.00) will be used for decimal numbers. A hashtag '#' represents a digit, a comma ',' is used to separate numbers, and a period '.' is used for decimals.

Will return none if the format is invalid.

For further reference, see this article.

formatNumber(number: number, format: string = )
Since
2.10
Returns
Text

Formatted Date

Expression

Converts date to human-readable text format. By default, 'yyyy-MM-dd HH:mm:ss z' (e.g. '2018-03-30 16:03:12 +01') will be used. For reference, see this Wikipedia article.

%dates% formatted [human-readable] [(with|as) %text%]
[human-readable] formatted %dates% [(with|as) %text%]
Since
2.2-dev31, 2.7 (support variables in format)

Former/Future State

Expression

Represents the value of an expression before an event happened or the value it will have directly after the event, e.g. the old or new level respectively in a level change event.

Note: The past, future and present states of an expression are sometimes called 'time states' of an expression.

Note 2: If you don't specify whether to use the past or future state of an expression that has different values, its default value will be used which is usually the value after the event.

[the] (former|past|old) [state] [of] %~objects%
%~objects% before [the event]
[the] (future|to-be|new) [state] [of] %~objects%
%~objects%(-to-be| after[(wards| the event)])
Since
1.1

Free / Max / Total Memory

Expression

The free, max or total memory of the server in Megabytes.

[the] [server] (free|max[imum]|total) (memory|ram)
Since
2.8.0

Freeze Time

Expression

How much time an entity has been in powdered snow for.

[the] freeze time of %entities%
%entities%'[s] freeze time
Since
2.7

Function

New
Type

A function loaded by Skript.

This can be executed (with arguments) and may return a result.

Since
2.10

Function

Structure

Functions are structures that can be executed with arguments/parameters to run code.

They can also return a value to the trigger that is executing the function.

Note that local functions come before global functions execution

[local] function <.+>
Since
2.2, 2.7 (local functions)

Function (Experimental)

New
Expression

Obtain a function by name, which can be executed.

[the|a] function [named] %text% [(in|from) %script%]
[the] functions [named] %texts% [(in|from) %script%]
[all [[of] the]|the] functions (in|from) %script%
Since
2.10

Furnace Event Items

New
Expression

Represents the different items in furnace events.

Only 'smelting item' can be changed.

[the] (smelted item|result[ item])
[the] extracted item[s]
[the] smelting item
[the] burned (fuel|item)
Since
2.10
Supported events
smelt, fuel burn, smelting start, furnace extract

Furnace Slot

Expression

A slot of a furnace, i.e. either the ore, fuel or result slot.

[the] (ore|input) slot[s] [of %blocks%]
%blocks%'[s] (ore|input) slot[s]
[the] fuel slot[s] [of %blocks%]
%blocks%'[s] fuel slot[s]
[the] (result|output) slot[s] [of %blocks%]
%blocks%'[s] (result|output) slot[s]
Since
1.0, 2.8.0 (syntax rework)
Supported events
smelt, fuel burn

Furnace Times

New
Expression

The cook time, total cook time, and burn time of a furnace. Can be changed.

  • cook time: The amount of time an item has been smelting for.
  • total cook time: The amount of time required to finish smelting an item.
  • burn time: The amount of time left for the current fuel until consumption of another fuel item.

[the] [furnace] cook[ing] time [of %blocks%]
%blocks%'[s]cook[ing] time
[the] [furnace] total cook[ing] time [of %blocks%]
%blocks%'[s]total cook[ing] time
[the] [furnace] fuel burn[ing] time [of %blocks%]
%blocks%'[s]fuel burn[ing] time
Since
2.10

Game Mode

Type

The game modes survival, creative, adventure and spectator.

adventure, survival, spectator, creative
Since
1.0

Game Mode

Expression

The gamemode of a player. (Gamemodes)

[the] game[ ]mode of %players%
%players%'[s] game[ ]mode
Since
1.0

Gamerule

Type

A gamerule

tntExplosionDropDecay, globalSoundEvents, enderPearlsVanishOnDeath, doFireTick, maxCommandChainLength, doVinesSpread, disableElytraMovementCheck, lavaSourceConversion, commandBlockOutput, forgiveDeadPlayers, playersNetherPortalCreativeDelay, doMobSpawning, maxEntityCramming, universalAnger, playersSleepingPercentage, snowAccumulationHeight, doImmediateRespawn, blockExplosionDropDecay, naturalRegeneration, doMobLoot, fallDamage, doEntityDrops, randomTickSpeed, playersNetherPortalDefaultDelay, spawnRadius, freezeDamage, sendCommandFeedback, doWardenSpawning, fireDamage, reducedDebugInfo, waterSourceConversion, projectilesCanBreakBlocks, announceAdvancements, drowningDamage, spawnChunkRadius, disableRaids, doWeatherCycle, mobExplosionDropDecay, doDaylightCycle, showDeathMessages, doTileDrops, doInsomnia, keepInventory, disablePlayerMovementCheck, doLimitedCrafting, mobGriefing, doTraderSpawning, commandModificationBlockLimit, logAdminCommands, minecartMaxSpeed, spectatorsGenerateChunks, doPatrolSpawning, maxCommandForkCount
Since
2.5
Requirements
Minecraft 1.13 or newer

Gamerule Value

Type

A wrapper for the value of a gamerule for a world.

Since
2.5

Gamerule Value

Expression

The gamerule value of a world.

[the] gamerule %gamerule% of %worlds%
Since
2.5
Requirements
Minecraft 1.13+

Gene

Type

Represents a Panda's main or hidden gene. See genetics for more info.

normal, lazy, happy, worried, worrisome, aggressive, brown, brownish, savage, playful, wild, weak
Since
2.4
Requirements
Minecraft 1.14 or newer

Generate Loot

New
Effect

Generates the loot in the specified inventories from a loot table using a loot context. Not specifying a loot context will use a loot context with a location at the world's origin.

Note that if the inventory is full, it will cause warnings in the console due to over-filling the inventory.

generate [the] loot (of|using) %loot table% [(with|using) %loot context%] in %inventories%
Since
2.10

Gliding State

Expression

Sets of gets gliding state of player. It allows you to set gliding state of entity even if they do not have an Elytra equipped.

[the] (gliding|glider) [state] of %living entities%
%living entities%'[s] (gliding|glider) [state]
Since
2.2-dev21

Glowing

Expression

Indicates if targeted entity is glowing (new 1.9 effect) or not. Glowing entities can be seen through walls.

[the] glowing of %entities%
%entities%'[s] glowing
Since
2.2-dev18

Gravity

Expression

If entity is affected by gravity or not, i.e. if it has Minecraft 1.10+ NoGravity flag.

[the] gravity of %entities%
%entities%'[s] gravity
Since
2.2-dev21

Handedness

Effect

Make mobs left or right-handed. This does not affect players.

make %living entities% (left|right)( |-)handed
Since
2.8.0
Requirements
Paper 1.17.1+

Hanging Entity/Remover

Expression

Returns the hanging entity or remover in hanging break and place events.

[the] hanging (entity|remover)
Since
2.6.2

Has AI

Condition

Checks whether an entity has AI.

%living entities% (has|have) (ai|artificial intelligence)
%living entities% (doesn't|does not|do not|don't) have (ai|artificial intelligence)
Since
2.5

Has Chat Filtering

New
Condition

Checks whether a player has chat filtering enabled.

%players% (has|have) (chat|text) filtering (on|enabled)
%players% (doesn't|does not|do not|don't) have (chat|text) filtering (on|enabled)
Since
2.10
Requirements
Paper

Has Client Weather

Condition

Checks whether the given players have a custom client weather

%players% (has|have) [a] (client|custom) weather [set]
%players% (doesn't|does not|do not|don't) have [a] (client|custom) weather [set]
Since
2.3

Has Custom Model Data

Condition

Check if an item has a custom model data tag

%item types% (has|have) [custom] model data
%item types% (doesn't|does not|do not|don't) have [custom] model data
Since
2.5
Requirements
1.14+

Has Glowing Text

Condition

Checks whether a sign (either a block or an item) has glowing text

%blocks/item types% (has|have) glowing text
%blocks/item types% (doesn't|does not|do not|don't) have glowing text
Since
2.8.0

Has Item Cooldown

Condition

Check whether a cooldown is active on the specified material for a specific player.

%players% (has|have) [([an] item|a)] cooldown (on|for) %item types%
%players% (has|have) %item types% on [(item|a)] cooldown
%players% (doesn't|does not|do not|don't) have [([an] item|a)] cooldown (on|for) %item types%
%players% (doesn't|does not|do not|don't) have %item types% on [(item|a)] cooldown
Since
2.8.0

Has Item Tooltips

Condition

Whether the entire or additional tooltip of an item is shown or hidden.

The 'entire tooltip' is what shows to the player when they hover an item (i.e. name, lore, etc.).

The 'additional tooltip' hides certain information from certain items (potions, maps, books, fireworks, and banners).

[the] [entire|additional] tool[ ]tip[s] of %item types% (is|are) (shown|hidden)
[the] [entire|additional] tool[ ]tip[s] of %item types% (isn't|is not|aren't|are not) (shown|hidden)
%item types%'[s] [entire|additional] tool[ ]tip[s] (is|are) (shown|hidden)
%item types%'[s] [entire|additional] tool[ ]tip[s] (isn't|is not|aren't|are not) (shown|hidden)
Since
2.9.0
Requirements
Spigot 1.20.5+

Has Line of Sight

Condition

Checks whether living entities have an unobstructed line of sight to other entities or locations.

%living entities% (has|have) [a] [direct] line of sight to %entities/locations%
%living entities% does(n't| not) have [a] [direct] line of sight to %entities/locations%
%living entities% (has|have) no [direct] line of sight to %entities/locations%
Since
2.8.0

Has Loot Table

New
Condition

Checks whether an entity or block has a loot table. The loot tables of chests will be deleted when the chest is opened or broken.

%blocks/entities% (has|have) [a] loot[ ]table
%blocks/entities% (doesn't|does not|do not|don't) have [a] loot[ ]table
Since
2.10

Has Metadata

Condition

Checks whether a metadata holder has a metadata tag.

%metadata holders% (has|have) metadata [(value|tag)[s]] %texts%
%metadata holders% (doesn't|does not|do not|don't) have metadata [(value|tag)[s]] %texts%
Since
2.2-dev36

Has Permission

Condition

Test whether a player has a certain permission.

%command senders% (has|have) [the] permission[s] %texts%
%command senders% (doesn't|does not|do not|don't) have [the] permission[s] %texts%
Since
1.0

Has Played Before

Condition

Checks whether a player has played on this server before. You can also use on first join if you want to make triggers for new players.

%offline players% [(has|have|did)] [already] play[ed] [on (this|the) server] (before|already)
%offline players% (has not|hasn't|have not|haven't|did not|didn't) [(already|yet)] play[ed] [on (this|the) server] (before|already|yet)
Since
1.4, 2.7 (multiple players)

Has Potion

Condition

Checks whether the given living entities have specific potion effects.

%living entities% (has|have) potion[s] [effect[s]] %potion effect types%
%living entities% (doesn't|does not|do not|don't) have potion[s] [effect[s]] %potion effect types%
Since
2.6.1

Has Resource Pack

Condition

Checks whether the given players have a server resource pack loaded. Please note that this can't detect player's own resource pack, only the resource pack that sent by the server.

%players% (has|have) [a] resource pack [(loaded|installed)]
%players% (doesn't|does not|do not|don't) have [a] resource pack [(loaded|installed)]
Since
2.4
Requirements
Paper 1.9 or newer

Has Scoreboard Tag

Condition

Checks whether the given entities has the given scoreboard tags.

%entities% (has|have) [the] score[ ]board tag[s] %texts%
%entities% (doesn't|does not|do not|don't) have [the] score[ ]board tag[s] %texts%
Since
2.3

Hash

Expression

Hashes the given text using the MD5 or SHA-256 algorithms. Each algorithm is suitable for different use cases.

MD5 is provided mostly for backwards compatibility, as it is outdated and not secure.

SHA-256 is more secure, and can used to hash somewhat confidental data like IP addresses and even passwords.

It is not that secure out of the box, so please consider using salt when dealing with passwords!

When hashing data, you must specify algorithms that will be used for security reasons!

Please note that a hash cannot be reversed under normal circumstanses. You will not be able to get original value from a hash with Skript.

%texts% hash[ed] with (MD5|SHA-256)
Since
2.0, 2.2-dev32 (SHA-256 algorithm)

Hatching Entity Type

Expression

The type of the entity that will be hatched in a Player Egg Throw event.

[the] hatching entity [type]
Since
2.7
Supported events
Egg Throw

Hatching Number

Expression

The number of entities that will be hatched in a Player Egg Throw event.

Please note that no more than 127 entities can be hatched at once.

[the] hatching number
Since
2.7
Supported events
Egg Throw

Head location

Expression

The location of an entity's head, mostly useful for players and e.g. looping blocks in the player's line of sight.

Please note that this location is only accurate for entities whose head is exactly above their center, i.e. players, endermen, zombies, skeletons, etc., but not sheep, pigs or cows.

[the] (head|eye[s]) [location[s]] of %living entities%
%living entities%'[s] (head|eye[s]) [location[s]]
Since
2.0

Heal Amount

Expression

The amount of health healed in a heal event.

[the] heal[ing] amount
Since
2.5.1
Supported events
heal

Heal Reason

Type

The health regain reason in a heal event.

an ender crystal, magic, a magic regeneration, magic regeneration, fed, sated, a magic regen, regen potion, a wither spawn, peaceful, unknown, a regeneration potion, consuming, a wither effect, peaceful regeneration, wither summoning, healing potion, wither potion, an end crystal, satiated, regeneration potion, potion, satisfied, ingesting, withered, custom, a wither spawning, end crystal, eating, wither spawning, a wither summoning, wither effect, a plugin, a regen potion, plugin, withering, a potion, wither spawn, a healing potion, ender crystal, magic regen, wither, peaceful regen
Since
2.5

Heal Reason

Expression

The heal reason of a heal event.

[the] (regen|health regain|heal[ing]) (reason|cause)
Since
2.5
Supported events
heal

Health

Expression

The health of a creature, e.g. a player, mob, villager, etc. The minimum value is 0, and the maximum is the creature's max health (e.g. 10 for players).

[the] health of %living entities%
%living entities%'[s] health
Since
1.0
Supported events
damage

Hidden Players

Expression

The players hidden from a player that were hidden using the entity visibility effect.

[(all [[of] the]|the)] hidden players (of|for) %players%
[(all [[of] the]|the)] players hidden (from|for|by) %players%
Since
2.3

Hide Player from Server List

Effect

Hides a player from the hover list and decreases the online players count (only if the player count wasn't changed before).

hide %players% (in|on|from) [the] server list
hide %players%'[s] info[rmation] (in|on|from) [the] server list
Since
2.3

Horse Domestication

New
Expression

Gets and/or sets the (max) domestication of a horse.

The domestication of a horse is how close a horse is to becoming tame - the higher the domestication, the closer they are to becoming tame (must be between 1 and the max domestication level of the horse).

The max domestication of a horse is how long it will take for a horse to become tame (must be greater than 0).

[the] [max[imum]] domestication level of %living entities%
%living entities%'[s] [max[imum]] domestication level
Since
2.10

Hostname

Expression

The hostname used by the connecting player to connect to the server in a connect event.

[the] (host|domain)[ ][name]
Since
2.6.1

Hotbar Button

Expression

The hotbar button clicked in an inventory click event.

[the] hotbar button
Since
2.5

Hotbar Slot

Expression

The currently selected hotbar slot.

To retrieve its number use Slot Index expression.

Use future and past tense to grab the previous slot in an item change event, see example.

[the] [([currently] selected|current)] hotbar slot[s] [of %players%]
%players%'[s] [([currently] selected|current)] hotbar slot[s]
Since
2.2-dev36

Hover List

Expression

The list when you hover on the player counts of the server in the server list.

This can be changed using texts or players in a server list ping event only. Adding players to the list means adding the name of the players.

And note that, for example if there are 5 online players (includes fake online count) in the server and the hover list is set to 3 values, Minecraft will show "... and 2 more ..." at end of the list.

[the] [custom] [player|server] (hover|sample) ([message] list|message)
[the] [custom] player [hover|sample] list
Since
2.3
Requirements
Paper 1.12.2 or newer
Supported events
server list ping

Humidity

Expression

Humidity of given blocks.

[the] humidit(y|ies) of %blocks%
%blocks%'[s] humidit(y|ies)
Since
2.2-dev35

Ignite/Extinguish

Effect

Lights entities on fire or extinguishes them.

(ignite|set fire to) %entities% [for %time span%]
(set|light) %entities% on fire [for %time span%]
extinguish %entities%
Since
1.4

Ignition Process

Condition

Checks if a creeper is going to explode.

[creeper[s]] %living entities% ((is|are)|(isn't|is not|aren't|are not)) going to explode
[creeper[s]] %living entities% ((is|are)|(isn't|is not|aren't|are not)) in the (ignition|explosion) process
creeper[s] %living entities% ((is|are)|(isn't|is not|aren't|are not)) ignited
Since
2.5
Requirements
Paper 1.13 or newer

In The Past/Future

New
Condition

Checks whether a date is in the past or future.

Note that using the 'now' expression will not be in the past or future when used directly in the condition.

%dates% (is|are)[(n't| not)] in the (past|future)
%dates% ha(s|ve)[(n't| not)] passed
Since
2.10

Index Of

Expression

The first or last index of a character (or text) in a text, or -1 if it doesn't occur in the text. Indices range from 1 to the length of the text.

[the] [(first|last)] index of %text% in %text%
Since
2.1

Indices of List

Expression

Returns all the indices of a list variable, optionally sorted by their values.

To sort the indices, all objects in the list must be comparable;

Otherwise, this expression will just return the unsorted indices.

[(the|all [[of] the])] (indexes|indices) of %~objects%
%~objects%'[s] (indexes|indices)
[sorted] (indices|indexes) of %~objects% in (ascending|descending) order
[sorted] %~objects%'[s] (indices|indexes) in (ascending|descending) order
Since
2.4 (indices), 2.6.1 (sorting)

Initiator Inventory

Expression

Returns the initiator inventory in an on inventory item move event.

[the] [event-]initiator[( |-)inventory]
Since
2.8.0
Supported events
Inventory Item Move

Input

Expression

Represents the input in a filter expression or sort effect.

For example, if you ran 'broadcast "something" and "something else" where [input is "something"]

the condition would be checked twice, using "something" and "something else" as the inputs.

The 'input index' pattern can be used when acting on a variable to access the index of the input.

input
%*type% input
input index
Since
2.2-dev36, 2.9.0 (input index)

Input Key

New
Type

Represents a movement input key that is pressed by a player.

left movement key, forward movement key, right movement key, backward key, left key, sprint key, forward key, right key, jumping key, sneaking key, jump key, sneak key, sprinting key, backward movement key
Since
2.10
Requirements
Minecraft 1.21.3+

Inventory

Type

An inventory of a player or block. Inventories have many effects and conditions regarding the items contained.

An inventory has a fixed amount of slots which represent a specific place in the inventory, e.g. the helmet slot for players (Please note that slot support is still very limited but will be improved eventually).

Since
1.0

Inventory

Expression

The inventory of a block or player. You can usually omit this expression and can directly add or remove items to/from blocks or players.

[the] inventor(y|ies) of %inventoryholders/item types%
%inventoryholders/item types%'[s] inventor(y|ies)
Since
1.0

Inventory Action

Type

What player just did in inventory event. Note that when in creative game mode, most actions do not work correctly.

drop stack from slot, swap items with hotbar, swap cursor stack, pickup single item, pickup some, drop all from cursor, move to other inventory, pickup from bundle inventory actions, drop cursor stack, place all into bundle inventory actions, pickup all, swap with hotbar, pickup all into bundle inventory actions, nothing, drop all from slot, swap cursor, drop cursor, pickup all items, drop slot item, place from bundle inventory actions, place all, drop cursor item, drop slot stack, drop single item from slot, swap with cursor, place some, pickup one item, drop single item from cursor, collect items to cursor, unknown, clone stack, drop stack from cursor, drop one item from slot, drop one item from cursor, unsupported, do nothing, drop one from cursor, pickup half, drop items from slot, swap stack with cursor, place some into bundle inventory actions, place all items, collect to cursor, pickup some items, drop slot, drop items from cursor, hotbar move and readd, shift move, custom, pickup single, place one item, hotbar swap items, drop one from slot, place some items, place one, pickup half stack, instant move, hotbar swap, pickup some into bundle inventory actions
Since
2.2-dev16

Inventory Action

Expression

The inventory action of an inventory event. Please click on the link for more information.

[the] inventory action
Since
2.2-dev16

Inventory Close Reason

Expression

The inventory close reason of an inventory close event.

[the] inventory clos(e|ing) (reason|cause)
Since
2.8.0
Requirements
Paper
Supported events
Inventory Close

Inventory Close Reasons

Type

The inventory close reason in an inventory close event.

disconnect, death, teleport, cannot use, new opened, unknown, can't use, unloaded, disconnected, plugin, can not use, open new, player
Since
2.8.0
Requirements
Paper

Inventory Holder/Viewers/Rows/Slots

Expression

Gets the amount of rows/slots, viewers and holder of an inventory.

NOTE: 'Viewers' expression returns a list of players viewing the inventory. Note that a player is considered to be viewing their own inventory and internal crafting screen even when said inventory is not open.

(holder[s]|viewers|[amount of] rows|[amount of] slots) of %inventories%
%inventories%'[s] (holder[s]|viewers|[amount of] rows|[amount of] slots)
Since
2.2-dev34, 2.5 (slots)

Inventory Slot

Expression

Represents a slot in an inventory. It can be used to change the item in an inventory too.

[the] slot[s] %numbers% of %inventory%
%inventory%'[s] slot[s] %numbers%
Since
2.2-dev24

Inventory Type

Type

Minecraft has several different inventory types with their own use cases.

barrel inventory, a loom inventory, a blast furnace inventory, workbench inventory, ender chest inventory, loom inventory, a workbench inventory, hopper inventory, a merchant inventory, a hopper inventory, chiseled bookshelf, an ender chest inventory, new smithing table, bookshelf, a jukebox, beacon inventory, shulker box inventory, a barrel inventory, a shulker box inventory, lectern inventory, chest inventory, a villager inventory, a smoker inventory, a brewing stand inventory, a smithing inventory, grindstone inventory, a crafter inventory, a crafting table inventory, a player inventory, decorated pot, furnace inventory, a creative inventory, blast furnace inventory, upgrade gear, a composter inventory, an enchanting table inventory, jukebox, a dropper inventory, a cartography table inventory, a upgrade gear, smoker inventory, composter inventory, a chest inventory, upgrade gear table, a upgrade gear table, dispenser inventory, player inventory, stonecutter inventory, a stonecutter inventory, a decorated pot, a lectern inventory, merchant inventory, cartography table inventory, a chiseled bookshelf, a new smithing table, a furnace inventory, anvil inventory, a dispenser inventory, a grindstone inventory, smithing inventory, dropper inventory, brewing stand inventory, villager inventory, enchanting table inventory, a beacon inventory, a bookshelf, crafter inventory, creative inventory, crafting table inventory, an anvil inventory
Since
2.2-dev32

IP

Expression

The IP address of a player, or the connected player in a connect event, or the pinger in a server list ping event.

IP[s][( |-)address[es]] of %players%
%players%'[s] IP[s][( |-)address[es]]
IP[( |-)address]
Since
1.4, 2.2-dev26 (when used in connect event), 2.3 (when used in server list ping event)

Is a Skript command

Condition

Checks whether a command/string is a custom Skript command.

%text% (is|are) [a] s(k|c)ript (command|cmd)
%text% (isn't|is not|aren't|are not) [a] s(k|c)ript (command|cmd)
Since
2.6

Is Adult

New
Condition

Checks whether or not a living entity is an adult.

%living entities% (is|are) [an] adult
%living entities% (isn't|is not|aren't|are not) [an] adult
Since
2.10

Is Alive

Condition

Checks whether an entity is alive. Works for non-living entities too.

%entities% (is|are) (alive|dead)
%entities% (isn't|is not|aren't|are not) (alive|dead)
Since
2.0, 2.4-alpha4 (non-living entity support)

Is Baby

New
Condition

Checks whether or not a living entity is a baby.

%living entities% (is|are) a (child|baby)
%living entities% (isn't|is not|aren't|are not) a (child|baby)
Since
2.10

Is Banned

Condition

Checks whether a player or IP is banned.

%offline players/texts% (is|are) banned
%players/texts% (is|are) IP[(-| )]banned
%offline players/texts% (isn't|is not|aren't|are not) banned
%players/texts% (isn't|is not|aren't|are not) IP[(-| )]banned
Since
1.4

Is Bed/Anchor Spawn

Condition

Checks what the respawn location of a player in the respawn event is.

[the] respawn location (was|is)[(n'| no)t] [a] (bed|respawn anchor)
Since
2.7
Requirements
Minecraft 1.16+
Supported events
respawn

Is Block

Condition

Checks whether an item is a block.

%item types% (is|are) ([a] block|blocks)
%item types% (isn't|is not|aren't|are not) ([a] block|blocks)
Since
2.4

Is Block Redstone Powered

Condition

Checks if a block is indirectly or directly powered by redstone

%blocks% (is|are) redstone powered
%blocks% (is|are) indirectly redstone powered
%blocks% (is|are)(n't| not) redstone powered
%blocks% (is|are)(n't| not) indirectly redstone powered
Since
2.5

Is Blocking

Condition

Checks whether a player is blocking with their shield.

%players% (is|are) (blocking|defending) [with [a] shield]
%players% (isn't|is not|aren't|are not) (blocking|defending) [with [a] shield]
Since
unknown (before 2.1)

Is Burning

Condition

Checks whether an entity is on fire, e.g. a zombie due to being in sunlight, or any entity after falling into lava.

%entities% (is|are) (burning|ignited|on fire)
%entities% (isn't|is not|aren't|are not) (burning|ignited|on fire)
Since
1.4.4

Is Charged

New
Condition

Checks if a creeper, wither, or wither skull is charged (powered).

%entities% (is|are) (charged|powered)
%entities% (isn't|is not|aren't|are not) (charged|powered)
Since
2.5, 2.10 (withers, wither skulls)

Is Climbing

Condition

Whether a living entity is climbing, such as a spider up a wall or a player on a ladder.

%living entities% (is|are) climbing
%living entities% (isn't|is not|aren't|are not) climbing
Since
2.8.0
Requirements
Minecraft 1.17+

Is Conditional

New
Condition

Checks whether a command block is conditional or not.

%blocks% (is|are) [un]conditional
%blocks% (isn't|is not|aren't|are not) [un]conditional
Since
2.10

Is Custom Name Visible

New
Condition

Checks if an entity's custom name is visible.

%entities%'[s] custom name[s] (is|are) visible
%entities%'[s] custom name[s] (isn't|is not|are not|aren't) visible
custom name of %entities% (is|are) visible
custom name of %entities% (isn't|is not|are not|aren't) visible
Since
2.10

Is Edible

Condition

Checks whether an item is edible.

%item types% (is|are) edible
%item types% (isn't|is not|aren't|are not) edible
Since
2.2-dev36

Is Empty

Condition

Checks whether an inventory, an inventory slot, a queue, or a text is empty.

%inventories/slots/texts/numbered thing% (is|are) empty
%inventories/slots/texts/numbered thing% (isn't|is not|aren't|are not) empty
Since
unknown (before 2.1)

Is Enchanted

Condition

Checks whether an item is enchanted.

%item types% (is|are) enchanted [with %enchantment type%]
%item types% (isn't|is not|aren't|are not) enchanted [with %enchantment type%]
Since
1.4.6

Is Evenly Divisible By

New
Condition

Check if a number is evenly divisible by another number.

%numbers% (is|are) evenly divisible by %number%
%numbers% (isn't|is not|aren't|are not) evenly divisible by %number%
%numbers% can be evenly divided by %number%
%numbers% (can't|can[ ]not) be evenly divided by %number%
Since
2.10

Is Fire Resistant

Condition

Checks whether an item is fire resistant.

%item types% (is|are) (fire resistant|resistant to fire)
%item types% (isn't|is not|aren't|are not) (fire resistant|resistant to fire)
Since
2.9.0
Requirements
Spigot 1.20.5+

Is Fish Hook in Open Water

New
Condition

Checks whether the fish hook is in open water.

Open water is defined by a 5x4x5 area of water, air and lily pads. If in open water, treasure items may be caught.

%entities% (is|are) in open water[s]
%entities% (isn't|is not|aren't|are not) in open water[s]
Since
2.10
Supported events
Fishing

Is Flammable

Condition

Checks whether an item is flammable.

%item types% (is|are) flammable
%item types% (isn't|is not|aren't|are not) flammable
Since
2.2-dev36

Is Flying

Condition

Checks whether a player is flying.

%players% (is|are) flying
%players% (isn't|is not|aren't|are not) flying
Since
1.4.4

Is From A Mob Spawner

New
Condition

Checks if an entity was spawned from a mob spawner.

%entities% (is|are) from a [mob] spawner
%entities% (isn't|aren't|is not|are not) from a [mob] spawner
%entities% (was|were) spawned (from|by) a [mob] spawner
%entities% (wasn't|weren't|was not|were not) spawned (from|by) a [mob] spawner
Since
2.10
Requirements
PaperMC

Is Frozen

Condition

Checks whether an entity is frozen.

%entities% (is|are) frozen
%entities% (isn't|is not|aren't|are not) frozen
Since
2.7

Is Fuel

Condition

Checks whether an item can be used as fuel in a furnace.

%item types% (is|are) [furnace] fuel
%item types% (isn't|is not|aren't|are not) [furnace] fuel
Since
2.5.1
Requirements
Minecraft 1.11.2+

Is Gliding

Condition

Checks whether a living entity is gliding.

%living entities% (is|are) gliding
%living entities% (isn't|is not|aren't|are not) gliding
Since
2.7

Is Hand Raised

Condition

Checks whether an entity has one or both of their hands raised.

Hands are raised when an entity is using an item (eg: blocking, drawing a bow, eating).

%living entities%'[s] [main] hand[s] (is|are) raised
%living entities%'[s] [main] hand[s] (isn't|is not|aren't|are not) raised
[main] hand[s] of %living entities% (is|are) raised
[main] hand[s] of %living entities% (isn't|is not|aren't|are not) raised
%living entities%'[s] off[ |-]hand[s] (is|are) raised
%living entities%'[s] off[ |-]hand[s] (isn't|is not|aren't|are not) raised
off[ |-]hand[s] of %living entities% (is|are) raised
off[ |-]hand[s] of %living entities% (isn't|is not|aren't|are not) raised
Since
2.8.0
Requirements
Paper

Is Holding

Condition

Checks whether a player is holding a specific item. Cannot be used with endermen, use 'entity is [not] an enderman holding <item type>' instead.

[%living entities%] ha(s|ve) %item types% in [main] hand
[%living entities%] (is|are) holding %item types% [in main hand]
[%living entities%] ha(s|ve) %item types% in off[(-| )]hand
[%living entities%] (is|are) holding %item types% in off[(-| )]hand
[%living entities%] (ha(s|ve) not|do[es]n't have) %item types% in [main] hand
[%living entities%] (is not|isn't) holding %item types% [in main hand]
[%living entities%] (ha(s|ve) not|do[es]n't have) %item types% in off[(-| )]hand
[%living entities%] (is not|isn't) holding %item types% in off[(-| )]hand
Since
1.0

Is In Love

New
Condition

Checks whether or not a living entity is in love.

%living entities% (is|are) in lov(e|ing) [state|mode]
%living entities% (isn't|is not|aren't|are not) in lov(e|ing) [state|mode]
Since
2.10

Is Incendiary

Condition

Checks if an entity will create fire when it explodes. This condition is also usable in an explosion prime event.

%entities% ((is|are) incendiary|cause[s] a[n] (incendiary|fiery) explosion)
%entities% ((is not|are not|isn't|aren't) incendiary|(does not|do not|doesn't|don't) cause[s] a[n] (incendiary|fiery) explosion)
the [event(-| )]explosion (is|(is not|isn't)) (incendiary|fiery)
Since
2.5

Is Infinite

Condition

Checks whether potion effects are infinite.

%potion effects% (is|are) infinite
%potion effects% (isn't|is not|aren't|are not) infinite
Since
2.7

Is Interactable

Condition

Checks wether or not a block is interactable.

%item types% (is|are) interactable
%item types% (isn't|is not|aren't|are not) interactable
Since
2.5.2
Requirements
Minecraft 1.13+

Is Invisible

Condition

Checks whether a living entity is invisible.

%living entities% (is|are) (invisible|visible)
%living entities% (isn't|is not|aren't|are not) (invisible|visible)
Since
2.7

Is Invulnerable

New
Condition

Checks whether an entity or a gamemode is invulnerable. For gamemodes, Paper and Minecraft 1.20.6 are required

%entities/gamemodes% (is|are) (invulnerable|invincible)
%entities/gamemodes% (isn't|is not|aren't|are not) (invulnerable|invincible)
Since
2.5, 2.10 (gamemode)
Requirements
Paper 1.20.6+ (gamemodes)

Is Jumping

Condition

Checks whether a living entity is jumping. This condition does not work on players.

%living entities% (is|are) jumping
%living entities% (isn't|is not|aren't|are not) jumping
Since
2.8.0
Requirements
Paper 1.15+

Is Leashed

Condition

Checks to see if an entity is currently leashed.

%living entities% (is|are) leashed
%living entities% (isn't|is not|aren't|are not) leashed
Since
2.5

Is Loaded

New
Condition

Checks whether a world, chunk or script is loaded.

'chunk at 1, 1' uses chunk coordinates, which are location coords divided by 16.

chunk[s] %directions% [%locations%] (is|are)[((n't| not))] loaded
chunk [at] %number%, %number% (in|of) [world] %world% is[((n't| not))] loaded
%scripts/worlds% (is|are)[(n't| not)] loaded
script[s] %scripts% (is|are)[(n't| not)] loaded
world[s] %worlds% (is|are)[(n't| not)] loaded
Since
2.3, 2.5 (revamp with chunk at location/coords), 2.10 (Scripts)

Is Lootable

New
Condition

Checks whether an entity or block is lootable. Lootables are entities or blocks that can have a loot table.

%blocks/entities% (is|are) lootable
%blocks/entities% (isn't|is not|aren't|are not) lootable
Since
2.10

Is Normalized

Condition

Checks whether a vector is normalized i.e. length of 1

%vectors% (is|are) normalized
%vectors% (isn't|is not|aren't|are not) normalized
Since
2.5.1

Is Occluding

Condition

Checks whether an item is a block and completely blocks vision.

%item types% (is|are) occluding
%item types% (isn't|is not|aren't|are not) occluding
Since
2.5.1

Is of Type

Condition

Checks whether an item or an entity is of the given type. This is mostly useful for variables, as you can use the general 'is' condition otherwise (e.g. 'victim is a creeper').

%item stacks/entities% (is|are) of type[s] %item types/entity types%
%item stacks/entities% (isn't|is not|aren't|are not) of type[s] %item types/entity types%
Since
1.4

Is on Ground

Condition

Checks whether an entity is on ground.

%entities% (is|are) on [the] ground
%entities% (isn't|is not|aren't|are not) on [the] ground
Since
2.2-dev26

Is Online

Condition

Checks whether a player is online. The 'connected' pattern will return false once this player leaves the server, even if they rejoin. Be aware that using the 'connected' pattern with a variable will not have this special behavior. Use the direct event-player or other non-variable expression for best results.

%offline players% (is|are) (online|offline|connected)
%offline players% (isn't|is not|aren't|are not) (online|offline|connected)
Since
1.4
Requirements
Paper 1.20+ (Connected)

Is Operator

Condition

Checks whether a player is a server operator.

%offline players% (is|are) [[a] server|an] op[erator][s]
%offline players% (isn't|is not|aren't|are not) [[a] server|an] op[erator][s]
Since
2.7

Is Passable

Condition

Checks whether a block is passable.

A block is passable if it has no colliding parts that would prevent players from moving through it.

Blocks like tall grass, flowers, signs, etc. are passable, but open doors, fence gates, trap doors, etc. are not because they still have parts that can be collided with.

%blocks% (is|are) passable
%blocks% (isn't|is not|aren't|are not) passable
Since
2.5.1
Requirements
Minecraft 1.13.2+

Is Pathfinding

Condition

Checks whether living entities are pathfinding.

Can only be a living entity that is a Mob.

%living entities% (is|are) pathfinding [to[wards] %living entity/location%]
%living entities% (isn't|is not|aren't|are not) pathfinding [to[wards] %living entity/location%]
Since
2.9.0
Requirements
Paper

Is Plugin Enabled

Condition

Check if a plugin is enabled/disabled on the server.

Plugin names can be found in the plugin's 'plugin.yml' file or by using the '/plugins' command, they are NOT the name of the plugin's jar file.

When checking if a plugin is not enabled, this will return true if the plugin is either disabled or not on the server.

When checking if a plugin is disabled, this will return true if the plugin is on the server and is disabled.

plugin[s] %texts% (is|are) enabled
plugin[s] %texts% (is|are)(n't| not) enabled
plugin[s] %texts% (is|are) disabled
Since
2.6

Is Poisoned

Condition

Checks whether an entity is poisoned.

%living entities% (is|are) poisoned
%living entities% (isn't|is not|aren't|are not) poisoned
Since
1.4.4

Is Preferred Tool

Condition

Checks whether an item is the preferred tool for a block. A preferred tool is one that will drop the block's item when used. For example, a wooden pickaxe is a preferred tool for grass and stone blocks, but not for iron ore.

%item types% (is|are) %blocks/block datas%'s preferred tool[s]
%item types% (is|are) [the|a] preferred tool[s] (for|of) %blocks/block datas%
%item types% (is|are)(n't| not) %blocks/block datas%'s preferred tool[s]
%item types% (is|are)(n't| not) [the|a] preferred tool[s] (for|of) %blocks/block datas%
Since
2.7
Requirements
1.16.5+, Paper 1.19.2+ (blockdata)

Is Pressing Key

New
Condition

Checks if a player is pressing a certain input key.

%players% (is|are) pressing %input keys%
%players% (isn't|is not|aren't|are not) pressing %input keys%
%players% (was|were) pressing %input keys%
%players% (wasn't|was not|weren't|were not) pressing %input keys%
Since
2.10
Requirements
Minecraft 1.21.2+

Is Riding

Condition

Tests whether an entity is riding another or is in a vehicle.

%entities% (is|are) riding [%entity types%]
%entities% (isn't|is not|aren't|are not) riding [%entity types%]
Since
2.0

Is Riptiding

Condition

Checks to see if an entity is currently using the Riptide enchantment.

%living entities% (is|are) riptiding
%living entities% (isn't|is not|aren't|are not) riptiding
Since
2.5

Is Saddled

New
Condition

Checks whether a given entity (horse or steerable) is saddled.

If 'properly' is used, this will only return true if the entity is wearing specifically a saddle item.

%living entities% (is|are) [properly] saddled
%living entities% (isn't|is not|aren't|are not) [properly] saddled
Since
2.10

Is Script Loaded

Condition

Check if the current script, or another script, is currently loaded.

script[s] [%texts%] (is|are) loaded
script[s] [%texts%] (isn't|is not|aren't|are not) loaded
Since
2.2-dev31

Is Silent

Condition

Checks whether an entity is silent i.e. its sounds are disabled.

%entities% (is|are) silent
%entities% (isn't|is not|aren't|are not) silent
Since
2.5

Is Sleeping

Condition

Checks whether a player is sleeping.

%players% (is|are) sleeping
%players% (isn't|is not|aren't|are not) sleeping
Since
1.4.4

Is Slime Chunk

Condition

Tests whether a chunk is a so-called slime chunk.

Slimes can generally spawn in the swamp biome and in slime chunks.

For more info, see the Minecraft wiki.

%chunk% (is|are) ([a] slime chunk|slime chunks|slimey)
%chunk% (isn't|is not|aren't|are not) ([a] slime chunk|slime chunks|slimey)
Since
2.3

Is Sneaking

Condition

Checks whether a player is sneaking.

%players% (is|are) sneaking
%players% (isn't|is not|aren't|are not) sneaking
Since
1.4.4

Is Solid

Condition

Checks whether an item is solid.

%item types% (is|are) solid
%item types% (isn't|is not|aren't|are not) solid
Since
2.2-dev36

Is Sprinting

Condition

Checks whether a player is sprinting.

%players% (is|are) sprinting
%players% (isn't|is not|aren't|are not) sprinting
Since
1.4.4

Is Stackable

Condition

Checks whether an item is stackable.

%item stacks% (is|are) stackable
%item stacks% (isn't|is not|aren't|are not) stackable
Since
2.7

Is Swimming

Condition

Checks whether a living entity is swimming.

%living entities% (is|are) swimming
%living entities% (isn't|is not|aren't|are not) swimming
Since
2.3
Requirements
1.13 or newer

Is Tagged

New
Condition

Checks whether an item, block, entity, or entitydata is tagged with the given tag.

%item types/entities/entity types% (is|are) tagged (as|with) %minecraft tags%
%item types/entities/entity types% (isn't|is not|aren't|are not) tagged (as|with) %minecraft tags%
Since
2.10

Is Tameable

Condition

Check if an entity is tameable.

%living entities% (is|are) tameable
%living entities% (isn't|is not|aren't|are not) tameable
Since
2.5

Is Tamed

New
Condition

Check if a tameable entity is tamed (horse, parrot, cat, etc.).

%entities% (is|are) (tamed|domesticated)
%entities% (isn't|is not|aren't|are not) (tamed|domesticated)
Since
2.10

Is Ticking

New
Condition

Checks if an entity is ticking.

%entities% (is|are) ticking
%entities% (isn't|is not|aren't|are not) ticking
Since
2.10
Requirements
PaperMC

Is Transparent

Condition

Checks whether an item is transparent. Note that this condition may not work for all blocks, due to the transparency list used by Spigot not being completely accurate.

%item types% (is|are) transparent
%item types% (isn't|is not|aren't|are not) transparent
Since
2.2-dev36

Is Unbreakable

Condition

Checks whether an item is unbreakable.

%item types% (is|are) [un]breakable
%item types% (isn't|is not|aren't|are not) [un]breakable
Since
2.5.1, 2.9.0 (breakable)

Is Using Experimental Feature

Condition

Checks whether a script is using an experimental feature by name.

%script% is using %texts%
%scripts% are using %texts%
%script% is(n't| not) using %texts%
%scripts% are(n't| not) using %texts%
Since
2.9.0

Is Valid

New
Condition

Checks whether something (an entity, a script, a config, etc.) is valid.

An invalid entity may have died or de-spawned for some other reason.

An invalid script reference may have been reloaded, moved or disabled since.

%entities/scripts% (is|are) valid
%entities/scripts% (isn't|is not|aren't|are not) valid
Since
2.7, 2.10 (Scripts & Configs)

Is Wearing

Condition

Checks whether an entity is wearing some items (usually armor).

%living entities% (is|are) wearing %item types%
%living entities% (isn't|is not|aren't|are not) wearing %item types%
Since
1.0

Is Whitelisted

Condition

Whether or not the server or a player is whitelisted, or the server is whitelist enforced.

[the] server (is|(isn't|is not)) (in white[ ]list mode|white[ ]listed)
%offline players% (is|are|(isn't|is not|aren't|are not)) white[ ]listed
[the] server white[ ]list (is|(isn't|is not)) enforced
Since
2.5.2, 2.9.0 (enforce, offline players)
Requirements
MC 1.17+ (enforce)

Is Within

Condition

Whether a location is within something else. The "something" can be a block, an entity, a chunk, a world, or a cuboid formed by two other locations.

Note that using the is between condition will refer to a straight line between locations, while this condition will refer to the cuboid between locations.

%locations% (is|are) within %location% and %location%
%locations% (isn't|is not|aren't|are not) within %location% and %location%
%locations% (is|are) (within|in[side [of]]) %entity/chunk/world/block%
%locations% (isn't|is not|aren't|are not) (within|in[side [of]]) %entity/chunk/world/block%
Since
2.7
Requirements
MC 1.17+ (within block)

Is Within Radius

Condition

Checks whether a location is within a certain radius of another location.

%locations% (is|are) within %number% (block|metre|meter)[s] (around|of) %locations%
%locations% (isn't|is not|aren't|are not) within %number% (block|metre|meter)[s] (around|of) %locations%
Since
2.7

isNaN

Function

Returns true if the input is NaN (not a number).

isNaN(n: number)
Since
2.8.0
Returns
Boolean

Item

Type

An item, e.g. a stack of torches, a furnace, or a wooden sword of sharpness 2. Unlike item type an item can only represent exactly one item (e.g. an upside-down cobblestone stair facing west), while an item type can represent a whole range of items (e.g. any cobble stone stairs regardless of direction).

You don't usually need this type except when you want to make a command that only accepts an exact item.

Please note that currently 'material' is exactly the same as 'item', i.e. can have an amount & enchantments.

<code>[&lt;number&gt; [of]] &lt;alias&gt; [of &lt;enchantment&gt; &lt;level&gt;]</code>, Where &lt;alias&gt; must be an alias that represents exactly one item (i.e cannot be a general alias like 'sword' or 'plant')
Since
1.0

Item

Expression

The item involved in an event, e.g. in a drop, dispense, pickup or craft event.

[the] item
Since
unknown (before 2.1)

Item Amount

Expression

The amount of an item stack.

[the] item[[ ]stack] (amount|size|number) of %slots/item types/item stacks%
%slots/item types/item stacks%'[s] item[[ ]stack] (amount|size|number)
Since
2.2-dev24

Item Cooldown

Expression

Change the cooldown of a specific material to a certain amount of Timespan.

[the] [item] cooldown of %item types% for %players%
%players%'[s] [item] cooldown for %item types%
Since
2.8.0

Item Display Transform

New
Expression

Returns or changes the item display transform of item displays.

[the] item [display] transform [of %displays%]
%displays%'[s] item [display] transform
Since
2.10

Item Display Transforms

New
Type

Represents the transform setting of an item display.

first person left handed, left handed in first person, right handed in third person, first person left hand, no transform, the ground, third person right hand, third person right handed, right handed in first person, menu, head, third person left hand, first person right handed, first person right hand, fixed position, left handed in third person, gui, ground, fixed, third person left handed
Since
2.10

Item Enchantments

Expression

All the enchantments an item type has.

[the] enchantments of %item types%
%item types%'[s] enchantments
Since
2.2-dev36

Item Flag

New
Type

Represents flags that may be applied to hide certain attributes of an item.

hide unbreakable, hide unbreakable status, hide destroys, hide additional tooltip, destroys hidden, hide enchants, stored enchantments hidden, hidden destroys, hidden stored enchants, dye hidden, stored enchants hidden, hidden enchants, hidden unbreakable status, hidden stored enchantments, hide stored enchants, hide stored enchantments, hide attributes, hidden additional tooltip, hidden armor trim, hidden placed on, additional tooltip hidden, enchants hidden, enchantments hidden, attributes hidden, unbreakable status hidden, hidden dye color, unbreakable hidden, dye color hidden, hide enchantments, hidden unbreakable, hide dye color, hidden attributes, armor trim hidden, hide destroyable blocks, hide placed on, hidden dye, hide armor trim, hide breakable blocks, placed on hidden, hide dye
Since
2.10

Item Flags

New
Expression

The item flags of an item. Can be modified.

[the] item flags of %item types%
%item types%'[s] item flags
Since
2.10

Item Has Enchantment Glint Override

New
Condition

Checks whether an item has the enchantment glint overridden, or is forced to glint or not.

%item types% (has|have) enchantment glint overrid(den|e)
%item types% (doesn't|does not|do not|don't) have enchantment glint overrid(den|e)
Since
2.10
Requirements
Spigot 1.20.5+

Item Has Enchantment Glint Override

New
Condition

Checks whether an item has the enchantment glint overridden, or is forced to glint or not.

%item types% (is|are) forced to [not] glint
%item types% (isn't|is not|aren't|are not) forced to [not] glint
Since
2.10
Requirements
Spigot 1.20.5+

Item of an Entity

New
Expression

An item associated with an entity. For dropped item entities, it gets the item that was dropped.

For item frames, the item inside the frame is returned.

For throwable projectiles (snowballs, enderpearls etc.) or item displays, it gets the displayed item.

Other entities do not have items associated with them.

[the] item [inside] of %entities%
%entities%'[s] item [inside]
Since
2.2-dev35, 2.2-dev36 (improved), 2.5.2 (throwable projectiles), 2.10 (item displays)

Item Tooltips

Effect

Show or hide the tooltip of an item.

If changing the 'entire' tooltip of an item, nothing will show up when a player hovers over it.

If changing the 'additional' tooltip, only specific parts (which change per item) will be hidden.

(show|reveal|hide) %item types%'[s] [entire|additional] tool[ ]tip
(show|reveal|hide) [the] [entire|additional] tool[ ]tip of %item types%
Since
2.9.0
Requirements
Spigot 1.20.5+

Item Type

Type

An item type is an alias, e.g. 'a pickaxe', 'all plants', etc., and can result in different items when added to an inventory, and unlike items they are well suited for checking whether an inventory contains a certain item or whether a certain item is of a certain type.

An item type can also have one or more enchantments with or without a specific level defined, and can optionally start with 'all' or 'every' to make this item type represent all types that the alias represents, including data ranges.

[&lt;number&gt; [of]] [all/every] &lt;alias&gt; [of &lt;enchantment&gt; [&lt;level&gt;] [,/and &lt;more enchantments...&gt;]]
Since
1.0

Item with CustomModelData

Expression

Get an item with a CustomModelData tag. (Value is an integer between 0 and 99999999)

%item type% with [custom] model data %number%
Since
2.5
Requirements
1.14+

Item with Enchantment Glint

New
Expression

Get an item with or without enchantment glint.

%item types% with[out] [enchant[ment]] glint
Since
2.10
Requirements
Spigot 1.20.5+

Item with Item Flags

New
Expression

Creates a new item with the specified item flags.

%item types% with [the] item flag[s] %item flags%
%item types% with [the] %item flags% item flag[s]
Since
2.10

Item with Lore

Expression

Returns the given item type with the specified lore added to it.

If multiple strings are passed, each of them will be a separate line in the lore.

%item type% with [(a|the)] lore %texts%
Since
2.3

Items

Expression

Items or blocks of a specific type, useful for looping.

[all [[of] the]|the] block[[ ]type]s
every block[[ ]type]
[all [[of] the]|the|every] block[s] of type[s] %item types%
[all [[of] the]|the|every] item[s] of type[s] %item types%
Since
1.0 pre-5

Items In

Expression

All items or specific type(s) of items in an inventory. Useful for looping or storing in a list variable.

Please note that the positions of the items in the inventory are not saved, only their order is preserved.

[all [[of] the]] items ([with]in|of|contained in|out of) [inventor(y|ies)] %inventories%
all [[of] the] %item types% ([with]in|of|contained in|out of) [inventor(y|ies)] %inventories%
Since
2.0, 2.8.0 (specific types of items)

Join & Split

New
Expression

Joins several texts with a common delimiter (e.g. ", "), or splits a text into multiple texts at a given delimiter.

(concat[enate]|join) %texts% [(with|using|by) [[the] delimiter] %text%]
split %text% (at|using|by) [[the] delimiter] %text% [with case sensitivity] [without [the] trailing [empty] (string|text)]
%text% split (at|using|by) [[the] delimiter] %text% [with case sensitivity] [without [the] trailing [empty] (string|text)]
regex split %text% (at|using|by) [[the] delimiter] %text% [without [the] trailing [empty] (string|text)]
regex %text% split (at|using|by) [[the] delimiter] %text% [without [the] trailing [empty] (string|text)]
Since
2.1, 2.5.2 (regex support), 2.7 (case sensitivity), 2.10 (without trailing string)

Keep Inventory / Experience

Effect

Keeps the inventory or/and experiences of the dead player in a death event.

keep [the] (inventory|items) [(and [e]xp[erience][s] [point[s]])]
keep [the] [e]xp[erience][s] [point[s]] [(and (inventory|items))]
Since
2.4
Supported events
death

Kick

Effect

Kicks a player from the server.

kick %players% [(by reason of|because [of]|on account of|due to) %text%]
Since
1.0

Kill

New
Effect

Kills an entity.

kill %entities%
Since
1.0, 2.10 (ignoring totem of undying)

Knockback

Effect

Apply the same velocity as a knockback to living entities in a direction. Mechanics such as knockback resistance will be factored in.

(apply knockback to|knock[back]) %living entities% [%direction%] [with (strength|force) %number%]
Since
2.7
Requirements
Paper 1.19.2+

Language

Expression

Currently selected game language of a player. The value of the language is not defined properly.

The vanilla Minecraft client will use lowercase language / country pairs separated by an underscore, but custom resource packs may use any format they wish.

[the] [([currently] selected|current)] [game] (language|locale) [setting] of %players%
%players%'[s] [([currently] selected|current)] [game] (language|locale) [setting]
Since
2.3

Last Attacker

Expression

The last block or entity that attacked an entity.

[the] last attacker of %entity%
%entity%'[s] last attacker
Since
2.5.1

Last Color

Expression

The colors used at the end of a string. The colors of the returned string will be formatted with their symbols.

[the] last color[s] of %texts%
%texts%'[s] last color[s]
Since
2.6

Last Damage

Expression

The last damage that was done to an entity. Note that changing it doesn't deal more/less damage.

[the] last damage of %living entities%
%living entities%'[s] last damage
Since
2.5.1

Last Damage Cause

Expression

Cause of last damage done to an entity

[the] last damage (cause|reason|type) of %living entities%
%living entities%'[s] last damage (cause|reason|type)
Since
2.2-Fixes-V10

Last Death Location

New
Expression

Gets the last death location of a player, or offline player, if available.

Can also be set, reset, and deleted if the player is online.

[the] [last] death location[s] of %offline players%
%offline players%'[s] [last] death location[s]
Since
2.10

Last Loaded Server Icon

Expression

Returns the last loaded server icon with the load server icon effect.

[the] [last[ly]] loaded server icon
Since
2.3
Requirements
Paper 1.12.2 or newer

Last Resource Pack Response

Expression

Returns the last resource pack response received from a player.

[the] [last] resource pack response[s] of %players%
%players%'[s] [last] resource pack response[s]
Since
2.4
Requirements
Paper 1.9 or newer

Last Spawned Entity

Expression

Holds the entity that was spawned most recently with the spawn effect (section), dropped with the drop effect, shot with the shoot effect or created with the lightning effect. Please note that even though you can spawn multiple mobs simultaneously (e.g. with 'spawn 5 creepers'), only the last spawned mob is saved and can be used. If you spawn an entity, shoot a projectile and drop an item you can however access all them together.

[the] [last[ly]] (spawned|shot) %*entity type%
[the] [last[ly]] dropped (item)
[the] [last[ly]] (created|struck) (lightning)
[the] [last[ly]] (launched|deployed) (firework)
Since
1.3 (spawned entity), 2.0 (shot entity), 2.2-dev26 (dropped item), 2.7 (struck lightning, firework)

Last/First Login Time

Expression

When a player last/first logged in the server. 'last login' requires paper to get the last login, otherwise it will get the last time they were seen on the server.

[the] (last|first) login of %offline players%
%offline players%'[s] (last|first) login
Since
2.5

Launch firework

Effect

Launch firework effects at the given location(s).

(launch|deploy) [[a] firework [with effect[s]]] %firework effects% at %locations% [([with] (duration|power)|timed) %number%]
Since
2.4

Leash entities

Effect

Leash living entities to other entities. When trying to leash an Ender Dragon, Wither, Player, or a Bat, this effect will not work.

See Spigot's Javadocs for more info.

(leash|lead) %living entities% to %entity%
make %entity% (leash|lead) %living entities%
un(leash|lead) [holder of] %living entities%
Since
2.3

Leash Holder

Expression

The leash holder of a living entity.

[the] leash holder[s] of %living entities%
%living entities%'[s] leash holder[s]
Since
2.3

Leash Will Drop

New
Condition

Checks whether the leash item will drop during the leash detaching in an unleash event.

[the] (lead|leash) [item] (will|(won't|will not)) (drop|be dropped)
Since
2.10
Requirements
Paper 1.16+
Supported events
Unleash

Left Handed

Condition

Checks if living entities or players are left or right-handed. Armor stands are neither right nor left-handed.

Paper 1.17.1+ is required for non-player entities.

%living entities% (is|are) (left|right)( |-)handed
%living entities% (isn't|is not|aren't|are not) (left|right)( |-)handed
Since
2.8.0
Requirements
Paper 1.17.1+ (entities)

Length

Expression

The length of a text, in number of characters.

[the] length of %texts%
%texts%'[s] length
Since
2.1

Level

Expression

The level of a player.

[the] level of %players%
%players%'[s] level
Since
unknown (before 2.1)
Supported events
level change

Level Progress

Expression

The player's progress in reaching the next level, this represents the experience bar in the game. Please note that this value is between 0 and 1 (e.g. 0.5 = half experience bar).

Changing this value can cause the player's level to change if the resulting level progess is negative or larger than 1, e.g. increase the player's level progress by 0.5 will make the player gain a level if their progress was more than 50%.

[the] level progress of %players%
%players%'[s] level progress
Since
2.0
Supported events
level change

Lid Is Open/Closed

New
Condition

Check to see whether lidded blocks (chests, shulkers, etc.) are open or closed.

[the] lid[s] of %blocks% (is|are) (open[ed]|close[d])
[the] lid[s] of %blocks% (isn't|is not|aren't|are not) (open[ed]|close[d])
%blocks%'[s] lid[s] (is|are) (open[ed]|close[d])
%blocks%'[s] lid[s] (isn't|is not|aren't|are not) (open[ed]|close[d])
Since
2.10

Light Level

Expression

Gets the light level at a certain location which ranges from 0 to 15.

It can be separated into sunlight (15 = direct sunlight, 1-14 = indirect) and block light (torches, glowstone, etc.). The total light level of a block is the maximum of the two different light types.

[(sky|sun|block)[ ]]light[ ]level [(of|%direction%) %location%]
Since
1.3.4

Lightning

Effect

Strike lightning at a given location. Can use 'lightning effect' to create a lightning that does not harm entities or start fires.

(create|strike) lightning[([ ]effect)] %directions% %locations%
Since
1.4

Living Entity

Type

A living entity, i.e. a mob or player, not inanimate entities like projectiles or dropped items.

see <a href='#entity'>entity</a>, but ignore inanimate objects
Since
1.0

ln

Function

The natural logarithm. You probably don't need this if you don't know what this is.

Returns NaN (not a number) if the argument is negative.

ln(n: number)
Since
2.2
Returns
Number

Load Server Icon

Effect

Loads server icons from the given files. You can get the loaded icon using the

last loaded server icon expression.

Please note that the image must be 64x64 and the file path starts from the server folder.

load [the] server icon (from|of) [the] [image] [file] %text%
Since
2.3
Requirements
Paper 1.12.2 or newer

Load World

Effect

Load your worlds or unload your worlds

The load effect will create a new world if world doesn't already exist.

When attempting to load a normal vanilla world you must define it's environment i.e "world_nether" must be loaded with nether environment

load [[the] world[s]] %texts% [with environment %environment%]
unload [[the] world[s]] %worlds% [without saving]
Since
2.8.0

Loaded Plugins

Expression

An expression to obtain a list of the names of the server's loaded plugins.

[(all [[of] the]|the)] [loaded] plugins
Since
2.7

Locally Suppress Warning

Effect

Suppresses target warnings from the current script.

[local[ly]] suppress [the] (conflict|variable save|[missing] conjunction|starting [with] expression[s]|deprecated syntax|unreachable code) warning[s]
Since
2.3

location

Function

Creates a location from a world and 3 coordinates, with an optional yaw and pitch.

If for whatever reason the world is not found, it will fallback to the server's main world.

location(x: number, y: number, z: number, world: world = event-world, yaw: number = 0, pitch: number = 0)
Since
2.2
Returns
Location

Location

Type

A location in a world. Locations are world-specific and even store a direction, e.g. if you save a location and later teleport to it you will face the exact same direction you did when you saved the location.

Since
1.0

Location

Expression

The location where an event happened (e.g. at an entity or block), or a location relative to another (e.g. 1 meter above another location).

[the] [event-](location|position)
Since
2.0

Location

Expression

The location where an event happened (e.g. at an entity or block), or a location relative to another (e.g. 1 meter above another location).

[the] (location|position) %directions% [%location%]
Since
2.0

Location

Expression

The location of a block or entity. This not only represents the x, y and z coordinates of the location but also includes the world and the direction an entity is looking (e.g. teleporting to a saved location will make the teleported entity face the same saved direction every time).

Please note that the location of an entity is at it's feet, use head location to get the location of the head.

(location|position) of %location%
%location%'[s] (location|position)
Since

Location At

Expression

Allows to create a location from three coordinates and a world.

[the] (location|position) [at] [\(][x[ ][=[ ]]]%number%, [y[ ][=[ ]]]%number%, [and] [z[ ][=[ ]]]%number%[\)] [[(in|of) [[the] world]] %world%]
Since
2.0

log

Function

A logarithm, with base 10 if none is specified. This is the inverse operation to exponentiation (for positive bases only), i.e. log(base ^ exponent, base) = exponent for any positive number 'base' and any number 'exponent'.

Another useful equation is base ^ log(a, base) = a for any numbers 'base' and 'a'.

Please note that due to how numbers are represented in computers, these equations do not hold for all numbers, as the computed values may slightly differ from the correct value.

Returns NaN (not a number) if any of the arguments are negative.

log(n: number, base: number = 10)
Since
2.2
Returns
Number

Log

Effect

Writes text into a .log file. Skript will write these files to /plugins/Skript/logs.

NB: Using 'server.log' as the log file will write to the default server log. Omitting the log file altogether will log the message as '[Skript] [<script>.sk] <message>' in the server log.

log %texts% [(to|in) [file[s]] %texts%] [with [the|a] severity [of] (warning|severe)]
Since
2.0, 2.9.0 (severities)

Look At

Effect

Forces the mob(s) or player(s) to look at an entity, vector or location. Vanilla max head pitches range from 10 to 50.

(force|make) %living entities% [to] (face [towards]|look [(at|towards)]) (%entity%['s (feet|eyes)]|(feet|eyes) of %entity%) [at [head] [rotation] speed %number%] [[and] max[imum] [head] pitch %number%]
(force|make) %living entities% [to] (face [towards]|look [(at|towards)]) %vector/location% [at [head] [rotation] speed %number%] [[and] max[imum] [head] pitch %number%]
Since
2.7
Requirements
Paper 1.17+, Paper 1.19.1+ (Players & Look Anchors)

Loop

Section

Loop sections repeat their code with multiple values.

A loop will loop through all elements of the given expression, e.g. all players, worlds, items, etc. The conditions & effects inside the loop will be executed for every of those elements, which can be accessed with ‘loop-’, e.g. send "hello" to loop-player. When a condition inside a loop is not fulfilled the loop will start over with the next element of the loop. You can however use stop loop to exit the loop completely and resume code execution after the end of the loop.

Loopable Values

All expressions that represent more than one value, e.g. ‘all players’, ‘worlds’, etc., as well as list variables, can be looped. You can also use a list of expressions, e.g. loop the victim and the attacker, to execute the same code for only a few values.

List Variables

When looping list variables, you can also use loop-index in addition to loop-value inside the loop. loop-value is the value of the currently looped variable, and loop-index is the last part of the variable's name (the part where the list variable has its asterisk *).

loop %objects%
Since
1.0

Loop Iteration

Expression

Returns the loop's current iteration count (for both normal and while loops).

[the] loop(-| )(counter|iteration)[-%*number%]
Since
2.8.0

Loop value

New
Expression

Returns the previous, current, or next looped value.

[the] [current] loop-<.+>
[the] next loop-<.+>
[the] previous loop-<.+>
Since
1.0, 2.8.0 (loop-counter), 2.10 (previous, next)

Loot

Expression

The loot that will be generated in a 'loot generate' event.

[the] loot
Since
2.7
Requirements
MC 1.16+

Loot Context

New
Type

Represents additional information a loot table can use to modify its generated loot.

Some loot tables will require some values (i.e. looter, location, looted entity) in a loot context when generating loot whereas others may not.

For example, the loot table of a simple dungeon chest will only require a location, whereas the loot table of a cow will require a looting player, looted entity, and location.

You can find more information about this in https://minecraft.wiki/w/Loot_context

Since
2.10

Loot Context

New
Expression

The loot context involved in the context create section.

[the] loot[ ]context
Since
2.10

Loot Location of Loot Context

New
Expression

Returns the loot location of a loot context.

[the] loot[ing] [context] location [of %loot contexts%]
%loot contexts%'[s] loot[ing] [context] location
Since
2.10

Loot of Loot Table

New
Expression

Returns the items of a loot table using a loot context. Not specifying a loot context will use a loot context with a location at the world's origin.

[the] loot of %loot tables% [(with|using) %loot context%]
%loot tables%'[s] loot [(with|using) %loot context%]
Since
2.10

Loot Table

New
Type

Loot tables represent what items should be in naturally generated containers, what items should be dropped when killing a mob, or what items can be fished.

You can find more information about this in https://minecraft.wiki/w/Loot_table

Since
2.10

Loot Table

New
Expression

Returns the loot table of an entity or block.

Setting the loot table of a block will update the block state, and once opened will generate loot of the specified loot table. Please note that doing so may cause warnings in the console due to over-filling the chest.

Please note that resetting/deleting the loot table of an ENTITY will reset the entity's loot table to its default.

[the] loot[ ]table[s] of %entities/blocks%
%entities/blocks%'[s] loot[ ]table[s]
Since
2.10

Loot Table from Key

New
Expression

Returns the loot table from a namespaced key.

[the] loot[ ]table[s] %texts%
Since
2.10

Looted Entity of Loot Context

New
Expression

Returns the looted entity of a loot context.

[the] looted entity [of %loot contexts%]
%loot contexts%'[s] looted entity
Since
2.10

Looter of Loot Context

New
Expression

Returns the looter of a loot context. Note that setting the looter will read the looter's tool enchantments (e.g. looting) when generating loot.

[the] (looter|looting player) [of %loot contexts%]
%loot contexts%'[s] (looter|looting player)
Since
2.10

Lore

Expression

An item's lore.

[the] lore of %item stack/item type%
%item stack/item type%'[s] lore
[the] line %number% of [the] lore of %item stack/item type%
[the] line %number% of %item stack/item type%'[s] lore
[the] %number%(st|nd|rd|th) line of [the] lore of %item stack/item type%
[the] %number%(st|nd|rd|th) line of %item stack/item type%'[s] lore
Since
2.1

Love Time

New
Expression

The amount of time the animals have been in love for. Using a value of 30 seconds is equivalent to using an item to breed them.

Only works on animals that can be bred and returns '0 seconds' for animals that can't be bred.

[the] love[d] time of %living entities%
%living entities%'[s] love[d] time
Since
2.10

Lowest/Highest Solid Block

Expression

An expression to obtain the lowest or highest solid (impassable) block at a location.

Note that the y-coordinate of the location is not taken into account for this expression.

[the] (highest|lowest) [solid] block (at|of) %locations%
%locations%'[s] (highest|lowest) [solid] block
Since
2.2-dev34, 2.9.0 (lowest solid block, 'non-air' option removed, additional syntax option)

Luck of Loot Context

New
Expression

Returns the luck of a loot context as a float. This represents the luck potion effect that an entity can have.

[the] loot[ing] [context] luck [value|factor] [of %loot contexts%]
%loot contexts%'[s] loot[ing] [context] luck [value|factor]
Since
2.10

Make Adult/Baby

New
Effect

Force a animal to become an adult or baby.

make %living entities% [a[n]] (adult|baby)
force %living entities% to be[come] a[n] (adult|baby)
Since
2.10

Make Breedable

New
Effect

Sets whether or not entities will be able to breed. Only works on animals.

make %living entities% breedable
unsterilize %living entities%
make %living entities% (not |non(-| )|un)breedable
sterilize %living entities%
Since
2.10

Make Egg Hatch

Effect

Makes the egg hatch in a Player Egg Throw event.

make [the] egg [not] hatch
Since
2.7
Supported events
Egg Throw

Make Fire Resistant

Effect

Makes items fire resistant.

make %item types% [not] (fire resistant|resistant to fire)
Since
2.9.0
Requirements
Spigot 1.20.5+

Make Fly

Effect

Forces a player to start/stop flying.

force %players% to [(start|stop)] fly[ing]
make %players% (start|stop) flying
make %players% fly
Since
2.2-dev34

Make Incendiary

Effect

Sets if an entity's explosion will leave behind fire. This effect is also usable in an explosion prime event.

make %entities% [not] incendiary
make %entities%'[s] explosion [not] (incendiary|fiery)
make [the] [event(-| )]explosion [not] (incendiary|fiery)
Since
2.5

Make Invisible

Effect

Makes a living entity visible/invisible. This is not a potion and therefore does not have features such as a time limit or particles.

When setting an entity to invisible while using an invisibility potion on it, the potion will be overridden and when it runs out the entity keeps its invisibility.

make %living entities% (invisible|not visible)
make %living entities% (visible|not invisible)
Since
2.7

Make Invulnerable

Effect

Makes an entity invulnerable/not invulnerable.

make %entities% (invulnerable|invincible)
make %entities% (not (invulnerable|invincible)|vulnerable|vincible)
Since
2.5

Make Say

Effect

Forces a player to send a message to the chat. If the message starts with a slash it will force the player to use command.

make %players% (say|send [the] message[s]) %texts%
force %players% to (say|send [the] message[s]) %texts%
Since
2.3

Make Sign Glow

Effect

Makes a sign (either a block or item) have glowing text or normal text

make %blocks/item types% have glowing text
make %blocks/item types% have (normal|non[-| ]glowing) text
Since
2.8.0

Matches

Condition

Checks whether the defined strings match the input regexes (Regular expressions).

%texts% (match[es]|do[es](n't| not) match) %texts%
%texts% (partially match[es]|do[es](n't| not) partially match) %texts%
Since
2.5.2

max

Function

Returns the maximum number from a list of numbers.

max(ns: numbers)
Since
2.2
Returns
Number

Max Durability

Expression

The maximum durability of an item. Changing requires Minecraft 1.20.5+

Note: 'delete' will remove the max durability from the item (making it a non-damageable item). Delete requires Paper 1.21+

[the] max[imum] (durabilit(y|ies)|damage) of %item types/item stacks/slots%
%item types/item stacks/slots%'[s] max[imum] (durabilit(y|ies)|damage)
Since
2.5, 2.9.0 (change)
Requirements
Minecraft 1.20.5+ (custom amount)

Max Health

Expression

The maximum health of an entity, e.g. 10 for a player.

[the] max[imum] health of %living entities%
%living entities%'[s] max[imum] health
Since
2.0
Supported events
damage, death

Max Item Use Time

Expression

Returns the max duration an item can be used for before the action completes. E.g. it takes 1.6 seconds to drink a potion, or 1.4 seconds to load an unenchanted crossbow.

Some items, like bows and shields, do not have a limit to their use. They will return 1 hour.

[the] max[imum] [item] us(e|age) (time|duration) of %item stacks%
%item stacks%'[s] max[imum] [item] us(e|age) (time|duration)
Since
2.8.0
Requirements
Paper

Max Minecart Speed

Expression

The maximum speed of a minecart.

[the] max[imum] minecart (speed|velocity) of %entities%
%entities%'[s] max[imum] minecart (speed|velocity)
Since
2.5.1

Max Players

Expression

The count of max players. This can be changed in a server list ping event only.

'real max players' returns the real count of max players of the server and can be modified on Paper 1.16 or later.

[the] [(real|default)|(fake|shown|displayed)] max[imum] player[s] [count|amount|number|size]
[the] [(real|default)|(fake|shown|displayed)] max[imum] (count|amount|number|size) of players
Since
2.3, 2.7 (modify max real players)
Requirements
Paper 1.16+ (modify max real players)

Maximum Freeze Time

Expression

The maximum amount of time an entity can spend in powdered snow before taking damage.

[the] max[imum] freeze time of %entities%
%entities%'[s] max[imum] freeze time
Since
2.7

Maximum Stack Size

New
Expression

The maximum stack size of an item (e.g. 64 for torches, 16 for buckets, 1 for swords, etc.) or inventory.

In 1.20.5+, the maximum stack size of items can be changed to any integer from 1 to 99, and stacked up to the maximum stack size of the inventory they're in.

[the] max[imum] stack[[ ]size] of %item types/inventories%
%item types/inventories%'[s] max[imum] stack[[ ]size]
Since
2.1, 2.10 (changeable, inventories)
Requirements
Spigot 1.20.5+ (changeable)

Me

Expression

A 'me' expression that can be used in players' effect commands only.

me
my[self]
Since
2.1.1

Mending Repair Amount

Expression

The number of durability points an item is to be repaired in a mending event.

Modifying the repair amount will affect how much experience is given to the player after mending.

[the] [mending] repair amount
Since
2.5.1

Message

Effect

Sends a message to the given player. Only styles written

in given string or in formatted expressions will be parsed.

Adding an optional sender allows the messages to be sent as if a specific player sent them.

This is useful with Minecraft 1.16.4's new chat ignore system, in which players can choose to ignore other players,

but for this to work, the message needs to be sent from a player.

(message|send [message[s]]) %objects% [to %command senders%] [from %player%]
Since
1.0, 2.2-dev26 (advanced features), 2.5.2 (optional sender), 2.6 (sending objects)
Requirements
Minecraft 1.16.4+ for optional sender

Message

New
Expression

The (chat) message of a chat event, the join message of a join event, the quit message of a quit event, the death message of a death event or the broadcasted message in a broadcast event. This expression is mostly useful for being changed.

[the] [chat( |-)]message
[the] (join|log[ ]in)( |-)message
[the] (quit|leave|log[ ]out|kick)( |-)message
[the] death( |-)message
[the] broadcast(-|[ed] )message
Since
1.4.6 (chat message), 1.4.9 (join & quit messages), 2.0 (death message), 2.9.0 (clear message), 2.10 (broadcasted message)
Supported events
chat, join, quit, death, broadcast

Metadata

New
Expression

Metadata is a way to store temporary data on entities, blocks and more that disappears after a server restart.

metadata [(value|tag)[s]] %texts% of %metadata holders%
%metadata holders%'[s] metadata [(value|tag)[s]] %text%
Since
2.2-dev36, 2.10 (add, remove)

Metadata Holder

Type

Something that can hold metadata (e.g. an entity or block)

Since
2.2-dev36

Middle of Location

Expression

Returns the middle/center of a location. In other words, returns the middle of the X, Z coordinates and the floor value of the Y coordinate of a location.

[the] (middle|center) [point] of %location%
%location%'[s] (middle|center) [point]
Since
2.6.1

min

Function

Returns the minimum number from a list of numbers.

min(ns: numbers)
Since
2.2
Returns
Number

Minecart Derailed / Flying Velocity

Expression

The velocity of a minecart as soon as it has been derailed or as soon as it starts flying.

[the] [minecart] (derailed|flying) velocity of %entities%
%entities%'[s] [minecart] (derailed|flying) velocity
Since
2.5.1

Minecraft Tag

New
Type

A tag that classifies a material, or entity.

Since
2.10

mod

Function

Returns the modulo of the given arguments, i.e. the remainder of the division d/m, where d and m are the arguments of this function.

The returned value is always positive. Returns NaN (not a number) if the second argument is zero.

mod(d: number, m: number)
Since
2.2
Returns
Number

Moon Phase

Type

Represents the phase of a moon.

last quarter, waning crescent, waxing gibbous, full moon, waning gibbous, waxing crescent, new moon, first quarter
Since
2.7
Requirements
Paper 1.16+

Moon Phase

Expression

The current moon phase of a world.

[the] (lunar|moon) phase[s] of %worlds%
%worlds%'[s] (lunar|moon) phase[s]
Since
2.7
Requirements
Paper 1.16+

MOTD

Expression

The message of the day in the server list. This can be changed in a server list ping event only.

'default MOTD' returns the default MOTD always and can't be changed.

[the] [(default)|(shown|displayed)] (MOTD|message of [the] day)
Since
2.3

Moved blocks

Expression

Blocks which are moved in a piston event. Cannot be used outside of piston events.

[the] moved blocks
Since
2.2-dev27

Name / Display Name / Tab List Name

Expression

Represents the Minecraft account, display or tab list name of a player, or the custom name of an item, entity, block, inventory, gamerule, world, script or function.

Players:

Name: The Minecraft account name of the player. Can't be changed, but 'display name' can be changed.

Display Name: The name of the player that is displayed in messages. This name can be changed freely and can include color codes, and is shared among all plugins (e.g. chat plugins will use the display name).

Entities:

Name: The custom name of the entity. Can be changed. But for living entities, the players will have to target the entity to see its name tag. For non-living entities, the name will not be visible at all. To prevent this, use 'display name'.

Display Name: The custom name of the entity. Can be changed, which will also enable custom name visibility of the entity so name tag of the entity will be visible always.

Items:

Name and Display Name: The custom name of the item (not the Minecraft locale name). Can be changed.

Inventories:

Name and Display Name: The name/title of the inventory. Changing name of an inventory means opening the same inventory with the same contents but with a different name to its current viewers.

Gamerules:

Name: The name of the gamerule. Cannot be changed.

Worlds:

Name: The name of the world. Cannot be changed.

Scripts:

Name: The name of a script, excluding its file extension.

[the] name[s] of %offline players/entities/named things/inventories%
%offline players/entities/named things/inventories%'[s] name[s]
[the] (display|nick|chat|custom)[ ]name[s] of %offline players/entities/named things/inventories%
%offline players/entities/named things/inventories%'[s] (display|nick|chat|custom)[ ]name[s]
[the] (player|tab)[ ]list name[s] of %players%
%players%'[s] (player|tab)[ ]list name[s]
Since
before 2.1, 2.2-dev20 (inventory name), 2.4 (non-living entity support, changeable inventory name), 2.7 (worlds)

Named Item/Inventory

Expression

Directly names an item/inventory, useful for defining a named item/inventory in a script. If you want to (re)name existing items/inventories you can either use this expression or use set name of <item/inventory> to <text>.

%item type/inventory type% (named|with name[s]) %text%
Since
2.0, 2.2-dev34 (inventories)

Nearest Entity

Expression

Gets the entity nearest to a location or another entity.

[the] nearest %*entity types% [[relative] to %entity/location%]
[the] %*entity types% nearest [to %entity/location%]
Since
2.7

New Line

Expression

Returns a line break separator.

nl
new[ ]line
line[ ]break
Since
2.5

No Damage Ticks

Expression

The number of ticks that an entity is invulnerable to damage for.

[the] (invulnerability|invincibility|no damage) tick[s] of %living entities%
%living entities%'[s] (invulnerability|invincibility|no damage) tick[s]
Since
2.5

Node

New
Type

A node (entry) from a script config file.

This may have navigable children.

Since
2.10

Node (Experimental)

New
Expression

Returns a node inside a config (or another section-node).

Nodes in Skript configs are written in the format `key: value`.

Section nodes can contain other nodes.

[the] node %text% (of|in) %node%
%node%'[s] node %text%
[the] nodes (of|in) %nodes%
%node%'[s] nodes
Since
2.10

Now

Expression

The current system time of the server. Use time to get the Minecraft time of a world.

now
Since
1.4

Number

Type

A number, e.g. 2.5, 3, -9812454, 30 degrees or 3.14 radians.

Please note that many expressions only need integers, i.e. will discard any fractional parts of any numbers without producing an error.

Radians will be converted to degrees.

[-]###[.###] [[in ](rad[ian][s]|deg[ree][s])]</code> (any amount of digits; very large numbers will be truncated though)
Since
1.0

Number of Characters

Expression

The number of uppercase, lowercase, or digit characters in a string.

number of upper[ ]case char(acters|s) in %text%
number of lower[ ]case char(acters|s) in %text%
number of digit char(acters|s) in %text%
Since
2.5

Numbers

Expression

All numbers between two given numbers, useful for looping.

Use 'numbers' if your start is not an integer and you want to keep the fractional part of the start number constant, or use 'integers' if you only want to loop integers.

You may also use 'decimals' if you want to use the decimal precision of the start number.

You may want to use the 'times' expression instead, for instance 'loop 5 times:'

[(all [[of] the]|the)] (numbers|integers|decimals) (between|from) %number% (and|to) %number%
Since
1.4.6 (integers & numbers), 2.5.1 (decimals)

Object

Type

The supertype of all types, meaning that if %object% is used in e.g. a condition it will accept all kinds of expressions.

Since
1.0

Offline Player

Type

A player that is possibly offline. See player for more information. Please note that while all effects and conditions that require a player can be used with an offline player as well, they will not work if the player is not actually online.

Parsing an offline player as a player (online) will return nothing (none), for that case you would need to parse as offlineplayer which only returns nothing (none) if player doesn't exist in Minecraft databases (name not taken) otherwise it will return the player regardless of their online status.
Since
2.0 beta 8

Offline players

Expression

All players that have ever joined the server. This includes the players currently online.

[(all [[of] the]|the)] offline[ ]players
Since
2.2-dev35

offlineplayer

Function

Returns a offline player from their name or UUID. This function will still return the player if they're online. If Paper 1.16.5+ is used, the 'allowLookup' parameter can be set to false to prevent this function from doing a web lookup for players who have not joined before. Lookups can cause lag spikes of up to multiple seconds, so use offline players with caution.

offlineplayer(nameOrUUID: string, allowLookups: boolean = true)
Since
2.8.0, 2.9.0 (prevent lookups)
Returns
Offline Player

On Anvil Damage

Event
Cancellable

Called when an anvil is damaged/broken from being used to repair/rename items.

Note: this does not include anvil damage from falling.

anvil damag(e|ing)
Since
2.7
Requirements
Paper

On Anvil Prepare

Event

Called when an item is put in a slot for repair by an anvil. Please note that this event is called multiple times in a single item slot move.

anvil prepar(e|ing)
Since
2.7

On AoE Cloud Effect

Event
Cancellable

Called when area effect cloud applies its potion effect. This happens every 5 ticks by default.

(area|AoE) [cloud] effect
Since
2.2-dev21

On Arm Swing

Event
Cancellable

Called when a player swings their arm.

[player] arm swing
Since
2.5.1

On Armor Change

Event

Called when armor pieces of a player are changed.

[player] armo[u]r change[d]
Since
2.5
Requirements
Paper

On Beacon Change Effect

New
Event
Cancellable

Called when a player changes the effects of a beacon.

beacon change effect
beacon effect change
player chang(e[s]|ing) [of] beacon effect
Since
2.10
Requirements
Paper

On Beacon Effect

Event
Cancellable
[primary|secondary] beacon effect [of %potion effect types%]
application of [primary|secondary] beacon effect [of %potion effect types%]
[primary|secondary] beacon effect apply [of %potion effect types%]

On Beacon Toggle

Event
beacon toggle
beacon activat(e|ion)
beacon deactivat(e|ion)

On Bed Enter

Event
Cancellable

Called when a player starts sleeping.

bed enter[ing]
[player] enter[ing] [a] bed
Since
1.0

On Bed Leave

Event
Cancellable

Called when a player leaves a bed.

bed leav(e|ing)
[player] leav(e|ing) [a] bed
Since
1.0

On Bell Resonate

Event

Called when a bell resonates, highlighting nearby raiders.

bell resonat(e|ing)
Since
2.9.0
Requirements
Spigot 1.19.4+

On Bell Ring

Event
Cancellable

Called when a bell is rung.

bell ring[ing]
Since
2.9.0
Requirements
Spigot 1.19.4+ or Paper 1.16.5+ (no event-direction)

On Block Damage

Event
Cancellable

Called when a player starts to break a block. You can usually just use the leftclick event for this.

block damag(ing|e)
Since
1.0

On Block Drop

New
Event
Cancellable

Called when a block broken by a player drops something.

  • event-player: The player that broke the block
  • past event-block: The block that was broken
  • event-block: The block after being broken
  • event-items (or drops): The drops of the block
  • event-entities: The entities of the dropped items

If the breaking of the block leads to others being broken, such as torches, they will appearin "event-items" and "event-entities".

block drop[ping] [[of] %item types/block datas%]
Since
2.10

On Block Fertilize

Event
Cancellable

Called when a player fertilizes blocks.

[block] fertilize
Since
2.5
Requirements
Minecraft 1.13 or newer

On Block Growth

Event
Cancellable

Called when a crop grows. Alternative to new form of generic grow event.

(plant|crop|block) grow[(th|ing)] [[of] %item types%]
Since
2.2-Fixes-V10

On Book Edit

Event
Cancellable

Called when a player edits a book.

book (edit|change|write)
Since
2.2-dev31

On Book Sign

Event
Cancellable

Called when a player signs a book.

book sign[ing]
Since
2.2-dev31

On Break / Mine

Event
Cancellable

Called when a block is broken by a player. If you use 'on mine', only events where the broken block dropped something will call the trigger.

[block] (break[ing]|min(e|ing)) [[of] %item types/block datas%]
Since
1.0 (break), unknown (mine), 2.6 (BlockData support)

On Broadcast

New
Event
Cancellable

Called when a message is broadcasted.

broadcast
Since
2.10

On Bucket Catch Entity

Event
Cancellable
bucket (catch[ing]|captur(e|ing)) [[of] %entity types%]

On Bucket Empty

Event
Cancellable

Called when a player empties a bucket. You can also use the place event with a check for water or lava.

bucket empty[ing]
[player] empty[ing] [a] bucket
Since
1.0

On Bucket fill

Event
Cancellable

Called when a player fills a bucket.

bucket fill[ing]
[player] fill[ing] [a] bucket
Since
1.0

On Burn

Event
Cancellable

Called when a block is destroyed by fire.

[block] burn[ing] [[of] %item types/block datas%]
Since
1.0, 2.6 (BlockData support)

On Can Build Check

Event
Cancellable

Called when a player rightclicks on a block while holding a block or a placeable item. You can either cancel the event to prevent the block from being built, or uncancel it to allow it.

Please note that the data value of the block to be placed is not available in this event, only its ID.

[block] can build check
Since
1.0 (basic), 2.0 ([un]cancellable)

On Chat

Event
Cancellable

Called whenever a player chats.

Use chat format to change message format.

Use chat recipients to edit chat recipients.

chat
Since
1.4.1

On Chunk Generate

Event

Called after a new chunk was generated.

chunk (generat|populat)(e|ing)
Since
1.0

On Chunk Load

Event

Called when a chunk loads. The chunk might or might not contain mobs when it's loaded.

chunk load[ing]
Since
1.0

On Chunk Unload

Event

Called when a chunk is unloaded due to not being near any player.

chunk unload[ing]
Since
1.0

On Click

New
Event
Cancellable

Called when a user clicks on a block, an entity or air with or without an item in their hand.

Please note that rightclick events with an empty hand while not looking at a block are not sent to the server, so there's no way to detect them.

Also note that a leftclick on an entity is an attack and thus not covered by the 'click' event, but the 'damage' event.

[(right|left)[( |-)]][mouse[( |-)]]click[ing] [on %entity type/item type/block data%] [(with|using|holding) %item type%]
[(right|left)[( |-)]][mouse[( |-)]]click[ing] (with|using|holding) %item type% on %entity type/item type/block data%
Since
1.0, 2.10 (blockdata)

On Combust

Event
Cancellable

Called when an entity is set on fire, e.g. by fire or lava, a fireball, or by standing in direct sunlight (zombies, skeletons).

combust[ing]
Since
1.0

On Command

Event
Cancellable

Called when a player enters a command (not necessarily a Skript command) but you can check if command is a skript command, see Is a Skript command condition.

command [%texts%]
Since
2.0

On Connect

Event

Called when the player connects to the server. This event is called before the player actually joins the server, so if you want to prevent players from joining you should prefer this event over on join.

[player] connect[ing]
Since
2.0

On Consume

Event
Cancellable

Called when a player is done eating/drinking something, e.g. an apple, bread, meat, milk or a potion.

[player] ((eat|drink)[ing]|consum(e|ing)) [[of] %item types%]
Since
2.0

On Craft

Event
Cancellable

Called when a player crafts an item.

[player] craft[ing] [[of] %item types%]
Since
unknown (before 2.1)

On Creeper Power

Event
Cancellable

Called when a creeper is struck by lighting and gets powered. Cancel the event to prevent the creeper from being powered.

creeper power
Since
1.0

On Damage

Event
Cancellable

Called when an entity receives damage, e.g. by an attack from another entity, lava, fire, drowning, fall, suffocation, etc.

damag(e|ing) [of %entity type%] [by %entity type%]
Since
1.0, 2.7 (by entity)

On Death

Event
Cancellable

Called when a living entity (including players) dies.

death [of %entity types%]
Since
1.0

On Dispense

Event
Cancellable

Called when a dispenser dispenses an item.

dispens(e|ing) [[of] %item types%]
Since
unknown (before 2.1)

On Drop

Event
Cancellable

Called when a player drops an item from their inventory, or an entity drops an item, such as a chicken laying an egg.

[player|entity] drop[ping] [[of] %item types%]
Since
unknown (before 2.1), 2.7 (entity)

On Egg Throw

Event

Called when a player throws an egg and it lands. You can just use the shoot event in most cases. However, this event allows modification of properties like the hatched entity type and the number of entities to hatch.

throw[ing] [of] [an] egg
[player] egg throw
Since
1.0

On Elytra Boost

New
Event
Cancellable

Called when a player uses a firework to boost their fly speed when flying with an elytra.

elytra boost
Since
2.10
Requirements
Paper

On Enchant

Event
Cancellable

Called when a player successfully enchants an item.

To get the enchanted item, see the enchant item expression

[item] enchant
Since
2.5

On Enchant Prepare

Event
Cancellable

Called when a player puts an item into enchantment table. This event may be called multiple times.

To get the enchant item, see the enchant item expression

[item] enchant prepare
Since
2.5

On Enderman Enrage

Event
Cancellable

Called when an enderman gets mad because a player looked at them.

Note: This does not stop enderman from targeting the player as a result of getting damaged.

enderman (enrage|anger)
Since
2.9.0
Requirements
Paper

On Enderman/Sheep/Silverfish/Falling Block

Event
Cancellable

Called when an enderman places or picks up a block, a sheep eats grass, a silverfish boops into/out of a block or a falling block lands and turns into a block respectively.

event-block represents the old block and event-blockdata represents the new replacement that'll be applied to the block.

enderman place
enderman pickup
sheep eat
silverfish enter
silverfish exit
falling block fall[ing]
falling block land[ing]
(entity|%*-entitydatas%) chang(e|ing) block[s]
Since
unknown, 2.5.2 (falling block), 2.8.0 (any entity support)

On Entity Breed

New
Event
Cancellable

Called whenever two animals begin to conceive a child. The type can be specified.

[entity] breed[ing] [of %entity types%]
Since
2.10

On Entity Dismount

Event
Cancellable

Called when an entity dismounts.

dismount[ing]
Since
2.2-dev13b

On Entity Jump

Event
Cancellable

Called when an entity jumps.

entity jump[ing]
Since
2.7
Requirements
Paper 1.15.2+

On Entity Mount

Event
Cancellable

Called when entity starts riding another.

mount[ing]
Since
2.2-dev13b

On Entity Portal

Event
Cancellable

Called when an entity uses a nether or end portal. Cancel the event to prevent the entity from teleporting.

entity portal
Since
2.5.3

On Entity Potion Effect

New
Event
Cancellable

Called when an entity's potion effect is modified.

This modification can include adding, removing or changing their potion effect.

entity potion effect [modif[y|ication]] [[of] %potion effect types%] [due to %entity potion cause%]
Since
2.10

On Entity Transform

Event
Cancellable

Called when an entity is about to be replaced by another entity.

Examples when it's called include; when a zombie gets cured and a villager spawns, an entity drowns in water like a zombie that turns to a drown, an entity that gets frozen in powder snow, a mooshroom that when sheared, spawns a new cow.

(entit(y|ies)|%*-entitydatas%) transform[ing] [due to %transform reasons%]
Since
2.8.0

On Experience Change

Event

Called when a player's experience changes.

[player] (level progress|[e]xp|experience) (change|update|increase|decrease)
Since
2.7

On Experience Cooldown Change

New
Event

Called when a player's experience cooldown changes.

Experience cooldown is how long until a player can pick up another orb of experience.

player (experience|[e]xp) cooldown change
Since
2.10

On Experience Spawn

Event
Cancellable

Called whenever experience is about to spawn.

Please note that this event will not fire for xp orbs spawned by plugins (including Skript) with Bukkit.

[e]xp[erience] [orb] spawn
spawn of [a[n]] [e]xp[erience] [orb]
Since
2.0

On Explode

Event
Cancellable

Called when an entity (a primed TNT or a creeper) explodes.

explo(d(e|ing)|sion)
Since
1.0

On Explosion Prime

Event
Cancellable

Called when an explosive is primed, i.e. an entity will explode shortly. Creepers can abort the explosion if the player gets too far away, while TNT will explode for sure after a short time.

explosion prime
Since
1.0

On Fade

Event
Cancellable

Called when a block 'fades away', e.g. ice or snow melts.

[block] fad(e|ing) [[of] %item types/block datas%]
Since
1.0, 2.6 (BlockData support)

On Firework Explode

Event
Cancellable

Called when a firework explodes.

[a] firework explo(d(e|ing)|sion) [colo[u]red %colors%]
Since
2.4

On First Join

Event

Called when a player joins the server for the first time.

first (join|login)
Since
1.3.7

On Fishing

New
Event
Cancellable

Called when a player triggers a fishing event.

An entity hooked event is triggered when an entity gets caught by a fishing rod.

A fish escape event is called when the player fails to click on time, and the fish escapes.

A fish approaching event is when the bobber is waiting to be hooked, and a fish is approaching.

[fishing] (line|rod) cast
fish (caught|catch)
entity (hook[ed]|caught|catch)
(bobber|hook) (in|hit) ground
fish (escape|get away)
[fishing] (rod|line) reel in
fish bit(e|ing)
(fish approach[ing]|(bobber|hook) lure[d])
Since
2.10
Requirements
Paper (bobber lured)

On Flight Toggle

Event
Cancellable

Called when a players stops/starts flying.

[player] flight toggl(e|ing)
[player] toggl(e|ing) flight
Since
2.2-dev36

On Flow

Event
Cancellable

Called when a blocks flows or teleports to another block. This not only applies to water and lava, but teleporting dragon eggs as well.

[block] flow[ing]
block mov(e|ing)
Since
1.0

On Form

Event
Cancellable

Called when a block is created, but not by a player, e.g. snow forms due to snowfall, water freezes in cold biomes. This isn't called when block spreads (mushroom growth, water physics etc.), as it has its own event (see spread event).

[block] form[ing] [[of] %item types/block datas%]
Since
1.0, 2.6 (BlockData support)

On Fuel Burn

New
Event
Cancellable

Called when a furnace burns an item from its fuel slot.

[furnace] fuel burn[ing] [of %item types%]
Since
1.0, 2.10 (specific item)

On Furnace Item Extract

New
Event

Called when a player takes any item out of the furnace.

furnace [item] extract[ion] [of %item types%]
Since
2.10

On Gamemode Change

Event
Cancellable

Called when a player's gamemode changes.

game[ ]mode change [to %gamemode%]
Since
1.0

On Gliding State Change

Event
Cancellable

Called when an entity toggles glider on or off, or when server toggles gliding state of an entity forcibly.

(gliding state change|toggl(e|ing) gliding)
Since
2.2-dev21

On Grow

Event
Cancellable

Called when a tree, giant mushroom or plant grows to next stage.

"of" matches any grow event, "from" matches only the old state, "into" matches only the new state,and "from into" requires matching both the old and new states.

Using "and" lists in this event is equivalent to using "or" lists. The event will trigger if any one of the elements is what grew.

grow[th] [of (%tree types%|%item types/block datas%)]
grow[th] from %item types/block datas%
grow[th] [in]to (%tree types%|%item types/block datas%)
grow[th] from %item types/block datas% [in]to (%tree types%|%item types/block datas%)
Since
1.0, 2.2-dev20 (plants), 2.8.0 (from, into, blockdata)

On Hand Item Swap

Event
Cancellable

Called whenever a player swaps the items in their main- and offhand slots.

Works also when one or both of the slots are empty.

The event is called before the items are actually swapped,

so when you use the player's tool or player's offtool expressions,

they will return the values before the swap -

this enables you to cancel the event before anything happens.

swap[ping of] [(hand|held)] item[s]
Since
2.3

On Heal

Event
Cancellable

Called when an entity is healed, e.g. by eating (players), being fed (pets), or by the effect of a potion of healing (overworld mobs) or harm (nether mobs).

heal[ing] [of %entity types%] [(from|due to|by) %heal reasons%]
%entity types% heal[ing] [(from|due to|by) %heal reasons%]
Since
1.0, 2.9.0 (by reason)

On Horse Jump

Event
Cancellable

Called when a horse jumps.

horse jump
Since
2.5.1

On Hunger Meter Change

Event
Cancellable

Called when the hunger bar of a player changes, i.e. either increases by eating or decreases over time.

(food|hunger) (level|met(er|re)|bar) chang(e|ing)
Since
1.4.4

On Ignition

Event
Cancellable

Called when a block starts burning, i.e. a fire block is placed next to it and this block is flammable.

The burn event will be called when the block is about do be destroyed by the fire.

[block] ignit(e|ion)
Since
1.0

On Inventory Click

Event
Cancellable

Called when clicking on inventory slot.

[player] inventory(-| )click[ing] [[at] %item types%]
Since
2.2-Fixes-V10

On Inventory Close

Event

Called when player's currently viewed inventory is closed.

inventory clos(ing|e[d])
Since
2.2-dev21

On Inventory Drag

Event
Cancellable

Called when a player drags an item in their cursor across the inventory.

inventory drag[ging]
Since
2.7

On Inventory Item Move

Event
Cancellable

Called when an entity or block (e.g. hopper) tries to move items directly from one inventory to another.

When this event is called, the initiator may have already removed the item from the source inventory and is ready to move it into the destination inventory.

If this event is cancelled, the items will be returned to the source inventory.

inventory item (move|transport)
inventory (mov(e|ing)|transport[ing]) [an] item
Since
2.8.0

On Inventory Open

Event
Cancellable

Called when an inventory is opened for player.

inventory open[ed]
Since
2.2-dev21

On Inventory Pickup

Event
Cancellable

Called when an inventory (a hopper, a hopper minecart, etc.) picks up an item

inventory pick[ ]up
Since
2.5.1

On Inventory Slot Change

Event

Called when a slot in a player's inventory is changed.

Warning: setting the event-slot to a new item can result in an infinite loop.

[player] inventory slot chang(e|ing)
Since
2.7
Requirements
Paper 1.19.2+

On Item Break

Event

Called when a player breaks their tool because its damage reached the maximum value.

This event cannot be cancelled.

[player] tool break[ing]
[player] break[ing] [(a|the)] tool
Since
2.1.1

On Item Damage

Event
Cancellable

Called when an item is damaged. Most tools are damaged by using them; armor is damaged when the wearer takes damage.

item damag(e|ing)
Since
2.5

On Item Despawn

Event
Cancellable

Called when an item is about to be despawned from the world, usually 5 minutes after it was dropped.

(item[ ][stack]|[item] %item types%) despawn[ing]
[item[ ][stack]] despawn[ing] [[of] %item types%]
Since
2.2-dev35

On Item Mend

Event
Cancellable

Called when a player has an item repaired via the Mending enchantment.

item mend[ing]
Since
2.5.1
Requirements
Minecraft 1.13 or newer

On Item Merge

Event
Cancellable

Called when dropped items merge into a single stack. event-entity will be the entity which is trying to merge, and future event-entity will be the entity which is being merged into.

(item[ ][stack]|[item] %item types%) merg(e|ing)
item[ ][stack] merg(e|ing) [[of] %item types%]
Since
2.2-dev35

On Item Spawn

Event
Cancellable

Called whenever an item stack is spawned in a world, e.g. as drop of a block or mob, a player throwing items out of their inventory, or a dispenser dispensing an item (not shooting it).

item spawn[ing] [[of] %item types%]
Since
unknown (before 2.1)

On Join

Event

Called when the player joins the server. The player is already in a world when this event is called, so if you want to prevent players from joining you should prefer on connect over this event.

[player] (login|logging in|join[ing])
Since
1.0

On Jump

Event
Cancellable

Called whenever a player jumps.

This event requires PaperSpigot.

[player] jump[ing]
Since
2.3

On Kick

Event
Cancellable

Called when a player is kicked from the server. You can change the kick message or cancel the event entirely.

[player] (kick|being kicked)
Since
1.0

On Language Change

Event

Called after a player changed their language in the game settings. You can use the language expression to get the current language of the player.

This event requires Minecraft 1.12+.

[player] (language|locale) chang(e|ing)
[player] chang(e|ing) (language|locale)
Since
2.3

On Leash / Unleash

New
Event
Cancellable

Called when an entity is leashed or unleashed. Cancelling these events will prevent the leashing or unleashing from occurring.

[player] [un]leash[ing] [of %entity types%]
Since
2.10

On Leaves Decay

Event
Cancellable

Called when a leaf block decays due to not being connected to a tree.

leaves decay[ing]
Since
1.0

On Level Change

Event

Called when a player's level changes, e.g. by gathering experience or by enchanting something.

[player] level (change|up|down)
Since
1.0, 2.4 (level up/down)

On Lightning Strike

Event
Cancellable

Called when lightning strikes.

lightning [strike]
Since
1.0

On Loot Generate

Event
Cancellable

Called when a loot table of an inventory is generated in the world.

For example, when opening a shipwreck chest.

loot generat(e|ing)
Since
2.7
Requirements
MC 1.16+

On Love Mode Enter

New
Event
Cancellable

Called whenever an entity enters a state of being in love.

[entity] enter[s] love mode
[entity] love mode [enter]
Since
2.10

On Move / Rotate

Event
Cancellable

Called when a player or entity moves or rotates their head.

NOTE: Move event will only be called when the entity/player moves position, keyword 'turn around' is for orientation (ie: looking around), and the combined syntax listens for both.

NOTE: These events can be performance heavy as they are called quite often.

%entity type% (move|walk|step|(turn[ing] around|rotate))
%entity type% (move|walk|step) or (turn[ing] around|rotate)
%entity type% (turn[ing] around|rotate) or (move|walk|step)
Since
2.6, 2.8.0 (turn around)
Requirements
Paper 1.16.5+ (entity move)

On Move On

Event
Cancellable

Called when a player moves onto a certain type of block.

Please note that using this event can cause lag if there are many players online.

(step|walk)[ing] (on|over) %*item types%
Since
2.0

On Physics

Event
Cancellable

Called when a physics check is done on a block. By cancelling this event you can prevent some things from happening, e.g. sand falling, dirt turning into grass, torches dropping if their supporting block is destroyed, etc.Please note that using this event might cause quite some lag since it gets called extremely often.

[block] physics
Since
1.4.6

On Pick Up

Event
Cancellable

Called when a player/entity picks up an item. Please note that the item is still on the ground when this event is called.

[(player|entity)] (pick[ ]up|picking up) [[of] %item types%]
Since
unknown (before 2.1), 2.5 (entity)

On Pig Zap

Event
Cancellable

Called when a pig is stroke by lightning and transformed into a zombie pigman. Cancel the event to prevent the transformation.

pig[ ]zap
Since
1.0

On Piglin Barter

New
Event
Cancellable

Called when a piglin finishes bartering. A piglin may start bartering after picking up an item on its bartering list.

Cancelling will prevent piglins from dropping items, but will still make them pick up the input.

piglin (barter[ing]|trad(e|ing))
Since
2.10
Requirements
Minecraft 1.16+

On Piston Extend

Event
Cancellable

Called when a piston is about to extend.

piston extend[ing]
Since
1.0

On Piston Retract

Event
Cancellable

Called when a piston is about to retract.

piston retract[ing]
Since
1.0

On Place

Event
Cancellable

Called when a player places a block.

[block] (plac(e|ing)|build[ing]) [[of] %item types/block datas%]
Since
1.0, 2.6 (BlockData support)

On Player Chunk Enter

Event
Cancellable

Called when a player enters a chunk. Note that this event is based on 'player move' event, and may be called frequent internally.

[player] (enter[s] [a] chunk|chunk enter[ing])
Since
2.7

On Player Deep Sleep

Event
Cancellable

Called when a player has slept long enough to count as passing the night/storm.

Cancelling this event will prevent the player from being counted as deeply sleeping unless they exit and re-enter the bed.

[player] deep sleep[ing]
Since
2.7
Requirements
Paper 1.16+

On Player Input

New
Event

Called when a player sends an updated input to the server.

Note: The input keys event value is the set of keys the player is currently pressing, not the keys that were pressed or released.

[player] (toggle|toggling|press[ing]|release|releasing) of (%input keys%|(an|any) input key)
([player] %input keys%|[an|any [player]] input key) (toggle|toggling|press[ing]|release|releasing)
Since
2.10
Requirements
Minecraft 1.21.3+

On Player Pickup Arrow

Event
Cancellable

Called when a player picks up an arrow from the ground.

[player] (pick[ing| ]up [an] arrow|arrow pick[ing| ]up)
Since
2.8.0
Requirements
Minecraft 1.14+ (event-projectile)

On Player Trade

Event
Cancellable

Called when a player has traded with a villager.

player trad(e|ing)
Since
2.7
Requirements
Paper 1.16.5+

On Player World Change

Event

Called when a player enters a world. Does not work with other entities!

[player] world chang(ing|e[d])
Since
2.2-dev28

On Portal

Event
Cancellable

Called when a player uses a nether or end portal. Cancel the event to prevent the player from teleporting.

[player] portal
Since
1.0

On Portal Create

Event
Cancellable

Called when a portal is created, either by a player or mob lighting an obsidian frame on fire, or by a nether portal creating its teleportation target in the nether/overworld.

In Minecraft 1.14+, you can use the player in this event.

Please note that there may not always be a player (or other entity) in this event.

portal creat(e|ion)
Since
1.0, 2.5.3 (event-entity support)
Requirements
Minecraft 1.14+ (event-entity support)

On Portal Enter

Event
Cancellable

Called when an entity enters a nether portal or an end portal. Please note that this event will be fired many times for a nether portal.

portal enter[ing]
entering [a] portal
Since
1.0

On Prepare Craft

Event

Called just before displaying crafting result to player. Note that setting the result item might or might not work due to Bukkit bugs.

[player] (preparing|beginning) craft[ing] [[of] %item types%]
Since
2.2-Fixes-V10

On Pressure Plate / Trip

Event
Cancellable

Called when a player steps on a pressure plate or tripwire respectively.

[step[ping] on] [a] [pressure] plate
(trip|[step[ping] on] [a] tripwire)
Since
1.0 (pressure plate), 1.4.4 (tripwire)

On Projectile Collide

Event
Cancellable

Called when a projectile collides with an entity.

projectile collide
Since
2.5
Requirements
Paper

On Projectile Hit

Event
Cancellable

Called when a projectile hits an entity or a block.

projectile hit
Since
1.0

On Quit

Event

Called when a player leaves the server.

(quit[ting]|disconnect[ing]|log[ ]out|logging out|leav(e|ing))
Since
1.0 (simple disconnection)

On Ready Arrow

Event
Cancellable

Called when a player is firing a bow and the server is choosing an arrow to use.

Cancelling this event will skip the current arrow item and fire a new event for the next arrow item.

The arrow and bow in the event can be accessed with the Readied Arrow/Bow expression.

[player] ((ready|choose|draw|load) arrow|arrow (choose|draw|load))
Since
2.8.0
Requirements
Paper

On Redstone

Event

Called when the redstone current of a block changes. This event is of not much use yet.

redstone [current] [chang(e|ing)]
Since
1.0

On Resource Pack Request Response

Event

Called when a player takes action on a resource pack request sent via the

send resource pack effect.

The resource pack condition can be used

to check the resource pack state.

This event will be triggered once when the player accepts or declines the resource pack request,

and once when the resource pack is successfully installed or failed to download.

resource pack [request] response
resource pack [request] %resource pack states%
Since
2.4

On Respawn

Event

Called when a player respawns. You should prefer this event over the death event as the player is technically alive when this event is called.

[player] respawn[ing]
Since
1.0

On Resurrect Attempt

Event
Cancellable

Called when an entity dies, always. If they are not holding a totem, this is cancelled - you can, however, uncancel it.

[entity] resurrect[ion] [attempt]
Since
2.2-dev28

On Riptide

Event

Called when the player activates the riptide enchantment, using their trident to propel them through the air.

Note: the riptide action is performed client side, so manipulating the player in this event may have undesired effects.

[use of] riptide [enchant[ment]]
Since
2.5

On Script Load/Unload

Event

Called directly after the trigger is loaded, or directly before the whole script is unloaded.

The keyword 'async' indicates the trigger can be ran asynchronously,

[async] [script] (load|init|enable)
[async] [script] (unload|stop|disable)
Since
2.0

On Send Command List

Event

Called when the server sends a list of commands to the player. This usually happens on join. The sent commands can be modified via the sent commands expression.

Modifications will affect what commands show up for the player to tab complete. They will not affect what commands the player can actually run.

Adding new commands to the list is illegal behavior and will be ignored.

send[ing] [of [the]] [server] command[s] list
[server] command list send
Since
2.8.0

On Server List Ping

Event
Cancellable

Called when a server list ping is coming in, generally when a Minecraft client pings the server to show its information in the server list.

The IP expression can be used to get the IP adress of the pinger.

This event can be cancelled on PaperSpigot 1.12.2+ only and this means the player will see the server as offline (but still can join).

Also you can use MOTD, Max Players, Online Players Count, Protocol Version, Version String, Hover List and Server Icon expressions, and Player Info Visibility and Hide Player from Server List effects to modify the server list.

server [list] ping
Since
2.3

On Server Start/Stop

Event

Called when the server starts or stops (actually, when Skript starts or stops, so a /reload will trigger these events as well).

(server|skript) (start|load|enable)
(server|skript) (stop|unload|disable)
Since
2.0

On Sheep Regrow Wool

Event
Cancellable

Called when sheep regrows its sheared wool back.

sheep [re]grow[ing] wool
Since
2.2-dev21

On Shoot

Event
Cancellable

Called whenever a projectile is shot. Use the shooter expression to get who shot the projectile.

[projectile] shoot
Since
1.0

On Sign Change

Event
Cancellable

As signs are placed empty, this event is called when a player is done editing a sign.

sign (chang[e]|edit)[ing]
[player] (chang[e]|edit)[ing] [a] sign
Since
1.0

On Slime Split

Event
Cancellable

Called when a slime splits. Usually this happens when a big slime dies.

slime split[ting]
Since
2.2-dev26

On Smelt

New
Event
Cancellable

Called when a furnace smelts an item in its input slot.

[furnace] [ore] smelt[ed|ing] [of %item types%]
[furnace] smelt[ed|ing] of ore
Since
1.0, 2.10 (specific item)

On Sneak Toggle

Event
Cancellable

Called when a player starts or stops sneaking. Use is sneaking to get whether the player was sneaking before the event was called.

[player] toggl(e|ing) sneak
[player] sneak toggl(e|ing)
Since
1.0

On Spawn

Event
Cancellable

Called when an entity spawns (excluding players).

spawn[ing] [of %entity types%]
Since
1.0, 2.5.1 (non-living entities)

On Spawn Change

Event

Called when the spawn point of a world changes.

[world] spawn change
Since
1.0

On Spectate

Event
Cancellable

Called with a player starts, stops or swaps spectating an entity.

[player] stop spectating [(of|from) %*entity types%]
[player] (swap|switch) spectating [(of|from) %*entity types%]
[player] start spectating [of %*entity types%]
Since
2.7
Requirements
Paper

On Sponge Absorb

Event
Cancellable

Called when a sponge absorbs blocks.

sponge absorb
Since
2.5
Requirements
Minecraft 1.13 or newer

On Spread

Event
Cancellable

Called when a new block forms as a result of a block that can spread, e.g. water or mushrooms.

spread[ing]
Since
1.0

On Sprint Toggle

Event
Cancellable

Called when a player starts or stops sprinting. Use is sprinting to get whether the player was sprinting before the event was called.

[player] toggl(e|ing) sprint
[player] sprint toggl(e|ing)
Since
1.0

On Start Smelt

New
Event

Called when a furnace starts smelting an item in its ore slot.

[furnace] start [of] smelt[ing] [[of] %item types%]
[furnace] smelt[ing] start [of %item types%]
Since
2.10

On Stonecutter Recipe Select

Event
Cancellable

Called when a player selects a recipe in a stonecutter.

stonecutting [[of] %item types%]
Since
2.8.0
Requirements
Paper 1.16+

On Stop Using Item

Event

Called when a player stops using an item. For example, when the player releases the interact button when holding a bow, an edible item, or a spyglass.

Note that event-timespan will return the time the item was used for.

[player] (stop|end) (using item|item use)
Since
2.8.0
Requirements
Paper 1.18.2+

On Swim Toggle

Event
Cancellable

Called when an entity swims or stops swimming.

[entity] toggl(e|ing) swim
[entity] swim toggl(e|ing)
Since
2.3
Requirements
1.13 or newer

On Tame

Event
Cancellable

Called when a player tames a wolf or ocelot. Can be cancelled to prevent the entity from being tamed.

[entity] tam(e|ing)
Since
1.0

On Target

Event
Cancellable

Called when a mob starts/stops following/attacking another entity, usually a player.

[entity] target
[entity] un[-]target
Since
1.0

On Teleport

Event
Cancellable

This event can be used to listen to teleports from non-players or player entities respectively.

When teleporting entities, the event may also be called due to a result of natural causes, such as an enderman or shulker teleporting, or wolves teleporting to players.

When teleporting players, the event can be called by teleporting through a nether/end portal, or by other means (e.g. plugins).

[%entity types%] teleport[ing]
Since
1.0, 2.9.0 (entity teleport)

On Test Case

Event

Contents represent one test case.

test %text% [when <.+>]
Since
2.5

On Tool Change

Event
Cancellable

Called whenever a player changes their held item by selecting a different slot (e.g. the keys 1-9 or the mouse wheel), not by dropping or replacing the item in the current slot.

[player['s]] (tool|item held|held item) chang(e|ing)
Since
1.0

On Vehicle Collision

New
Event
Cancellable

Called when a vehicle collides with a block or entity.

vehicle collision [(with|of) [a[n]] %item types/block datas/entity types%]
vehicle block collision [(with|of) [a[n]] %item types/block datas%]
vehicle entity collision [(with|of) [a[n]] %entity types%]
Since
2.10

On Vehicle Create

Event
Cancellable

Called when a new vehicle is created, e.g. when a player places a boat or minecart.

vehicle create
creat(e|ing|ion of) [a] vehicle
Since
1.0

On Vehicle Damage

Event
Cancellable

Called when a vehicle gets damage. Too much damage will destroy the vehicle.

vehicle damage
damag(e|ing) [a] vehicle
Since
1.0

On Vehicle Destroy

Event
Cancellable

Called when a vehicle is destroyed. Any passenger will be ejected and the vehicle might drop some item(s).

vehicle destroy
destr(oy[ing]|uction of) [a] vehicle
Since
1.0

On Vehicle Enter

Event
Cancellable

Called when an entity enters a vehicle, either deliberately (players) or by falling into them (mobs).

vehicle enter
enter[ing] [a] vehicle
Since
1.0

On Vehicle Exit

Event
Cancellable

Called when an entity exits a vehicle.

vehicle exit
exit[ing] [a] vehicle
Since
1.0

On Vehicle Move

New
Event

Called when a vehicle moves.

Please note that using this event can cause lag if there are multiple vehicle entities, i.e. Horse, Pig, Boat, Minecart

vehicle move
Since
2.10

On Weather Change

Event
Cancellable

Called when a world's weather changes.

weather change [to %weather types%]
Since
1.0

On World Init

Event

Called when a world is initialized. As all default worlds are initialized before

any scripts are loaded, this event is only called for newly created worlds.

World management plugins might change the behaviour of this event though.

world init[ialization] [of %worlds%]
Since
1.0, 2.8.0 (defining worlds)

On World Load

Event

Called when a world is loaded. As with the world init event, this event will not be called for the server's default world(s).

world load[ing] [of %worlds%]
Since
1.0, 2.8.0 (defining worlds)

On World Save

Event

Called when a world is saved to disk. Usually all worlds are saved simultaneously, but world management plugins could change this.

world sav(e|ing) [of %worlds%]
Since
1.0, 2.8.0 (defining worlds)

On World Unload

Event
Cancellable

Called when a world is unloaded. This event will never be called if you don't have a world management plugin.

world unload[ing] [of %worlds%]
Since
1.0, 2.8.0 (defining worlds)

On Zombie Break Door

Event
Cancellable

Called when a zombie is done breaking a wooden door. Can be cancelled to prevent the zombie from breaking the door.

zombie break[ing] [a] [wood[en]] door
Since
1.0

Online Player Count

Expression

The amount of online players. This can be changed in a server list ping event only to show fake online player amount.

real online player count always return the real count of online players and can't be changed.

[the] [((real|default)|(fake|shown|displayed))] [online] player (count|amount|number)
[the] [((real|default)|(fake|shown|displayed))] (count|amount|number|size) of online players
Since
2.3
Requirements
Paper (fake count)

op/deop

Effect

Grant/revoke a user operator state.

[de[-]]op %offline players%
Since
1.0

Open Book

Effect

Opens a written book to a player.

(open|show) book %item type% (to|for) %players%
Since
2.5.1
Requirements
Minecraft 1.14.2+

Open/Close Inventory

Effect

Opens an inventory to a player. The player can then access and modify the inventory as if it was a chest that he just opened.

Please note that currently 'show' and 'open' have the same effect, but 'show' will eventually show an unmodifiable view of the inventory in the future.

(open|show) (((crafting [table]|workbench)|chest|anvil|hopper|dropper|dispenser) [(view|window|inventory)]|%inventory/inventory type%) (to|for) %players%
close [the] inventory [view] (to|of|for) %players%
close %players%'[s] inventory [view]
Since
2.0, 2.1.1 (closing), 2.2-Fixes-V10 (anvil), 2.4 (hopper, dropper, dispenser

Open/Close Lid

New
Effect

Open or close the lid of the block(s).

(open|close) [the] lid[s] (of|for) %blocks%
(open|close) %blocks%'[s] lid[s]
Since
2.10

Opened Inventory

Expression

Return the currently opened inventory of a player.

If no inventory is open, it returns the own player's crafting inventory.

[the] (current|open|top) inventory [of %players%]
%players%'[s] (current|open|top) inventory
Since
2.2-dev24, 2.2-dev35 (Just 'current inventory' works in player events)

Options

Structure

Options are used for replacing parts of a script with something else.

For example, an option may represent a message that appears in multiple locations.

Take a look at the example below that showcases this.

options
Since
1.0

Parse

Expression

Parses text as a given type, or as a given pattern.

This expression can be used in two different ways: One which parses the entire text as a single instance of a type, e.g. as a number, and one that parses the text according to a pattern.

If the given text could not be parsed, this expression will return nothing and the parse error will be set if some information is available.

Some notes about parsing with a pattern:

- The pattern must be a Skript pattern, e.g. percent signs are used to define where to parse which types, e.g. put a %number% or %items% in the pattern if you expect a number or some items there.

- You have to save the expression's value in a list variable, e.g. set {parsed::*} to message parsed as "...".

- The list variable will contain the parsed values from all %types% in the pattern in order. If a type was plural, e.g. %items%, the variable's value at the respective index will be a list variable, e.g. the values will be stored in {parsed::1::*}, not {parsed::1}.

%text% parsed as (%*type%|"<.*>")
Since
2.0

Parse Error

Expression

The error which caused the last parse operation to fail, which might not be set if a pattern was used and the pattern didn't match the provided text at all.

[the] [last] [parse] error
Since
2.0

Passenger

Expression

The passenger of a vehicle, or the rider of a mob.

For 1.11.2 and above, it returns a list of passengers and you can use all changers in it.

See also: vehicle

[the] passenger[s] of %entities%
%entities%'[s] passenger[s]
Since
2.0, 2.2-dev26 (Multiple passengers for 1.11.2+)

Pathfind

Effect

Make an entity pathfind towards a location or another entity. Not all entities can pathfind. If the pathfinding target is another entity, the entities may or may not continuously follow the target.

make %living entities% (pathfind|move) to[wards] %living entity/location% [at speed %number%]
make %living entities% stop (pathfinding|moving)
Since
2.7
Requirements
Paper

Percent of

Expression

Returns a percentage of one or more numbers.

%number%(\%| percent) of %numbers%
Since
2.8.0

Periodical

Event

An event that is called periodically.

every %time span%
Since
1.0

Periodical

Event

An event that is called periodically.

every %time span% in [world[s]] %worlds%
Since
1.0

Pi

Expression

Returns the mathematical constant pi. (approx. 3.1415926535)

(pi|Ï€)
Since
2.7

Pickup Delay

Expression

The amount of time before a dropped item can be picked up by an entity.

[the] pick[ ]up delay of %entities%
%entities%'[s] pick[ ]up delay
Since
2.7

Ping

Expression

Pings of players, as Minecraft server knows them. Note that they will almost certainly be different from the ones you'd get from using ICMP echo requests. This expression is only supported on some server software (PaperSpigot).

[the] ping of %players%
%players%'[s] ping
Since
2.2-dev36

Plain Item

Expression

A plain item is an item with no modifications. It can be used to convert items to their default state or to match with other default items.

[a[n]] (plain|unmodified) %item type%
Since
2.6

Play Effect

Effect

Plays a visual effect at a given location or on a given entity.

Please note that some effects can only be played on entities, e.g. wolf hearts or the hurt effect, and that these are always visible to all players.

(play|show) %visual effects% (on|%directions%) %entities/locations% [(to %players%|in (radius|range) of %number%)]
(play|show) %number% %visual effects% (on|%directions%) %locations% [(to %players%|in (radius|range) of %number%)]
Since
2.1

Play Sound

Effect

Plays a sound at given location for everyone or just for given players, or plays a sound to specified players. Both Minecraft sound names and Spigot sound names are supported. Playing resource pack sounds are supported too. The sound category is 'master' by default.

When running 1.19+, playing a sound from an entity directly will result in the sound coming from said entity, even while moving.

If the sound is custom, a location emitter will follow the entity. Do note that pitch and volume

are reflected based on the entity, and Minecraft may not use the values from this syntax.

If using Paper 1.19.4+ or Adventure API 4.12.0+ you can utilize sound seeds. Minecraft sometimes have a set of sounds under one sound ID

that will randomly play, to counter this, you can directly state which seed to use.

Please note that sound names can get changed in any Minecraft or Spigot version, or even removed from Minecraft itself.

play sound[s] %texts% [[with] seed %number%] [(in|from) %sound category%] [(at|with) volume %number%] [(and|at|with) pitch %number%] (at|on|from) %locations/entities% [(to|for) %players%]
play sound[s] %texts% [[with] seed %number%] [(in|from) %sound category%] [(at|with) volume %number%] [(and|at|with) pitch %number%] [(to|for) %players%] [(at|on|from) %locations/entities%]
Since
2.2-dev28, 2.4 (sound categories), 2.9 (sound seed & entity emitter)
Requirements
Minecraft 1.18.1+ (entity emitters), Paper 1.19.4+ or Adventure API 4.12.0+ (sound seed)

player

Function

Returns an online player from their name or UUID, if player is offline function will return nothing.

Setting 'getExactPlayer' parameter to true will return the player whose name is exactly equal to the provided name instead of returning a player that their name starts with the provided name.

player(nameOrUUID: string, getExactPlayer: boolean = false)
Since
2.8.0
Returns
Player

Player

Type

A player. Depending on whether a player is online or offline several actions can be performed with them, though you won't get any errors when using effects that only work if the player is online (e.g. changing their inventory) on an offline player.

You have two possibilities to use players as command arguments: <player> and <offline player>. The first requires that the player is online and also accepts only part of the name, while the latter doesn't require that the player is online, but the player's name has to be entered exactly.

Parsing an offline player as a player (online) will return nothing (none), for that case you would need to parse as offlineplayer which only returns nothing (none) if player doesn't exist in Minecraft databases (name not taken) otherwise it will return the player regardless of their online status.
Since
1.0

Player Chat Completions

New
Expression

The custom chat completion suggestions. You can add, set, remove, and clear them. Removing the names of online players with this expression is ineffective.

This expression will not return anything due to Bukkit limitations.

[the] [custom] chat completion[s] of %players%
%players%'[s] [custom] chat completion[s]
Since
2.10
Requirements
Spigot 1.19+

Player Info Visibility

Effect

Sets whether all player related information is hidden in the server list.

The Vanilla Minecraft client will display ??? (dark gray) instead of player counts and will not show the

hover hist when hiding player info.

The version string can override the ???.

Also the Online Players Count and

Max Players expressions will return -1 when hiding player info.

hide [all] player [related] info[rmation] [(in|on|from) [the] server list]
(show|reveal) [all] player [related] info[rmation] [(in|to|on|from) [the] server list]
Since
2.3
Requirements
Paper 1.12.2 or newer
Supported events
server list ping

Player Input Keys

New
Expression

Get the current input keys of a player.

[the] [current] (inputs|input keys) of %players%
%players%'[s] [current] (inputs|input keys)
Since
2.10
Requirements
Minecraft 1.21.2+

Player List Header and Footer

Expression

The message above and below the player list in the tab menu.

[the] (player|tab)[ ]list (header|footer) [(text|message)] of %players%
%players%'[s] (player|tab)[ ]list (header|footer) [(text|message)]
Since
2.4
Requirements
Minecraft 1.13 or newer

Player Protocol Version

Expression

Player's protocol version. For more information and list of protocol versions visit wiki.vg.

[the] protocol version of %players%
%players%'[s] protocol version
Since
2.6.2
Requirements
Paper 1.12.2 or newer

Player Skull

Expression

Gets a skull item representing a player. Skulls for other entities are provided by the aliases.

[the] (head|skull) of %offline players%
%offline players%'[s] (head|skull)
Since
2.0

Player Weather

Expression

The weather for a player.

[the] [(client|custom)] weather of %players%
%players%'[s] [(client|custom)] weather
Since
2.2-dev34

Poison/Cure

Effect

Poison or cure a creature.

poison %living entities% [for %time span%]
(cure|unpoison) %living entities% [(from|of) poison]
Since
1.3.2

Portal

Expression

The blocks associated with a portal in the portal creation event.

[the] portal['s] blocks
[the] blocks of [the] portal
Since
2.4
Supported events
portal_create

Portal Cooldown

Expression

The amount of time before an entity can use a portal. By default, it is 15 seconds after exiting a nether portal or end gateway.

Players in survival/adventure get a cooldown of 0.5 seconds, while those in creative get no cooldown.

Resetting will set the cooldown back to the default 15 seconds for non-player entities and 0.5 seconds for players.

[the] portal cooldown of %entities%
%entities%'[s] portal cooldown
Since
2.8.0

Potion Effect

Type

A potion effect, including the potion effect type, tier and duration.

speed of tier 1 for 10 seconds
Since
2.5.2

Potion Effect

Expression

Create a new potion effect to apply to an entity or item type. Do note that when applying potion effects

to tipped arrows/lingering potions, Minecraft reduces the timespan.

[new] potion effect of %potion effect type% [potion] [[[of] tier] %number%] [without particles] [for %time span%]
[new] ambient potion effect of %potion effect type% [potion] [[[of] tier] %number%] [without particles] [for %time span%]
Since
2.5.2

Potion Effect Tier

Expression

An expression to obtain the amplifier of a potion effect applied to an entity.

[the] [potion] (tier|amplifier|level) of %potion effect types% (of|for|on) %living entities%
Since
2.7

Potion Effect Type

Type

A potion effect type, e.g. 'strength' or 'swiftness'.

absorption, bad luck, bad omen, blindness, conduit power, confusion, damage, damage resistance, darkness, dolphin's grace, dolphins grace, fast digging, fast mining, fire immunity, fire resistance, floating, glowing, haste, health, health boost, hero of the village, hunger, increase damage, increased damage, infested, instant damage, instant health, invisibility, jump, jump boost, levitation, luck, max health boost, maximum health boost, mining fatigue, nausea, night vision, oozing, poison, raid omen, reduce damage, reduced damage, regeneration, resistance, saturation, slow, slow digging, slow fall, slow falling, slow mining, slowness, speed, strength, swiftness, trial omen, unluck, water breathing, weakness, weaving, wind charged, wither, wither effect, wither potion effect
Since

Potion Effects

Effect

Apply or remove potion effects to/from entities.

apply %potion effects% to %living entities%
apply infinite [ambient] [potion of] %potion effect types% [potion] [[[of] tier] %number%] [without [any] particles] [(whilst hiding [the]|without (the|a)) [potion] icon] to %living entities% [replacing [the] existing effect]
apply [ambient] [potion of] %potion effect types% [potion] [[[of] tier] %number%] [without [any] particles] [(whilst hiding [the]|without (the|a)) [potion] icon] to %living entities% [for %time span%] [replacing [the] existing effect]
Since
2.0, 2.2-dev27 (ambient and particle-less potion effects), 2.5 (replacing existing effect), 2.5.2 (potion effects), 2.7 (icon and infinite)

Potion Effects

Expression

Represents the active potion effects of entities and itemtypes.

You can clear all potion effects of an entity/itemtype and add/remove a potion effect/type to/from an entity/itemtype.

Do note you will not be able to clear the base potion effects of a potion item. In that case, just set the item to a water bottle.

When adding a potion effect type (rather than a potion effect), it will default to 15 seconds with tier 1.

[the] [(all [[of] the]|the)] [active] potion effects of %living entities/item types%
%living entities/item types%'[s] [(all [[of] the]|the)] [active] potion effects
Since
2.5.2

product

Function

Calculates the product of a list of numbers.

product(ns: numbers)
Since
2.2
Returns
Number

Projectile

Type

A projectile, e.g. an arrow, snowball or thrown potion.

arrow, fireball, snowball, thrown potion, etc.
Since
1.0

Projectile Critical State

Expression

A projectile's critical state. The only currently accepted projectiles are arrows and tridents.

[the] (projectile|arrow) critical (state|ability|mode) of %projectiles%
%projectiles%'[s] (projectile|arrow) critical (state|ability|mode)
Since
2.5.1

Protocol Version

Expression

The protocol version that will be sent as the protocol version of the server in a server list ping event. For more information and list of protocol versions visit wiki.vg.

If this protocol version doesn't match with the protocol version of the client, the client will see the version string.

But please note that, this expression has no visual effect over the version string. For example if the server uses PaperSpigot 1.12.2, and you make the protocol version 107 (1.9),

the version string will not be "Paper 1.9", it will still be "Paper 1.12.2".

But then you can customize the version string as you wish.

Also if the protocol version of the player is higher than protocol version of the server, it will say

"Server out of date!", and if vice-versa "Client out of date!" when you hover on the ping bars.

This can be set in a server list ping event only

(increase and decrease effects cannot be used because that wouldn't make sense).

[the] [server] [(sent|required|fake)] protocol version [number]
Since
2.3
Requirements
Paper 1.12.2 or newer
Supported events
server list ping

Pull In Hooked Entity

New
Effect

Pull the hooked entity to the player.

(reel|pull) in hook[ed] entity
Since
2.10
Supported events
Fishing

Push

Effect

Push entities around.

(push|thrust) %entities% %direction% [(at|with) (speed|velocity|force) %number%]
Since
1.4.6

PvP

Condition

Checks the PvP state of a world.

(is PvP|PvP is) enabled [in %worlds%]
(is PvP|PvP is) disabled [in %worlds%]
Since
1.3.4

PvP

Effect

Set the PvP state for a given world.

enable PvP [in %worlds%]
disable PVP [in %worlds%]
Since
1.3.4

quaternion

New
Function

Returns a quaternion from the given W, X, Y and Z parameters.

quaternion(w: number, x: number, y: number, z: number)
Since
2.10
Returns
Quaternion

Quaternion

New
Type

Quaternions are four dimensional vectors, often used for representing rotations.

Since
2.10

Queue

New
Type

A queued list of values. Entries are removed from a queue when they are queried.

Since
2.10

Queue (Experimental)

New
Expression

Requires the using queues experimental feature flag to be enabled. Creates a new queue. A queue is a set of elements that can have things removed from the start and added to the end. Any value can be added to a queue. Adding a non-existent value (e.g. `{variable that isn't set}`) will have no effect. This means that removing an element from the queue will always return a value unless the queue is empty. Requesting an element from a queue (e.g. `the 1st element of {queue}`) also removes it from the queue.

[a] [new] queue [(of|with) %objects%]
Since
2.10 (experimental)

Queue Start/End (Experimental)

New
Expression

Requires the using queues experimental feature flag to be enabled. The first or last element in a queue. Asking for this does not remove the element from the queue. This is designed for use with the add changer: to add or remove elements from the start or the end of the queue.

[the] (start|end) of %queue%
%queue%'[s] (start|end)
Since
2.10 (experimental)

Quit Reason

Type

Represents a quit reason from a player quit server event.

disconnected, erroneous state, kicked, quit, timed out, erroneous
Since
2.8.0
Requirements
Paper 1.16.5+

Quit Reason

Expression

The quit reason as to why a player disconnected in a quit event.

[the] (quit|disconnect) (cause|reason)
Since
2.8.0
Requirements
Paper 1.16.5+

Random

Expression

Gets a random item out of a set, e.g. a random player out of all players online.

[a] random %*type% [out] of %objects%
Since
1.4.9

Random Character

Expression

One or more random characters between two given characters. Use 'alphanumeric' if you want only alphanumeric characters.

This expression uses the Unicode numerical code of a character to determine which characters are between the two given characters.

If strings of more than one character are given, only the first character of each is used.

[a|%integer%] random [alphanumeric] character[s] (from|between) %text% (to|and) %text%
Since
2.8.0

Random Numbers

New
Expression

A given amount of random numbers or integers between two given numbers. Use 'number' if you want any number with decimal parts, or use use 'integer' if you only want whole numbers.

Please note that the order of the numbers doesn't matter, i.e. random number between 2 and 1 will work as well as random number between 1 and 2.

[a|%integer%] random (integer|number)[s] (from|between) %number% (to|and) %number%
Since
1.4, 2.10 (Multiple random numbers)

Random UUID

Expression

Returns a random UUID.

[a] random uuid
Since
2.5.1

Raw Name

Expression

The raw Minecraft material name of the given item. Note that this is not guaranteed to give same results on all servers.

(raw|minecraft|vanilla) name[s] of %item types%
Since
unknown (2.2)

Raw String

Expression

Returns the string without formatting (colors etc.) and without stripping them from it, e.g. raw "&aHello There!" would output &aHello There!

raw %texts%
Since
2.7

Readied Arrow/Bow

Expression

The bow or arrow in a Ready Arrow event.

[the] (readied|selected|drawn) (arrow|bow)
Since
2.8.0
Supported events
ready arrow

Redstone Block Power

Expression

Power of a redstone block

[the] redstone power of %blocks%
%blocks%'[s] redstone power
Since
2.5

Register Tag

New
Effect

Registers a new tag containing either items or entity datas. Note that items will NOT keep any information other than their type, so adding `diamond sword named "test"` to a tag is the same as adding `diamond sword`

Item tags should be used for contexts where the item is not placed down, while block tags should be used for contexts where the item is placed. For example, and item tag could be "skript:edible", while a block tag would be "skript:needs_water_above".

All custom tags will be given the namespace "skript", followed by the name you give it. The name must only include the characters A to Z, 0 to 9, and '/', '.', '_', and '-'. Otherwise, the tag will not register.

Please note that two tags can share a name if they are of different types. Registering a new tag of the same name and type will overwrite the existing tag. Tags will reset on server shutdown.

register [a[n]] [custom] (item|block|entity [type]) tag named %text% (containing|using) %entity types/item types%
Since
2.10

Remaining Air

Expression

How much time a player has left underwater before starting to drown.

[the] remaining air of %living entities%
%living entities%'[s] remaining air
Since
2.0

Repeat String

Expression

Repeats inputted strings a given amount of times.

%texts% repeated %integer% time[s]
Since
2.8.0

Replace

New
Effect

Replaces all occurrences of a given text or regex with another text. Please note that you can only change variables and a few expressions, e.g. a message or a line of a sign.

replace [(all|every)|[the] first] %texts% in %texts% with %text% [with case sensitivity]
replace [(all|every)|[the] first] %texts% with %text% in %texts% [with case sensitivity]
(replace [with|using] regex|regex replace) %texts% in %texts% with %text%
(replace [with|using] regex|regex replace) %texts% with %text% in %texts%
replace [all|every] %item types% in %inventories% with %item type%
replace [all|every] %item types% with %item type% in %inventories%
Since
2.0, 2.2-dev24 (multiple strings, items in inventory), 2.5 (replace first, case sensitivity), 2.10 (regex)

Resonating Time

Expression

Returns the resonating time of a bell.

A bell will start resonating five game ticks after being rung, and will continue to resonate for 40 game ticks.

[the] resonat(e|ing) time of %block%
%block%'[s] resonat(e|ing) time
Since
2.9.0
Requirements
Spigot 1.19.4+

Resource Pack

Condition

Checks state of the resource pack in a resource pack request response event.

[the] resource pack (was|is|has) [been] %resource pack state%
[the] resource pack (was|is|has)(n't| not) [been] %resource pack state%
Since
2.4
Supported events
resource pack request response

Resource Pack State

Type

The state in a resource pack request response event.

discarded, refused, rejected, failed reload, accepted, failed, failed to reload, failed to download, downloaded, successfully loaded, accept, fail, successfully load, refuse, declined, successfully install, success, reject, decline, successfully installed, download fail, invalid url
Since
2.4

Respawn Anchor Charges

Expression

The charges of a respawn anchor.

[the] [max[imum]] charge[s] of %blocks%
%blocks%'[s] [max[imum]] charge[s]
Since
2.7
Requirements
Minecraft 1.16+

Respawn location

Expression

The location that a player should respawn at. This is used within the respawn event.

[the] respawn location
Since
2.2-dev35

Result (Experimental)

New
Expression

Runs something (like a function) and returns its result.

If the thing is expected to return multiple values, use 'results' instead of 'result'.

[the] result[s] of [running|executing] %executable% [with arg[ument]s %objects%]
Since
2.10

Return

Effect

Makes a trigger or a section (e.g. a function) return a value

return %objects%
Since
2.2, 2.8.0 (returns aliases)

Reversed List

Expression

Reverses given list.

reversed %objects%
Since
2.4

rgb

New
Function

Returns a RGB color from the given red, green and blue parameters. Alpha values can be added optionally, but these only take affect in certain situations, like text display backgrounds.

rgb(red: long, green: long, blue: long, alpha: long = 255)
Since
2.5, 2.10 (alpha)
Returns
Color

Ring Bell

Effect

Causes a bell to ring.

Optionally, the entity that rang the bell and the direction the bell should ring can be specified.

A bell can only ring in two directions, and the direction is determined by which way the bell is facing.

By default, the bell will ring in the direction it is facing.

ring %blocks% [from [the]] [%direction%]
(make|let) %entity% ring %blocks% [from [the]] [%direction%]
Since
2.9.0
Requirements
Spigot 1.19.4+

Ringing Time

Expression

Returns the ringing time of a bell.

A bell typically rings for 50 game ticks.

[the] ring[ing] time of %block%
%block%'[s] ring[ing] time
Since
2.9.0
Requirements
Spigot 1.19.4+

Rotate

New
Effect

Rotates displays, quaternions, or vectors around an axis a set amount of degrees, or around all 3 axes at once.

Vectors can only be rotated around the global X/Y/Z axes, or an arbitrary vector axis.

Quaternions are more flexible, allowing rotation around the global or local X/Y/Z axes, arbitrary vectors, or all 3 local axes at once.

Global axes are the ones in the Minecraft world. Local axes are relative to how the quaternion is already oriented.

Rotating a display is a shortcut for rotating its left rotation. If the right rotation needs to be modified, it should be acquired, rotated, and re-set.

Note that rotating a quaternion/display around a vector results in a rotation around the local vector, so results may not be what you expect. For example, rotating quaternions/displays around vector(1, 0, 0) is the same as rotating around the local X axis.

The same applies to rotations by all three axes at once. In addition, rotating around all three axes of a quaternion/display at once will rotate in ZYX order, meaning the Z rotation will be applied first and the X rotation last.

rotate %vectors/quaternions/displays% around [the] [global] (x|y|z)(-| )axis by %number%
rotate %quaternions/displays% around [the|its|their] local (x|y|z)(-| )ax(i|e)s by %number%
rotate %vectors/quaternions/displays% around [the] %vector% by %number%
rotate %quaternions/displays% by x %number%, y %number%(, [and]| and) z %number%
Since
2.2-dev28, 2.10 (quaternions, displays)

Rotated Quaternion/Vector

New
Expression

Rotates a quaternion or vector around an axis a set amount of degrees, or around all 3 axes at once.

Vectors can only be rotated around the global X/Y/Z axes, or an arbitrary vector axis.

Quaternions are more flexible, allowing rotation around the global or local X/Y/Z axes, arbitrary vectors, or all 3 local axes at once.

Global axes are the ones in the Minecraft world. Local axes are relative to how the quaternion is already oriented.

Note that rotating a quaternion around a vector results in a rotation around the local vector, so results may not be what you expect. For example, rotating around vector(1, 0, 0) is the same as rotating around the local X axis.

The same applies to rotations by all three axes at once. In addition, rotating around all three axes of a quaternion/display at once will rotate in ZYX order, meaning the Z rotation will be applied first and the X rotation last.

%quaternions/vectors% rotated around [the] [global] (x|y|z)(-| )axis by %number%
%quaternions% rotated around [the|its|their] local (x|y|z)(-| )ax(i|e)s by %number%
%quaternions/vectors% rotated around [the] %vector% by %number%
%quaternions% rotated by x %number%, y %number%(, [and]| and) z %number%
Since
2.10

Rotation Axis/Angle

New
Expression

Returns the axis or angle that a quaternion will rotate by/around.

All quaternions can be represented by a rotation of some amount around some axis, so this expression provides the ability to get that angle/axis.

[the] rotation (angle|axis) of %quaternions%
%quaternions%'[s] rotation (angle|axis)
Since
2.10

round

Function

Rounds a number, i.e. returns the closest integer to the argument. Place a second argument to define the decimal placement.

round(n: number, d: number = 0)
Since
2.2, 2.7 (decimal placement)
Returns
Number

Rounding

Expression

Rounds numbers normally, up (ceiling) or down (floor) respectively.

[(a|the)] round[ed] down %number%
[(a|the)] round[ed] %number%
[(a|the)] round[ed] up %number%
Since
2.0

Run (Experimental)

New
Effect

Executes a task (a function). Any returned result is discarded.

run %executable% [with arg[ument]s %objects%]
execute %executable% [with arg[ument]s %objects%]
Since
2.10

Running Minecraft

Condition

Checks if current Minecraft version is given version or newer.

running [below] minecraft %text%
Since
2.5

Saturation

Expression

The saturation of a player. If used in a player event, it can be omitted and will default to event-player.

[the] saturation of %players%
%players%'[s] saturation
Since
2.2-Fixes-v10, 2.2-dev35 (fully modifiable), 2.6.2 (syntax pattern changed)

Save World

Effect

Save all worlds or a given world manually.

Note: saving many worlds at once may possibly cause the server to freeze.

save [[the] world[s]] %worlds%
Since
2.8.0

Scoreboard Tags

Expression

Scoreboard tags are simple list of texts stored directly in the data of an entity.

So this is a Minecraft related thing, not Bukkit, so the tags will not get removed when the server stops. You can visit visit Minecraft Wiki for more info.

This is changeable and valid for any type of entity. Also you can use use the Has Scoreboard Tag condition to check whether an entity has the given tags.

Requires Minecraft 1.11+ (actually added in 1.9 to the game, but added in 1.11 to Spigot).

[(all [[of] the]|the)] scoreboard tags of %entities%
%entities%'[s] scoreboard tags
Since
2.3

Script

New
Type

A script loaded by Skript.

Disabled scripts will report as being empty since their content has not been loaded.

Since
2.10

Script

Expression

The current script, or a script from its (file) name.

If the script is enabled or disabled (or reloaded) this reference will become invalid.

Therefore, it is recommended to obtain a script reference when needed.

[the] [current] script
[the] script[s] [named] %texts%
[the] scripts in [directory|folder] %text%
Since
2.0

Sea Level

Expression

Gets the sea level of a world.

[the] sea level of %worlds%
%worlds%'[s] sea level
Since
2.5.1

Sea Pickles

Expression

An expression to obtain or modify data relating to the pickles of a sea pickle block.

[the] [(min|max)[imum]] [sea] pickle(s| (count|amount)) of %blocks%
%blocks%'[s] [(min|max)[imum]] [sea] pickle(s| (count|amount))
Since
2.7

Seed of Loot Table

New
Expression

Returns the seed of a loot table. Setting the seed of a block or entity that does not have a loot table will not do anything.

[the] loot[[ ]table] seed[s] of %entities/blocks%
%entities/blocks%'[s] loot[[ ]table] seed[s]
Since
2.10

Send Block Change

Effect

Makes a player see a block as something it really isn't. BlockData support is only for MC 1.13+

make %players% see %blocks% as %item type/block data%
Since
2.2-dev37c, 2.5.1 (block data support)

Send Resource Pack

Effect

Request that the player's client download and switch resource packs. The client will download

the resource pack in the background, and will automatically switch to it once the download is complete.

The URL must be a direct download link.

The hash is used for caching, the player won't have to re-download the resource pack that way.

The hash must be SHA-1, you can get SHA-1 hash of your resource pack using

this online tool.

The resource pack request action can be used to check

status of the sent resource pack request.

send [the] resource pack [from [[the] URL]] %text% to %players%
send [the] resource pack [from [[the] URL]] %text% with hash %text% to %players%
Since
2.4

Sent Command List

Expression

The commands that will be sent to the player in a send commands to player event.

Modifications will affect what commands show up for the player to tab complete. They will not affect what commands the player can actually run.

Adding new commands to the list is illegal behavior and will be ignored.

[the] [sent] [server] command[s] list
Since
2.8.0
Supported events
send command list

Server Icon

Type

A server icon that was loaded using the load server icon effect.

Since
2.3

Server Icon

Expression

Icon of the server in the server list. Can be set to an icon that loaded using the

load server icon effect,

or can be reset to the default icon in a server list ping.

'default server icon' returns the default server icon (server-icon.png) always and cannot be changed.

[the] [((default)|(shown|sent))] [server] icon
Since
2.3
Requirements
Paper 1.12.2 or newer

Sets

Expression

Returns a list of all the values of a type. Useful for looping.

[all [[of] the]|the|every] %*type%
Since
1.0 pre-5, 2.7 (classinfo)

Shear

Effect

Shears or un-shears a shearable entity with drops by shearing and a 'sheared' sound. Using with 'force' will force this effect despite the entity's 'shear state'.

Please note that..:

- If your server is not running with Paper 1.19.4 or higher, this effect will only change its 'shear state', and the 'force' effect is unavailable

- Force-shearing or un-shearing on a sheared mushroom cow is not possible

[force] shear %living entities%
un[-]shear %living entities%
Since
2.0 (cows, sheep & snowmen), 2.8.0 (all shearable entities)
Requirements
Paper 1.19.4+ (all shearable entities)

Shoot

New
Section

Shoots a projectile (or any other entity) from a given entity or location.

shoot %entity types% [from %living entities/locations%] [(at|with) (speed|velocity) %number%] [%direction%]
(make|let) %living entities/locations% shoot %entity types% [(at|with) (speed|velocity) %number%] [%direction%]
Since
2.10

Shooter

Expression

The shooter of a projectile.

[the] shooter [of %projectile%]
Since
1.3.7

Shuffled List

Expression

Shuffles given list randomly. This is done by replacing indices by random numbers in resulting list.

shuffled %objects%
Since
2.2-dev32

Sign Text

Expression

A line of text on a sign. Can be changed, but remember that there is a 16 character limit per line (including color codes that use 2 characters each).

[the] line %number% [of %block%]
[the] (1st|first|2nd|second|3rd|third|4th|fourth) line [of %block%]
Since
1.3

Silence Entity

Effect

Controls whether or not an entity is silent.

silence %entities%
unsilence %entities%
make %entities% silent
make %entities% not silent
Since
2.5

sin

Function

The sine function. It starts at 0° with a value of 0, goes to 1 at 90°, back to 0 at 180°, to -1 at 270° and then repeats every 360°. Uses degrees, not radians.

sin(n: number)
Since
2.2
Returns
Number

Skull Owner

New
Expression

The skull owner of a player skull.

[the] (head|skull) owner of %slots/item types/item stacks/blocks%
%slots/item types/item stacks/blocks%'[s] (head|skull) owner
Since
2.9.0, 2.10 (of items)

Slot

Type

Represents a single slot of an inventory. Notable slots are the armour slots and furnace slots.

The most important property that distinguishes a slot from an item is its ability to be changed, e.g. it can be set, deleted, enchanted, etc. (Some item expressions can be changed as well, e.g. items stored in variables. For that matter: slots are never saved to variables, only the items they represent at the time when the variable is set).

Please note that tool can be regarded a slot, but it can actually change it's position, i.e. doesn't represent always the same slot.

Since

Slot Index

Expression

Index of an an inventory slot. Other types of slots may or may not have indices. Note that comparing slots with numbers is also possible; if index of slot is same as the number, comparisonsucceeds. This expression is mainly for the cases where you must for some reason save the slot numbers.

Raw index of slot is unique for the view, see Minecraft Wiki

[the] [(raw|unique)] index of %slots%
%slots%'[s] [(raw|unique)] index
Since
2.2-dev35, 2.8.0 (raw index)

Sort

New
Effect

Sorts a list variable using either the natural ordering of the contents or the results of the given expression. Be warned, this will overwrite the indices of the list variable. When using the full sort %~objects% (by|based on) <expression> pattern, the input expression can be used to refer to the current item being sorted. (See input expression for more information.)

sort %~objects% [in (descending|ascending) order] [(by|based on) <.+>]
Since
2.9.0, 2.10 (sort order)

Sorted List

Expression

Sorts given list in natural order. All objects in list must be comparable; if they're not, this expression will return nothing.

sorted %objects%
Since
2.2-dev19

Sound Category

Type

The category of a sound, they are used for sound options of Minecraft. See the play sound and stop sound effects.

hostile creatures category, speech category, records category, friendly creature category, noteblock category, hostile creature category, note block category, voice category, ambient category, noteblocks category, note blocks category, weather category, block category, friendly mob category, jukebox category, hostile mob category, master category, master volume category, hostile category, record category, blocks category, environment category, jukeboxes category, player category, players category, hostile mobs category, friendly mobs category, music category, friendly creatures category, neutral category
Since
2.4

Source Block

Expression

The source block in a spread event.

[the] source block
Since
2.7
Supported events
Spread

Spawn

Expression

The spawn point of a world.

[the] spawn[s] [(point|location)[s]] [of %worlds%]
%worlds%'[s] spawn[s] [(point|location)[s]]
Since
1.4.2

Spawn

New
Section

Spawns entities. This can be used as an effect and as a section.

If it is used as a section, the section is run before the entity is added to the world.

You can modify the entity in this section, using for example 'event-entity' or 'cow'.

Do note that other event values, such as 'player', won't work in this section.

If you're spawning a display and want it to be empty on initialization, like not having a block display be stone, set hidden config node 'spawn empty displays' to true.

Note that when spawning an entity via entity snapshots, the code within the section will not run instantaneously as compared to spawning normally (via 'a zombie').

(spawn|summon) %entity types/entity snapshots% [%directions% %locations%]
(spawn|summon) %number% of %entity types/entity snapshots% [%directions% %locations%]
Since
1.0, 2.6.1 (with section), 2.8.6 (dropped items), 2.10 (entity snapshots)
Requirements
Minecraft 1.20.2+ (entity snapshots)

Spawn Egg Entity

New
Expression

Gets or sets the entity snapshot that the provided spawn eggs will spawn when used.

[the] spawn egg entity of %item stacks/item types/slots%
%item stacks/item types/slots%'[s] spawn egg entity
Since
2.10
Requirements
Minecraft 1.20.2+, Minecraft 1.20.5+ (comparisons)

Spawn Reason

Type

The spawn reason in a spawn event.

dispense egg, egg, village defense, ocelot baby, silverfish trap, village invading, trap, dispensing egg, shoulder, drowned, metamorphosis, lightning, silverfish reveal, spell, built iron golem, natural, trial mob spawner, village invasion, frozen, mount, build wither, built wither, iron golem defense, ender pearl, creature spawner, reinforcements, build snowman, build iron golem, breeding, raid, ominous item spawner, infection, customized, potion effect, spawn egg, jockey, beehive, default, golem defense, patrol, slime split, infected, sheared, mob spawner, nether portal, trial spawner, shear, perching, custom, built snowman, chunk generation, breed, command, duplication, explosion, spawner, cured, enchantment, trial creature spawner, customised, piglin zombification
Since
2.3

Spawn Reason

Expression

The spawn reason in a spawn event.

[the] spawn[ing] reason
Since
2.3

Spawner Type

Expression

Retrieves, sets, or resets the spawner's entity type

[the] (spawner|entity|creature) type[s] of %blocks%
%blocks%'[s] (spawner|entity|creature) type[s]
Since
2.4, 2.9.2 (trial spawner)

Special Number

Expression

Special number values, namely NaN, Infinity and -Infinity

(NaN|[(-|minus)](infinity|∞)) value
value of (NaN|[(-|minus)](infinity|∞))
Since
2.2-dev32d

Spectator Target

Expression

Grabs the spectator target entity of the players.

spectator target [of %players%]
%players%'[s] spectator target
Since
2.4-alpha4, 2.7 (Paper Spectator Event)
Requirements
Paper

Speed

Expression

A player's walking or flying speed. Both can be changed, but values must be between -1 and 1 (excessive values will be changed to -1 or 1 respectively). Negative values reverse directions.

Please note that changing a player's speed will change their FOV just like potions do.

[the] (walk[ing]|fl(y[ing]|ight))[( |-)]speed of %players%
%players%'[s] (walk[ing]|fl(y[ing]|ight))[( |-)]speed
Since
unknown (before 2.1)

sqrt

Function

The square root, which is the inverse operation to squaring a number (for positive numbers only). This is the same as (argument) ^ (1/2) – other roots can be calculated via number ^ (1/root), e.g. set {_l} to {_volume}^(1/3).

Returns NaN (not a number) if the argument is negative.

sqrt(n: number)
Since
2.2
Returns
Number

Starts/Ends With

Condition

Checks if a text starts or ends with another.

%texts% (start|end)[s] with %texts%
%texts% (doesn't|does not|do not|don't) (start|end) with %texts%
Since
2.2-dev36, 2.5.1 (multiple strings support)

Stop Server

Effect

Stops or restarts the server. If restart is used when the restart-script spigot.yml option isn't defined, the server will stop instead.

(stop|shut[ ]down) [the] server
restart [the] server
Since
2.5

Stop Sound

Effect

Stops specific or all sounds from playing to a group of players. Both Minecraft sound names and Spigot sound names are supported. Resource pack sounds are supported too. The sound category is 'master' by default. A sound can't be stopped from a different category.

Please note that sound names can get changed in any Minecraft or Spigot version, or even removed from Minecraft itself.

stop (all sound[s]|sound[s] %texts%) [(in [the]|from) %sound category%] [(from playing to|for) %players%]
stop playing sound[s] %texts% [(in [the]|from) %sound category%] [(to|for) %players%]
Since
2.4, 2.7 (stop all sounds)
Requirements
MC 1.17.1 (stop all sounds)

Substring

Expression

Extracts part of a text. You can either get the first <x> characters, the last <x> characters, the character at index <x>, or the characters between indices <x> and <y>. The indices <x> and <y> should be between 1 and the length of the text (other values will be fit into this range).

[the] (part|sub[ ](text|string)) of %texts% (between|from) [ind(ex|ices)|character[s]] %number% (and|to) [(index|character)] %number%
[the] (first|last) [%number%] character[s] of %texts%
[the] %number% (first|last) characters of %texts%
[the] character[s] at [(index|position|indexes|indices|positions)] %numbers% (in|of) %texts%
Since
2.1, 2.5.2 (character at, multiple strings support)

sum

Function

Sums a list of numbers.

sum(ns: numbers)
Since
2.2
Returns
Number

Swing Hand

Effect

Makes an entity swing their hand. This does nothing if the entity does not have an animation for swinging their hand.

make %living entities% swing [their] [main] hand
make %living entities% swing [their] off[ ]hand
Since
2.5.1
Requirements
Minecraft 1.15.2+

Tag

New
Expression

Represents a tag which can be used to classify items, blocks, or entities.

Tags are composed of a value and an optional namespace: "minecraft:oak_logs".

If you omit the namespace, one will be provided for you, depending on what kind of tag you're using. For example, `tag "doors"` will be the tag "minecraft:doors", while `paper tag "doors"` will be "paper:doors".

`minecraft tag` will search through the vanilla tags, `datapack tag` will search for datapack-provided tags (a namespace is required here!), `paper tag` will search for Paper's custom tags if you are running Paper, and `custom tag` will look in the "skript" namespace for custom tags you've registered.

You can also filter by tag types using "item", "block", or "entity".

[minecraft|datapack|paper|custom] [item|block|entity [type]] tag %texts%
Since
2.10
Requirements
Paper (paper tags)

Tag Namespaced Key

New
Expression

The namespaced key of a minecraft tag. This takes the form of "namespace:key", e.g. "minecraft:dirt".

[the] [namespace[d]] key[s] of %minecraft tags%
%minecraft tags%'[s] [namespace[d]] key[s]
Since
2.10

Tags Contents

New
Expression

Returns all the values that a tag contains.

For item and block tags, this will return items. For entity tags, it will return entity datas (a creeper, a zombie).

[the] tag (contents|values) of %minecraft tag%
%minecraft tag%'[s] tag (contents|values)
Since
2.10

Tags of X

New
Expression

Returns all the tags of an item, block, or entity.

`minecraft tag` will return only the vanilla tags, `datapack tag` will return only datapack-provided tags, `paper tag` will return only Paper's custom tags (if you are running Paper), and `custom tag` will look in the "skript" namespace for custom tags you've registered.

You can also filter by tag types using "item", "block", or "entity".

[all [[of] the]|the] [minecraft|datapack|paper|custom] [item|block|entity [type]] tags of %item type/entity/entity type%
%item type/entity/entity type%'[s] [minecraft|datapack|paper|custom] [item|block|entity [type]] tags
Since
2.10
Requirements
Paper (paper tags)

Tame / Untame

New
Effect

Tame a tameable entity (horse, parrot, cat, etc.).

[un](tame|domesticate) %entities%
Since
2.10

Tamer

Expression

The tamer of an entity. Can only be used in entity tame events. You can use 'event-entity' to refer tamed entity itself.

[the] tamer
Since
2.2-dev25

tan

Function

The tangent function. This is basically sin(arg)/cos(arg). Uses degrees, not radians.

tan(n: number)
Since
2.2
Returns
Number

Target

Expression

For players this is the entity at the crosshair.

For mobs and experience orbs this is the entity they are attacking/following (if any).

Display entities have a hit box of 0, so you should use 'target display' to collect Display entities

May grab entities in unloaded chunks.

[the] target[[ed] %*entity type%] [of %living entities%] [ignoring blocks] [[with|at] ray[ ]size %number%]
%living entities%'[s] target[[ed] %*entity type%] [ignoring blocks] [[with|at] ray[ ]size %number%]
Since
1.4.2, 2.7 (Reset), 2.8.0 (ignore blocks)

Targeted Block

Expression

The block at the crosshair. This regards all blocks that are not air as fully solid, e.g. torches will be like a solid stone block for this expression.

The actual target block will regard the actual hit box of the block.

[the] [(actual[ly]|exact)] target[ed] block[s] [of %living entities%]
%living entities%'[s] [(actual[ly]|exact)] target[ed] block[s]
Since
1.0, 2.9.0 (actual/exact)

Teleport

New
Effect

Teleport an entity to a specific location.

This effect is delayed by default on Paper, meaning certain syntax such as the return effect for functions cannot be used after this effect.

The keyword 'force' indicates this effect will not be delayed,

which may cause lag spikes or server crashes when using this effect to teleport entities to unloaded chunks.

Teleport flags are settings to retain during a teleport. Such as direction, passengers, x coordinate, etc.

[force] teleport %entities% (to|%direction%) %location% [[while] retaining %teleport flags%]
Since
1.0, 2.10 (flags)
Requirements
Paper 1.19+ (teleport flags)

Teleport Cause

Type

The teleport cause in a teleport event.

bed exit, nether portal, ender gateway, exiting bed, chorus fruit, ender portal, command, unknown, plugin, dismounted, ender pearl, spectator, spectate, end gateway, chorus, exit bed, gateway, dismount, end portal
Since
2.2-dev35

Teleport Cause

Expression

The teleport cause within a player teleport event.

[the] teleport (cause|reason|type)
Since
2.2-dev35

Teleport Flag

New
Type

Teleport Flags are settings to retain during a teleport.

passengers, xyz velocity, z velocity, yaw velocity, inventory, pitch velocity, vehicle, opened inventory, open inventory, x velocity, passenger, pitch and yaw velocity, yaw and pitch velocity, directional velocity, y velocity
Since
2.10
Requirements
Paper 1.19+

Temperature

Expression

Temperature at given block.

[the] temperature[s] of %blocks%
%blocks%'[s] temperature[s]
Since
2.2-dev35

Ternary

Expression

A shorthand expression for returning something based on a condition.

%objects% if <.+>[,] (otherwise|else) %objects%
Since
2.2-dev36

Text

Type

Text is simply text, i.e. a sequence of characters, which can optionally contain expressions which will be replaced with a meaningful representation (e.g. %player% will be replaced with the player's name).

Because scripts are also text, you have to put text into double quotes to tell Skript which part of the line is an effect/expression and which part is the text.

Please read the article on Texts and Variable Names to learn more.

simple: "..."
quotes: "...""..."
expressions: "...%expression%..."
percent  "...%%..."
Since
1.0

Text Display Alignment

New
Expression

Returns or changes the alignment setting of text displays.

[the] text alignment[s] [of %displays%]
%displays%'[s] text alignment[s]
Since
2.10

Text Display Drop Shadow

New
Effect

Applies or removes drop shadow from the displayed text on a text display.

(apply|add) (drop|text) shadow to [[the] text of] %displays%
(apply|add) (drop|text) shadow to %displays%'[s] text
(remove|clear) (drop|text) shadow from [[the] text of] %displays%
(remove|clear) (drop|text) shadow from %displays%'[s] text
Since
2.10

Text Display Has Drop Shadow

New
Condition

Returns whether the text of a display has drop shadow applied.

[[the] text of] %displays% (has|have) [a] (drop|text) shadow
%displays%'[s] text (has|have) [a] (drop|text) shadow
[[the] text of] %displays% (doesn't|does not|do not|don't) have [a] (drop|text) shadow
%displays%'[s] text (doesn't|does not|do not|don't) have [a] (drop|text) shadow
Since
2.10

Text Display Line Width

New
Expression

Returns or changes the line width of text displays. Default is 200.

[the] line width [of %displays%]
%displays%'[s] line width
Since
2.10

Text Display Opacity

New
Expression

Returns or changes the opacity of text displays.

Values are between -127 and 127. The value of 127 represents it being completely opaque.

[the] [display] opacity [of %displays%]
%displays%'[s] [display] opacity
Since
2.10

Text Display See Through Blocks

New
Effect

Forces a text display to either be or not be visible through blocks.

make %displays% visible through (blocks|walls)
force %displays% to be visible through (blocks|walls)
(prevent|block) %displays% from being (visible|seen) through (blocks|walls)
Since
2.10

Text Display Visible Through Blocks

New
Condition

Returns whether text displays can be seen through blocks or not.

%displays% (is|are) visible through (blocks|walls)
%displays% (isn't|is not|aren't|are not) visible through (blocks|walls)
Since
2.10

Text Of

New
Expression

Returns or changes the text/string of displays.

Note that currently you can only use Skript chat codes when running Paper.

[the] text[s] of %displays%
%displays%'[s] text[s]
Since
2.10

The Egg

Expression

The egg thrown in a Player Egg Throw event.

[the] [thrown] egg
Since
2.7
Supported events
Egg Throw

Time

Type

A time is a point in a minecraft day's time (i.e. ranges from 0:00 to 23:59), which can vary per world.

See date and timespan for the other time types of Skript.

##:##
##[##][ ]am/pm
Since
1.0

Time

Condition

Tests whether a given real time was more or less than some time span ago.

%date% (was|were)( more|(n't| not) less) than %time span% [ago]
%date% (was|were)((n't| not) more| less) than %time span% [ago]
Since
2.0

Time

Expression

The time of a world.

Use the "minecraft timespan" syntax to change the time according to Minecraft's time intervals.

Since Minecraft uses discrete intervals for time (ticks), changing the time by real-world minutes or real-world seconds only changes it approximately.

Removing an amount of time from a world's time will move the clock forward a day.

[the] time[s] [([with]in|of) %worlds%]
%worlds%'[s] time[s]
Since
1.0

Time Played

Expression

The amount of time a player has played for on the server. This info is stored in the player's statistics in the main world's data folder. Changing this will also change the player's stats which can be views in the client's statistics menu.

Using this expression on offline players on Minecraft 1.14 and below will return nothing <none>.

[the] time played of %offline players%
%offline players%'[s] time played
Since
2.5, 2.7 (offline players)
Requirements
MC 1.15+ (offline players)

Time Since/Until

New
Expression

The time since a date has passed or the time until a date will pass.

This expression will return 0 seconds if the time since or time until would be negative, e.g. if one tries to get the time since a future date.

[the] time since %dates%
[the] (time [remaining]|remaining time) until %dates%
Since
2.5, 2.10 (time until)

Timeperiod

Type

A period of time between two times. Mostly useful since you can use this to test for whether it's day, night, dusk or dawn in a specific world.

This type might be removed in the future as you can use 'time of world is between x and y' as a replacement.

##:## - ##
dusk/day/dawn/night
Since
1.0

Timespan

Type

A timespan is a difference of two different dates or times, e.g '10 minutes'. Timespans are always displayed as real life time, but can be defined as minecraft time, e.g. '5 minecraft days and 12 hours'.

NOTE: Months always have the value of 30 days, and years of 365 days.

See date and time for the other time types of Skript.

&lt;number&gt; [minecraft/mc/real/rl/irl] ticks/seconds/minutes/hours/days/weeks/months/years [[,/and] &lt;more...&gt;]
[]##:##[.####] ([]minutes:seconds[.milliseconds])
Since
1.0, 2.6.1 (weeks, months, years)

Timespan Details

Expression

Retrieve specific information of a timespan such as hours/minutes/etc.

[the] ((tick|second|minute|hour|day|week|month|year))s of %time spans%
%time spans%'[s] ((tick|second|minute|hour|day|week|month|year))s
Since
2.9.0

Title - Reset

Effect

Resets the title of the player to the default values.

reset [the] title[s] [of %players%]
reset [the] %players%'[s] title[s]
Since
2.3

Title - Send

Effect

Sends a title/subtitle to the given player(s) with optional fadein/stay/fadeout times for Minecraft versions 1.11 and above.

If you're sending only the subtitle, it will be shown only if there's a title displayed at the moment, otherwise it will be sent with the next title. To show only the subtitle, use: send title " " with subtitle "yourtexthere" to player.

Note: if no input is given for the times, it will keep the ones from the last title sent, use the reset title effect to restore the default values.

send title %text% [with subtitle %text%] [to %players%] [for %time span%] [with fade[(-| )]in %time span%] [[and] [with] fade[(-| )]out %time span%]
send subtitle %text% [to %players%] [for %time span%] [with fade[(-| )]in %time span%] [[and] [with] fade[(-| )]out %time span%]
Since
2.3

Toggle

Effect

Toggle the state of a block.

(close|turn off|de[-]activate) %blocks%
(toggle|switch) [[the] state of] %blocks%
(open|turn on|activate) %blocks%
Since
1.4

Toggle Custom Name Visibility

New
Effect

Toggles the custom name visibility of an entity.

(show|hide) [the] (custom|display)[ ]name of %entities%
(show|hide) %entities%'[s] (custom|display)[ ]name
Since
2.10

Toggle Flight

Effect

Toggle the flight mode of a player.

(allow|enable) (fly|flight) (for|to) %players%
(disallow|disable) (fly|flight) (for|to) %players%
Since
2.3

Toggle Picking Up Items

Effect

Determines whether living entities are able to pick up items or not

allow %living entities% to pick([ ]up items| items up)
(forbid|disallow) %living entities% (from|to) pick([ing | ]up items|[ing] items up)
Since
2.8.0

Tool

Expression

The item an entity is holding in their main or off hand.

[the] ((tool|held item|weapon)|(off[ ]hand (tool|item))) [of %living entities%]
%living entities%'[s] ((tool|held item|weapon)|(off[ ]hand (tool|item)))
Since
1.0

Total Experience

Expression

The total experience, in points, of players or experience orbs.

Adding to a player's experience will trigger Mending, but setting their experience will not.

[the] [total] experience of %entities%
%entities%'[s] [total] experience
Since
2.7

TPS (ticks per second)

Expression

Returns the 3 most recent TPS readings, like the /tps command. This expression is only supported on some server software (PaperSpigot).

tps from [the] last ([1] minute|1[ ]m[inute])
tps from [the] last 5[ ]m[inutes]
tps from [the] last 15[ ]m[inutes]
[the] tps
Since
2.2-dev36

Transform List

New
Effect

Transforms (or 'maps') a list's values using a given expression. This is akin to looping over the list and setting each value to a modified version of itself.

Evaluates the given expression for each element in the list, replacing the original element with the expression's result.

If the given expression returns a single value, the indices of the list will not change. If the expression returns multiple values, then then indices will be reset as a single index cannot contain multiple values.

Only variable lists can be transformed with this effect. For other lists, see the transform expression.

(transform|map) %~objects% (using|with) <.+>
Since
2.10

Transform Reason

Type

Represents a transform reason of an entity transform event.

infection, magma slime split, villager infection, tadpole metamorphosis, drowning, creeper super charge, unknown, split, tadpole converting, metamorphosis, skeleton converting to stray, lightning, slime split, entity drowning, slime splitting, zombie drowning, zombie curing, skeleton freeze, entity freezing, zombie converting to drowned, curing, entity freeze, skeleton freezing, mooshroom shear, zombie cure, tadpole converting to frog, mooshroom shearing, magma slime splitting, piglin zombification
Since
2.8.0

Transform Reason

Expression

The transform reason within an entity entity transform event.

[the] transform[ing] (cause|reason|type)
Since
2.8.0

Transformed List

New
Expression

Transforms (or 'maps') a list's values using a given expression. This is akin to looping over the list and getting a modified version of each value.

Indices cannot be retained with this expression. To retain indices, see the transform effect.

%objects% (transformed|mapped) (using|with) \[<.+>\]
%objects% (transformed|mapped) (using|with) \(<.+>\)
Since
2.10

Tree

Effect

Creates a tree.

This may require that there is enough space above the given location and that the block below is dirt/grass, but it is possible that the tree will just grow anyways, possibly replacing every block in its path.

(grow|create|generate) tree [of type %tree type%] %directions% %locations%
(grow|create|generate) %tree type% %directions% %locations%
Since
1.0

Tree Type

Type

A tree type represents a tree species or a huge mushroom species. These can be generated in a world with the generate tree effect.

[any] &lt;general tree/mushroom type&gt;, e.g. tree/any jungle tree/etc.
&lt;specific tree/mushroom species&gt;, e.g. red mushroom/small jungle tree/big regular tree/etc.
Since

Type

Type

Represents a type, e.g. number, object, item type, location, block, world, entity type, etc.

This is mostly used for expressions like 'event-<type>', '<type>-argument', 'loop-<type>', etc., e.g. event-world, number-argument and loop-player.

See the type name patterns of all types - including this one
Since
2.0

Type of

New
Expression

Type of a block, item, entity, inventory, potion effect or enchantment type.

Types of items, blocks and block datas are item types similar to them but have amounts

of one, no display names and, on Minecraft 1.13 and newer versions, are undamaged.

Types of entities and inventories are entity types and inventory types known to Skript.

Types of potion effects are potion effect types.

Types of enchantment types are enchantments.

[the] type of %entity types/item types/inventories/potion effects/block datas/enchantment types%
%entity types/item types/inventories/potion effects/block datas/enchantment types%'[s] type
Since
1.4, 2.5.2 (potion effect), 2.7 (block datas), 2.10 (enchantment type)

Unbreakable Items

Expression

Creates breakable or unbreakable copies of given items.

[un]breakable %item types%
Since
2.2-dev13b, 2.9.0 (breakable)

Unix Date

Expression

Converts given Unix timestamp to a date. The Unix timespan represents the number of seconds elapsed since 1 January 1970.

[the] unix date of %numbers%
%numbers%'[s] unix date
Since
2.5

Unix Timestamp

Expression

Converts given date to Unix timestamp. This is roughly how many seconds have elapsed since 1 January 1970.

[the] unix timestamp of %dates%
%dates%'[s] unix timestamp
Since
2.2-dev31

Unleash Reason

New
Type

Represents an unleash reason of an unleash event.

player unleashed, distance, unleashed by player, player unleash, holder (gone|disappeared), unknown
Since
2.10

Unleash Reason

New
Expression

The unleash reason in an unleash event.

[the] unleash[ing] reason
Since
2.10
Supported events
Unleash

Update Block

New
Effect

Updates the blocks by setting them to a selected block

Using 'without physics' will not send updates to the surrounding blocks of the blocks being set.

Example: Updating a block next to a sand block in the air 'without physics' will not cause the sand block to fall.

update %blocks% (as|to be) %block data% [without [neighbo[u]r[ing]|adjacent] [physic[s]] update[s]]
Since
2.10

Using Experimental Feature

Structure

Place at the top of a script file to enable an optional experimental feature.

For example, this might include

using <.+>
Since
2.9.0

UUID

Expression

The UUID of a player, entity or world.

In the future there will be an option to use a player's UUID instead of the name in variable names (i.e. when %player% is used), but for now this can be used.

Please note that this expression does not work for offline players if you are under 1.8!

[the] UUID of %offline players/worlds/entities%
%offline players/worlds/entities%'[s] UUID
Since
2.1.2, 2.2 (offline players' UUIDs), 2.2-dev24 (other entities' UUIDs)

Value

New
Expression

Returns the value of something that has a value, e.g. a node in a config.

The value is automatically converted to the specified type (e.g. text, number) where possible.

[the] %*type% value [at] %text% (from|in) %node%
[the] %*type% value of %valued thing%
[the] %*type% values of %valued things%
%valued thing%'s %*type% value
%valued things%'[s] %*type% values
Since
2.10 (Nodes), 2.10 (Any)

Value Within

Expression

Gets the value within objects. Usually used with variables to get the value they store rather than the variable itself, or with lists to get the values of a type.

[the] (%*type%|value[s]) (within|in) %~objects%
Since
2.7

Variables

Structure

Used for defining variables present within a script.

This section is not required, but it ensures that a variable has a value if it doesn't exist when the script is loaded.

variables
Since
1.0

vector

Function

Creates a new vector, which can be used with various expressions, effects and functions.

vector(x: number, y: number, z: number)
Since
2.2-dev23
Returns
Vector

Vector

Type

Vector is a collection of numbers. In Minecraft, 3D vectors are used to express velocities of entities.

vector(x, y, z)
Since
2.2-dev23

Vector/Quaternion - WXYZ Component

New
Expression

Gets or changes the W, X, Y or Z component of vectors/quaternions.

You cannot use the W component with vectors; it is for quaternions only.

[the] [vector|quaternion] (w|x|y|z) [component[s]] of %vectors/quaternions%
%vectors/quaternions%'[s] [vector|quaternion] (w|x|y|z) [component[s]]
Since
2.2-dev28, 2.10 (quaternions)

Vectors - Angle Between

Expression

Gets the angle between two vectors.

[the] angle between [[the] vectors] %vector% and %vector%
Since
2.2-dev28

Vectors - Create from Direction

Expression

Creates vectors from given directions.

Relative directions are relative to the origin, (0, 0, 0). Therefore, the vector from the direction 'forwards' is (0, 0, 1).

vector[s] [from] %directions%
%directions% vector[s]
Since
2.8.0

Vectors - Create from XYZ

Expression

Creates a vector from x, y and z values.

[a] [new] vector [(from|at|to)] %number%,[ ]%number%(,[ ]| and )%number%
Since
2.2-dev28

Vectors - Create Location from Vector

Expression

Creates a location from a vector in a world.

%vector% to location in %world%
location (from|of) %vector% in %world%
%vector% [to location] in %world% with yaw %number% and pitch %number%
location (from|of) %vector% in %world% with yaw %number% and pitch %number%
Since
2.2-dev28

Vectors - Cross Product

Expression

Gets the cross product between two vectors.

%vector% cross %vector%
Since
2.2-dev28

Vectors - Cylindrical Shape

Expression

Forms a 'cylindrical shaped' vector using yaw to manipulate the current point.

[a] [new] cylindrical vector [from|with] [radius] %number%, [yaw] %number%(,[ and]| and) [height] %number%
Since
2.2-dev28

Vectors - Dot Product

Expression

Gets the dot product between two vectors.

%vector% dot %vector%
Since
2.2-dev28

Vectors - Length

Expression

Gets or sets the length of a vector.

[the] (vector|standard|normal) length[s] of %vectors%
%vectors%'[s] (vector|standard|normal) length[s]
Since
2.2-dev28

Vectors - Location Vector Offset

Expression

Returns the location offset by vectors.

%location% offset by [[the] vectors] %vectors%
%location%[ ]~[~][ ]%vectors%
Since
2.2-dev28

Vectors - Normalized

Expression

Returns the same vector but with length 1.

normalize[d] %vector%
%vector% normalized
Since
2.2-dev28

Vectors - Random Vector

Expression

Creates a random unit vector.

[a] random vector
Since
2.2-dev28, 2.7 (signed components)

Vectors - Spherical Shape

Expression

Forms a 'spherical shaped' vector using yaw and pitch to manipulate the current point.

[a] [new] spherical vector [(from|with)] [radius] %number%, [yaw] %number%(,[ and]| and) [pitch] %number%
Since
2.2-dev28

Vectors - Squared Length

Expression

Gets the squared length of a vector.

[the] squared length[s] of %vectors%
%vectors%'[s] squared length[s]
Since
2.2-dev28

Vectors - Vector Between Locations

Expression

Creates a vector between two locations.

[the] vector (from|between) %location% (to|and) %location%
Since
2.2-dev28

Vectors - Vector from Location

Expression

Creates a vector from a location.

[the] vector (of|from|to) %location%
%location%'s vector
Since
2.2-dev28

Vectors - Vector from Yaw and Pitch

Expression

Creates a vector from a yaw and pitch value.

[a] [new] vector (from|with) yaw %number% and pitch %number%
[a] [new] vector (from|with) pitch %number% and yaw %number%
Since
2.2-dev28

Vectors - Vector Projection

Expression

An expression to get the vector projection of two vectors.

[vector] projection [of] %vector% on[to] %vector%
Since
2.8.0

Vectors - Velocity

Expression

Gets or changes velocity of an entity.

[the] velocit(y|ies) of %entities%
%entities%'[s] velocit(y|ies)
Since
2.2-dev31

Vehicle

Type

Represents a vehicle.

Since
INSERT VERSION

Vehicle

Effect

Makes an entity ride another entity, e.g. a minecart, a saddled pig, an arrow, etc.

(make|let|force) %entities% [to] (ride|mount) [(in|on)] %entities/entity types%
(make|let|force) %entities% [to] (dismount|(dismount|leave) [(from|of)] [(any|the[ir]|his|her)] vehicle[s])
(eject|dismount) [(any|the)] passenger[s] (of|from) %entities%
Since
2.0

Vehicle

Expression

The vehicle an entity is in, if any. This can actually be any entity, e.g. spider jockeys are skeletons that ride on a spider, so the spider is the 'vehicle' of the skeleton.

See also: passenger

[the] vehicle[s] of %entities%
%entities%'[s] vehicle[s]
Since
2.0

Version

Expression

The version of Bukkit, Minecraft or Skript respectively.

([craft]bukkit|minecraft|skript)( |-)version
Since
2.0

Version String

Expression

The text to show if the protocol version of the server doesn't match with protocol version of the client. You can check the protocol version expression for more information about this.

This can only be set in a server list ping event.

[the] [shown|custom] version [string|text]
Since
2.3
Requirements
Paper 1.12.2+
Supported events
Server List Ping

View Distance

Expression

The view distance of a player as set by the server. Can be changed.

NOTE: This is the view distance sent by the server to the player.

This has nothing to do with client side view distance settings

NOTE: This may not work on some versions (such as MC 1.14.x).

The return value in this case will be the view distance set in system.properties.

[the] view distance[s] of %players%
%players%'[s] view distance[s]
Since
2.4
Requirements
Paper

View Distance of Client

Expression

The view distance of the client. Can not be changed. This differs from the server side view distance of player as this will retrieve the view distance the player has set on their client.

[the] client view distance[s] of %players%
%players%'[s] client view distance[s]
Since
2.5
Requirements
1.13.2+

Villager Level/Experience

New
Expression

Represents the level/experience of a villager.

The level will determine which trades are available to players (value between 1 and 5, defaults to 1).

When a villager's level is 1, they may lose their profession if they don't have a workstation.

Experience works along with the leveling system, determining which level the villager will move to.

Experience must be greater than or equal to 0.

Learn more about villager levels on Minecraft Wiki

[the] villager (level|experience) of %living entities%
%living entities%'[s] villager (level|experience)
Since
2.10

Villager Profession

New
Type

Represents the different professions of villagers.

armorer, armorer profession, butcher, butcher profession, cartographer, cartographer profession, cleric, cleric profession, farmer, farmer profession, fisherman, fisherman profession, fletcher, fletcher profession, leatherworker, leatherworker profession, librarian, librarian profession, mason, mason profession, nitwit, nitwit profession, no profession, none, none profession, shepherd, shepherd profession, toolsmith, toolsmith profession, unemployed, weaponsmith, weaponsmith profession
Since
2.10

Villager Profession

New
Expression

Represents the profession of a villager/zombie villager.

[the] villager profession of %living entities%
%living entities%'[s] villager profession
Since
2.10

Villager Type

New
Type

Represents the different types of villagers. These are usually the biomes a villager can be from.

desert, jungle, plains, savanna, snow, swamp, taiga
Since
2.10

Villager Type

New
Expression

Represents the type of a villager/zombie villager. This usually represents the biome the villager is from.

[the] villager type of %living entities%
%living entities%'[s] villager type
Since
2.10

Visual Effect

Type

A visible effect, e.g. particles.

smoke, potion break, ender signal, mobspawner flames, arrow particles, jumping rabbit, hurt, wolf smoke, wolf hearts, wolf shaking, sheep eating, iron golem offering rose, witch magic, zombie turning to a villager, firework explosion, love hearts, squid rotation reset, entity poof, guardian target, block with shield, shield break, armor stand hit, hurt by thorns, iron golem sheathing rose, resurrection by totem, hurt by drowning, hurt by explosion, poof, large explosion, explosion emitter, firework, bubble, splash, water wake, underwater, critical hit, enchanted hit, smoke, large smoke, effect, instant effect, entity effect, witch, dripping water, dripping lava, angry villager, happy villager, mycelium, note, portal, enchant, flame, lava pop, cloud, dust, snowball, slime, heart, item, block, rain, elder guardian, dragon breath, end rod, damage indicator, sweep attack, falling dust, totem of undying, spit, squid ink, bubble pop, current down, bubble column up, nautilus, dolphin, sneeze, campfire cosy smoke, campfire signal smoke, composter, flash, falling lava, landing lava, falling water, dripping honey, falling honey, landing honey, falling nectar, soul fire flame, ash, crimson spore, warped spore, soul, dripping obsidian tear, falling obsidian tear, landing obsidian tear, reverse portal, white ash, dust color transition, vibration, falling spore blossom, spore blossom air, small flame, snowflake, dripping dripstone lava, falling dripstone lava, dripping dripstone water, falling dripstone water, glow squid ink, glow, wax on, wax off, electric spark, scrape, sonic boom, sculk soul, sculk charge, sculk charge pop, shriek, cherry leaves, egg crack, dust plume, white smoke, gust, small gust, large gust emitter, small gust emitter, trial spawner detection, ominous trial spawner detection, vault connection, infested, cobweb, dust pillar, ominous spawning, raid omen, block marker
Since
2.1

Weather

Expression

The weather in the given or the current world.

[the] weather [(in|of) %worlds%]
%worlds%'[s] weather
Since
1.0
Supported events
weather change

Weather Type

Type

The weather types sunny, rainy, and thundering.

clear/sun/sunny, rain/rainy/raining, and thunder/thundering/thunderstorm
Since
1.0

Whether

Expression

A shorthand for returning the result of a condition (true or false). This is functionally identical to using `true if else false`.

whether <.+>
Since
2.9.0

While Loop

Section

While Loop sections are loops that will just keep repeating as long as a condition is met.

[do] while <.+>
Since
2.0, 2.6 (do while)

Whitelist

Expression

An expression for obtaining and modifying the server's whitelist.

Players may be added and removed from the whitelist.

The whitelist can be enabled or disabled by setting the whitelist to true or false respectively.

[the] white[ ]list
Since
2.5.2, 2.9.0 (delete)

Will Consume Boosting Firework

New
Condition

Checks to see if the firework used in an 'elytra boost' event will be consumed.

[the] (boosting|used) firework will be consumed
[the] (boosting|used) firework (will not|won't) be consumed
Since
2.10
Requirements
Paper

With Fire Resistance

Expression

Creates a copy of an item with (or without) fire resistance.

%item type% with[out] fire[ ]resistance
fire resistant %item type%
Since
2.9.0
Requirements
Spigot 1.20.5+

Wolf Variant

Type

Represents the variant of a wolf entity.

NOTE: Minecraft namespaces are supported, ex: 'minecraft:ashen'.

ashen, black, chestnut, pale, rusty, snowy, spotted, striped, woods
Since
@VERSION
Requirements
Minecraft 1.21+

world

Function

Gets a world from its name.

world(name: string)
Since
2.2
Returns
World

World

Type

One of the server's worlds. Worlds can be put into scripts by surrounding their name with double quotes, e.g. "world_nether", but this might not work reliably as text uses the same syntax.

<code>"world_name"</code>, e.g. "world"
Since
1.0, 2.2 (alternate syntax)

World

Expression

The world the event occurred in.

[the] world [of %locations/entities/chunk%]
%locations/entities/chunk%'[s] world
Since
1.0

World Environment

Type

Represents the environment of a world.

normal, nether, the end, the overworld, custom, the nether, end, overworld
Since
2.7

World Environment

Expression

The environment of a world

[the] [world] environment of %worlds%
%worlds%'[s] [world] environment
Since
2.7

World from Name

Expression

Returns the world from a string.

[the] world [(named|with name)] %text%
Since
2.6.1

World Seed

Expression

The seed of given world. Note that it will be returned as Minecraft internally treats seeds, not as you specified it in world configuration.

[the] seed[s] (from|of) %worlds%
%worlds%'[s] seed[s]
Since
2.2-dev35

Worlds

Expression

All worlds of the server, useful for looping.

[(all [[of] the]|the)] worlds
Since
1.0

X of Item

Expression

An expression to be able to use a certain amount of items where the amount can be any expression. Please note that this expression is not stable and might be replaced in the future.

%number% of %item stacks/item types/entity type%
Since
1.2

X Times

Expression

Integers between 1 and X, used in loops to loop X times.

%number% time[s]
once
twice
thrice
Since
1.4.6

Yaw / Pitch

Expression

The yaw or pitch of a location or vector.

A yaw of 0 or 360 represents the positive z direction. Adding a positive number to the yaw of a player will rotate it clockwise.

A pitch of 90 represents the negative y direction, or downward facing. A pitch of -90 represents upward facing. Adding a positive number to the pitch will rotate the direction downwards.

Only Paper 1.19+ users may directly change the yaw/pitch of players.

[the] (yaw|pitch) of %entities/locations/vectors%
%entities/locations/vectors%'[s] (yaw|pitch)
Since
2.0, 2.2-dev28 (vector yaw/pitch), 2.9.0 (entity changers)
Requirements
Paper 1.19+ (player changers)

Filter by