Custom Book
Custom Books
This project is inactive, not sure that it will work on your server, though it might
If anyone wants to use the sourcecode to continue developing or making something for themselves it can be found at https://github.com/norbye/CustomBook-Bukkit.
If anyone wants to continue developing this plugin for the comunity, the main contributor would have to be contacted.
What does the plugin do?
This plugin allows you to make unlimited custom books which you can edit to your likings. Than all players with permissions to /cb or /custombook can spawn the books using /custombook or /cb <book name>. Did I tell you that you can make unlimited different books!?! You can also have unlimited books given to players the first time they join!
To list all the commands you can perform do /cb or /cb help
Commands & Permission
User Commands
Command | Description | Permission Node |
---|---|---|
/cb | Plugin command list | No Permission Needed |
/cb list [normal/join] | List registered books | No Permision Needed |
/cb <book> | Gives you a book | books.normal.<PERMISSION> |
/cb give <player name / all> <book name> | Gives the selected player a book | books.give.<PERMISSION> |
/cb reload | Reloads the configuration file | books.reload |
/cb version | View info about the installed plugin | No Permission Needed |
At First Join | Gives a book on first join | books.join.<PERMISSION> |
books.normal.* and books.join.* gives you permission to all books of given type, books.* gives you full permissions
<PERMISSION> is set pr book, a single book can have multiple permissions, if you for example want to give a group of books to certain ranks. There are two <permission> tags per book. The first one is for /cb <book> and /cb give, and the second one is for receiving books on first join or every join
Console Commands
Command | Description |
---|---|
/cb | Plugin command list |
/cb list [normal/join] | List registered books |
/cb give <player name / all> <book name> | Gives the selected player a book |
/cb reload | Reloads the configuration file |
/cb version | View info about the installed plugin |
How to install
- Step 1: Download this plugin. You only need this plugin there are no other requirements. (However a Permissions plugin can be usefull as this plugin has permissions for all of the commands that it has.)
- Step 2: Put Custom Books (this plugin) into your plugin folder.
- Step 3: Edit Books.xml after your likings
- Step 4: Save Books.xml
- Step 6: Profit!
Configurating the books
All books are stored in Books.xml in plugins/Books/
How to set the different contents of the book has been explained roughly in the default file. If anything is unclear, post a comment or file a ticket and it will be updated + you will have your reply
Default configuration file can be found here
How to update
- Change the name of the Books.xml file to something else
- Restart the server
- Update the information from the old xml file into the new This is because many updates have more settings for each book, and if your files lack these settings, the functions will not work
Changelog:
2.0.0 - Complete remake, support of the newer versions of spigot and craftbukkit 2.0.1 - Merged the two configs into one, changing the format a little
For more detailed changelog click the "download" link
To do..
This info is listed in the GitHub Repository, view it there:
https://github.com/norbye/CustomBook-Bukkit/blob/master/README.md
Known Bugs
None! :) If you have any questions are suggestions please say so in the comments
The fastest methods to get an answer: send a mail or create an issue in github
Colors
You can make everything here colored, the title, the author, and all the pages!
The way you do so is by using the normal color codes (found here: http://minecraft.gamepedia.com/Formatting_codes ) Then you remove the ยง and add a / on each side, this means that dark red would be /4/
How do I make enters?
The same way as the colors, but with the letter z instead
Info
This plugin is not always updated, mainly because of prioritizing of projects. It has recently (start of 2016) been uploaded to GitHub to allow other developers to participate in the project.
Another reason is that moderators have to aprove the new versions. The latest version uploaded is: 2.2.0
I you have found any bugs or are having problems with our plugin please send xXjn1234Xx a message with the console log and all the plugin files. For faster replies, send a mail to [email protected], because I'm not on this site very frequently
I would REALLY love to use this plugin, however, the very large and awesome plugin "Essentials" has a /book command and does not allow this book to work. Please fix, this plugin is NEEDED on my server!
We love this plugin on our server, but cannot use it. The voxelsniper brush command is also /b and there is a conflict between the two commands. I note that you are aware of this, but just wanted to post the simple fact that we love the plugin, but can't use! :(
Will keep checking back for updates :)
@xXjn1234Xx
Hey,
that really sounds great. I am gonna try the thing with deleting the config.
I'm not sure what is the problem. If you want me to post some configuration files I can do so.
Nevertheless, thanks for your help. I'll keep you up to date.
And,..yes,...more than 6 books would be great.. ;-)
Greetz Rob
@Sk89r
Of what you have posted im not sure what the problem is, if you could please send me a screenshot of what happens when you performs the command in-game and same in the console + what plugins you in a PM I will try to help you as best as i can.
xXjn1234Xx
@Robulus77
1. I have also seen that problem on servers im working with, when I worked on it it worked to reset the config file, and I didn't have to delete any other plugins, as you say maybe voxelSniper causes an error I will try to make up a server with our books plugin and voxelSniper to check ;)
2. Hi there, we don't only have /b, we have /cb and /custombook with the same functions, but i see the problem, just that wathever I try to make up with new commands goes wrong with another plugin, as an example /book is already a command in essentials, I would love it if I was able to make some of the commands de-activate if another plugin used it but I don't think its that easy.
3. The reason why it is limited is that we have not found a way to enable infinite books, and we thought 6 books was enough for most servers, If its true that people want more than 6 books I can easily make more books, just that the code will be messy
but, everything for the users ;)
xXjn1234Xx
Hi,
for me your plugin seems great. I was exactly looking for something like that.
But i got some issues: 1. The plugin doesn't work for me, I get " exception executing command 'book' in plugin Books v1.5.1" in the console. Maybe this is an issue with another plugin. Did anyone else have this problem?
2. You shouldn't use /b I think. This is a command used by Voxel Sniper and I think this might be a problem (as on my server). I guess Voxel Sniper is a little more common than this book plugin. So you might consider a new command. only /book would be fine I guess.
3. Why do you limit the number of books to 6? I'm currently setting up an RPG Server and I think i will need more than 6 books for all the stories.
Thanks for your answer and greetings! Rob
Hi there! When i type /b it gives me this error log
13:49:38 [SEVERE] null org.bukkit.command.CommandException: Unhandled exception executing command 'b' i n plugin Books v1.5.1 at org.bukkit.command.PluginCommand.execute(PluginCommand.java:46) at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:18 9) at org.bukkit.craftbukkit.v1_5_R3.CraftServer.dispatchCommand(CraftServe r.java:523) at net.minecraft.server.v1_5_R3.PlayerConnection.handleCommand(PlayerCon nection.java:965) at net.minecraft.server.v1_5_R3.PlayerConnection.chat(PlayerConnection.j ava:883) at net.minecraft.server.v1_5_R3.PlayerConnection.a(PlayerConnection.java :840) at net.minecraft.server.v1_5_R3.Packet3Chat.handle(Packet3Chat.java:44) at net.minecraft.server.v1_5_R3.NetworkManager.b(NetworkManager.java:292 ) at net.minecraft.server.v1_5_R3.PlayerConnection.d(PlayerConnection.java :109) at net.minecraft.server.v1_5_R3.ServerConnection.b(SourceFile:35) at net.minecraft.server.v1_5_R3.DedicatedServerConnection.b(SourceFile:3 0) at net.minecraft.server.v1_5_R3.MinecraftServer.r(MinecraftServer.java:5 81) at net.minecraft.server.v1_5_R3.DedicatedServer.r(DedicatedServer.java:2 26) at net.minecraft.server.v1_5_R3.MinecraftServer.q(MinecraftServer.java:4 77) at net.minecraft.server.v1_5_R3.MinecraftServer.run(MinecraftServer.java :410) at net.minecraft.server.v1_5_R3.ThreadServerApplication.run(SourceFile:5 73) Caused by: java.lang.NullPointerException at me.jonna.CustomBook.Colours.onCommand(Colours.java:172) at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44) ... 15 more
can it be to where it is compatible to Chest Shop, and you can SELL the custom books?
Any more suggestions on what we should add to this plugin? :) Thanks for 750 downloads though guys glad people like it!
@MW2Man00
Thanks for the reply, I will check the plugin source for errors, thought I had tested the uploaded version myself but.... Also its possible that some plugins are incompatible.
If you could please send me your server folder download link in the PM's I can try to find the problem.
xXjn1234Xx
I get this error every time i try to load the server with this plugin. Please help. I am running PermissionsEx, spawneradjuster worldedit nocheatplus znounce airjump lockette clearlag votifier mcmmo worldguard essentials chatmanager all of the stuff essentials comes with and factions. 20:22:09 [SEVERE] Could not load 'plugins/books.jar' in folder 'plugins' org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: me/jonna/CustomBook/Colours : Unsupported major.minor version 51.0 at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:184) at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager.java:305) at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:230) at org.bukkit.craftbukkit.v1_5_R3.CraftServer.loadPlugins(CraftServer.java:239) at org.bukkit.craftbukkit.v1_5_R3.CraftServer.<init>(CraftServer.java:217) at net.minecraft.server.v1_5_R3.PlayerList.<init>(PlayerList.java:55) at net.minecraft.server.v1_5_R3.DedicatedPlayerList.<init>(SourceFile:11) at net.minecraft.server.v1_5_R3.DedicatedServer.init(DedicatedServer.java:106) at net.minecraft.server.v1_5_R3.MinecraftServer.run(MinecraftServer.java:382) at net.minecraft.server.v1_5_R3.ThreadServerApplication.run(SourceFile:573) Caused by: java.lang.UnsupportedClassVersionError: me/jonna/CustomBook/Colours : Unsupported major.minor version 51.0 at java.lang.ClassLoader.defineClass1(Native Method) at java.lang.ClassLoader.defineClassCond(ClassLoader.java:631) at java.lang.ClassLoader.defineClass(ClassLoader.java:615) at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:141) at java.net.URLClassLoader.defineClass(URLClassLoader.java:283) at java.net.URLClassLoader.access$000(URLClassLoader.java:58) at java.net.URLClassLoader$1.run(URLClassLoader.java:197) at java.security.AccessController.doPrivileged(Native Method) at java.net.URLClassLoader.findClass(URLClassLoader.java:190) at org.bukkit.plugin.java.PluginClassLoader.findClass0(PluginClassLoader.java:80) at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:53) at java.lang.ClassLoader.loadClass(ClassLoader.java:306) at java.lang.ClassLoader.loadClass(ClassLoader.java:247) at java.lang.Class.forName0(Native Method) at java.lang.Class.forName(Class.java:249) at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:173) ... 9 more
@xXjn1234Xx
I think he means on the fly, using commands in-game. Which I think would be pretty cool to do..
@MrREOM
I think you will may have to test the plugin if he have not made it clear enough that you can edit the author. You can edit title, author, what the command for the book should be and the content, color codes are supported in every part of the plugin, title, name, author and content.
I'm pretty sure that you will find out that you can do all of the things you asked about if you test our plugin ;)
Good wishes with our plugin
xXjn1234Xx
Can you make it so we can change the name the author and change the name of the book and also adit it. Are color codes supported for the author and name of the book?
@MineCrafterCity
jn sure knows how to do this and has updated the plugin with this feature :P
@winter4w
Right now, you have to add more text in order to get a new page...
PRO TIP: Use spaces it might see it as a character and this way you can determine how many characters a page needs and then add enough spaces to kind of add a new page.
This will hopefully be easier in the future!
@DrKnockOut99
Thanks! :)
When making this plugin this was my first thought aswell. However, I havn't gotten the knowladge to this yet. but I'll keep working on it and it will hopefully be out soon! If not, I'm pretty sure jn1234 knows how to do this so I think he'll be updating it if I don't know how.
You should add a feature to initially give a player new to the server a custom book. We could put server rules in and info in the book instead of having them read 50 signs in the spawn! Great plugin btw!
How can you make it so it goes to the next page
@Oshydaka I am really sorry if you got problems using our plugin, with the first look at the config things you included it seems like ther is no '#' in front of 'Default configuration file'. This is neccesary to point out its a note and not an action, i am no sure if that can cause a problem with the plugin or not. I didn't see if you tried the in-game/console commands, since there may not be such a huge problem with it if some of the commands such as /b and /b reload is working :) Also i will be messaging you formmore info Thanks for reporting :)
- xXjn1234Xx