Got a question that the wiki doesn't answer? Ask on the forum (preferred), or join us on IRC.

About the ads

CommandBook/Commands

From SK's Wiki
Jump to: navigation, search

Contents

Commands

General

Command Arguments Description Permissions
/item

/i

[-d] <item[:data][|enchantment[:level][,otherenchantment[:level]]> [amount] Gives you an item (-d to drop items).

You can control permissions for individual items by setting up an item blacklist, whitelist, or per-item permissions. See the item permissions page.

  • - commandbook.give
  • - commandbook.give.other (to give to others)
  • - commandbook.give.infinite (for -1 amount)
  • - commandbook.give.stacks (for > 64)
  • - commandbook.give.stacks.unlimited (for > 5 stacks)
/give [-d] <target> <item[:data][|enchantment[:level][,otherenchantment[:level]]> [amount] Gives you or another player an item (-d to drop items).

You can control permissions for individual items by setting up an item blacklist, whitelist, or per-item permissions. See the item permissions page.

  • commandbook.give
  • commandbook.give.other (to give to others)
  • commandbook.give.infinite (for -1 amount)
  • commandbook.give.stacks (for > 64)
  • commandbook.give.stacks.unlimited (for > 5 stacks)
/more [-a] [-i] [target] Changes the held stack to have 64 items.
  • -a to affect all items in your inventory.
  • -i to create an infinite stack instead
  • commandbook.more
  • commandbook.more.infinite
/who
/list
/playerlist
/online
/players
[filter] See who is online.
  • commandbook.who
/motd Show the message of the day.
  • commandbook.motd
/intro Replays server's intro.mid file. See MIDI support.
  • commandbook.intro
/midi <midi> Plays a MIDI file. See MIDI support.
  • commandbook.midi
/rules Show the rules.
  • commandbook.rules
/kit Get a list of kits that a player can use.
  • commandbook.kit.list
  • commandbook.kit.kits.[kit] (such as commandbook.kit.kits.starter)
/kit <kit> [target] Get a kit.
  • commandbook.kit (to give to yourself)
  • commandbook.kit.other (to give to another player)
  • commandbook.kit.kits.[kit] (such as commandbook.kit.kits.starter)
/setspawn [destination] Set the spawn location.
  • commandbook.setspawn
/time Get the current time.
  • commandbook.time.check
/time now Get the current time.
  • commandbook.time.check
/time -l now Lock the time to the current time.
  • commandbook.time
  • commandbook.time.lock
/time [-l] [world] <time> Set the time. The time can be a number to indicate the number of ticks, names of the times of the day (sunrise, dusk, dawn, sunset, etc.), or a time string (3:44 or 5:44pm or 12am).
  • -l to lock the time (to prevent it from changing)
  • commandbook.time
  • commandbook.time.lock
/playertime [-rsw] [target] <time> Change the time for specific players only. This only affects what the client sees, not the server.
  • -r to reset to normal
  • -s for silent
  • -w to be relative to the world time (takes only an integer in ticks, not a time)
  • commandbook.time.player
  • commandbook.time.player.other
  • commandbook.time.player.check
/spawnmob [-d] [-i] [-r] [-b] <mob>[|rider] [count] [destination] Spawn a mob or several. The mob name can be a partial match. You can enter an invalid mob name and you will be listed the available types. Riders are supported in the mob argument, and special types of mobs can be made as well. See mob types.
  • -d means to set the mobs' health to 1
  • -i means to ignite the mob
  • -r means to rocket the mob
  • -b means to spawn a baby (only works on animals)
  • commandbook.spawnmob
  • commandbook.spawnmob.many (more than 10 mobs at a time)
  • commandbook.spawnmob.<mob> (per mob-permissions, such as commandbook.spawnmob.PigZombie)
/weather <'stormy'|'sunny'> [duration] [world] Change the weather. Use -1 for a duration (optional) if you want it to be natural, or you can specify a duration in seconds. Weather is global (on over the entire world) and it snows in snowy biomes and rains in other biomes.
  • commandbook.weather
/thunder <'on'|'off'> [duration] [world] Change the thunder and lightning state. Use -1 for a duration (optional) if you want it to be natural, or you can specify a duration in seconds. Thunder won't work when it's not storming.
  • commandbook.weather.thunder
/biome [target] (only matches one) Check the biome name of the location of specified player.
  • commandbook.biome
  • commandbook.biome.other

Teleportation

Command Arguments Description Permissions
/spawn Teleport to spawn.
  • commandbook.spawn
/teleport
/tp
[target] <destination> Teleport to a destination.
Tip: It is possible to teleport to coordinates by using /tp x,y,z (no spaces).
  • commandbook.teleport
  • commandbook.teleport.other (teleport others)
  • commandbook.locations.coords (needed to /tp x,y,z)
/bring
/tphere
/summon
/s
<target> Teleport another player to you.
  • commandbook.teleport.other
/place
/put
<target> Teleport another player to the location that you are looking at.
  • commandbook.teleport.other
/return
/ret
Return back to your last location.
  • commandbook.return
/call <target> Request a teleport from someone.
  • commandbook.call

Homes

Command Arguments Description Permissions
/home Teleport to specified own home in current world.
  • commandbook.home.teleport
/home <owner> Teleport to home of specified owner in current world.
  • commandbook.home.teleport
  • commandbook.home.other (teleport to other’s homes)
/home <target> <owner> Teleport given targets to specied owner‘s home in current world.
  • commandbook.home.teleport
  • commandbook.home.other
  • commandbook.home.teleport.other (teleport others)
/home <world> <target> <owner> Teleport targets to specied owner‘s home in given world.
  • commandbook.home.teleport
  • commandbook.home.other
  • commandbook.home.teleport.other
/sethome Sets own home at current position.
  • commandbook.home.set
/sethome <owner> Creates a home at current position for given player name.
  • commandbook.home.set
  • commandbook.home.set.other
/sethome <location> <owner> Creates a home at specified location for given player name.
  • commandbook.home.set
  • commandbook.home.set.other
/homes Unused.

Warps

Command Arguments Description Permissions
/warp [world] [target] <warp> Teleport to specified warp (name).
  • commandbook.warp.teleport
  • commandbook.warp.teleport.(warp name)
  • commandbook.warp.teleport.other (teleport others)
/setwarp <warp> [location] Creates a warp with given name at players location or given location.
  • commandbook.warp.set
/warps del <warp>
delete <warp>
remove <warp>
rem <warp>
Removes the warp named <warp>[1]
  • commandbook.warp.remove
  • commandbook.warp.remove.other
/warps list
show
List warps[2]
  • commandbook.warp.list

Messaging

Command Arguments Description Permissions
/broadcast <message...> Broadcasts a message to everyone. The format of the broadcast message can be configured.
  • commandbook.broadcast
/say <message...> Send a message. The format of the message if console uses it can be configured.
  • commandbook.say
/me <message...> Send an action message.
  • commandbook.say.me
/msg
/message
/whisper
/pm
/tell
<target> <message...> Sends a message to a player (or console if "!" is used).
  • commandbook.msg
/reply
/r
<message...> Reply to the last person that you messaged.
  • commandbook.msg
/mute <target> Mute a player.
  • commandbook.mute
/unmute <target> Unmute a player.
  • commandbook.mute
/afk [status] Sets you as afk, If another user uses /msg or /reply while you are away, it will warn them and tell them your status if given. Typing /afk again will set you as no longer being afk.
  • commandbook.away

Player

Command Arguments Description Permissions
/whereami
/getpos
/pos
/where
[target] Get your current location.
  • commandbook.whereami
  • commandbook.whereami.compass
/compass [target] Get your current cardinal direction.
  • commandbook.whereami.compass
/clear [-a] [-s] [target] Clears your or another player's inventory.
  • -a clears all slots (armor and hot keys)
  • -s clears a single slot only
  • commandbook.clear
  • commandbook.clear.other
/slap [-h|-v] [-d] [-s] [target] Slap a player.
  • -h means to slap "hard," while -v means to slap "very hard"
  • -d means to drop the player's health by one point
  • -s means to be silent and not announce to everyone on the server
  • commandbook.slap
  • commandbook.slap.other (slap others)
/slay [-s] [target] Slay a player.
  • -s means to be silent and not announce to everyone on the server
  • commandbook.slay
  • commandbook.slay.other
/rocket [-h] [-s] [target] Rocket a player.
  • -h means to rocket "hard"
  • -s means to be silent and not announce to everyone on the server
  • commandbook.rocket
  • commandbook.rocket.other (rocket others)
/barrage [-s] [target] Send a barrage of arrows from a player.
  • -s means to be silent and not announce to everyone on the server
  • commandbook.barrage
  • commandbook.barrage.other (barrage others)
/firebarrage [-s] [target] Send a barrage of fireballs from a player.
  • -s means to be silent and not announce to everyone on the server
  • commandbook.firebarrage
  • commandbook.firebarrage.other (firebarrage others)
/shock [-s] [-k] [-a] [target] Strikes a player with lightning.
  • -s means to be silent and not announce to everyone on the server
  • -k means to set the player's health to 0 and in-effect kill the player
  • -a means that lightning will come down around the player many times
  • commandbook.shock
  • commandbook.shock.other (shock others)
/thor <target> Give Thor's hammer.
  • commandbook.thor
  • commandbook.thor.other (give other people ability to use Thor's hammer)
/freeze <target> Stops a player from moving, talking and building.
  • commandbook.freeze
/unthor <target> Revoke Thor's hammer.
  • commandbook.thor
  • commandbook.thor.other (give other people ability to use Thor's hammer)
/gamemode [target] [Game mode] Sets a player's gamemode. Currently survival or creative
  • commandbook.gamemode
  • commandbook.gamemode.change
  • commandbook.gamemode.change.other
  • commandbook.gamemode.check
  • commandbook.gamemode.check.other
/heal [-s] [target] Heals you or another player
  • -s means to be silent
  • commandbook.heal
  • commandbook.heal.other

Miscellaneous

Command Arguments Description Permissions
/ping Says "Pong" back to tell you if the server is responding. (Not applicable)
/whois <target> Get information about a player.
  • commandbook.whois
  • commandbook.whois.other (lookup others)
  • commandbook.ip-address (see player's IP)
/debug info Show server information.
  • commandbook.debug.info
/debug clock Perform a very accurate measure of your server's clock speed to measure your server's lag.
  • commandbook.debug.clock
/cmdbook version Show CommandBook's version. (Not applicable)
/cmdbook reload Reloads CommandBook's configuration.
  • commandbook.reload

Bans

Character Meaning
m Minute
h Hour
d Day
w Week
y Year

Since v2.0 CommandBook has a flexible bans system that supports temporary bans, storing ban reasons, and logging of every action.

Exemption: Players with the commandbook.bans.exempt permission cannot be banned, unless the player banning them has the commandbook.bans.exempt.override permissions and uses the ban command with the -o flag. The same applies for kicking users, replacing commandbook.bans with commandbook.kick.

Temporary bans are given by using the /ban command with the -t <time> flag, where ban length is given as a series of [number][m|h|d|w|y] split by -. The meanings of each character are given in the table to the right.

With this system, /ban -t 1h-5m platnicat would ban platnicat for one hour and five minutes.

Command Arguments Description Permissions
/kick [-o] <target> [reason...] Kick a player.
  • commandbook.kick
  • commandbook.kick.exempt
  • commandbook.kick.exempt.override
/ban [-e] [-o] [-t time] <name> [reason...] Ban a player.
  • If you want to enter a name exactly, use -e so that the command won't try to match a player's name on the server.
  • commandbook.bans.ban
  • commandbook.bans.exempt
  • commandbook.bans.exempt.override
/unban <name> [reason...] Unban a player (exact name).
  • commandbook.bans.unban
/isbanned <name> Checks if a player is banned (exact name).
  • commandbook.bans.isbanned
/baninfo <name> Provides information about a ban for a player (exact name), if it exists
  • commandbook.bans.baninfo
/bans load Read bans from disk.
  • commandbook.bans.load
/bans save Force save bans to disk.
  • commandbook.bans.save

God

This component provides godemode support for players. Players in the cb-invincible group or with the commandbook.god.auto-invincible permission will have their godmode enabled automatically on login. A player can have their godmode enabled with the /god command if the sender of the command has commandbook.god for themselves or commandbook.god.other for other players.

Command Arguments Description Permissions
/god <target> Enable godmode on a player
  • commandbook.god
  • commandbook.god.other
/ungod <target> Disable godmode on a player
  • commandbook.god
  • commandbook.god.other

Parameter types

CommandBook understands advanced "parameter types". For example, you can spawn mobs at a player using /spawnmob Pig 10 nameofplayer or at the spawn location of netherworld using /spawnmob Pig 10 #spawn:netherworld. You may also use coordinates with /spawnmob Pig 10 10,64,-233. Another example is teleporting everyone near you, yourself included, to spawn with /tp #near #spawn.

Directed targets

The private message commands take a directed target.

  • ! or #console matches the console
  • @<player> matches a player exactly by their name
  • <filter> matches everyone whose name starts with the specified filter (will only work if there's only one match)
  • *<filter> matches everyone whose name contains the specified filter (will only work if there's only one match)

Targets

With most commands, a target can include an entire group of people. You can use a number of targets, including some special ones:

  • @<player> matches a player exactly by their name
  • * matches everyone
  • #world matches everyone in the same world as you
  • #near matches everyone within 30 blocks radius of you
  • <filter> matches everyone whose name starts with the specified filter
  • *<filter> matches everyone whose name contains the specified filter
Example: Rocketing all nearby players
/rocket #near

Locations

The teleport commands let you specify a location. You can use the following.

  • <x>,<y>,<z> matches coordinates (requires the commandbook.locations.coords permission)
  • #spawn matches spawn (requires the commandbook.spawn permission)
  • #target matches the first free block in the column of the block that you are looking at
  • #warp:name matches a warp with the specified name. #warp:name:world will check a different world if per-world-warps is enabled. (requires the commandbook.locations.warp permission if you own the warp, and commandbook.locations.warp.other otherwise) Since v1.6
  • #home will match your own home if you have one, and #home:name and #home:name:world work like the #warp target. (requires the commandbook.locations.home permission if you own the warp, and commandbook.locations.home.other otherwise) Since v1.6
  • Anything else matches the location of the first target found
Example: Teleporting to coordinates
/tp 312,65,13
Example: Spawning 20 pigs at netherworld spawn
/spawnmob Pig 20 #spawn:#nether
Example: Teleporting nearby players to spawn
/tp #near #spawn

Worlds

Some commands let you specify a world.

  • #main matches the main world
  • #normal matches the first normal world
  • #nether matches the first Nether world
  • #skyworld matches the first Sky world Since v1.6
  • #player:<filter> matches the world of the first player target found
  • <filter> matches a world by the exact name

Times

For the time command, you have several choices of specifying the time. Some example possibilities are as follows:

  • 12:00 (24-hour time)
  • 4pm (24-hour time)
  • 5:22am (24-hour time)
  • Dawn
  • Sunrise
  • Morning
  • Day
  • Midday
  • Noon
  • Afternoon
  • Evening
  • Sunset
  • Dusk
  • Night
  • Midnight
  • 12144 (number of ticks, a number between 0 and 24000)

Mobs

For the spawnmob command, additional properties can be specified for some mobs using the mob:type syntax. Since v1.6

  • Wolves:
    • wolf:angry - Makes the wolf aggressive
    • wolf:sitting - Makes the wolf sit down
    • wolf:tame - Makes the wolf tame (owner will be set to the person using the command)
  • Creepers:
  • Sheep:
    • sheep:sheared - Takes all the wool off the sheep
    • sheep:<color> - Colors the sheep any dye color
  • Pigs
    • pig:saddled - Saddles the pig for riding
  • Slimes
    • slime:<number> - Sets the slime to the specified size. slime:1 is the regular tiny slime.
  • Pig zombies
    • pigzombie:angry - Angers the pig zombie, causing it to attack nearby players.
    • pigzombie:<number> - Sets the anger level. Attacking a calm one will set it to 400. Lower numbers mean it will take less time to "calm down", longer numbers mean more time.
  • Endermen
    • enderman:<id:data> - Spawns the enderman with the given block in their hands.
  • Snowman


Namespaces

Variants
Actions