CommandBookCommands

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	<target>	Return back to your last location.	commandbook.return commandbook.return.other
/call	<target>	Request a teleport from someone. Tip: Enable this instead of commandbook.teleport.other to prevent abuse. Other players can't arbitrarily teleport you without your permission.	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)(may not work) commandbook.warp.warp.(warp name)[1] 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>[2]	commandbook.warp.remove commandbook.warp.remove.other
/warps	list show	List warps[3]	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 (requires commandbook.targets.everyone Since v2.2.1)
• #world matches everyone in the same world as you (requires commandbook.targets.world.<worldname> Since v2.2.1)
• #near matches everyone within 30 blocks radius of you (requires commandbook.targets.near Since v2.2.1)
• <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)
• ~<x>,~<y>,~<z> makes coordinates relative. Only used in /tp target x y z syntax. Any or all coordinates can be made relative, while any without ~ will be constant (requires the commandbook.locations.coords.relative permission) Since v2.2.1
• #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:
  • creeper:powered - Gives the creeper power armor
• 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