CommandBook

Logo

CommandBook adds essential commands for managing your server, from teleportation commands to time changing commands.

  • Modular, and extremely light on your server.
  • Add multiple types of easy-to-use teleportation commands.
  • Change time without having to remember the numbers (/time 3am works)
  • Add support for homes and warps for your players.
  • Change weather with ease.
  • Play with your players using commands like /slap.
  • Ban and kick users that are troublesome.
  • Do more! The list of features is below.
  • Enable features that you need, disable ones that you don't
Quote:

Disclaimer: These builds have not been approved by the BukkitDev staff. Use them at your own risk. Development builds of CommandBook can be found at our build server, http://builds.enginehub.org.

Thinking about adding cool Redstone features? See CraftBook. Want to protect regions, as well as your server? We recommend WorldGuard.

Read the Wiki Chat with Us Report a Bug Source Code

Features

Hint: If you want to select commands that you want to use instead of using them all, modify the components: section of the configuration.

  • General:
    • item [-d] <item[:data]> [amount]
    • give [-d] <target> <item[:data]> [amount]
    • more [-a] [-i] <target>
    • online [filter]
    • motd
    • intro (play intro music)
    • midi (play a MIDI file for yourself)
    • rules
    • setspawn [destination]
    • time [world] <time>
    • weather <'stormy'|'sunny'> [duration] [world]
    • thunder <'on'|'off'> [duration] [world]
    • spawnmob [-p] [-d] [-i] [-r] <mob> [count] [location]
    • kit <kit> [target]
  • Teleportation:
    • spawn
    • tp [target] <destination>
    • bring <target>
    • put <target>
    • call <target> (request a teleport)
  • Messaging:
    • broadcast <message>
    • say <message>
    • me <message>
    • msg <target> <message...>
    • reply <message...>
    • mute <target>
    • unmute <target>
  • Player:
    • whereami
    • compass
    • clear [-a] [target]
    • slap [-s] [-h|-v] [-d] [target]
    • rocket [-s] [-h] [target]
    • barrage [-s] [target]
    • shock [-s] [target]
    • thor [target] (get Thor's hammer)
    • unthor [target] (revoke Thor's hammer)
    • whois [target]
  • Utilities:
    • ping
    • debug info
    • debug clock (very accurate server lag benchmark)
  • Bans:
    • kick <target> [reason...]
    • ban [-e] <target> [reason...]
    • unban <target> [reason...]

See the list of commands and permissions.

Getting Started

Installation

Bukkit is currently required.

  1. Install WorldEdit first. (DON'T FORGET THIS)
  2. Download CommandBook and install it the same way.
  3. Run your server once to generate the files.
  4. Edit plugins/CommandBook/config.yml to your liking.
  5. Restart the server for the settings to take effect.

You'll have to read the wiki (see below) to find the permissions you need.

Want more features, faster? We need some help with something!

Documentation

What are the permissions? The commands? Check out the wiki below.

Read the Wiki Chat with Us Report a Bug Source Code

Learning More
  • Project leader: Contact @sk89q on Twitter
  • Lead developers: sk89q, and zml2008

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of AzoriusBeat AzoriusBeat Mar 15, 2014 at 08:18 UTC - 0 likes

    I'm really new and I'm making a server, Everything seems so fine but For some reason I can't figure out Command book? Where do I put the permissions in, and how do I enable Sethome and Home? That's all i need to know and if anyone can give me a picture on how to do it, that would be awesome otherwise i'm about to give up.

  • Avatar of TheExcel TheExcel Mar 13, 2014 at 03:17 UTC - 0 likes

    @ManBeastPigDev: Go

    It is updated, don't use /reload if you are, and make sure the components for the relevant commands are enabled.

    Power to the people for the power of the people.

  • Avatar of TheExcel TheExcel Mar 13, 2014 at 03:15 UTC - 0 likes

    @SXRWahrheit: Go

    This one, you can also fix the teleport issues by forcing the alias. Also make sure you have low-priority-command-registration disabled.

  • Avatar of SXRWahrheit SXRWahrheit Mar 08, 2014 at 22:25 UTC - 0 likes

    @TheExcel: Go

    There are a couple different messages on that link, can you link me directly to the jar I should be using?

    http://summaxr.com/newgtop.gif
    I run http://summaxr.com and our Minecraft server at mc.summaxr.com - feel free to visit.

  • Avatar of ManBeastPigDev ManBeastPigDev Mar 08, 2014 at 10:04 UTC - 0 likes

    Hi,

    Are there any plans to update cmdbook so it works with 1.7.4? Currently the follow commands are broke.

    spawnmob slap rocket afk whois (although this seems to work off and on anyway) barrage shock thor /unthor ping

    They all report UNKNOWN COMMAND The rest above work. I've tried the commandbook-latest from the dev site and that got tp working kinda. But it might have been a bukkit update i dont know.

    I'm using spigot but its the same on bukkit. If there is a version of spigot or bukkit (ideally spigot) i can use that will work with cmdbook please let me have the exact version numbers for cmdbook and spigot if you can.

    Thanks.

    Crafty Creeper Party Server

  • Avatar of TheExcel TheExcel Mar 05, 2014 at 22:57 UTC - 0 likes

    @elMakers: Go

    I'm currently working on Util refactoring, and updating. The new ItemUtil class can be seen here https://github.com/sk89q/commandbook/blob/parchment/src/main/java/com/sk89q/commandbook/util/item/ItemUtil.java.

    You may be able to replace that class :P

    I'll think about what you're trying to do, and see if I can come up with a more official way for someone to insert a custom item provider into CommandBook.

  • Avatar of elMakers elMakers Mar 05, 2014 at 16:40 UTC - 0 likes

    Hi! Is there any way for me to add custom items to kits via API? What I mean by "custom" is items with special NBT data that only my plugin can create (well, presumably, I don't think your flat file item format supports anything other than standard echants, right?).

    For instance, in Essentials I have sneakily replaced their ItemDB class to first check if an item name starts with "wand:", in which case my plugin creates it, if not it falls back on default Essentials functionality. This is really hacky, but they have no API that supports what I want to do.

    Unfortunately I won't be able to get so hacky with CommandBook due to your item producer being the main plugin class- I can't really swap that one out :)

    What I would love to see (and love to help implement, if needed) is a way for my plugin to register itself as an ItemProducer, an interface that would have a single "ItemStack getItem(String itemKey)" method. This would return null if the plugin doesn't handle the specified item, or return an ItemStack if it does.

    Ideally this would be called in CommandBook::getCommandItem, and not cached. For instance, if given "wand: random(20)", my plugin would create a randomly-generated level-20 wand, and it'd be nice if that could happen every time the item is created, so it's random each time.

    I'm wanting to switch away from Essentials on my own server, and would love to support CommandBook kits in my own plugin the way I do Essentials. I love (and integrate with) WorldEdit and WorldGuard already, so I figured I'd go for the sk89q trifecta. (Still looking for a good shop replacement, too...)

    Thanks for reading!

    Last edited Mar 05, 2014 by elMakers

    BFAK:1034,0c13cf5d490f7c7bab438f2c4298c44509c85d916593cec4815c2ae51a52ecf6

  • Avatar of TheExcel TheExcel Feb 28, 2014 at 20:53 UTC - 0 likes

    @digimbyte: Go

    What exactly isn't working in 2.3 on 1.5.2?

    Edit: Scratch that, try this build.

    Last edited Feb 28, 2014 by TheExcel
  • Avatar of TheExcel TheExcel Feb 28, 2014 at 20:48 UTC - 0 likes

    @sharqman: Go

    If call is broken that has to do with improper configuration. As for summon, that's fixed in the build that can be found here.

  • Avatar of sharqman sharqman Feb 27, 2014 at 17:16 UTC - 0 likes

    This has been broken since 1.6.4 please update -/summon interferes with vanilla command -/call doesn't display who is calling you -basically all formatting codes using § are messed up because of commandbook (it displays a boxed question mark)

Facts

Date created
Aug 25, 2011
Categories
Last update
Jul 16, 2013
Development stage
Release
Language
  • enUS
License
GNU General Public License version 3 (GPLv3)
Curse link
CommandBook
Downloads
734,847
Recent files

Authors

Relationships

Required dependency
WorldEdit