Difference between revisions of "Commands"

From Mine Blocks Wiki
Jump to navigation Jump to search
If you find a typo, inconsistency, or error, please sign up and help out the wiki! We can't do it without your help! :D Thank you!

(Added missing commands, added descriptions and definitions, organized examples, and formatted it into a table.)
m (Fixed link.)
 
(48 intermediate revisions by 14 users not shown)
Line 1: Line 1:
Commands (also known as Cheats), are scripted codes that the player can write in a game console that change the game directly.
+
__NOTOC__
  
==Using==
+
Commands (also known as Cheats) are scripted codes that the player can write in the game console that change the game directly.
In order to use commands, the world must have cheats enabled. This option can only be enabled on the world creation screen, and cannot be enabled after a world has already been created.
+
 
 +
== Using Commands ==
 +
To use commands, the world must have cheats enabled. Cheats can only be enabled on the world creation screen, and cannot be enabled after a world has already been created.
  
 
The default key binding for opening the command console is "T". This can be changed in the game settings. When the console is open, the player can write a command, and execute it by pressing Enter.
 
The default key binding for opening the command console is "T". This can be changed in the game settings. When the console is open, the player can write a command, and execute it by pressing Enter.
  
The command definition includes two different types of brackets. It's important to know the difference between them.
+
When commands are entered, the capitalization of letters does not matter.
* Parameters between the <code>&lt;</code> and <code>&gt;</code> brackets is a list of options, separated by <code>|</code> characters. For example, in <code>/gamemode <survival|creative></code>, you can either write <code>/gamemode survival</code>, or <code>/gamemode creative</code>.
 
* Parameters between the <code>[</code> and <code>]</code> brackets is an optional parameter. When writing a command, you can omit the parameters. For example, in <code>/lightning [[~]x [~]y]</code>, you can simply omit the X and Y parameters like so: <code>/lightning</code>.
 
  
Note that <code>[~]</code> is an optional modifier that can be added to coordinates, which makes it relative the player's location.
+
=== Reading Command Definitions ===
 +
Below is a list of command definitions (instructions on how each command works). The definitions include two different types of brackets:
 +
# Parameters between <code>&lt;</code> and <code>&gt;</code> angle brackets is a list of potential options. Each option is separated by a <code>|</code> "pipe" character. If an option contains multiple parameters, as seen in the <code>fill</code> command, it will be surrounded by parentheses. As an example, in <code>/gamemode <survival|creative|adventure|spectator></code>, you can write <code>/gamemode survival</code>, <code>/gamemode creative</code>, <code>/gamemode adventure</code>, or <code>/gamemode spectator</code>.
 +
# Parameters between the <code>[</code> and <code>]</code> square brackets are ''optional'' parameters. When writing a command, you can skip optional parameters. For example, in <code>/lightning [[~]x [~]y]</code>, you can omit both the <code>[~]x</code> and <code>[~]y</code> parameters, like so: <code>/lightning</code>. Also, the <code>[~]</code> means you can use relative coordinates.
  
==List of Commands==
+
The <code>~</code> character can be added before certain coordinate numbers to make the coordinate relative to your position in the world, instead of relative to block (0, 0). For example, running <code>/explode 5 ~3 ~0</code> will perform a size 5 explosion, 3 blocks to the left of the player.
  
{| class="wikitable" class="wikitable" style="vertical-align:top; width:100%; background-color:#F2F2F2"
+
== List of Commands ==
|-----------------------------------------------------------------------------------------------------------
+
{| class="wikitable" style="width: 100%;"
 +
|-
 
!width="100"|Command
 
!width="100"|Command
 
!width="250"|Description
 
!width="250"|Description
 
!width="400"|Definition
 
!width="400"|Definition
 
!Examples
 
!Examples
|-----------------------------------------------------------------------------------------------------------
+
|-
|
+
!
===help===
+
=== help ===
| ''This command is '''always available''', even if cheats are disabled.''
+
| This command is always available, even if cheats are disabled.
  
 
Lists all of the possible commands.
 
Lists all of the possible commands.
|
+
| <code>/help</code>
<code>/help</code>
+
| <code>/help</code>
|
+
|-
 
+
!
|-----------------------------------------------------------------------------------------------------------
+
=== seed ===
|
+
| This command is always available, even if cheats are disabled.
===seed===
 
| ''This command is '''always available''', even if cheats are disabled.''
 
  
 
Shows the seed number of the current world.
 
Shows the seed number of the current world.
|
+
| <code>/seed</code>
<code>/seed</code>
+
| <code>/seed</code>
|
 
 
 
 
|-
 
|-
| colspan="4" style="text-align: center;"|
+
!
 
+
=== cheats ===
|-----------------------------------------------------------------------------------------------------------
+
| This command will only exist if the world was created prior to 1.26.5 (when cheats were added to the game).
|
 
===cheats===
 
| ''This command will '''only exist''' if the world was created prior to cheats being added to the game.''
 
  
 
It allows players to permanently enable or disable cheats in their world.
 
It allows players to permanently enable or disable cheats in their world.
 
|
 
|
 
<code>/cheats <enable|disable></code>
 
<code>/cheats <enable|disable></code>
 +
| <code>/cheats enable</code><br>
 +
<code>/cheats disable</code>
 +
|-
 +
!
 +
=== clear ===
 +
| Removes items from the inventory, but also returns a message if the specified item is present.
 +
|
 +
<code>/clear itemname [<quantity|-1>] [damage] [data_tags]</code>
 +
* <code>itemname</code>: The [[identifiers|identifier]] for the item to remove.
 +
* <code>itemname</code>: The quantity of items to be removed. -1 means all present in the inventory
 +
* <code>damage</code>: The amount of damage the item to be removed has undergone.
 +
* <code>data_tags</code>: The tags the item to be removed has.
 
|
 
|
 
+
*<code>/clear</code>
 +
**Removes all items from the inventory.
 +
*<code>/clear wool 0</code>
 +
**Does not remove any items, but returns a message saying "Found a match" if the player has wool in their inventory.
 +
*<code>/clear wool -1 0 {type:"rainbow"}</code>
 +
** Removes all rainbow wool from the inventory
 +
*<code>/clear wool 1 0 {type:"red"}</code>
 +
** Removes 1 red wool from the inventory
 
|-
 
|-
| colspan="4" style="text-align: center;"|
+
!
 
+
=== clone ===
|-----------------------------------------------------------------------------------------------------------
+
| Clones part of the world and pastes it somewhere else, with data tags for blocks.
 +
|
 +
<code>/clone [~]x1 [~]y1 width height [~]xDest [~]yDest [<filtered|masked|replace>] [<force|move|normal>] block_mask</code>
 +
* <code>[~]x1 [~]y1</code>: The x and y coordinate to start cloning from.
 +
* <code>width height</code>: How many blocks rightward (width) and upward (height) to clone.
 +
* <code>[~]xDest [~]yDest</code>: The x and y coordinate to clone to.
 +
* <code>[filtered|masked|replace]</code>: The filtering setting.
 +
* <code>[force|move|normal]</code>: Whether the original blocks are kept.
 +
* <code>block_mask</code>: The blocks to clone.
 
|
 
|
===difficulty===
+
|-
 +
!
 +
=== cls ===
 +
| "cls" stands for "clear screen". This command clears console messages from the screen.
 +
| <code>/cls</code>
 +
| <code>/cls</code>
 +
|-
 +
!
 +
=== difficulty ===
 
| Sets the difficulty mode of the world.
 
| Sets the difficulty mode of the world.
 
|
 
|
Line 65: Line 97:
 
*<code>/difficulty normal</code>
 
*<code>/difficulty normal</code>
 
*: Sets the game to normal difficulty
 
*: Sets the game to normal difficulty
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== enchant ===
===enchant===
+
| Applies an enchantment to the player's held item. A message will appear saying that the enchantment has been "added to selected item". If the player is holding nothing, the message that the held item has been enchanted will still appear.
| Applies and enchantment to the player's equipped item.
 
 
|
 
|
<code>enchant enchantment_id</code>
+
<code>/enchant enchantment_id</code>
* <code>enchantment_id</code>: See list of enchantment ID's here: [[Enchantment_table#Commands|Enchantments]]
+
* <code>enchantment_id</code>: See list of enchantment ID's here: [[Enchanting#Commands|Enchantments]]
 
|
 
|
 
* <code>/enchant Unbreaking4</code>
 
* <code>/enchant Unbreaking4</code>
Line 78: Line 109:
 
* <code>/enchant LuckOfTheSeaII</code>
 
* <code>/enchant LuckOfTheSeaII</code>
 
*: Enchants the held item with the Luck of the Sea 2 enchantment.
 
*: Enchants the held item with the Luck of the Sea 2 enchantment.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== explode ===
===explode===
 
 
| Creates an explosion.
 
| Creates an explosion.
 
|
 
|
Line 90: Line 120:
 
* <code>/explode 5 ~ ~-3</code>
 
* <code>/explode 5 ~ ~-3</code>
 
*: Performs a size 5 explosion, 3 blocks below the player.
 
*: Performs a size 5 explosion, 3 blocks below the player.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== fill ===
===fill===
+
| Fills a region of blocks with the specified block type.
| Fills a region of blocks with the specified block type
 
 
|
 
|
<code>fill block_type [~]x [~]y width height [(replace [replace_block_type])|keep|outline|hollow|destroy]</code>
+
<code>/fill block_type [~]x [~]y width height [<(replace [replace_block_type])|keep|outline|hollow|destroy>] [data_tags]</code>
 
* <code>block_type</code>: The [[identifiers|identifier]] for the block to fill.
 
* <code>block_type</code>: The [[identifiers|identifier]] for the block to fill.
 
* <code>[~]x [~]y</code>: The x and y coordinate to start filling from.
 
* <code>[~]x [~]y</code>: The x and y coordinate to start filling from.
Line 106: Line 135:
 
** <code>hollow</code> will fill the inner edge and clear all blocks inside.
 
** <code>hollow</code> will fill the inner edge and clear all blocks inside.
 
** <code>destroy</code> replaces all blocks by mining them first.
 
** <code>destroy</code> replaces all blocks by mining them first.
 +
* <code>data_tags</code>: Specifies additional data to apply to the block. See [[data tags]] for more information.
 
|
 
|
 
* <code>/fill diamond_block ~-5 ~ 11 1 replace</code>
 
* <code>/fill diamond_block ~-5 ~ 11 1 replace</code>
Line 111: Line 141:
 
* <code>/fill air ~-10 ~-10 21 21 replace stone</code>
 
* <code>/fill air ~-10 ~-10 21 21 replace stone</code>
 
*: Replaces stone around the player with air.
 
*: Replaces stone around the player with air.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== gamemode ===
===gamemode===
 
 
| Switches between the game modes.
 
| Switches between the game modes.
 
|
 
|
<code>/gamemode <survival|creative></code>
+
<code>/gamemode <survival|creative|adventure|spectator></code>
 
|
 
|
 
*<code>/gamemode creative</code>
 
*<code>/gamemode creative</code>
Line 125: Line 154:
 
*: Switches to survival mode.
 
*: Switches to survival mode.
 
*: <code>/gamemode 0</code> and <code>/gamemode s</code> will also work.
 
*: <code>/gamemode 0</code> and <code>/gamemode s</code> will also work.
 
+
*<code>/gamemode adventure</code>
|-----------------------------------------------------------------------------------------------------------
+
*: Switches to adventure mode.
|
+
*: <code>/gamemode 2</code> and <code>/gamemode a</code> will also work.
===gamerule===
+
*<code>/gamemode spectator</code>
 +
*: Switches to spectator mode.
 +
*: <code>/gamemode 3</code> and <code>/gamemode p</code> will also work.
 +
|-
 +
!
 +
=== gamerule ===
 
| Sets global variables in the game world, such as the ability for players to keep their inventory when they die.
 
| Sets global variables in the game world, such as the ability for players to keep their inventory when they die.
 
|
 
|
<code>/gamerule <rule> value</code>
+
<code>/gamerule rule <value></code>
 
|
 
|
 
* <code>/gamerule keepinventory true</code>
 
* <code>/gamerule keepinventory true</code>
Line 141: Line 175:
 
* <code>/gamerule mobgriefing false</code>
 
* <code>/gamerule mobgriefing false</code>
 
*: Disallows mobs from changing blocks in the world.
 
*: Disallows mobs from changing blocks in the world.
 
+
* <code>/gamerule domobloot false</code>
|-----------------------------------------------------------------------------------------------------------
+
*: Stops mobs from dropping items upon death.
|
+
* <code>/gamerule sendcommandfeedback false</code>
===give===
+
*: Stops commands from returning feedback into chat if they are run successfully.
 +
|-
 +
!
 +
=== give ===
 
| Gives the player any block or item.
 
| Gives the player any block or item.
 
|
 
|
<code>give item [amount] [damage] [data_tags]</code>
+
<code>/give item [amount] [damage] [data_tags]</code>
 
* <code>item</code>: The [[identifiers|identifier]] for the item to give.
 
* <code>item</code>: The [[identifiers|identifier]] for the item to give.
 
* <code>amount</code>: Specifies how many of the item to give.
 
* <code>amount</code>: Specifies how many of the item to give.
Line 161: Line 198:
 
* <code>/give wooden_shovel 1 0 {enchantments:["unbreaking3"]}</code>
 
* <code>/give wooden_shovel 1 0 {enchantments:["unbreaking3"]}</code>
 
*: Gives a wooden shovel with an unbreaking enchantment.
 
*: Gives a wooden shovel with an unbreaking enchantment.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== heal ===
===heal===
 
 
| Instantly heals the player.
 
| Instantly heals the player.
|
+
| <code>/heal</code>
<code>/heal</code>
+
| <code>/heal</code>
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== home ===
===home===
 
 
| Teleports to the player's spawn point.
 
| Teleports to the player's spawn point.
 
|
 
|
Line 182: Line 217:
 
* <code>/home set 5 3</code>
 
* <code>/home set 5 3</code>
 
*: Sets the player's spawn point to the block at x=5 and y=3.
 
*: Sets the player's spawn point to the block at x=5 and y=3.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== kill ===
===kill===
 
 
| Instantly kills the player.
 
| Instantly kills the player.
|
+
| <code>/kill</code>
<code>/kill</code>
+
| <code>/kill</code>
|
+
|-
 
+
!
|-----------------------------------------------------------------------------------------------------------
+
=== lightning ===
|
+
| Generates lightning.
===lightning===
 
| Generates lightning
 
 
|
 
|
 
<code>/lightning [[~]x [~]y]</code>
 
<code>/lightning [[~]x [~]y]</code>
Line 202: Line 234:
 
* <code>/lightning ~-5 ~</code>
 
* <code>/lightning ~-5 ~</code>
 
*: Generates lightning 5 blocks to the left of the player.
 
*: Generates lightning 5 blocks to the left of the player.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
 +
=== say ===
 +
| Returns the specified message in chat.
 +
| <code>/say message</code>
 +
|
 +
*<code>/say hello world</code>
 +
**Returns the message "hello world" in chat.
 +
* <code>/say hello \n world</code>
 +
*: Returns the message with a line break after \n.
 +
|-
 +
!
 +
=== setblock ===
 +
| Replaces the existing block with the specified block.
 +
|
 +
<code>/setblock block_type [~]x [~]y [<replace|keep|destroy>] [data_tags]</code>
 +
* <code>block_type</code>: The [[identifiers|identifier]] for the block.
 +
* <code>[~]x [~]y</code>: The x and y coordinate where the block is put.
 +
* <code>oldBlockHandling</code>: Different replacement algorithms:
 +
** <code>replace</code> replaces any existing block.
 +
** <code>keep</code> only replaces an air block.
 +
** <code>destroy</code> replaces block by mining it first.
 +
* <code>data_tags</code>: Specifies additional data to apply to the block. See [[data tags]] for more information.
 
|
 
|
===spawnskin===
+
* <code>/setblock diamond_block ~ ~</code>
| Spawns in a NPC (Non-player control)into the game. You need to have a skin ID for the NPC, which can be found on skin stats in the gallery.
+
** Replaces the block under the player with a diamond block.
 +
* <code>/setblock dirt ~2 ~2 keep</code>
 +
** Replaces the block two blocks to the right and two blocks above the player to dirt, so long as it is an air block.
 +
* <code>/setblock anvil 10 10 destroy {damage:2}</code>
 +
** Creates an anvil that has been damaged at position x=10 and y=10 in the world, first destroying any block that might have been there.
 +
|-
 +
!
 +
=== spawnskin ===
 +
| Spawns in an NPC (non-player character) into the game. You need to have a skin ID for the NPC, which can be found on skin information in the skin database.
 
|
 
|
 
<code>/spawnskin skin_id_number [amount] [[~]x [~]y]</code>
 
<code>/spawnskin skin_id_number [amount] [[~]x [~]y]</code>
 
|
 
|
 
* <code>/spawnskin 58300</code>
 
* <code>/spawnskin 58300</code>
*: Spawns 1 of [http://mineblocks.com/1/skin/58300 Zanzlanz's Squid skin].
+
*: Spawns 1 of [//mineblocks.com/1/skin/58300 Zanzlanz's Squid skin].
 
* <code>/spawnskin 58300 5</code>
 
* <code>/spawnskin 58300 5</code>
 
*: Spawns 5 of them.
 
*: Spawns 5 of them.
 
* <code>/spawnskin 58300 1 ~-5 ~3</code>
 
* <code>/spawnskin 58300 1 ~-5 ~3</code>
 
*: Spawns 1 of them, 5 blocks to the left, and three blocks above the player.
 
*: Spawns 1 of them, 5 blocks to the left, and three blocks above the player.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
 +
=== summon ===
 +
| Spawns in a mob.
 +
|
 +
<code>/summon mob_type [quantity] [[~]x [~]y] [data_tags]</code>
 
|
 
|
===time===
+
* <code>summon pig</code>
 +
** Summons 1 pig, at the players position
 +
* <code>summon cow 5 ~1 ~-2</code>
 +
** Summons 5 cows one block to the right, and two blocks below the player
 +
* <code>summon spawnskin 1 ~ ~ {skin:1327,name:"Notch",health:1,drops:[{item:{id:"mob_head",type:1327}}]}</code>
 +
** Summons one notch spawnskin at the players position with the name "Notch", which has half a heart of health and drops its head upon death.
 +
*
 +
* <code>summon spawnskin 1 ~ ~ {skin:6273, aggro:"hostile"}</code>
 +
** Summons a spawnskin that will instantly start attacking the player; other possible data tags are neutral and passive.
 +
|-
 +
!
 +
=== time ===
 
| Sets/shows the current time of the day, which is a value between 1 and 100.
 
| Sets/shows the current time of the day, which is a value between 1 and 100.
 
|
 
|
<code>/time <get|set [t|day|night]></code>
+
<code>/time <get|set <t|day|night>></code>
 
|
 
|
 
* <code>/time get</code>
 
* <code>/time get</code>
Line 230: Line 306:
 
* <code>/time set day</code>
 
* <code>/time set day</code>
 
*: Sets time to 0.
 
*: Sets time to 0.
 
+
|-
 
+
!
|-----------------------------------------------------------------------------------------------------------
+
=== tp ===
|
 
===tp===
 
 
| Teleports (TPs) the player to a specific location.
 
| Teleports (TPs) the player to a specific location.
 
|
 
|
<code>/tp <[~]x [~]y></code>
+
<code>/tp [~]x [~]y</code>
 
|
 
|
 
* <code>/tp ~5 ~3</code>
 
* <code>/tp ~5 ~3</code>
Line 243: Line 317:
 
* <code>/tp 5 3</code>
 
* <code>/tp 5 3</code>
 
*: Teleports the player to the block at x=5 and y=3.
 
*: Teleports the player to the block at x=5 and y=3.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== weather ===
===weather===
 
 
| Sets/shows whether it is raining in the world, or not.
 
| Sets/shows whether it is raining in the world, or not.
 
|
 
|
Line 255: Line 328:
 
* <code>/weather set rain</code>
 
* <code>/weather set rain</code>
 
*: Makes it start raining.
 
*: Makes it start raining.
 
+
|-
|-----------------------------------------------------------------------------------------------------------
+
!
|
+
=== xp ===
===xp===
 
 
| Sets the experience points of the player.
 
| Sets the experience points of the player.
 
|
 
|
Line 269: Line 341:
 
* <code>/xp add 10L</code>
 
* <code>/xp add 10L</code>
 
*: Adds 10 levels to the player's experience.
 
*: Adds 10 levels to the player's experience.
 +
|}
  
 +
== History ==
 +
{| class="wikitable"
 +
! width=60px | Version
 +
! width=100px | Date
 +
! Changes
 +
|-
 +
! [[Version History#1.26.5|1.26.5]]
 +
| Jul 03, 2014
 +
|
 +
* Commands were first introduced
 +
** Added commands: '''cheats, explode, fill, gamemode, gamerule, give, help, home, kill, seed, time, weather, xp'''
 +
|-
 +
! [[Version History#1.27|1.27]]
 +
| Nov 13, 2015
 +
|
 +
* Default keybinding to open commands changed from "/" to "T"
 +
* Added commands: '''heal, spawnskin, tp'''
 +
* Added a doFireTick game rule
 +
* Added "L" modifier to xp
 +
* Added oldBlockHandling to fill
 +
|-
 +
! [[Version History#1.28|1.28]]
 +
| Oct 08, 2016
 +
|
 +
* Added commands: '''difficulty, enchant, lightning'''
 +
* Added a passiveMobs game rule
 +
* Added durability and data_tags to give
 +
|-
 +
! [[Version History#1.29|1.29]]
 +
| Sep 27, 2019
 +
|
 +
* Removed quick command buttons from creative inventory
 +
* Added commands: '''clone, summon, setBlock, say, cls, clear'''
 +
* Command history is retained when switching worlds
 +
* "Hallow" and "replace" methods of the fill command behave properly
 +
* The area where the command console could not be clicked on decided to vanish
 +
* Giving a potion with commands with a space in the name works properly
 +
* Fixed various small command parsing issues
 +
* Converted fill command to use width and height instead of X2 and Y2 coordinates
 +
* Wool, wool backdrops, dye, carpet and potions now have default types when given with commands
 +
* Moved command output higher to no longer overlap command window and item text
 +
* mobGriefing for creepers properly matches gamerule by default
 +
* New game rules doMobLoot and sendCommandFeedback
 +
* Adventure game mode
 +
* Fill command now takes data tags
 +
|-
 +
! [[Version History#1.29.1|1.29.1]]
 +
| Oct 5, 2019
 +
|
 +
* Fill command fill info displays width and height instead of secondary coordinates
 +
* Replaced "spawn" with "summon" in the help command list
 +
* Added "say" to the help command list
 +
* Increased maximum command length from 256 to 1024 characters
 +
* Summon command quantity is now limited to 20 mobs
 +
|-
 +
! [[Version History#1.29.2|1.29.2]]
 +
| Oct 20, 2019
 +
|
 +
* Entering a lightning command without parameters no longer randomizes the position
 +
|-
 +
! [[Version History#1.30|1.30]]
 +
| Nov 13, 2020
 +
|
 +
* Spectator game mode
 +
* Fill command can fill a maximum of 10000 blocks instead of 9999
 +
|-
 +
! [[Version History#1.30.3b|1.30.3b]]
 +
| Nov 21, 2021
 +
|
 +
* Command history now goes back 100 commands instead of only 10
 +
* Home and tp commands now reset player velocity
 +
|-
 +
! [[Version History#1.30.3b_1|1.30.3b_1]]
 +
| Dec 5, 2021
 +
|
 +
* Give command quantity is now limited to 10000
 +
* Maximum horizontal tp coordinate is now 10000 instead of 1100
 +
* (Desktop) Gamerule command now accepts the value "true"
 
|}
 
|}
  
==History==
+
== See Also ==
*1.25: Default keybinding to open commands changed from "/" to "T".
+
* [[Identifiers]]
 
+
* [[Data tags]]
==See Also==
+
* [[Enchantment_table#Commands|Enchantment IDs]]
*[[Command book]]
+
* [[Command book]]
  
 
[[Category:Gameplay]]
 
[[Category:Gameplay]]

Latest revision as of 05:19, 2 December 2023


Commands (also known as Cheats) are scripted codes that the player can write in the game console that change the game directly.

Using Commands

To use commands, the world must have cheats enabled. Cheats can only be enabled on the world creation screen, and cannot be enabled after a world has already been created.

The default key binding for opening the command console is "T". This can be changed in the game settings. When the console is open, the player can write a command, and execute it by pressing Enter.

When commands are entered, the capitalization of letters does not matter.

Reading Command Definitions

Below is a list of command definitions (instructions on how each command works). The definitions include two different types of brackets:

  1. Parameters between < and > angle brackets is a list of potential options. Each option is separated by a | "pipe" character. If an option contains multiple parameters, as seen in the fill command, it will be surrounded by parentheses. As an example, in /gamemode <survival|creative|adventure|spectator>, you can write /gamemode survival, /gamemode creative, /gamemode adventure, or /gamemode spectator.
  2. Parameters between the [ and ] square brackets are optional parameters. When writing a command, you can skip optional parameters. For example, in /lightning [[~]x [~]y], you can omit both the [~]x and [~]y parameters, like so: /lightning. Also, the [~] means you can use relative coordinates.

The ~ character can be added before certain coordinate numbers to make the coordinate relative to your position in the world, instead of relative to block (0, 0). For example, running /explode 5 ~3 ~0 will perform a size 5 explosion, 3 blocks to the left of the player.

List of Commands

Command Description Definition Examples

help

This command is always available, even if cheats are disabled.

Lists all of the possible commands.

/help /help

seed

This command is always available, even if cheats are disabled.

Shows the seed number of the current world.

/seed /seed

cheats

This command will only exist if the world was created prior to 1.26.5 (when cheats were added to the game).

It allows players to permanently enable or disable cheats in their world.

/cheats <enable|disable>

/cheats enable

/cheats disable

clear

Removes items from the inventory, but also returns a message if the specified item is present.

/clear itemname [<quantity|-1>] [damage] [data_tags]

  • itemname: The identifier for the item to remove.
  • itemname: The quantity of items to be removed. -1 means all present in the inventory
  • damage: The amount of damage the item to be removed has undergone.
  • data_tags: The tags the item to be removed has.
  • /clear
    • Removes all items from the inventory.
  • /clear wool 0
    • Does not remove any items, but returns a message saying "Found a match" if the player has wool in their inventory.
  • /clear wool -1 0 {type:"rainbow"}
    • Removes all rainbow wool from the inventory
  • /clear wool 1 0 {type:"red"}
    • Removes 1 red wool from the inventory

clone

Clones part of the world and pastes it somewhere else, with data tags for blocks.

/clone [~]x1 [~]y1 width height [~]xDest [~]yDest [<filtered|masked|replace>] [<force|move|normal>] block_mask

  • [~]x1 [~]y1: The x and y coordinate to start cloning from.
  • width height: How many blocks rightward (width) and upward (height) to clone.
  • [~]xDest [~]yDest: The x and y coordinate to clone to.
  • [filtered|masked|replace]: The filtering setting.
  • [force|move|normal]: Whether the original blocks are kept.
  • block_mask: The blocks to clone.

cls

"cls" stands for "clear screen". This command clears console messages from the screen. /cls /cls

difficulty

Sets the difficulty mode of the world.

/difficulty <peaceful|easy|normal|hard>

  • /difficulty normal
    Sets the game to normal difficulty

enchant

Applies an enchantment to the player's held item. A message will appear saying that the enchantment has been "added to selected item". If the player is holding nothing, the message that the held item has been enchanted will still appear.

/enchant enchantment_id

  • enchantment_id: See list of enchantment ID's here: Enchantments
  • /enchant Unbreaking4
    Enchants the held item with the Unbreaking 4 enchantment.
  • /enchant LuckOfTheSeaII
    Enchants the held item with the Luck of the Sea 2 enchantment.

explode

Creates an explosion.

/explode size [[~]x [~]y]

  • /explode 10
    Performs a size 10 explosion at the player's location.
  • /explode 5 ~ ~-3
    Performs a size 5 explosion, 3 blocks below the player.

fill

Fills a region of blocks with the specified block type.

/fill block_type [~]x [~]y width height [<(replace [replace_block_type])|keep|outline|hollow|destroy>] [data_tags]

  • block_type: The identifier for the block to fill.
  • [~]x [~]y: The x and y coordinate to start filling from.
  • width height: How many blocks rightward (width) and upward (height) to fill.
  • oldBlockHandling: Different replacement algorithms:
    • replace replace_block_type will only fill blocks that match the replace_block_type.
    • keep will only replace air blocks.
    • outline will fill blocks on only the inner edge of the rectangle.
    • hollow will fill the inner edge and clear all blocks inside.
    • destroy replaces all blocks by mining them first.
  • data_tags: Specifies additional data to apply to the block. See data tags for more information.
  • /fill diamond_block ~-5 ~ 11 1 replace
    Replaces the area under the player with diamond blocks.
  • /fill air ~-10 ~-10 21 21 replace stone
    Replaces stone around the player with air.

gamemode

Switches between the game modes.

/gamemode <survival|creative|adventure|spectator>

  • /gamemode creative
    Switches to creative mode
    /gamemode 1 and /gamemode c will also work.
  • /gamemode survival
    Switches to survival mode.
    /gamemode 0 and /gamemode s will also work.
  • /gamemode adventure
    Switches to adventure mode.
    /gamemode 2 and /gamemode a will also work.
  • /gamemode spectator
    Switches to spectator mode.
    /gamemode 3 and /gamemode p will also work.

gamerule

Sets global variables in the game world, such as the ability for players to keep their inventory when they die.

/gamerule rule <value>

  • /gamerule keepinventory true
    Allows the player to keep their inventory upon death.
  • /gamerule dodaylightcycle false
    Stops the day/night cycle from continuing.
  • /gamerule dofiretick false
    Stops fire from spreading between blocks.
  • /gamerule mobgriefing false
    Disallows mobs from changing blocks in the world.
  • /gamerule domobloot false
    Stops mobs from dropping items upon death.
  • /gamerule sendcommandfeedback false
    Stops commands from returning feedback into chat if they are run successfully.

give

Gives the player any block or item.

/give item [amount] [damage] [data_tags]

  • item: The identifier for the item to give.
  • amount: Specifies how many of the item to give.
  • damage: How much damage the tool will have (default is 0). Positive numbers are damage, and negative numbers are durability.
  • data_tags: Specifies additional data to apply to the item. See data tags for more information.
  • /give diamond 12
    Gives the player twelve diamonds.
  • /give diamond_sword 1 50 {name:"Jimbo"}
    Gives a diamond sword named "Jimbo" that has been damaged 50 times.
  • /give command_book 1 0 {command:"give carrot 1 0 {name:'Perry'}"}
    Gives a command book that gives the player a carrot named "Perry".
  • /give wooden_shovel 1 0 {enchantments:["unbreaking3"]}
    Gives a wooden shovel with an unbreaking enchantment.

heal

Instantly heals the player. /heal /heal

home

Teleports to the player's spawn point.

/home [set [~]x [~]y]

  • /home
    Goes to the player's home location.
  • /home set ~5 ~3
    Sets the player's spawn point 5 blocks to the right, and 3 blocks up.
  • /home set 5 3
    Sets the player's spawn point to the block at x=5 and y=3.

kill

Instantly kills the player. /kill /kill

lightning

Generates lightning.

/lightning [[~]x [~]y]

  • /lightning
    Generates lightning at the player's location.
  • /lightning ~-5 ~
    Generates lightning 5 blocks to the left of the player.

say

Returns the specified message in chat. /say message
  • /say hello world
    • Returns the message "hello world" in chat.
  • /say hello \n world
    Returns the message with a line break after \n.

setblock

Replaces the existing block with the specified block.

/setblock block_type [~]x [~]y [<replace|keep|destroy>] [data_tags]

  • block_type: The identifier for the block.
  • [~]x [~]y: The x and y coordinate where the block is put.
  • oldBlockHandling: Different replacement algorithms:
    • replace replaces any existing block.
    • keep only replaces an air block.
    • destroy replaces block by mining it first.
  • data_tags: Specifies additional data to apply to the block. See data tags for more information.
  • /setblock diamond_block ~ ~
    • Replaces the block under the player with a diamond block.
  • /setblock dirt ~2 ~2 keep
    • Replaces the block two blocks to the right and two blocks above the player to dirt, so long as it is an air block.
  • /setblock anvil 10 10 destroy {damage:2}
    • Creates an anvil that has been damaged at position x=10 and y=10 in the world, first destroying any block that might have been there.

spawnskin

Spawns in an NPC (non-player character) into the game. You need to have a skin ID for the NPC, which can be found on skin information in the skin database.

/spawnskin skin_id_number [amount] [[~]x [~]y]

  • /spawnskin 58300
    Spawns 1 of Zanzlanz's Squid skin.
  • /spawnskin 58300 5
    Spawns 5 of them.
  • /spawnskin 58300 1 ~-5 ~3
    Spawns 1 of them, 5 blocks to the left, and three blocks above the player.

summon

Spawns in a mob.

/summon mob_type [quantity] [[~]x [~]y] [data_tags]

  • summon pig
    • Summons 1 pig, at the players position
  • summon cow 5 ~1 ~-2
    • Summons 5 cows one block to the right, and two blocks below the player
  • summon spawnskin 1 ~ ~ {skin:1327,name:"Notch",health:1,drops:[{item:{id:"mob_head",type:1327}}]}
    • Summons one notch spawnskin at the players position with the name "Notch", which has half a heart of health and drops its head upon death.
  • summon spawnskin 1 ~ ~ {skin:6273, aggro:"hostile"}
    • Summons a spawnskin that will instantly start attacking the player; other possible data tags are neutral and passive.

time

Sets/shows the current time of the day, which is a value between 1 and 100.

/time <get|set <t|day|night>>

  • /time get
    Displays the time of the day in the console.
  • /time set 10
    Sets time to 10, which is morning time.
  • /time set day
    Sets time to 0.

tp

Teleports (TPs) the player to a specific location.

/tp [~]x [~]y

  • /tp ~5 ~3
    Teleports the player 5 blocks to the right, and 3 blocks up.
  • /tp 5 3
    Teleports the player to the block at x=5 and y=3.

weather

Sets/shows whether it is raining in the world, or not.

/weather <get|set <clear|rain|thunder>>

  • /weather get
    Displays the current weather in the console.
  • /weather set rain
    Makes it start raining.

xp

Sets the experience points of the player.

/xp [add] value[L]

  • /xp 100
    Sets the player's experience to 100 points (1 level).
  • /xp 1L
    Sets the player's experience to 1 level (100 points).
  • /xp add 10L
    Adds 10 levels to the player's experience.

History

Version Date Changes
1.26.5 Jul 03, 2014
  • Commands were first introduced
    • Added commands: cheats, explode, fill, gamemode, gamerule, give, help, home, kill, seed, time, weather, xp
1.27 Nov 13, 2015
  • Default keybinding to open commands changed from "/" to "T"
  • Added commands: heal, spawnskin, tp
  • Added a doFireTick game rule
  • Added "L" modifier to xp
  • Added oldBlockHandling to fill
1.28 Oct 08, 2016
  • Added commands: difficulty, enchant, lightning
  • Added a passiveMobs game rule
  • Added durability and data_tags to give
1.29 Sep 27, 2019
  • Removed quick command buttons from creative inventory
  • Added commands: clone, summon, setBlock, say, cls, clear
  • Command history is retained when switching worlds
  • "Hallow" and "replace" methods of the fill command behave properly
  • The area where the command console could not be clicked on decided to vanish
  • Giving a potion with commands with a space in the name works properly
  • Fixed various small command parsing issues
  • Converted fill command to use width and height instead of X2 and Y2 coordinates
  • Wool, wool backdrops, dye, carpet and potions now have default types when given with commands
  • Moved command output higher to no longer overlap command window and item text
  • mobGriefing for creepers properly matches gamerule by default
  • New game rules doMobLoot and sendCommandFeedback
  • Adventure game mode
  • Fill command now takes data tags
1.29.1 Oct 5, 2019
  • Fill command fill info displays width and height instead of secondary coordinates
  • Replaced "spawn" with "summon" in the help command list
  • Added "say" to the help command list
  • Increased maximum command length from 256 to 1024 characters
  • Summon command quantity is now limited to 20 mobs
1.29.2 Oct 20, 2019
  • Entering a lightning command without parameters no longer randomizes the position
1.30 Nov 13, 2020
  • Spectator game mode
  • Fill command can fill a maximum of 10000 blocks instead of 9999
1.30.3b Nov 21, 2021
  • Command history now goes back 100 commands instead of only 10
  • Home and tp commands now reset player velocity
1.30.3b_1 Dec 5, 2021
  • Give command quantity is now limited to 10000
  • Maximum horizontal tp coordinate is now 10000 instead of 1100
  • (Desktop) Gamerule command now accepts the value "true"

See Also