Action Bar
🔗Ban
🔗Patterns: |
|
Since: | 1.4, 2.1.1 (ban reason), 2.5 (timespan) |
Note that banning people does not kick them from the server. Consider using the kick effect after applying a ban.
Examples:
ban "127.0.0.1"
IP-ban the player because "he is an idiot"
ban player due to "inappropriate language" for 2 days
Break Block
🔗Patterns: | |
Since: | 2.4 |
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)
Examples:
break clicked block naturally
loop blocks in radius 10 around player:
break loop-block using player's tool
loop blocks in radius 10 around player:
break loop-block naturally using diamond pickaxe
Broadcast
🔗Cancel Command Cooldown
🔗Patterns: |
|
Since: | 2.2-dev34 |
Examples:
executable by: players
cooldown: 10 seconds
trigger:
if length of arg-1 is more than 16:
# Makes it so that invalid arguments don't make you wait for the cooldown again
cancel the cooldown
send "Your nickname may be at most 16 characters."
stop
set the player's display name to arg-1
Cancel Drops
🔗Patterns: |
|
Since: | 2.4 |
Usable in events: | death, break / mine |
Requirements: | 1.12.2 or newer (cancelling item drops of blocks) |
Examples:
if name of the entity is "&cSpecial":
cancel drops of items
on break of a coal ore:
cancel the experience drops
Cancel Event
🔗Patterns: |
|
Since: | 1.0 |
Examples:
victim is a player
victim has the permission "skript.god"
cancel the event
Change: Set/Add/Remove/Delete/Reset
🔗Patterns: | |
Since: | 1.0 (set, add, remove, delete), 2.0 (remove all) |
Examples:
Set the player's display name to "<red>%name of player%"
set the block above the victim to lava
# add:
add 2 to the player's health # preferably use 'heal' for this
add argument to {blacklist::*}
give a diamond pickaxe of efficiency 5 to the player
increase the data value of the clicked block by 1
# remove:
remove 2 pickaxes from the victim
subtract 2.5 from {points::%uuid of player%}
# remove all:
remove every iron tool from the player
remove all minecarts from {entitylist::*}
# delete:
delete the block below the player
clear drops
delete {variable}
# reset:
reset walk speed of player
reset chunk at the targeted block
Charge Creeper
🔗Patterns: |
|
Since: | 2.5 |
Examples:
charge the event-entity
Colour Items
🔗Patterns: |
|
Since: | 2.0, 2.2-dev26 (maps and potions) |
(red, green, blue)
, where (0,0,0)
is black and (255,255,255)
is white. Armor is colourable for all Minecraft versions. With Minecraft 1.11 or newer you can also colour potions and maps. Note that the colours might not look exactly how you'd expect. Examples:
colour the player's tool red
Command
🔗Patterns: |
|
Since: | 1.0 |
Examples:
execute console command "/say Hello everyone!"
Connect
🔗Continue
🔗Patterns: |
|
Since: | 2.2-dev37 |
Examples:
if loop-value does not have permission "moderator":
continue # filter out non moderators
broadcast "%loop-player% is a moderator!" # Only moderators get broadcast
Damage/Heal/Repair
🔗Patterns: |
|
Since: | 1.0 |
Examples:
heal the player
repair tool of player
Delay
🔗Patterns: |
|
Since: | 1.4 |
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! Examples:
halt for 5 minecraft hours
wait a tick
Do If
🔗Patterns: |
|
Since: | 2.3 |
Examples:
give a diamond to the player if the player has permission "rank.vip"
Drop
🔗Patterns: |
|
Since: | 1.0 |
Examples:
drop 1 TNT
Enable/Disable/Reload Script File
🔗Patterns: |
|
Since: | 2.4 |
Examples:
enable script file "testing"
unload script file "script.sk"
Enchant/Disenchant
🔗Patterns: |
|
Since: | 2.0 |
Examples:
disenchant the player's tool
Equip
🔗Patterns: |
|
Since: | 1.0 |
Examples:
equip player with all diamond armor
Exit
🔗Patterns: |
|
Since: | unknown (before 2.1) |
Examples:
stop
message "%player% has no ores!"
loop blocks above the player:
loop-block is not air:
exit 2 sections
set loop-block to water
Explode Creeper
🔗Patterns: |
|
Since: | 2.5 |
Requirements: | Paper 1.13 or newer/Spigot 1.14 or newer. Ignition can be stopped on Paper 1.13 or newer. |
Examples:
stop ignition of the last spawned creeper
Explosion
🔗Patterns: |
|
Since: | 1.0 |
Examples:
create an explosion of force 0 at the victim
Feed
🔗Force Attack
🔗Patterns: |
|
Since: | 2.5.1 |
Requirements: | Minecraft 1.15.2+ |
Examples:
make last spawned wolf attack player
Force Respawn
🔗Patterns: |
|
Since: | 2.2-dev21 |
Examples:
force event-player to respawn
Hide Player from Server List
🔗Patterns: | |
Since: | 2.3 |
Examples:
hide {vanished::*} from the server list
Ignite/Extinguish
🔗Keep Inventory / Experience
🔗Patterns: |
|
Since: | 2.4 |
Usable in events: | death |
Examples:
if the victim is an op:
keep the inventory and experiences
Kick
🔗Kill
🔗Patterns: |
|
Since: | 1.0 |
Examples:
kill all creepers in the player's world
kill all endermen, witches and bats
Launch firework
🔗Patterns: |
|
Since: | 2.4 |
Examples:
Leash entities
🔗Patterns: |
|
Since: | 2.3 |
Examples:
Lightning
🔗Patterns: |
|
Since: | 1.4 |
Examples:
strike lightning effect at the victim
Load Server Icon
🔗Patterns: |
|
Since: | 2.3 |
Requirements: | Paper 1.12.2 or newer |
Examples:
clear {server-icons::*}
loop 5 times:
load server icon from file "icons/%loop-number%.png"
add the last loaded server icon to {server-icons::*}
on server list ping:
set the icon to a random server icon out of {server-icons::*}
Locally Suppress Warning
🔗Patterns: |
|
Since: | 2.3 |
Examples:
suppress the variable save warnings
Log
🔗Patterns: | |
Since: | 2.0 |
Examples:
log "%player% placed TNT in %world% at %location of block%" to "tnt/placement.log"
Make Fly
🔗Make Incendiary
🔗Patterns: | |
Since: | 2.5 |
Examples:
make the explosion fiery
Make Invulnerable
🔗Make Say
🔗Patterns: | |
Since: | 2.3 |
Examples:
force all players to send the message "I love this server"
Message
🔗Patterns: |
|
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 |
Examples:
message "This message is a distraction. Mwahaha!"
send "Your kill streak is %{kill streak::%uuid of player%}%." to player
if the targeted entity exists:
message "You're currently looking at a %type of the targeted entity%!"
on chat:
cancel event
send "[%player%] >> %message%" to all players from player
Open Book
🔗Open/Close Inventory
🔗Patterns: |
|
Since: | 2.0, 2.1.1 (closing), 2.2-Fixes-V10 (anvil), 2.4 (hopper, dropper, dispenser |
Examples:
open the player's inventory for the player
Play Effect
🔗Patterns: |
|
Since: | 2.1 |
Examples:
show mob spawner flames at the targeted block to the player
Play Sound
🔗Patterns: | |
Since: | 2.2-dev28, 2.4 (sound categories) |
Requirements: | Minecraft 1.11+ (sound categories) |
Please note that sound names can get changed in any Minecraft or Spigot version, or even removed from Minecraft itself.
Examples:
play sound "entity.experience_orb.pickup" with volume 0.5 to the player
play sound "custom.music.1" in jukebox category at {speakerBlock}
Player Info Visibility
🔗Patterns: |
|
Since: | 2.3 |
Usable in events: | server list ping |
Requirements: | Paper 1.12.2 or newer |
Examples:
hide player related information in the server list
reveal all player related info
Player Visibility
🔗Patterns: | |
Since: | 2.3 |
Note: if a player was hidden and relogs, this player will be visible again.
Examples:
if {vanished::%player's uuid%} is true:
hide the player from all players
reveal hidden players of {_player}
Poison/Cure
🔗Patterns: |
|
Since: | 1.3.2 |
Examples:
poison the victim for 20 seconds
cure the player from poison
Potion Effects
🔗Patterns: |
|
Since: | 2.0, 2.2-dev27 (ambient and particle-less potion effects), 2.5 (replacing existing effect), 2.5.2 (potion effects) |
Examples:
remove haste from the victim
on join:
apply potion of strength of tier {strength.%player%} to the player for 999 days
apply potion effects of player's tool to player
Push
🔗PvP
🔗Replace
🔗Patterns: |
|
Since: | 2.0, 2.2-dev24 (replace in muliple strings and replace items in inventory), 2.5 (replace first, case sensitivity) |
Examples:
replace every "&" with "§" in line 1
# The following acts as a simple chat censor, but it will e.g. censor mass, hassle, assassin, etc. as well:
on chat:
replace all "kys", "idiot" and "noob" with "****" in the message
replace all stone and dirt in player's inventory and player's top inventory with diamond
Return
🔗Patterns: |
|
Since: | 2.2 |
Examples:
return 2 * {_i}
Send Block Change
🔗Patterns: |
|
Since: | 2.2-dev37c, 2.5.1 (block data support) |
Examples:
make player see target block as campfire[facing=south]
Send Resource Pack
🔗Patterns: | |
Since: | 2.4 |
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.
Examples:
send the resource pack from "URL" with hash "hash" to the player
Shear
🔗Patterns: |
|
Since: | 2.0 |
Examples:
shear the clicked sheep
Shoot
🔗Patterns: |
|
Since: | 1.4 |
Examples:
make the player shoot a creeper at speed 10
shoot a pig from the creeper
Silence Entity
🔗Spawn
🔗Patterns: |
|
Since: | 1.0 |
Examples:
spawn a ghast 5 meters above the player
Stop Server
🔗Patterns: |
|
Since: | 2.5 |
Examples:
restart server
Stop Sound
🔗Patterns: |
|
Since: | 2.4 |
Requirements: | Minecraft 1.10.2+, Minecraft 1.11+ (sound categories) |
Please note that sound names can get changed in any Minecraft or Spigot version, or even removed from Minecraft itself.
Examples:
stop playing sounds "ambient.underwater.loop" and "ambient.underwater.loop.additions" to the player
Swing Hand
🔗Patterns: |
|
Since: | 2.5.1 |
Requirements: | Minecraft 1.15.2+ |
Examples:
Teleport
🔗Patterns: | |
Since: | 1.0 |
Examples:
teleport the attacker to the victim
Title - Reset
🔗Title - Send
🔗Patterns: | |
Since: | 2.3 |
Examples:
send title "Hi %player%" to player
send title "Loot Drop" with subtitle "starts in 3 minutes" to all players
send title "Hello %player%!" with subtitle "Welcome to our server" to player for 5 seconds with fadein 1 second and fade out 1 second
send subtitle "Party!" to all players
Toggle
🔗Toggle Flight
🔗Tree
🔗Patterns: |
|
Since: | 1.0 |
Examples:
Vectors - Rotate Around Vector
🔗Vectors - Rotate around XYZ
🔗Vehicle
🔗Patterns: |
|
Since: | 2.0 |
Examples:
make the attacker ride the victim
op/deop
🔗Patterns: |
|
Since: | 1.0 |
Examples:
deop all players