Books without Borders!
Books without Borders!
Ever wanted to export your book to a text file? Ever want to import it back in? Accidentally sign it too soon? If so, Books without Borders has got your back!
Features
- Export written books and book and quills to .txt or .yml files
- Import books from files as written books or unsigned books
- Text files can be any length, and the import process fits the content to the correct page length
- Books can be saved privately, or to a directory visible server wide
- Encrypt books to secure their contents [Courtesy of dorrax]
- Give, encrypt, or decrypt held books with signs
- Give players books via command blocks
- Unsign or copy held books with a simple command
- Give first time players a single book or a set of books when they join
- Configurable option to require certain items or pay via Vault compatible economy to create books via command
- Add lore to any item with a simple command
- Supports adding and saving color to titles, lore, and book contents
Usage
[Video Tutorial courtesy of luigi_vampa]
Just use the simple commands linked below and you'll be on your way. No tricky maneuvers required!
To make books auto-update, make the book's title end with "[U]". For example, "booktitle[U],authorname.txt" or "updatingbook[U].txt".
All book data saves to [Server Plugins Folder]->[Books without Borders]->[Books]
View commands and permissions here.
See examples of Yaml format book editing here.
See examples of sign usage here.
View sample configuration file here.
For general book usage and writing information click here.
For advanced book editing and tips like how to use §r to create line breaks, click here.
Concerning Future Updates
Development for this plugin is currently inactive for the foreseeable future, though I would love to start again if I ever got the chance. If I become aware that this plugin no longer functions with current builds of bukkit and minecraft I will update this page to reflect that.
A sincere thank you to everyone who used and/or gave feedback for this plugin. It was a pleasure while it lasted.
If you enjoy this plugin and want to say thanks, some caffeine is always welcome :D
Check out my other plugins!
Feel free to leave comments and suggestions!
@AkiraAkiba
Thanks for your fast reply, after setting the title ingame with the command it worked properly!
Thanks alot :)
@RAGEmond
Thank you for your inquiries, I will do my best to clear them up.
The lore line-separator is the character used in the /bwb setLore command to force a line break in the supplied lore, much like how §r is used in .TXT books.
For a .YML book to auto update both its filename and the title line in the .YML file itself must end with [U]. If you load the book and its in game title does not end with [U] it will not auto update.
Currently there is no way to provoke a new page in the .TXT format, which is one of the reasons I introduced the .YML format.
Please let me know if there is anything I missed, or if you have any additional questions.
Hello AkiraAkiba,
I'm using ur plugin on my server, unfortunately I got some problems but first I wanted to ask whats a lore line seperator? My english isn't that good and the translator doesnt help me there.
Now the real problem:
While using "bookname[U].txt" the autoupdate works but with "bookname[U].yml" it doesn't.
Also I can make a linebreak in .yml files by adding empty lines but in txt it doesn't work, so I'm using §r to make a line break but how can I provoke a new page in txt books?
For e.g. bookname[U].txt
§r Line 1 §r Line 2 §r Line 3 §r Line 4 §r Line 5 §r Line 6 §r Line 7 §r Line 8 §r Line 9 §r Line 10 §r Line 11 §r Line 12 §r Line 13 §r Line 14
This book shows 14 lines ingame, the 14th line is below the border of the book but should be on the next page.
Thanks in advance
RAGEmond
@luigi_vampa
I'm glad to hear from you, and very glad you are still interested in making a video for the plugin. As for your questions:
I actually just submitted v1.3.1 for approval, which allows users to specify a list of books to give to players new to the server, among other things. I will be updating the sample configuration file page shortly to show how that is done.
To make books auto-update, make the book's title end with "[U]". For example, "booktitle[U],authorname.txt" or "updatingbook[U].txt", then save the book. The actual updating mechanism works by BwB setting the books contents to that of the saved text file's contents anytime the player switches to that book.
Feel free to let me know if you have any additional questions, and as always I greatly appreciate your input and contributions.
Hello. Glad to see this plugin still going. I'll see if I can get the time to update the video for you. Anyway to give a player more than one book to begin with? Also, how does the update [U] work? Does it update a book after it has been created as well?
@Youramoron
Glad to be of assistance.
@Youramoron
"Book_for_new_players: Zero4000/Soul_Intro,Zero4000.txt"
should be:
"Book_for_new_players: Soul_Intro,Zero4000.txt"
The new player book must be located in the "Books" folder, and not a player sub-folder. Please let me know if this issue persists after this change.
Thank you once again for your time and patience.
NOTICE:
Please contact me through BukkitDev so that I may assist you in a timely manner.
@Youramoron
I apologize for the video not being helpful for this feature, it is getting a bit out of date.
If I may ask, what value have you set for "Book_for_new_players" in the config file?
I would also recommend checking "Existing Players.txt" (in BwB's folder) to confirm that the players you want to receive the first-time book are not listed within. If they are, simply remove that line, or all lines to ensure everyone gets a book when they join next.
If you modify either the config file or "Existing Players.txt", be sure to restart your server or run the /bwb reload command.
If you are still experiencing difficulty with any part of BwB, please let me know, as I am eager to assist. I will also try to improve upon my documentation.
Thank you for your time and patience.
@Burnt_Poptarts
I've just uploaded BwB v1.2.61 to correct the issue you brought to my attention. It should be available for download soon.
@Burnt_Poptarts
Thank you for bringing this to my attention. This is actually an important error to fix, because BwB is meant to support saving book and quills as well as finished books.
I have already pinned down the cause of this, and will have version 1.2.61 out shortly to remedy the situation.
I also hope to have a proper BwB feature update out soon, as I know it is much overdue.
As always, I am grateful for your continued interest and support in this plugin. I will do my best to insure it lives up to those standards.
I'm not sure if this is only me, but I get an internal error whenever I accidentally try to save an unsigned book.
This isn't a severe error or anything, but it would look much nicer if you added a conditional to give a nicer message when saving unsigned books was attempted.
Any chance of this?
Thanks, and I love this plugin!
@DreamCastNetwork
Glad to be of assistance!
@AkiraAkiba
Cheers mate, thanks for the great support!
I have just submitted BwB v1.2.6 which improves and corrects Book_for_new_players functionality.
@DreamCastNetwork
Sorry for the difficulty BwB's given you, and thank you for pointing out something I missed in the last update.
I forgot to update the Book_for_new_players code to allow the use of list number instead of the actual title. I'm patching that as I type this, but for an immediate fix just change
Book_for_new_players: '1'
to
Book_for_new_players: 'The title of the book you want'
Also be sure that the book you are specifying is in the "BooksWithoutBorders\Books" folder, and not a player's sub-folder.
As for your second question, currently BwB only gives the new book to players that have not logged on to the server before, but I plan to change that so that BwB maintains its own list that the server admin can tweak as they see fit. I hope to also include that in the patch I am working on right now.
A somewhat current fix to that however, is to make sure the first time book's title ends with "[U]". Books titled in that fashion stay up to date with their corresponding text file. In that case as long as the player keeps track of the book, they will always have the new additions you make to it.
Thank you again for your patience and hopefully the patch will be up fairly soon. Please let me know if there is anything else you need assistance with.
And if you have a new starter book, do the old players get the book when the server join? or do they get a book just once?
I don't understand how my players will get a book, this is how i configured my config:
Options: Max_Number_of_Duplicates: 64 Title-Author_Separator: ',' Lore_line_separator: '' Book_for_new_players: '1' Message_for_new_players: ' ' Require_book_and_quill_to_create_book: false
And the new players aint getting a book ;( please help? or send me a private message so I can read this again? Thank you!
@monstercat101
No problem, glad to be of service!
@AkiraAkiba
Yes I was going to ask for this, tyvm!