CommandBook
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.
- Got a question about CommandBook? Need server or code help? Consider asking on the forum too!
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.
- Install WorldEdit first. (DON'T FORGET THIS)
- Download CommandBook and install it the same way.
- Run your server once to generate the files.
- Edit plugins/CommandBook/config.yml to your liking.
- 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.
Learning More |
---|
- Project leader: Contact @sk89q on Twitter
- Lead developers: sk89q, Dark Arc, and zml2008
@Dark_Arc
There are a couple different messages on that link, can you link me directly to the jar I should be using?
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.
@NathanWolf
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.
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!
@digimbyte
What exactly isn't working in 2.3 on 1.5.2?
Edit: Scratch that, try this build.
@sharqman
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.
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)
@SXRWahrheit
@ManBeastPigDev
It's a bukkit issue, we have a hot fix available however built off of the development builds. :)
http://youtrack.sk89q.com/issue/CMDBOOK-2361
@SXRWahrheit
Yes me, i think CmdBook needs an update
Is anyone having issues with /tp since the last Bukkit Beta build?
Когда обновление?
Hi, is it possible to do the /item -d command without it putting a message on the screen saying "You have been given "???
I dont know if the dev cares, but I'm having an issue with CommandBook.
I love CB, I really do, its simple, lite and does what its supposed to. but I run a 1.5.2 server and 2.2 is more broken then 2.3 i can only use one or the other, since /call seems to be now broken I'm going to have to move back to 2.3 where I lost other functions.
if its possible, could you look into updating or releasing one thats compatible with 1.5.2 for hexxit and tekkit servers? Thank you.
@z00100100
I'll look into that.
@feaugustoabreu
The way it's currently coded it's very difficult to provide translations.
@KnightOfLegion
This is being addressed.
could you add a named home to the /home <name> (player) and /sethome <name> (player) where name is what you name that location of your home and set it up to save multiple locations per person and just save the cords bound to the name of the home?
would be nice to have this in this plugin instead of needing outside plugins that way it would take less of a servers performance away.
Hi, i would to know if the plugin needs help for translating the plugin for another language, such portuguese =)
The alias for "/bring" summon, refuses to let us summon creatures using command blocks. Please fix this.
Awesome plugin man! No bugs yet could you add like a chat plugin that comes with it?
This Plugin is AWESOME**
parkrussell.dyndns.org:25569 ZOMBIE APOCALYPSE!**
Owner Username: Atomosie
Hello, I am using kits in Commandbook and everything is working good, but is there any way to put more than one enchant on an item. Here is a sample of what I am trying to do, but only the first enchant shows up in-game:
Thanks in advance for any help with this!