Player commands
These commands can be used in the chat window by any player who is allowed to connect to a server, and can also be used in single player whether or not cheats are enabled. Please note that all Commands are case sensitive, and will not succeed if case does not match. The format of this list will be the command, then followed by a description of the command. Note: Commands entered via the Multicraft console do not need the / in front of the command.
Bukkit Commands and Permissions
1. /help [page | commandname]
/? [page | commandname]
Shows a list of available commands or further information to the commandname. Note: the multiplayer-only commands are not listed in single-player games, even when open to LAN players.
2. /me <actiontext>
Similar to the /emote or /action, and the same as the /me commands in IRC clients, the /me command sends a narrative message to the other players in the form of "* Yournameactiontext" (e.g., "* Notch sneezes." or "* Notch exploded." ). If a multi-person target selector (e.g. @a) is used in actiontext, the list of names is formatted as "name1, name2, and name3", or "name1 and name2" for two names. Therefore, regardless of any target selectors which are used in actiontext, this command will only output once.
3. /tell <playername> <message>
/msg <playername> <message>
/w <playername> <message>
Used to send a private message to a player on the server. Very useful on servers if you need to ask/tell something from/to another player without other players seeing. If a multi-person target selector (e.g. @a) is used in message, the list of names is formatted as "name1, name2, and name3", or "name1 and name2" for two names. Therefore, regardless of any target selectors which are used in message, this command will only output once - however, a selector for playername can send a message to multiple people.
4. /plugins
Lists all installed plugins on the server.
5. /version
Gives the version number of CraftBukkit which is installed on the server
Operator-only commands
These commands are usable by ops (operators) from the server console as well as through the chat window when prefixed by the command character (a forward slash). These commands are also available in SSP with enabled cheats or for players hosting a world.
Note: Op commands are broadcast to the other ops online.
1. /achievement give <achievementname> [playername]
Gives a player an achievement, and all prerequisite achievements. achievementname must use "achievement." followed by the achievement name (see Scoreboard or Achievements for valid names). If playername is not specified, the achievement will be given to the command's executor.
2. /clear <playername> [item] [metadata]
Clears the inventory of playername or the specified item:data.
3. /debug start | stop
Starts a new debug profiling session or stops the session currently running. It notifies about potential performance bottlenecks in the console when active and creates a profiler results file in the folder debug when stopped.
4. /defaultgamemode survival | creative | adventure
Sets the default game mode that is shown on the world selection menu. New players that join the world will be put into the default game mode; i.e., if the default game mode is creative, new players will start in creative. The game modes can be abbreviated to "s/c/a" or "0/1/2" respectively. This command cannot enable or disable Hardcore mode.
5. /difficulty peaceful | easy | normal | hard
Changes the difficulty. The difficulties can be abbreviated to "p/e/n/h" or "0/1/2/3" respectively.
6. /effect <playername> <effect> [seconds] [amplifier]
Gives the targeted player the specified effect for the specified time (default is 30 seconds). Effects have a limit of 1,000,000 seconds, and the amplifier field has a limit of 255. Effect id's can be found on the potion effects page. Setting seconds to 0 clears this effect. If you put the amplifier to a number of a variably high value, it will not give the desired amplifier.
7. /effect <playername> clear
Clears all effects on playername.
8. /enchant <playername> <enchantment ID> [enchantment level]
Enchants the item that the player is currently holding, according to enchantment ID. Note that this works within the normal limitations of enchanting items. Enchantments can only be applied to items which can normally receive that specific enchantment. Enchantment levels can not be above the normal highest
9. /gamemode [playername]
Changes the game mode for playername. The game modes can be abbreviated to "s/c/a" or "0/1/2" respectively. If no playername is given, it will set your own gamemode. Remember, this will only affect playername and no one else.
10. /gamerule <rulename> [true | false]
Activates or deactivates the rulename. If true/false is not given, displays the current status of rulename. Available rules are:
- commandBlockOutput - Whether command blocks should notify admins when they perform commands.
- doFireTick - Whether fire should spread.
- doMobLoot - Whether mobs should drop items.
- doMobSpawning - Whether mobs should naturally spawn.
- doTileDrops - Whether blocks should have drops.
- keepInventory - Whether the player should keep items in their inventory if they die.
- mobGriefing - Whether creepers, endermen, ghasts, and withers should be able to change blocks, or zombies, skeletons, and zombie pigmen can pick up items.
- naturalRegeneration - Whether the player can regenerate health naturally if their hunger is at a regenerable state.
- doDaylightCycle - Whether the day/night cycle is in effect or not.
11. /give <playername> <item> [amount] [metadata] [dataTag]
Spawns amount (defaults to 1) of the item defined by item with the specified metadata (defaults to 0) at playername 's location, using dataTag for the "tag" NBT tag. For example typing /give John 5 30 1 {display:{Lore:["Wooden planks"]}} will give a player called John 30 blocks of Spruce Wood Planks with Lore that says "Wooden planks".
12. /kill <playername>
Inflicts 1000 ( × 500) void damage to the user, killing the user instantly even if in creative (a high-level Resistance effect cannot protect the player either). The text "Ouch! That looks like it hurt." will be displayed after executing. Useful when lost, stuck, or to restore health and hunger (assuming you can get your items back easily or the keepInventory gamerule is set to "true"). Death message displays as "playername fell out of the world"
13. /publish
Opens your single-player game for LAN friends to join. This command appears in the singleplayer cheats.
14. /playsound <sound> <playername> [x] [y] [z] [volume] [pitch] [minimumVolume]
Plays the selected sound to the selected player. The format for sound is as follows:
Example: Sound located at .minecraft\assets\sound\mob\pig\death.ogg
The value for sound would be written as mob.pig.death, as the command originates from the sound folder. For sequentially numbered files pertaining to the same event (Example: various walking sounds), the player must exclude the number of the sound.
Example: Sound located at .minecraft\assets\sound\mob\pig\say[1-3].ogg
The value for sound would be written as mob.pig.say in this case. Since there are multiple mob.pig.say files (say1, say2, and say3), the command will play a randomly selected sound out of the three available.
The coordinates x, y, and z are the coordinates to play the sound from. If prefixed with "~", they will be relative to the player's current location. Note that "~" is shorthand for "~0", and thus "~ ~ ~" can be used as a substitute for the player's current location.
The volume argument controls the distance from which a sound may be heard. At values less than 1.0, the sound will be quieter and have a smaller sphere within which it may be heard. At values greater than 1.0, the sound will not actually grow louder, but its audible range (a 16-block radius at 1.0) will be multiplied by volume.
The minimumVolume argument controls the volume of the sound outside its normal audible sphere. Note that the sound inside this sphere may actually be less than the volume of the sound outside this sphere, if volume is less than minimumVolume.
The pitch argument alters both the pitch and the duration of the sound (which means that it's actually changing its speed).
15. /op<playername>
Turns a player into a server operator.
16. /reload
Stops and restarts all plugins on the server
17. /say <message>
Broadcasts message to all players on the server. If a multi-person target selector (e.g. @a) is used, the list of names is formatted as "name1, name2, and name3", or "name1 and name2" for two names. Therefore, regardless of any target selectors which are used, this command will only output once.
18. /scoreboardobjectives|players|teams
Changes scoreboard settings/options with the used parameters.
19. /seed
Displays the seed. This command can always be used in single-player mode, regardless of whether cheats are enabled or not.
20. /setblock <x> <y> <z> <tilename> [datavalue] [oldblockHandling] [dataTag]
Places the block in the x, y and z coordinates specified.
21. /setworldspawn [x] [y] [z]
Sets the world's spawn to the specified coordinates. If no coordinates are specified, the world spawn will be set to the executor's current location.
22. /spawnpoint <playername> [x] [y] [z]
Sets the spawn point of that player to that position, or to the current position if x y and z are not specified.Player is optional if x y z are not specified; will set the spawnpoint of the user to their current location. NOTE: Spawnpoint coordinates must be specified in integers. No decimals.
23. /spreadplayers <x> <z> [spreadDistance] [maxRange] [respectTeams] <playernames>
This command allows players to spread out over a long or short distance.
x and z mark the center of the area across which players are to be spread. spreadDistance is the rough minimum distance players will be spread apart.
maxRange is the maximum distance from x, z where players will be put. Note that this distance is not a circular radius; it represents the maximum distance on either coordinate (thus forming a box ranging from x-maxRange to x+maxRange and z-maxRange to z+maxRange).
respectTeams may be true or false, and represents whether players should be moved individually or teams should be kept together.
playernames is the list of players to spread. Names are separated by spaces.
24. /summon <EntityName> [x] [y] [z] [dataTag]
Spawns desired entity. For example, /summon Pig ~ ~ ~ {Saddle:1,CustomName:"Mr. Pig",CustomNameVisible:1} would create a saddled pig named Mr. Pig at the player's current location.
25. /tellraw <playername> <raw message>
Sends a message to a specified player, or to every player online on a server. Links can also be sent, with customizable actions when they are clicked, for example giving an apple to a player or teleporting the player to another location. This command can also be used to fake player messages.
raw message uses JSON. Note that in the game, color will default to white if not given and all formatting (bold, italic, etc.) will default to false if not given, so you don't have to use the exact command the tool gives you.
26. /testforblock <x> <y> <z> <tilename> [datavalue] [dataTag]
Used to test whether a particular block is in the x, y and z coordinates specified.
27. /testfor <player or entity> [datavalue] [dataTag]
Tests for a player or entity, and specified data if needed.
28. /time set <number | day | night>
Sets the world time. number is an integer between 0 and 24000, inclusive, where 0 is dawn, 6000 midday, 12000 dusk and 18000 midnight. Number can be greater than 24000; in this case, the the time of day wraps around, but the moon's phase is advanced. However, Setting the time "backward" (earlier than the current time) does not change the moon. "time set day" sets the time to 1000, and "time set night" sets the time to 13000.
29. /time add <number>
Increments the world time, as above.
30. /toggledownfall
Toggles rain and snow.
31. /tp [playername] <targetplayer>
Teleports player playername to targetplayer 's location. If no player is specified, it will teleport yourself.
32. /tp [playername] <x> <y> <z>
Teleports player playername (or yourself if no player is specified) to coordinates x,y,z. (the y value cannot be smaller than 0). Can also relatively move the player by adding the ~ character before the coordinate value. For example typing /tp John -3 64 -3 will teleport a player called John 3 blocks away from his current x and z, and to y 64.
33. /weather (clear | rain | thunder) [seconds]
Changes the weather for the specified duration.
34. /xp <amount> [playername]
Gives the specified user the given number of orbs. Maximum is 2,147,483,647 per command. Negative amounts may not be used to remove experience points.
35. /xp <amount>L [playername]
Gives playername the amount number of experience levels. Maximum is 2,147,483,647 — if a player is given levels pushing them past this limit, they get reset to 0. Negative amounts may be used to remove experience levels.
Multiplayer-only Commands
These commands are usable by ops (operators) from the server console as well as through the chat window when prefixed by the command character (a forward slash). These commands are only available in SMP. With the exception of the list command, none of these commands can be executed by a command block, and none make use of target selectors. Many of these commands can be used on players who have never been to the server, or even on names which are not (or cannot be) registered as Minecraft accounts.
1. /ban <playername> [reason]
Blacklists the name playername from the server so that they can no longer connect. Note: Bans supersede any whitelisting in place.
2. /ban-ip <ip-address | playername>
Blacklists an IP address so that all subsequent connections from it are rejected.
3. /banlist [ips]
Displays banned players. To display banned IP addresses, use the command "banlist ips"
4. /deop <playername>
Revokes a player's operator status.
5. /kick <playername> [reason]
Forcibly disconnects playername from the server, displaying an optional reason to them.
6. /list
Shows the names of all currently-connected players (the same can be achieved when pressing tab)
7. /op <playername>
Grants playername operator status on the server.
8. /pardon <playername>
Removes playername from the blacklist, allowing them to connect again.
9. /pardon-ip <ip-address>
Removes ip-address from the IP blacklist, allowing players from that IP address to connect to the server.
10. /save-all
Forces the server to write all pending changes to the world to disk.
11. /save-off
Disables the server writing to the world files. All changes will temporarily be queued.
12. /save-on
Enables the server writing to the world files. This is the default behavior.
13. /setidletimeout <Minutes until kick>
Set the idle kick timer. Any players idle for Minutes until kick will be kicked.
14. /stop
Saves all changes to disk, then shuts down the server.
15. /whitelist <add - remove> <playername>
Adds or removes playername from the whitelist.
16. /whitelist list
Displays all players in the whitelist.
17. /whitelist<on - off>
Enables/disables the server's use of a whitelist. Note: Server ops will always be able to connect when the whitelist is active, even if their names do not appear in the whitelist.
18. /whitelist reload
Reloads the list of playernames in white-list.txt from disk (used when white-list.txt has been modified outside of Minecraft).
Command-Block-only commands
These commands can be used only in a Command Block and cannot be used in other ways. Command blocks are only obtainable via the /give 137 command.
1. /testfor <playername | selector>
Used to test whether playername is online, or if selector has matches. A Redstone Comparator as output from a command block with this command will indicate the number of players matched by selector. For example, "testfor @a[r=3]" will output the number of players within 3 meters of the command block. More information about selectors may be found here.
