|
Welcome to the BukkitWiki!
|
CraftBukkit commands
|
This page has been suggested for inclusion in the Official Documentation
|
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 this 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 | Permission | Permission Default |
|---|---|---|---|---|
| tell <player> <message> | Allows the user to privately message another player. | tell Notch Hey, how's it going? | bukkit.command.tell | Everybody |
| kill | Allows the player to kill themselves, returning to spawn (and losing items). | kill | bukkit.command.kill | Everybody |
| me | Says a message from the player's point of view: *player1 is building a castle! | me is building a castle! | bukkit.command.me | Everybody |
| help or ? | Shows a list of server commands in the console or in-game. | help | bukkit.command.help | Operators |
| kick <player> | Removes a player from the server. | kick player1 | bukkit.command.kick | Operators |
| ban <player> | Bans a player from the server. | ban player1 | bukkit.command.ban.player | Operators |
| banlist | Shows the banned players. | banlist | bukkit.command.ban.list | Operators |
| pardon <player> | Pardons a banned player so that they can connect again. | pardon player1 | bukkit.command.unban.player | Operators |
| ban-ip <ip> | Bans an IP address from the server. | ban-ip 192.168.1.5 | bukkit.command.ban.ip | Operators |
| pardon-ip <ip> | Pardons a banned IP address so that they can connect again. | pardon-ip 192.168.1.5 | bukkit.command.unban.ip | Operators |
| op <player> | Turns a player into a server operator. | op player1 | bukkit.command.op.give | Operators |
| deop <player> | Removes server operator status from a player. | deop player1 | bukkit.command.op.take | 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 | Operators |
| give <player> <data-value> [amount [damage]] | Gives player blocks/items blockID data-value. 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 Values. | give player1 267 (gives player1 1 iron sword) give player1 3 31 (gives player1 31 blocks of dirt) |
bukkit.command.give | 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 | Operators |
| save-all | Forces a server-wide level save of the terrain. | save-all | bukkit.command.save.perform | Operators |
| save-off | Disables automatic terrain saving (useful for backup scripts). | save-off | bukkit.command.save.disable | Operators |
| save-on | Re-enables automatic terrain saving. | save-on | bukkit.command.save.enable | Operators |
| list | Lists all currently connected players. | list | bukkit.command.list | Operators |
| say <message> | Broadcasts a message to all players as the server. | say hello minecraft world! | bukkit.command.say | Operators |
| whitelist <on/off> | Enable or disable whitelisting (i.e. only listed players may join). | whitelist on whitelist off |
bukkit.command.whitelist.enable bukkit.command.whitelist.disable |
Operators |
| whitelist <add/remove> <player> | Add or remove a player from the whitelist. | whitelist add Notch whitelist remove Notch |
bukkit.command.whitelist.add bukkit.command.whitelist.remove |
Operators |
| whitelist list | Lists all currently whitelisted players. | whitelist list | bukkit.command.whitelist.list | Operators |
| whitelist reload | Reload the whitelist from file. Useful if you edited the file manually. | whitelist reload | bukkit.command.whitelist.reload | 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 |
bukkit.command.time.add bukkit.command.time.set |
Operators |
| gamemode <0/1/2> <player> | Change the game mode of a player. 0 = Survival mode, 1 = Creative mode, 2 = Adventure mode. | gamemode 1 Notch | bukkit.command.gamemode | Operators |
| xp <player> <amount> | Gives the specified player a certain amount of experience | xp Notch 100 | bukkit.command.xp | Operators |
| toggledownfall | Turn on or off rain/snow in the current world | toggledownfall | bukkit.command.toggledownfall | Operators |
| defaultgamemode <0/1> | Change the gamemode of new players joining the server. | defaultgamemode 1 | bukkit.command.defaultgamemode | Operators |
| seed | outputs the world seed | seed | bukkit.command.seed | Operators |
| enchant <user> <enchant number or ID> <level> <force> | Enchants the item in the user's hand. | enchant Notch 1 1 1 | bukkit.command.enchant | Operators |
| weather <weather> | Changes the weather in-game. | weather clear | bukkit.command.weather | Operators |
| clear <user> | Clears a user's inventory | clear Notch | bukkit.command.clear | Operators |
| difficulty <diff level> | Changes the difficulty of the server. | difficulty 0 | bukkit.command.difficulty | Operators |
| spawnpoint <User> <x> <y> <z> | Sets the spawnpoint of the user specified | spawnpoint Notch | bukkit.command.spawnpoint | Operators |
| GameRule | Prints out the current game rules being applied to the server | GameRule | bukkit.command.gamerule | Operators |
Additional Permissions
Permission: bukkit.command.ban
Description: Combines the Player Ban and IP Ban permissions.
Default: Operators
Permission: bukkit.command.unban
Description: Combines the Player Unban and IP Unban permissions.
Default: Operators
Permission: bukkit.command.op
Description: Combines the Op Give and Op Take permissions.
Default: Operators
Permission: bukkit.command.time
Description: Combines the Time Add and Time Set permissions.
Default: Operators
Permission: bukkit.command.save
Description: Combines the Save Enable, Save Disable and Save Perform permissions.
Default: Operators
Permission: bukkit.broadcast
Description: Allows the user to receive all broadcast messages.
Default: Operators
Permission: bukkit.broadcast.admin
Description: Allows the user to receive administrative broadcasts.
Default: Operators
Permission: bukkit.broadcast.user
Description: Allows the user to receive user broadcasts.
Default: Everybody
