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!
I don't mind the plug, thought it was done in the silkiest of fashions! hahaha
I'm just going to keep filling the library until it crashes then, I'll let you know how far I get.
Had one error from it so far - http://pastebin.com/k1awHfz7
I think it was caused by trying to load a .txt file that was empty, maybe add something to catch the exception in an update?
Thanks, luigi
@luigi_vampa
Thank you for the additional feedback. I am currently planning on making the third line use the list number as you have suggested, as well as having the partial titles as they fit on the sign be matched up to the full title in the data folder. That should remedy the current sign difficulties.
Unfortunately, in regards to your second question, I have not performed tests at that volume of data. I do not foresee much issue with the individual books sizes, but I do imagine if a user tried to get a numbered list of the 3,000 books things might not end well. I will probably add a config option to set a limit on how large these numbered lists can be.
If I may, there is currently one solution I can offer that may help this issue. By first loading a single copy of a book with BwB, you could then use my other plugin Shelf-It's free-type or display-type bookshelves to dispense endless copies of said books. With the display-type bookshelves a sign is automatically created that displays the title and author of the contained book as well, for easy finding.
I hope these answers are helpful and I hope you don't mind my small but shameless plug for Shelf-It. I really think it might help.
Hello Akira, I've had the same issue as GrandRiver, all the file names are too long for the signs. Could it be possible to use the list number on the third line? Also, how big have you tried making the books? Do you think there would be an issue with large files? Like 'Lord of the Rings' sort of large? I'm making a library that has room for roughly 3,000 books and I'd like to fill it with proper novels. Do you think there'd be any performance issues with 3,000 books?
@GrandRiver
I'm sorry you've experienced some difficulty with the plugin. The third line does have to be the whole name of the file to work correctly. In a future update I will try to make it more accommodating in regards to the short length signs offer. For now, you could edit the name of the text file on the server to be shorter, even dropping the comma and author name completely.
I apologize for the inconvenience and thank you for your feedback. I really hadn't heard anything positive or negative on the sign implementation so it hadn't really been a project focus.
I'm somewhat puzzled as to how the signs work, since ShowCaseStandalone is currently having issues with Written Book shops I thought I'd use the BWB Signs to distribute Tutorial Books for the time being. From the signs page...
First line [BWB] Second line [GIVE] Third line "Text File Name"
It doesn't seem to matter what I type in the third line it always turns red and doesn't work. Furthermore the text file name length on any of our books with the author's name is too long to fit on a single line of a sign. Any insight? I'm at a loss.
@RedstoneCrafter
No problem. I hope you enjoy it.
@AkiraAkiba
Thank u
I have just uploaded BooksWithoutBorders v1.2.2 which, among other things, adds compatibility for 1.4.5 and 1.4.6 bukkit builds.
@RedstoneCrafter
Unfortunately no, but I am writing the update to make BooksWithoutBorders compatible for both 1.4.5 and 1.4.6 as I type this message. I hope to have it done fairly soon.
And this works whith 1.4.5?
@ursak
Thank you very much for the feedback and suggestion. I like the idea and will probably implement it in an upcoming update. I apologize in advance, as the next update will probably be a bit slow coming along, for a few reasons.
Due to some issues in spacial text formatting, as well as the lack of forced new pages and paragraphs, I am likely going to do a major rewrite of BwB's core code in the hopes of achieving a much higher quality experience all around.
I thank you again for your time and patience, and with any luck the next update will come sooner than later.
A command to send a player a book would be awesome.
If you add a command like "bwb load <book> <player>" that will load the specified book to the specified player inventory it would make this plugin so much better since it can then be used by Denizen to give players specifik books.
The reason I like to use it this way is to offer players different books from my citizens. A quest for instance could award the player a book with a diary from an explorer that would lead them to their next quest. Or to offer players a books explaining things like how to use the trader that they can by in the village on my server.
@MCwolski
Thank you for letting me know about this issue, I will look into it and see what I can do to remedy it.
@dorrax
This is not currently possible, but I like the idea, and it will more than likely be in the next release of this plugin. Thank you for your feedback and patience.
Sorry to ask incase I'm missing something basic, but can we give a book to a player when they join a server? To tell them rules and stuff?
Nice plugin!But...if the text is full of full-width characters,some pages will display abnormally.... like......this.....囧.....
@Nickbbeezy and @surrealdave
Currently what surrealdave has suggested is the best option. I am in the process of fine tuning the text import a bit more, and probably adding a new page character to force content to the next page manually in the next release. As always, thank you for your feedback.
@Nickbbeezy
In order to get books to export and re-import correctly, I've been using spaces (and taking advantage of word wrap) to get to the next line.
What's the best way to get line breaks?
@Torondork
Thank you for your feedback. I got your pm and am looking into it.
@AkiraAkiba
I would be happy to if I knew how AkiraAkiba. I didn't see a means for attaching a file within the "PM" section above, but I will look again. -T