Difference between revisions of "Commands"
(The page's code is way cleaner this way, and will support dark theme properly when it's added to the wiki.) |
|||
(15 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
− | + | __NOTOC__ | |
+ | |||
Commands (also known as Cheats) are scripted codes that the player can write in the game console that change the game directly. | Commands (also known as Cheats) are scripted codes that the player can write in the game console that change the game directly. | ||
== Using Commands == | == 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 | + | 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: | ||
+ | # Parameters between <code><</code> and <code>></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. | ||
− | + | 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. | |
== List of Commands == | == List of Commands == | ||
Line 21: | Line 25: | ||
!Examples | !Examples | ||
|- | |- | ||
− | ! help | + | ! |
+ | === help === | ||
| This command is always available, even if cheats are disabled. | | This command is always available, even if cheats are disabled. | ||
Line 28: | Line 33: | ||
| <code>/help</code> | | <code>/help</code> | ||
|- | |- | ||
− | ! seed | + | ! |
+ | === seed === | ||
| This command is always available, even if cheats are disabled. | | This command is always available, even if cheats are disabled. | ||
Line 35: | Line 41: | ||
| <code>/seed</code> | | <code>/seed</code> | ||
|- | |- | ||
− | ! cheats | + | ! |
+ | === cheats === | ||
| This command will only exist if the world was created prior to 1.26.5 (when cheats were added to the game). | | This command will only exist if the world was created prior to 1.26.5 (when cheats were added to the game). | ||
Line 44: | Line 51: | ||
<code>/cheats disable</code> | <code>/cheats disable</code> | ||
|- | |- | ||
− | ! clear | + | ! |
+ | === clear === | ||
| Removes items from the inventory, but also returns a message if the specified item is present. | | 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>/clear itemname [<quantity|-1>] [damage] [data_tags]</code> |
* <code>itemname</code>: The [[identifiers|identifier]] for the item to remove. | * <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>itemname</code>: The quantity of items to be removed. -1 means all present in the inventory | ||
Line 62: | Line 70: | ||
** Removes 1 red wool from the inventory | ** Removes 1 red wool from the inventory | ||
|- | |- | ||
− | ! clone | + | ! |
+ | === clone === | ||
| Clones part of the world and pastes it somewhere else, with data tags for blocks. | | 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>/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>[~]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>width height</code>: How many blocks rightward (width) and upward (height) to clone. | ||
Line 74: | Line 83: | ||
| | | | ||
|- | |- | ||
− | ! cls | + | ! |
+ | === cls === | ||
| "cls" stands for "clear screen". This command clears console messages from the screen. | | "cls" stands for "clear screen". This command clears console messages from the screen. | ||
| <code>/cls</code> | | <code>/cls</code> | ||
| <code>/cls</code> | | <code>/cls</code> | ||
|- | |- | ||
− | ! difficulty | + | ! |
+ | === difficulty === | ||
| Sets the difficulty mode of the world. | | Sets the difficulty mode of the world. | ||
| | | | ||
Line 87: | Line 98: | ||
*: Sets the game to normal difficulty | *: Sets the game to normal difficulty | ||
|- | |- | ||
− | ! enchant | + | ! |
− | | Applies an enchantment to the player's | + | === 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. | ||
| | | | ||
− | <code>enchant enchantment_id</code> | + | <code>/enchant enchantment_id</code> |
− | * <code>enchantment_id</code>: See list of enchantment ID's here: [[ | + | * <code>enchantment_id</code>: See list of enchantment ID's here: [[Enchanting#Commands|Enchantments]] |
| | | | ||
* <code>/enchant Unbreaking4</code> | * <code>/enchant Unbreaking4</code> | ||
Line 98: | Line 110: | ||
*: 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 108: | Line 121: | ||
*: Performs a size 5 explosion, 3 blocks below the player. | *: Performs a size 5 explosion, 3 blocks below the player. | ||
|- | |- | ||
− | ! fill | + | ! |
− | | Fills a region of blocks with the specified block type | + | === fill === |
+ | | 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] [data_tags]</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 128: | Line 142: | ||
*: 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. | ||
| | | | ||
Line 146: | Line 161: | ||
*: <code>/gamemode 3</code> and <code>/gamemode p</code> will also work. | *: <code>/gamemode 3</code> and <code>/gamemode p</code> will also work. | ||
|- | |- | ||
− | ! gamerule | + | ! |
+ | === 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 < | + | <code>/gamerule rule <value></code> |
| | | | ||
* <code>/gamerule keepinventory true</code> | * <code>/gamerule keepinventory true</code> | ||
Line 164: | Line 180: | ||
*: Stops commands from returning feedback into chat if they are run successfully. | *: Stops commands from returning feedback into chat if they are run successfully. | ||
|- | |- | ||
− | ! give | + | ! |
+ | === 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 182: | Line 199: | ||
*: 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> | | <code>/heal</code> | ||
|- | |- | ||
− | ! home | + | ! |
+ | === home === | ||
| Teleports to the player's spawn point. | | Teleports to the player's spawn point. | ||
| | | | ||
Line 199: | Line 218: | ||
*: 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> | | <code>/kill</code> | ||
|- | |- | ||
− | ! lightning | + | ! |
− | | Generates lightning | + | === lightning === |
+ | | Generates lightning. | ||
| | | | ||
<code>/lightning [[~]x [~]y]</code> | <code>/lightning [[~]x [~]y]</code> | ||
Line 214: | Line 235: | ||
*: 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 | + | === say === |
+ | | Returns the specified message in chat. | ||
| <code>/say message</code> | | <code>/say message</code> | ||
| | | | ||
*<code>/say hello world</code> | *<code>/say hello world</code> | ||
**Returns the message "hello world" in chat. | **Returns the message "hello world" in chat. | ||
+ | * <code>/say hello \n world</code> | ||
+ | *: Returns the message with a line break after \n. | ||
|- | |- | ||
− | ! setblock | + | ! |
+ | === setblock === | ||
| Replaces the existing block with the specified block. | | Replaces the existing block with the specified block. | ||
| | | | ||
− | <code>/setblock block_type [~]x [~]y [replace|keep|destroy] [data_tags]</code> | + | <code>/setblock block_type [~]x [~]y [<replace|keep|destroy>] [data_tags]</code> |
* <code>block_type</code>: The [[identifiers|identifier]] for the block. | * <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>[~]x [~]y</code>: The x and y coordinate where the block is put. | ||
Line 240: | Line 265: | ||
** 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. | ** 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 | + | ! |
+ | === 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. | | 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. | ||
| | | | ||
Line 252: | Line 278: | ||
*: 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 | + | ! |
+ | === summon === | ||
| Spawns in a mob. | | Spawns in a mob. | ||
| | | | ||
Line 267: | Line 294: | ||
** Summons a spawnskin that will instantly start attacking the player; other possible data tags are neutral and passive. | ** Summons a spawnskin that will instantly start attacking the player; other possible data tags are neutral and passive. | ||
|- | |- | ||
− | ! time | + | ! |
+ | === 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 | + | <code>/time <get|set <t|day|night>></code> |
| | | | ||
* <code>/time get</code> | * <code>/time get</code> | ||
Line 279: | Line 307: | ||
*: 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. | ||
| | | | ||
Line 289: | Line 318: | ||
*: 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 299: | Line 329: | ||
*: 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 313: | Line 344: | ||
== History == | == History == | ||
− | {| class="wikitable | + | {| class="wikitable" |
− | ! width= | + | ! width=60px | Version |
− | ! width= | + | ! width=100px | Date |
! Changes | ! Changes | ||
|- | |- | ||
Line 322: | Line 353: | ||
| | | | ||
* Commands were first introduced | * Commands were first introduced | ||
− | ** Added commands: cheats, explode, fill, gamemode, gamerule, give, help, home, kill, seed, time, weather, xp | + | ** Added commands: '''cheats, explode, fill, gamemode, gamerule, give, help, home, kill, seed, time, weather, xp''' |
|- | |- | ||
! [[Version History#1.27|1.27]] | ! [[Version History#1.27|1.27]] | ||
Line 328: | Line 359: | ||
| | | | ||
* Default keybinding to open commands changed from "/" to "T" | * Default keybinding to open commands changed from "/" to "T" | ||
− | * Added commands: heal, spawnskin, tp | + | * Added commands: '''heal, spawnskin, tp''' |
* Added a doFireTick game rule | * Added a doFireTick game rule | ||
* Added "L" modifier to xp | * Added "L" modifier to xp | ||
Line 336: | Line 367: | ||
| Oct 08, 2016 | | Oct 08, 2016 | ||
| | | | ||
− | * Added commands: difficulty, enchant, lightning | + | * Added commands: '''difficulty, enchant, lightning''' |
* Added a passiveMobs game rule | * Added a passiveMobs game rule | ||
* Added durability and data_tags to give | * Added durability and data_tags to give | ||
Line 344: | Line 375: | ||
| | | | ||
* Removed quick command buttons from creative inventory | * Removed quick command buttons from creative inventory | ||
− | * Added commands: clone, summon, setBlock, say, cls, clear | + | * Added commands: '''clone, summon, setBlock, say, cls, clear''' |
* Command history is retained when switching worlds | * Command history is retained when switching worlds | ||
* "Hallow" and "replace" methods of the fill command behave properly | * "Hallow" and "replace" methods of the fill command behave properly | ||
Line 350: | Line 381: | ||
* Giving a potion with commands with a space in the name works properly | * Giving a potion with commands with a space in the name works properly | ||
* Fixed various small command parsing issues | * Fixed various small command parsing issues | ||
− | |||
* Converted fill command to use width and height instead of X2 and Y2 coordinates | * 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 | * Wool, wool backdrops, dye, carpet and potions now have default types when given with commands | ||
Line 358: | Line 388: | ||
* Adventure game mode | * Adventure game mode | ||
* Fill command now takes data tags | * 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" | ||
+ | |- | ||
+ | ! [[Version History#1.31.2|1.31.2]] | ||
+ | | Nov 9, 2024 | ||
+ | | | ||
+ | * Added the whisper command to the Scavenger Hunt Minigame | ||
|} | |} | ||
Latest revision as of 17:09, 16 November 2024
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:
- 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 thefill
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
. - 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
|
clear |
Removes items from the inventory, but also returns a message if the specified item is present. |
|
|
clone |
Clones part of the world and pastes it somewhere else, with data tags for blocks. |
|
|
cls |
"cls" stands for "clear screen". This command clears console messages from the screen. | /cls
|
/cls
|
difficulty |
Sets the difficulty mode of the world. |
|
|
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. |
|
|
explode |
Creates an explosion. |
|
|
fill |
Fills a region of blocks with the specified block type. |
|
|
gamemode |
Switches between the game modes. |
|
|
gamerule |
Sets global variables in the game world, such as the ability for players to keep their inventory when they die. |
|
|
give |
Gives the player any block or item. |
|
|
heal |
Instantly heals the player. | /heal
|
/heal
|
home |
Teleports to the player's spawn point. |
|
|
kill |
Instantly kills the player. | /kill
|
/kill
|
lightning |
Generates lightning. |
|
|
say |
Returns the specified message in chat. | /say message
|
|
setblock |
Replaces the existing block with the specified block. |
|
|
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. |
|
|
summon |
Spawns in a mob. |
|
|
time |
Sets/shows the current time of the day, which is a value between 1 and 100. |
|
|
tp |
Teleports (TPs) the player to a specific location. |
|
|
weather |
Sets/shows whether it is raining in the world, or not. |
|
|
xp |
Sets the experience points of the player. |
|
|
History
Version | Date | Changes |
---|---|---|
1.26.5 | Jul 03, 2014 |
|
1.27 | Nov 13, 2015 |
|
1.28 | Oct 08, 2016 |
|
1.29 | Sep 27, 2019 |
|
1.29.1 | Oct 5, 2019 |
|
1.29.2 | Oct 20, 2019 |
|
1.30 | Nov 13, 2020 |
|
1.30.3b | Nov 21, 2021 |
|
1.30.3b_1 | Dec 5, 2021 |
|
1.31.2 | Nov 9, 2024 |
|