Welcome to the BukkitWiki!

This Wiki is home to Bukkit's documentation and regulations surrounding the Bukkit Project and it's services. Want to help out? We would love to have you! Signup to get started!

CraftBukkit Commands

From BukkitWiki
(Redirected from CraftBukkit commands)
Jump to: navigation, search
This page has been suggested for inclusion in the Official Documentation

This page has been marked for inclusion in the Bukkit Offical Documentation section, Docs. You can deliberate about its inclusion on its Talk page.

The following are all the server commands either a server administrator or admin in-game can enter with CraftBukkit out-of-the-box. In addition to the original vanilla SMP commands there are 4 additional commands which are specific to CraftBukkit. CraftBukkit provides built-in permissions which can be used in a permissions manager. Defaults are also observed for the permissions. There are also additional permissions which group together several of the single permissions.

Bukkit Commands and Permissions

Command Description Usage Permission Permission Default
version Gives the version number of CraftBukkit which is installed on the server. version bukkit.command.version Everybody
plugins Lists all installed plugins on the server. plugins bukkit.command.plugins Everybody
reload Stops and restarts all plugins on the server. reload bukkit.command.reload Operators
timings Records timings for all plugin events. timings <reset|merged|separate> bukkit.command.timings Operators

Default Minecraft Commands and Permissions

Command Description Usage Bukkit Permission Mojang Permission Permission Default
achievement give <stat_name> [player] Gives the specified player an achievement or changes a statistic value. Use '*' to give all achievements. achievement give * player1 bukkit.command.achievement minecraft.command.achievement Operators
ban <player> Bans a player from the server. ban player1 bukkit.command.ban.player minecraft.command.ban Operators
ban-ip <ip> Bans an IP address from the server. ban-ip bukkit.command.ban.ip minecraft.command.ban-ip Operators
banlist Shows the banned players. banlist bukkit.command.ban.list minecraft.command.banlist Operators
clear [user] [item] [data] [maxCount] [dataTag] Clears the player's inventory of the item and data. If no item is specified it clears the whole inventory. If maxCount is set to 0 it does not clear anything, but still outputs to command blocks. clear player1 dye 15 0 {display:{Name:Fertilizer}} bukkit.command.clear minecraft.command.clear Operators
debug On success, starts or stops the debug session. While active, includes notifications about potential performance bottlenecks in the console. When stopped, creates a profiler results file in the folder "debug". debug bukkit.command.debug minecraft.command.debug Operators
defaultgamemode <mode> Change the gamemode of new players joining the server. defaultgamemode 1 bukkit.command.defaultgamemode minecraft.command.defaultgamemode Operators
deop <player> Removes server operator status from a player. deop player1 bukkit.command.op.take minecraft.command.deop Operators
difficulty <level> Changes the difficulty of the server. difficulty 0 bukkit.command.difficulty minecraft.command.difficulty Operators
effect <player> <effect id> [seconds] [amplifier] Adds the specified effect to a player for the duration of 30 seconds or as specified by the user. effect player1 9 bukkit.command.effect minecraft.command.effect Operators
enchant <user> <enchantment ID> <level> [force] Enchants the item in the user's hand. If force is false, the enchantment only applies if it can go on the item and does not conflict with any existing enchantments. enchant player1 1 1 1 bukkit.command.enchant minecraft.command.enchant Operators
gamemode <mode> [player] Change the game mode of a player. 0 = Survival mode, 1 = Creative mode, 2 = Adventure mode. gamemode 1 player1 bukkit.command.gamemode minecraft.command.gamemode Operators
gamerule [rule] [new value] Changes the rules of the server. Type /gamerule to see a list of all game rules. gamerule keepInventory true
gamerule doFireTick false
bukkit.command.gamerule minecraft.command.gamerule Operators
give <player> <name> [amount] [damage] [data tag] Gives player blocks/items with the item name name. amount is is how many of the block/item to give (Default: 1). damage is the damage value of the block/item (Default: 0). data tag is the NBT tag to add.Data Values Item structure give player1 iron_sword
give player1 dirt 32
give player1 dye 7 15
give player1 diamond_sword 1 0 {display:{Name:"Herobrine's Sword"}}
bukkit.command.give minecraft.command.give Operators
help/? [plugin] Shows a list of server or plugin commands in the console or in-game. help bukkit.command.help minecraft.command.help Everybody
kick <player> [reason] Removes a player from the server. kick player1 bukkit.command.kick minecraft.command.kick Operators
kill Commits suicide. kill bukkit.command.kill minecraft.command.kill Operators
list Lists all currently connected players. list bukkit.command.list minecraft.command.list Operators
me <message> Says a message from the player's point of view: * player1 is building a castle! me is building a castle! bukkit.command.me minecraft.command.me Everybody
op <player> Turns a player into a server operator. op player1 bukkit.command.op.give minecraft.command.op Operators
pardon <player> Pardons a banned player so that they can connect again. pardon player1 bukkit.command.unban.player minecraft.command.pardon Operators
pardon-ip <ip> Pardons a banned IP address so that it can be used to connect again. pardon-ip bukkit.command.unban.ip minecraft.command.pardon-ip Operators
playsound <sound> <player> [x] [y] [z] [volume] [pitch] [minimumVolume] Plays the sound sound to player, coming from the specified location, at the specified volume, pitch, and minimum volume (to combat volume reduction as a result of distance). playsound mob.pig.say player1 bukkit.command.playsound minecraft.command.playsound Operators
save-all Forces a server-wide level save of the terrain. save-all bukkit.command.save.perform minecraft.command.save-all Operators
save-off Disables automatic terrain saving (useful for backup scripts). save-off bukkit.command.save.disable minecraft.command.save-off Operators
save-on Re-enables automatic terrain saving. save-on bukkit.command.save.enable minecraft.command.save-on Operators
say <message> Broadcasts a message to all players as the server. say Hello minecraft world! bukkit.command.say minecraft.command.say Operators
scoreboard <objectives/players/teams> <...> Complex command which edits and manipulates the scoreboard, a data storage structure. Scoreboard command scoreboard players set player1 points 3
scoreboard teams option redteam color red
scoreboard objectives setdisplay belowName health
bukkit.command.scoreboard minecraft.command.scoreboard Operators
seed Outputs the world seed. seed bukkit.command.seed minecraft.command.seed Operators
setblock <x> <y> <z> <name> [data] [handling] [dataTag] Sets a block to be another block. Block entity format Data values setblock ~ ~-1 ~ wool 3 destroy
setblock ~ ~ ~ chest 0 replace {CustomName:"Locked Chest",Lock:Key}
bukkit.command.setblock minecraft.command.setblock Operators
fill <x1> <y1> <z1> <x2> <y2> <z2> <name> [data] [handling] [dataTag] Fills a area of blocks. Block entity format Data values fill 10 ~-1 -10 -10 ~-1 10 stone
fill ~ ~-1 ~ ~10 ~-1 ~10 dirt 0 replace grass
bukkit.command.fill minecraft.command.fill Operators
setidletimeout <Minutes until kick> Sets the server's idle timeout setidletimeout 10 bukkit.command.setidletimeout minecraft.command.setidletimeout Operators
setworldspawn [x] [y] [z] Sets a worlds's spawn point. If no coordinates are specified, the player's coordinates will be used. setworldspawn 0 0 0 bukkit.command.setworldspawn minecraft.command.setworldspawn Operators
spawnpoint [User] [x] [y] [z] Sets the spawnpoint of the user specified. spawnpoint player1 bukkit.command.spawnpoint minecraft.command.spawnpoint Operators
spreadplayers <x> <z> <spreadDistance> <maxRange> <respectTeams> <players> Spreads players randomly throughout a region of blocks, spreadDistance blocks apart. respectTeams puts teams close to each other. spreadplayers ~ ~ 20 50 false @a[score_points_min=6] bukkit.command.spreadplayers minecraft.command.spreadplayers Operators
stop Gracefully stops the server (i.e. allows the server to save the worlds and lets all the plugins shut down properly). stop bukkit.command.stop minecraft.command.stop Operators
summon <EntityName> [x] [y] [z] [dataTag] Summons an entity (mobs, projectiles, items, vehicles, etc.). Entity format summon Creeper ~ ~ ~ {powered:1,CustomName:"Powered Creeper",CustomNameVisible:1} bukkit.command.summon minecraft.command.summon Operators
tell <player> <message> Allows the user to privately message another player. tell player1 Hey, how's it going? bukkit.command.tell minecraft.command.tell Everybody
tellraw <player> <JSON message> Sends a raw message to the player using the JSON text format. JSON format tellraw player1 {"text":"Click me!","hoverEvent":{"action":"show_text","value":"Go on, click me!"},"color":"green","clickEvent":"action":"run_command","value":"/kill"}} bukkit.command.tellraw minecraft.command.tellraw Operators
testfor <player> [dataTag] Tests for players with the specified names and data tag. player is most commonly an @identifier. Used in command blocks, as the success count (comparator output) increases for each player found. testfor @p[score_points_min=6] {OnGround:1} bukkit.command.testfor minecraft.command.testfor Operators
testforblock <x> <y> <z> <name> [data] [dataTag] Tests if the block at the location is name:data with dataTag. Used primarily in command blocks as their success outputs to a comparator. testforblock ~ ~5 ~2 chest 0 {Items:[{Slot:13,tag:{display:{Name:"I am an item!"}}}]} bukkit.command.testforblock minecraft.command.testforblock Operators
time <add/set> <amount> Add to or set the world time. Amount may be a number between 0 and 24000, inclusive, where 0 is dawn (i.e. clock is bisected; left side is day) and 12000 is noon. time add 6000
time set 0
minecraft.command.time Operators
toggledownfall Turn on or off rain/snow in the current world. toggledownfall bukkit.command.toggledownfall minecraft.command.toggledownfall Operators
tp <player1> <player2>
tp <player1> <x> <y> <z>
Moves player1 to the same location as player2.
Moves player1 to the exact coordinates.
tp player1 player2
tp player1 0 70 12
bukkit.command.teleport minecraft.command.tp Operators
weather <weather> Changes the weather in-game. weather clear bukkit.command.weather minecraft.command.weather Operators
whitelist on/off
whitelist add/remove <player>
whitelist list
whitelist reload
Enable or disable whitelisting (i.e. only listed players may join).
Add or remove player from the whitelist.
Lists whitelist.
Reloads whitelist from file.
whitelist on
whitelist add player1
whitelist list
whitelist reload
minecraft.command.whitelist Operators
xp <player> <amount> Gives the specified player a certain amount of experience. If 'l' is appended to the amount, it gives levels instead of points. xp player1 100
xp player2 6l
bukkit.command.xp minecraft.command.xp Operators

Additional Permissions

Permission Description Default
bukkit.broadcast.user Allows the user to receive user broadcasts Everybody
bukkit.command.plugins Allows user to look at plugins. Disables: /pl and /plugins Everybody
bukkit.command.ban Combines the Player ban and the IP ban permissions Operators
bukkit.command.unban Combines the Player Unban and IP Unban permissions. Operators
bukkit.command.op Combines the Op Give and Op Take permissions. Operators
bukkit.command.time Combines the Time Add and Time Set permissions. Operators
bukkit.command.save Combines the Save Enable, Save Disable and Save Perform permissions. Operators
bukkit.broadcast Allows the user to receive all broadcast messages. Everybody
bukkit.broadcast.scradmin Allows the user to receive administrative broadcasts. Operators
Language   EnglishбеларускаяDeutschespañolsuomifrançaisitaliano한국어Nederlandsnorsk bokmålpolskiportuguêsрусскийlietuviųčeština