BookRules Icon


Automatically give players written books containing rules, getting started guides, etc when they join your server.


/bookrules Show current plugin information.
/bookrules info Show current plugin information.
/bookrules version Show current plugin information.
/bookrules commands Show description of all commands available to the player.
/bookrules reload Reload data from the config files.
/bookrules get [id | title] Get book specified by ID or title, or all books if no ID or title is specified.
/bookrules give <player> [id | title] Give the specified player the book specified by ID or title, or all books if no ID or title is specified.
/bookrules add Add the currently held book to the plugin.
/bookrules delete <id | title> Delete the book specified by ID or title from the plugin.
/bookrules list Show all of the books currently stored by the plugin.
/bookrules setauthor <author> Change the author of the currently held book.
/bookrules settitle <title> Change the title of the currently held book.
/bookrules unsign Unsign the currently held book, changing it back to a book and quill.


Permission NodeDescription
bookrules.* Allow full access to all commands in the plugin. Allow use of /bookrules [info | version] to see the plugin information.
bookrules.reload Allow use of /bookrules reload to reload data from file.
bookrules.receivealerts Receive alerts when there is an update to the plugin.
bookrules.get Allow use of /bookrules get to get the books stored by the plugin.
bookrules.give Allow use of /bookrules give to give books to other players.
bookrules.add Allow use of /bookrules add to add a new book to be stored by the plugin.
bookrules.delete Allow use of /bookrules delete to delete a book stored by the plugin.
bookrules.list Allow use of /bookrules list to list all books stored by the plugin.
bookrules.setauthor Allow use of /bookrules setauthor to set the author of the currently held book.
bookrules.settitle Allow use of /bookrules settitle to set the title of the currently held book.
bookrules.unsign Allow use of /bookrules unsign to unsign written books, changing them back to book and quills.


Verbose Boolean value that enables/disables logging to the console. (Used for debug)
Seconds-Delay Integer value that controls the delay of giving books to new players after logging in. (Useful when using other plugins that modify inventories at login, such as StarterKit and AuthMe.
Check-for-Updates Boolean value that determines whether the plugin will check for updates and send alerts when there is a new version.
Give-New-Books-On-Join Boolean value that determines whether players will automatically be given all books they have not yet received upon logging in to the server.
Display-Messages Boolean value that determines whether messages will be sent to players when they receive new books from this plugin.
Block-Villager-Book-Trading Boolean value that determines whether players will be prevented from trading written books generated by the plugin with villagers.
Give-Books-Every-Join Boolean value that determines whether players will be given a new copy of all books every time they join the server.
Language Abbreviation of the language to load the plugin in. See the translations section below for valid abbreviations.


This plugin contains an extensive localization system, allowing it to be translated into different languages. The following is a list of the currently available languages:


If you would like to supply a translation to be included in the plugin, please let me know. If you know how, feel free to create a pull request on GitHub with the translation file included. Otherwise, send me a private message and I will get you a list of the messages that need to be translated.

Update Checking

This plugin periodically checks BukkitDev for a new version, and will notify the console and players with the "bookrules.recievealerts" permission of a new version. If you would like to disable this feature, simply set "Check-for-Updates" to false in plugins/BookRules/config.yml.

Stats Collection

Anonymous statistics are collected automatically by this plugin and sent to MCStats. If you would like to view the data, you can do so here. If you would like to disable this feature, set "opt-out" to true in plugins/PluginMetrics/config.yml.


  • Optional groups for books, allowing groups to only be given to players with the correct permission (defined on add command?)
  • Multiverse support (possibly, no guarantee)
  • Option to let players keep books on death
  • Update to UUID system

Support and Feature Requests

If you have found a bug with the plugin, or would like to suggest a feature to be added, please create an issue on Github to make sure I see it. You can do this by clicking either the Tickets link at the top of the BukkitDev page or the Issues link on the Github repo, then click New Issue and provide as much information as possible. The more information you provide, the better I can help you.


BukkitDev Page
GitHub Repository


Donations are by no means required, but would be much appreciated. If you feel that my plugins have been of great use to you and would like to give me a little something in return, this is the way to do it.



Licensed under the Common Development and Distribution License Version 1.0 (CDDL-1.0).
For license information, see the LICENSE file, or on the web at

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

  • Avatar of SatansDaughter66 SatansDaughter66 Sep 28, 2015 at 00:17 UTC - 0 likes

    he hasnt been on for a month....but if i get lucky maybe he'll see this:
    please add an option where we can choose which books are given every join and which are not.

  • Avatar of Gangpimp Gangpimp Sep 25, 2015 at 16:36 UTC - 0 likes

    @Adrihun: Go That must be something on your end, cus i just installed fresh and tested on my server, and it worked without any errors at all...

  • Avatar of Adrihun Adrihun Sep 22, 2015 at 16:54 UTC - 0 likes

    Awful plugin, doesn't work! [17:51:38 INFO]: Adrihun issued server command: /BookRules add [17:51:38 WARN]: java.lang.NullPointerException [17:51:38 WARN]: at net.minecraft.launchwrapper.LaunchClassLoader.findClass( [17:51:38 WARN]: at [17:51:38 WARN]: at [17:51:38 WARN]: at java.lang.ClassLoader.loadClass(Unknown Source) [17:51:38 WARN]: at java.lang.ClassLoader.loadClass(Unknown Source) [17:51:38 WARN]: at com.mstiles92.bookrules.BookRulesCommandExecutor.onCommand( [17:51:38 WARN]: at org.bukkit.command.PluginCommand.execute( [17:51:38 WARN]: at org.bukkit.command.SimpleCommandMap.dispatch( [17:51:38 WARN]: at org.bukkit.craftbukkit.v1_7_R4.CraftServer.dispatchCommand( [17:51:38 WARN]: at [17:51:38 WARN]: at [17:51:38 WARN]: at [17:51:38 WARN]: at [17:51:38 WARN]: at [17:51:38 WARN]: at [17:51:38 WARN]: at net.minecraft.server.MinecraftServer.func_71190_q( [17:51:38 WARN]: at net.minecraft.server.dedicated.DedicatedServer.func_71190_q( [17:51:38 WARN]: at net.minecraft.server.MinecraftServer.func_71217_p( [17:51:38 WARN]: at [17:51:38 WARN]: at Source)

  • Avatar of minecraftbuildr0 minecraftbuildr0 Jul 26, 2015 at 10:46 UTC - 0 likes

    Is there a way to make the books spawn in a specific item slot?

  • Avatar of sleite sleite Apr 06, 2015 at 06:46 UTC - 0 likes

    I give myself the bookrules.* perm, but I cannot issue the command /rulebook commands

    What am I doing wrong?


  • Avatar of TrewCraft360 TrewCraft360 Mar 18, 2015 at 22:14 UTC - 0 likes

    Please respond Asap Also I disabled the join message when ever someone joins my server a message pops up saying &9[BookRules]&a 1 new books received. I play on Spigot 1.8.1 please help update or fix!

  • Avatar of TrewCraft360 TrewCraft360 Mar 18, 2015 at 21:39 UTC - 0 likes

    Could you please add we can color our book Title? Like I want the book to be &aRule Book.. Could you please add that soon?

  • Avatar of mstiles92 mstiles92 Dec 25, 2014 at 04:15 UTC - 0 likes

    @TheGamingTyphoon: Go

    It sounds like the plugin didn't load correctly. Check the log when starting your server for any errors. Create a pastebin of any errors and post it here. Also let me know what version of BookRules and CraftBukkit you are using.

  • Avatar of TheGamingTyphoon TheGamingTyphoon Dec 24, 2014 at 19:06 UTC - 0 likes

    It says that /bookrules is an unknown command please help because this would be an awesome plugin if it worked!

  • Avatar of LordKainzo LordKainzo Sep 12, 2014 at 01:50 UTC - 0 likes

    @mstiles92: Go

    Can you post a link to the new DL?


Date created
Aug 30, 2012
Last update
Jun 27, 2014
Development stage
Common Development and Distribution License (CDDL)
Curse link
Recent files
  • R: v2.1.1 for CB 1.7.9-R0.1 Jun 27, 2014
  • R: v2.0.0 for CB 1.7.9-R0.1 Mar 18, 2013
  • R: v1.2.2 for CB 1.4.7-R1.0 Dec 28, 2012
  • R: v1.2.1 for CB 1.3.1-R2.0 Sep 08, 2012
  • R: v1.2.0 for CB 1.3.1-R2.0 Sep 03, 2012