Player & Target Commands
You need to know that by default all commands are run by the console, so if you want that the player run the command add SUDO or SUDOOP before.
(Click on SUDO or SUDOOP for more infos)
Don't use this option for vanilla commands and CUSTOM COMMANDS, to use vanilla commands properly go to FAQ and "How to use vanilla commands",
"Multi-world" compatibility for the vanilla commands.
execute in <<NAME
OF
YOUR_WORLD>> run ...
Example, you want summon a Zombie in the world SsomarWorld:
execute in <<SsomarWorld>> run summon zombie 100 50 100
Example with a placeholder:
execute in <<%player_world%>> run summon zombie 100 50 100
You want keep the brut HEX form in your command ? add the tag BRUT_HEX in your command. It works anywhere in the command line but it's recommended to put it in the first part of the cmd to make it less confusing
By default all commands aren't executed if the player is offline. (the commands will be executed at the connection of the player)
But you can add the tag [<OFFLINE>] in your commands to remove this restriction.
(Very useful for broadcast, boost, giveall commands, ...)
Example:
[<OFFLINE>] broadcast hello !
[<OFFLINE>] execute at %player% run setblock %block_x_int%+3 %block_y_int%-1 %block_z_int%-14 minecraft:air
You can use [<CLEAR_IF_DISCONNECT>] if you want to clear commands if the player disconnects
Example:
[<CLEAR_IF_DISCONNECT>] say meow
Mixed Commands
In addition of the following list of commands you can also use:
Mixed Commands (Player & Entity)These commands can be used in the Player related commands OR Entity related commands.
Custom commands
Sorted by alphabetical order
+++ (Command Connector)
Info: Allows you to add more commands in one command line. Should be used only when you use the custom command
RANDOM RUN
.Example:
<+> (Around Command Connector)
Info: Allows you to add more commands in one command line. Will only work well with
AROUND
andMOB_AROUND
but also withALL_PLAYERS
,ALL_MOB
,NEAREST
andMOB_NEAREST
.Example:
<+::step1> (Around Command Connector when many AROUND, MOB_AROUND, NEAREST, MOB_NEAREST, ALL_PLAYERS, ALL_MOBS AND IF are nested)
ABSORPTION
Info: Gives absorption effect to the player
Command:
ABSORPTION {amount} [time in ticks]
{amount}: amount of absorption half hearts. Supports negative values to remove.
[time in ticks]: time of the effect. Set it empty or "0" if want to be infinite.
Example:
ACTIONBAR
Info: Display the action bar with your text + the time remaining (59, 58, 57...).
Command:
ACTIONBAR {Your text} {delay}
Example:
ADDENCHANTMENT
Info: It adds an enchantment on an item on a specific slot with certain level
Command: ADDENCHANTMENT {slot} {enchantment} {level}
{slot}: The slot where it will be applied. -1 for mainhand
{enchantment}: The enchantment that you want to be applied, don't use spaces, use the minecraft enchantments not the display ones.
{level}: The level for the enchantment
Example:
ADDITEMATTRIBUTE
Info: It adds an attribute to an item as sum or rest operation.
Command: ADDITEMATTRIBUTE {slot} {Attribute} {value} {equipment slot}
{slot}: The slot where it will be applied. -1 for mainhand
{attribute}: The attribute you want to add
{value}: The value for the operation
{equipment slot}: The slot for the attribute
Example:
You can find the attributes here https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
And the slots here
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/EquipmentSlot.html
AROUND
Info: Targets players in a specific radius and makes them run commands
Command:
AROUND {distance} {msgPlayerAffected true/false} {command} throughBlocks:false
{distance}: To how far in radius the command will select players
{msgPlayerAffected true/false}: To notify the affected players that they are tagged by the command and to notify the user of the item if it managed to target players or not
{command}: The command that the targeted players will execute}
throughBlocks: it will affect or not the players that are behind blocks
Example:
This summons lightning at players in a 20 block radius
This gives players slowness in a 10 block radius
Damages nearby players by 20 player damage in a 7 block radius
Many around in the same command
You can add conditions to AROUND command
The condition looks like AROUND <distance> <msg> CONDITIONS(<conditions>) <command>
Conditions works with placeholders but need to be %::_::% instead of %_%
For example %::player_health::%
To add MORE than 1 condition use "&&" between the conditions
Example:
(Mainly in blockCommands/entityCommands) where you want the owner of the block/projectile won't harm the user of the item (Requires PlaceholderAPI's Player Expansion)
Keep in mind that the CONDITIONS() part parses the placeholders in it with the player selected by the AROUND command. So what actually happened in the placeholders above is that it checks if the target's health is greater than 10 and if that player who got selected by the AROUND command is named "2Ssomar"
Placeholders that came from plugins like ExecutableItems, ExecutableBlocks will be parsed not by the player affected by the AROUND command.
For example, with ExecutableBlocks, CONDITIONS(%var_faction%=%::factionsuuid_faction_name::%) works through checking if the block's factions variable value is equal to the targetted player's faction Placeholder Source: (https://factions.support/placeholderapi/)
ADDLORE
Info: Adds a line of lore
Command: ADDLORE {slot of the player} {text dont need brackets}
Example:
AWARENESS
Info: Sets to true or false the awareness of a mob.
Command: AWARENESS {DEFAULT TRUE}
Example:
it only works for 1.16.5+
BOOTS
Info: Puts the item in your main hand to your boots slot. (Will not work if the item has "Curse of Binding")
Command: BOOTS
Example:
BOSSBAR
Info: Creates a bossbar text for a certain duration time.
Command: {duration} {color} {text}
{duration}: duration of the bossbar text
{color}: Color of bossbar text
{text}: text on the bossbar
Example:
CANCELPICKUP
Info: Disables pickup on a player for a set amount of time
Command: CANCELPICKUP {time_in_ticks} [material]
{time_in_ticks}: The duration of how long till the player can pickup items again
Example:
The only wait to RESET this command after setting a time in ticks is reloading or restarting the server. If would like a way to reset this suggest it in #suggestion-bugs channel on Discord.
CHAT
Info: Send a message from the player to the chat
Command: CHAT {text}
{text}: Text to send
Example:
CHESTPLATE
Info: Puts the item in your main hand to your chestplate slot. (Will not work if the item has "Curse of Binding")
Command: CHESTPLATE
Example:
CLOSE_INVENTORY
Info: It closes the inventory to the player
Command: CLOSE_INVENTORY
Example:
CROPS_GROWTH_BOOST
Info: It boost the growth of the crops around you
Command: CROPS_CROPS_GROWTH {radius} {delay between two growths in ticks} {total duration in ticks} {chance 0-100}
Example:
DISABLE_FLY_ACTIVATION
Info: Deny the usage of the fly for a player (Gliding in Elytra is not considered as flying)
Command: DISABLE_FLY_ACTIVATION {timeinsecs}
{timeinsecs}: The duration of the effect
Example: (The command below disable the activation of the fly during 1 minute)
DISABLE_GLIDE_ACTIVATION
Info: Deny the use of elytra for a period of time
Command: DISABLE_GLIDE_ACTIVATION {timeinsecs}
Example: (the command below disable the use of elytra for 20 secs)
DROPSPECIFICEI
Info: It drops all the EI in your inventory with the id specified
Command: DROPSPECIFICEI {id}
Example:
EICOOLDOWN
Info: It applys a cooldown to a specific ExecutableItems
Command: EICOOLDOWN {PLAYER} {ID} {SECONDS} {boolean TICKS} [optional activator id]
{PLAYER}: The player to target the command
{ID}: The id of the ExecutableItem
{Seconds}: The amount of time
{boolean TICKS}: If you want the time to be in ticks
[optional activator id]: You can apply it to a specific activator id
Example:
EBCOOLDOWN
Info: It applys a cooldown to a specific ExecutableBlocks
Command: EBCOOLDOWN {PLAYER} {ID} {SECONDS} {boolean TICKS} [optional activator id]
{PLAYER}: The player to target the command
{ID}: The id of the ExecutableItem
{Seconds}: The amount of time
{boolean TICKS}: If you want the time to be in ticks
[optional activator id]: You can apply it to a specific activator id
Example:
EECOOLDOWN
Info: It applys a cooldown to a specific ExecutableItems
Command: EECOOLDOWN {PLAYER} {ID} {SECONDS} {boolean TICKS} {optional activator}
{PLAYER}: The player to target the command
{ID}: The id of the ExecutableItem
{Seconds}: The amount of time
{boolean TICKS}: If you want the time to be in ticks
[optional activator id]: You can apply it to a specific activator id
Example:
FORMAT_ENCHANTMENTS
Info: It formats all enchantments in your lore
Command: FORMAT_ENCHANTMENTS {slot}
It supports -1 as slot to target the mainhand
Example:
FLY
FLY ON
Info: Gives the player creative flight
Command: FLY ON
Example:
FLY OFF
Info: Disables creative flight on the player and if the player's flight get's disabled midair, the player will be teleported on the possible block under the player.
Command: FLY OFF {teleportOnTheGround true or false}
{teleportOnTheGround true or false}: Whether the player would get teleported to the ground or not
Example:
GRAVITY ENABLE/DISABLE
Info: It stops the gravity for the player, stopping the player to "fall" down or going up.
Command:
GRAVITY_ENABLE
GRAVITY_DISABLE
Example:
HEAD
Info: Puts the item in your main hand to your head slot. (Will not work if the item has "Curse of Binding")
Command: HEAD
Example:
HITSCAN_PLAYERS
Info: It allows to run a command at certain direction to players
Command: HITSCAN_PLAYERS range:5 radius:0 pitch:0 yaw:0 leftRightShift:0 yShift:0 throughBlocks:true throughEntities:true COMMANDS HERE
Range: how far an entity can be to be targetted by the HITSCAN command
RadiusOfHitscan: How WIDE the cylinder is. It's basically the difference of shooting a bullet vs shooting a cannonball.
Pitch: What direction to shoot it in, relative to player pitch
Yaw: Same thing as Pitch but with yaw
leftRightShift:
-5 = the hitscan STARTS from 5 blocks to the left.
0 = Hitscan is centered where the player is.
5 = hitscan STARTS from 5 blocks to the right of the player.
yShift: Same as left,right, except with a different axis.
throughEntities: Boolean: Whether or not the HITSCAN can go through entities.
throughBlocks: Boolean: Whether or not the HITSCAN can go through blocks.
Commands: The same than AROUND commands, cou can type command1 <+> command2 ... and use the placeholder %around_target%
Image to understand:
HITSCAN_ENTITIES
Info: It allows to run a command at certain direction to entities
Command: HITSCAN_ENTITIES range:5 radius:0 pitch:0 yaw:0 leftRightShift:0 yShift:0 throughBlocks:true throughEntities:true COMMANDS HERE
Range: how far an entity can be to be targetted by the HITSCAN command
RadiusOfHitscan: How WIDE the cylinder is. It's basically the difference of shooting a bullet vs shooting a cannonball.
Pitch: What direction to shoot it in, relative to player pitch
Yaw: Same thing as Pitch but with yaw
leftRightShift:
-5 = the hitscan STARTS from 5 blocks to the left.
0 = Hitscan is centered where the player is.
5 = hitscan STARTS from 5 blocks to the right of the player.
yShift: Same as left,right, except with a different axis.
throughEntities: Boolean: Whether or not the HITSCAN can go through entities.
throughBlocks: Boolean: Whether or not the HITSCAN can go through blocks.
Commands: The same than AROUND commands, cou can type command1 <+> command2 ... and use the placeholder %around_target%
Image to understand:
JOBS_MONEY_BOOST
It supports "Jobs reborn"
Info: Increases the money gained temporarily
Command: JOBS_MONEY_BOOST {multiplier} {timeinsecs}
{multiplier}: Multiplier value
{timeinsecs}: Duration of the boost in seconds
LAUNCH
Info: Launches a custom projectile. Reference
List:
Command: LAUNCH {projectile} [angle rotation y] [angle rotation z]
{projectile}: the type of the projectile
[angle rotation y]: (only for 1.14 and +) (not necessary) (default = 0) (in degrees) Define the direction where the entity will be launched
[angle rotation z]: (only for 1.14 and +) (not necessary) (default = 0) (in degrees) Define the direction where the entity will be launched
Example:
Example multiple shoots:
If you use the LAUNCH COMMAND in the activator PLAYER_LAUNCH_PROJECTILE, and the projectile has been launched by a bow, the projectile launch with the custom LAUNCH command will keep the same velocity.
LEGGINGS
Info: Puts the item in your main hand to your leggings slot. (Will not work if the item has "Curse of Binding")
Command: LEGGINGS
Example:
LOCATED_LAUNCH
Info: Launches a projectile at a specific location
Command: LOCATED_LAUNCH {projectileType} {frontValue positive=front , negative=back} {rightValue right=positive, negative=left} {yValue} {velocity} [vertical rotation] [horizontal rotation]
{projectileType}: The id of the projectile that you want to launch
{frontValue positive=front , negative=back}: Front/Back Position. For example, if you want to spawn the projectile 5 blocks far from where you're facing, use a higher positive value
{rightValue right=positive, negative=left}: Right/Left Position. For example, if you want the projectile to spawn to your left, use a higher negative value
{yValue}: To how high up from your Y position will the projectile will spawn.
{velocity}: To how fast will the projectile fly. Set the value to 0 for the projectile to fall downwards upon spawning the projectile.
[vertical rotation] (Optional) you can add a vetical rotation for your projectile (in degrees)
[horizontal rotation] (Optional) you can add a horizontal rotation for your projectile (in degrees)
Example:
MINECART_BOOST
Info: It boost you when riding a minecart (Effect close to when you go up of a powered rail)
Command: MINECART_BOOST {number boost}
Example:
MOB_AROUND
Info: Targets entities in a specific radius and makes them run commands
Available entities -> https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/LivingEntity.html
Command: MOB_AROUND {distance} {mute or not} (command)
{distance}: To how far in radius the command will select entities
{mute or not}: (true or false) To notify the user of the item if it didn't manage to target any mobs.
Set to true to hide the message
You can BLACKLIST or WHITELIST entities adding one of these ones in anyplace of the command:
BLACKLIST(ZOMBIE,ARMOR_STAND)
WHITELIST(CHICKEN)
Example:
To use entity nbt on the WHITELIST/BLACKLIST field, you need to install NBT API plugin
It supports NBT Tags so you can add for example something like: ZOMBIE{IsBaby:1}
MODIFYDURABILITY
Modifies the durability of a specific item in a specific slot
Command: MODIFYDURABILITY {number} {slot} {supportUnbreaking true or false}
{number}: Positive value to increase the durability. Negative value to decrease the durability
{slot}: The slot number of the item (-1 for the held slot)
{supportUnbreaking true or false}: If it supports the unbreaking enchantment or not
Example:
MIX_HOTBAR
Info: it mixes the hotbar of the player
Command: MIX_HOTBAR
Example:
MOB_NEAREST
Info: Targets the nearest mob from the player/target.
Command:
MOB_NEAREST
{max accepted distance}{command}
{max accepted distance}: Max distance accepted that the "entity" can be.
{command}: The command that will be executed
Example:
Damages nearest player
NEAREST
Info: Targets the nearest player from the player/target.
Command:
NEAREST
{max accepted distance}{command}
{max accepted distance}: Max distance accepted that the "target" can be.
{command}: The command that will be executed
Example:
Damages nearest player
OPEN_WORKBENCH
Info: It opens a workbench for the player that runs the activator
Command: OPEN_WORKBENCH
Example:
OPEN_ENDERCHEST
Info: It opens the ender chest for the player that runs the activator
Command: OPEN_ENDERCHEST
Example:
OPENCHEST
Info: It opens a chest in the selected location
Command: OPENCHEST {world} {x} {y} {z} [bypassProtections]
{bypassProtections}: If it will open the chest anyways even if its protected
Example:
It supports barrels
OXYGEN
Info: It gives oxygen to the target
Command: OXYGEN {timeinticks}
Example:
PARTICLE
Info: Spawns particles in the player/target's location
Command: PARTICLE {type} {quantity} {offset} {speed}
{type}: The type of particle (ALL CAPS)
{quantity}: The amount of particles that will spawn
{offset}: The radius of the area where the particles may spawn in the player/target's location
{speed}: To how fast or how big particles will be
Example:
PROJECTILE_CUSTOMDASH1
Info: Similar to CUSTOMDASH1 but the xyz will be replaced with the xyz coords of the nearest projectile from you.
Command: PROJECTILE_CUSTOMDASH1 {fallDamage}
{fallDamage}: Whether you will get fall damage or not (If you forgot to set whether it's true or false, the default will be false. To get fall damage, set this to true)
Example:
REGAIN FOOD
Info: Gives you a specific amount of food/saturation
Command: REGAIN FOOD {amount}
{amount}: The amount of saturation points you want to gain. Use negative values to reduce hunger points
Example:
REGAIN MAGIC
Info: Gives the player specific values of a specific magic
Command: REGAIN MAGIC {ecoskills magic ID} {amount}
{ecoskills magic ID}: The ID of the Ecoskills's magic.
{amount}: The amount to get.
Example:
It supports negative values.
REGAIN SATURATION
Info: Gives you a specific amount of saturation
Command: REGAIN SATURATION <value>
Example:
REMOVEENCHANTMENT
Info: Remove an enchantment from a slot
Command: REMOVEENCHANTMENT {slot} {enchantment}
{slot}: Slot to remove the enchantment from
{enchantment}: Enchantment to remove (ALL for every enchantment)
Example:
REMOVELORE
Info: Remove a lore line
Command: REMOVELORE {slot} {line}
{slot}: Slot to remove the lore from
{line}: The line that you want to remove
Example:
REPLACEBLOCK
Info: Replaces the block the player is looking at into a different one
Command: REPLACEBLOCK {material}
{material}: Block ID (Block states are supported) (ALL CAPS)
Example:
SENDBLANKMESSAGE
Info: Sends you a blank message
Command: SENDBLANKMESSAGE
Example:
SENDMESSAGE
Info: Sends you a message
Command: SENDMESSAGE (message)
Example:
You can use minimessages color codes, like using gradient and stuff from this site: https://docs.adventure.kyori.net/minimessage/format.html You can only use one type of formatting at once in the same SENDMESSAGE command, either the classic color codes format or minimessage format.
SETARMORTRIM
Info: Set the specific armor trim with the specific pattern for the specified slot
Command: SETARMORTRIM {slot} {PATTERN} {MATERIAL OF PATTERN}
{slot}: The slot to apply the command
{PATTERN}: The pattern of the trim
{MATERIAL OF PATTERN}: The material of the pattern
Example:
SETBLOCK
Info: (FOR ACTIVATORS THAT INVOLVES TARGETTING BLOCKS) Adds blocks in the block's location. (Only replaces air)
Command: SETBLOCK {material}
{material}: Block ID (Block states are supported) (ALL CAPS)
Example:
SETTEMPBLOCKPOS
Command: SETTEMPBLOCKPOS {x} {y} {z} {material} {time} [bypassProtection true or false] [blocks list]
{material}: Block ID
{time}: Time in ticks
[bypassProtection true or false]: Whether to ignore 3rd party intervention or not
[blocks list]: List of blocks to watch out for
Examples:
AIR, WATER
!STONE, !COBBLESTONE
It doesn't replace blocks that have extra datas (inventory, rotation, etc)
SETBLOCKPOS
Info: Set a block in a specific position
Command: SETBLOCKPOS {x} {y} {z} {material} [bypassProtection true-false] [replace true or false]
Example:
SETEXECUTABLEBLOCK
Info: Setblock but for Executable Blocks. (EXECUTABLE BLOCKS MUST BE INSTALLED)
Command: SETEXECUTABLEBLOCK {id} {x} {y} {z} {world} {replace true or false} [ownerUUID]
{id}: ID of the executable block you are trying to place down
{x}: X-Coordinate
{y}: Y-Coordinate
{z}: Z-Coordinate
{world}: Name of the world
{replace true or false}: true or false. Whether it will replace the existing block in the said coordinates or not
[bypassProtection true or false]: (Optional) if you want bypass the protections like worldguard (default false)
[ownerUUID]: (Optional) The uuid of the supposed owner of the executable block
Example:
SETITEMNAME
Info: Sets a custom name for your item in a specific slot
Command: SETITEMNAME {slot} {text}
Example:
SETITEMCOLOR
Info: Sets a specific color for the item (item colorables as leather armor)
Command: SETITEMCOLOR {slot} {color in number}
Example:
Use the website: https://www.tydac.ch/color/ for the leather color
It supports FIREWORK_STAR
SETITEMATTRIBUTE
Info: It sets an attribute to an item.
Command: SETITEMATTRIBUTE {slot} {Attribute} {value} {equipment slot}
{slot}: The slot where it will be applied. -1 for mainhand
{attribute}: The attribute you want to add
{value}: The value for the operation
{equipment slot}: The slot for the attribute
Example:
You can find the attributes here https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
SETITEMCUSTOMMODELDATA
Info: Sets a specific custom model data to the specific item
Command: SETITEMCUSTOMMODELDATA {slot} {customModelData}
Example:
It supports -1 to mainhand
SETMATERIALCOOLDOWN
Gives the player/target cooldown on an item
Command: SETMATERIALCOOLDOWN {material} {delay in secs}
{material}: The type of material
{delay in secs}: Cooldown
Example:
SETITEMMATERIAL
Only works at 1.20.5 and above
Replaces the material of the item with a different material while keeping the nbt of the target item
Commands: SETITEMMATERIAL {slot} {material}
{slot}: Slot number
{material}: The material you want the item to become into
Example:
SETLORE
Info: Sets a line of lore
Command: SETLORE {slot of the player} {line} {text}
{line} : If you want to set the lore of the first line, type 0
Example:
SPAWNENTITYONCURSOR
Info: Spawn entities on your cursor
Command: SPAWNENTITYONCURSOR {entityType} {amount}
{entityType}: Mob ID (ALL CAPS)
{amount}: The amount of mobs that will spawn in that spot
Example:
SUDO
Info: Forces you to run a command
Command: SUDO (command)
Example:
SUDOOP
Info: Gives the player OP, SUDOs the player and DEOPs it
Extra Info: During the OP, the player can only run the specified command after the SUDOOP, all other commands are blocked when the player is OP, and if the server crashes, no problem. The player will be DEOPed when the player reconnects.
Command: SUDOOP (command)
Example:
It is not recommended to use this a lot. As it is explained on the top of this page, if want to run vanilla commands use the execute command (Explained on the FAQ "How to use vanilla commands").
If have another way to achieve what you want use it.
And if you have no other way but using SUDOOP, then use this command. This shouldn't be your first option.
SWAPHAND
Info: Swaps the current item with your offhand item
Command: SWAPHAND
Example:
TRANSFER_ITEM
Info: Swaps 2 items in the inventory by slot
Command: TRANSFER_ITEM {slot of launcher} {slot of receiver} [boolean drop]
{slot of launcher}: Target slot for slot no.1
{slot of receiver}: Target slot for slot no.2
[boolean drop]: (default = false) Whether {slot of launcher} gets dropped during the swap or not
XPBOOST
Info: Boost the xp gain for a time.
Command: XPBOOST {multiplier} {timeinsecs}
Example:
Be careful ! This command can get stacked, so if you run this command multiple times you will get more and more multipliers if the time between them is not enough for the last boost to disappear. XPBOOST 2 5 DELAY 1 XPBOOST 2 5 This means the XP will be boosted in this order: 1 second: x2 4 seconds: x4 1 second: x2
WHILE
Info: It constantly executes the commands written as long as the condition matches
Command: WHILE {condition_without_spaces} {delay_in_ticks} {command}
{condition_without_spaces}: The condition that need to match for the commands to run
Condition supports these symbols: != ; <= ; >= ; < ; > ; =
{delay_in_ticks}: The delay between each moment to run the commands
Condition support double placeholders, example %player_x%>%player_z%
{command}: The command that you want to run as long as the condition matches
Example:
It supports more than one command
You can force to remove the WHILE command with "/score clear {player} WHILE"
Mixed Commands
In addition of the following list of commands you can also use:
Mixed Commands (Player & Entity)These commands can be used in the Player related commands OR Entity related commands.
Last updated