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
Hi man) I have an problem with your plugin. He is not create more pages on book. Now i have 463 symbols displayed, but i have 3503 symbols on file on one line.
@Morfarmi
The answer in that seems kinda logical, there is an unnacepted character which from what i can see is a color or something similar, i do not see why the problem is caused but if you could send me your config file in a pm i can see if i find a problem. So, at the moment i do not spot what causes the error
Nevermind, copy the config file from the plugin description (on this page) and paste it in your config.yml :)
i post the error 2 days ago, your answer was i have a old version :)
version error was only info :)
now you say version number is no problem.
but my Problem is many line later, please read full post :)
on start i get the config error and my configfile in folder "Books" has 0 byte.
23:34:34 [SEVERE] Cannot load configuration from stream org.bukkit.configuration.InvalidConfigurationException unacceptable character '�' (0xFFFD) special characters are not allowed in "<string>", position 384
@Morfarmi
Hey, that the version says 1.4.3 is most likely that the version number isn't updated, which is no problem for you because it still works
@Konsider
You sure? During our tests it automaticly made a new page, if it doesn't do that it is a kinda huge error we need to fix. If thats really the problem i have a way i can fix it and will add this in the next update, which will hopefully come in some days and include unlimite books and book editing in game, so stay updated and we will hopefully fix your problems.
Thanks for reporting to us, xXjn1234Xx
&z is not working for new lines, and new pages are not being made when the text becomes too large.
@Morfarmi
The version you're using is quite old that might be the problem.. Btw, we're bringing out a new version later today. With unlimted books.
@AtexorCamil
I will put this on the todo list, but to awnser your question. no it's not possible yet.
hi, is it possible to player get a book every respawn? Not only firtst time? I need this feature...
14:58:13 [INFO] Books Has been enabled!on version1.4.3 14:58:13 [SEVERE] Cannot load configuration from stream org.bukkit.configuration.InvalidConfigurationException: unacceptable character '�' (0xFFFD) special characters are not allowed in "<string>", position 384
@MineCrafterCity Instead of using a defined number of books, you could store them in a List or even in a Map. To load/save them on server restart, you could simply use their name. By the way, is your source code on GitHub ?
@DirtyMonster
Uhm, what do you mean exactly, list?
Why don't you use a list instead of limiting the number of books?
@Hopkinator2000
You can use &z :)
@AwesomeAntlo
I'm putting that on the list!
@avataracid
Sorry for the late reply, I fixed this today.
@xXjn1234Xx
I was thinking.. Try to use \n and than make ENTER a variable to \n? :P
@Hopkinator2000
We have found no other way to do it than to but in spaces until the text gets moved to the next line
How do you start a new line in a book?
@think420
Can you please send me the config you are using ao i can see after problems?
After what we have tested in the plugin it should automaticly create a new page so I'm not sure what the problem is so please le me see the config :)
Hi guys, thanks for replying to us here I love that you guys reply problems if there are and tells us if you like our plugin. Im sorry its not updated to 1.6 yet, and sorry for not answering here cause i have, and will be offline most of the summer.
1) the plugin can be used if you don't think it will work because /book and /b is used by another plugin I think tht is wrong. I think it is at least 2 reasons for that, first, at least essentials lets other plugins override their commands, second /b is not our only command, yes, we only write /b here i think but you can also use /cb or /custombook with the same functions as /b
2) Some people are askig about an option for more books, for now i have found a way to make unlimited books, I have tested it out but I'm getting some errors, also I'm not online that much in a while :(
Will try to reply faster to comments from now :)
Hello! Just giving the plugin a test run. I am able to edit a book in the config file, but it gets to a certain point and the content is not put onto a second page. Basically I can only get one page of text. Am I missing something?