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!
@G1Teanji
Works fine under Spigot 1.8 for me - everything but the sign feature. Maybe it's some plugin compatibility issue... you might try turning a few of them off to test it... do you have the latest protocollib and essentials from Spigot?
I'd love to see this updated to 1.8! It's the only book plugin that has everything I've been looking for (unlimited characters, colouring support and saving to file + editing from file). It just doesn't want to work with Spigot 1.8 right now :/
@AkiraAkiba
Hi there. Thank you for the detailed response.
First off, let me say that I may have expressed myself poorly in my first post. The only problem I had was with the "give" sign not working.
At this point, I am happily using BWB and simply avoided using the "give" sign. At first I tried using the new clickable sign in MC 1.8, but it insists in running the command as if the user were typing it in the command line, and so I could make the sign give a book to a specific player (by name), but not to any player (using @p).
Finally, I decided to use a command block, so now there's a button under a sign that says "click below to get the book", and that works just fine. I edit the book directly in the yml file and run a "bwb givepublic bookname @p" in the command block. Works like a charm.
I'm running 1.8, both Bukkit and Spigot. I always test everything under both systems and so far have been able to get everything I need to work under both, including BWB. If you download and compile Sipgot 1.8, it will easily generate both the Spigot and the Bukkit versions. I can send you the jar files, if you like.
Thank you once again for your reply. It'll be great if you get the sign to work, but it's not a showstopper.
best regards.
@AkiraAkiba
Hey, if you're interested in Bukkit 1.8 check this post out: http://www.spigotmc.org/threads/bukkit-craftbukkit-spigot-1-8.36598/
I can send the jar file to you if you need it.
@ebaldino
I'd like to begin by apologizing for the slow response. I've had a very heavy workload the past few months, and I allowed that to lead to a slump in my plugin upkeep. I very much appreciate your patience and continued interest in this plugin.
To start, I would like to address the contents of your edit, as I feel I have a better understanding of whats going on.
The first issue has come and gone through out the plugin's life, an inventory lag issue where new items don't appear in your inventory until some other inventory event happens and everything suddenly catches up. I will do my best to correct this issue, although it has proven in the past a very difficult defect to pin down.
The second issue arises from how minecraft handles inventories, and how that handling doesn't consider the books contents and some other factors. I will do my best to have this behavior corrected by the next update.
As for the contents of your original post, I feel like I may not be completely understanding the situation. I did my best to recreate the issue but I could not. I was able to create .txt files and immediately get them via give signs without ever having to save them in-game. If you could answer the following questions it would aid me immensely in troubleshooting this issue:
What version of bukkit are you running this on?
What are you putting on the id line, and what is the full name of the save file for the book you are trying to load?
When the sign is created and the last lines end up black, or when you try to get a book from the sign, are there any related errors or messages in the server console?
Unfortunately because of the copyright take down, I do not have access to bukkit versions newer than version 1.7.9-R0.1. If the issue stems from something that changed in bukkit since then, (which I feel is likely) then I am currently unable to correct it.
Concerning the loss in formatting when saving books to .txt file, that is a limitation of how minecraft books parse into text, and one of the major reasons I developed the .yaml book format. I would recommend using the .yaml format whenever possible, as it is more robust and does a much better job of respecting the authors formatting. If you have any questions about using the .yaml format, I would be glad to answer them.
I look forward to your response.
@Gyziie
EDIT: Actually, the problem persists. I click several times on the sign and it says "Received book" each time, but I get nothing. Then, if I issue just one "bwb give book myself", it will say "Book sent", then "Book received" and then it will give me all the copies for all the times I clicked on the sign.
Also, it doesn't seem to distinguish between books that have the same name in the public or private folders. If you get one of each, they will stack and be the same book in your inventory - even if the filenames are different.
Here's my original post, from a little while ago:
I know it's been 3 months since your question, but I just started using this plugin (takes some getting used to) and I was having the same problem... I was trying to "give" myself a book using a sign - it was a book I was writing (editing directly in the .txt file and using "load" to see it in the game.)
It refused to work until I used "bwb save" to save the book. Apparently the plugin treats saved books and the books you write directly in .txt as different things...
Also, take care not to overwrite the file you're writing, the saved file loses all the .txt formatting.
It would be nice if they treated all .txt book files as saved books....
@Gyziie I apologize for the slow reply, things have been a bit crazy on my end lately. I have a few questions before I can help you. Feel free to answer them here or pm the responses to me.
What plugins are you running besides BwB?
What are you putting on the id line, and what is the full name of the save file for the book you are trying to load?
When the sign is created and / or when you try to get a book from the sign, are there any related errors or messages in the server console?
Thank you for your patience! I look forward to your reply.
Hi - I really like this Plugin .. but...
I can't make the Give sign work.. :/
I use 1.3.3b and [BwB] is green, [Give] is blue, but the "ID-line" is black, and I can't make it give me the book!
I'm Op, but i tried give myself the perms anyways, but this didn't work..
Please help, I really need this for my server! <3
Hello Akira, thanks for your attempt to better BwB. However if it's too complicated, we can live with actual version. Its a big improvement yet imo.
@DrEngine
Thank you for the feedback.
The functionality you refer to was somewhat implemented in BwB's pre-.YML format days. Unfortunately it was, and is, a very complicated and messy business that was often not very accurate and really only works reliably if line breaks and other similar characters aren't used. I will however do my best to see if I can develop a better method.
Currently using the .yml format does allow you to add page breaks without other forms of spacing, but the page overflow problem persists. If you haven't already, I recommend looking here for tips.
I hope that information helps and, as I said above, I will do what I can to improve the process for BwB's next update. Wish me luck.
Hello Akira, thanks for deadly quick response. :-)
I have some ideas to improve your plugin: - keeping a book text source is very complicated; its necessary to use paragraphs to split text into pages and to check every page for overflow all the time; what about text without splitting into pages and do it automatically during text import ? do Minecraft know the lenght of book page ? it would hugely improve the preparing of books texts; - in that case we would only need one special character - page break to begin new chapter at new page;
@DrEngine
Thank you for bringing this to my attention. I have just submitted BwB v1.3.3b to correct this issue. It will be available for download as soon as the Bukkit team approves it.
hi, signs dont work. I put:
[BwB] [Give] manual,dre
onto sign and it doesnt work. BwB is green, Give is blue and file name is red. However I have the right file named manual,DrE.yml in ..\books directory. Whats wrong ?
@CommodoreAlpha
Currently copying is the only command the author check is hooked into, but I could definitely expand it to cover the commands you mention.
Sorry for the slow response, things have been a bit hecktick on my end lately.
As always, thank you for the valuable feedback and continued interest in this plugin.
Players can only unsign, setauthor, and settitle on books they've authored, correct? If not, then perhaps they should be able to do so, only if they've authored it. Wouldn't make sense (and then there's the possibility of plagiarism, even in Minecraft) if someone could change the author on a book they don't even own.
@BroderMibran
Of course I remember you, though I can hardly believe how long its actually been since then. I am very pleased to hear you enjoy what has been added to the plugin in the meantime, and I thank you for all the effort you brought forth to help make that possible.
If there are areas of the plugin that you feel could be improved or more robust, or if you have any other feedback at all, I would be pleased to hear them.
Hej AkiraAkiba
Do you recall me?
We spoke some months ago, about adding permissions, and perhaps even sub-permissions to your Plugin.
I have looked through your changes, and are pleased to see that you used some of my (and those who might suggested this also) ideas, . :-D
It is okay you didn't uses all of them, such as sub-permissions for additional groups. Just the fact, that you added single and group permissions, makes me very pleased. ;-)
So thank you so much, for adding this to your plugin.
...If I can be at any service, then I am still offering you, my help. ;-)
Regards Mibran. :-)
@wegazmc
Thank you for bringing this to my attention.
I will likely change the give commands so that they require the consent of the book recipient before the transaction is concluded, as some teleporting plugins do. I will also definitely add configurable limits to the number of books that can be stored in the public and the private directories.
Let me know if you have any additional questions or feedback, and once again, thank you for helping to make BwB a better plugin.
giving book can be abused. Lets make a command for blocking receiving books or make a command for sending requests for giving book.
and please make a limit for having saved books. It should get changed at config file.
I am definitely interested in adding a command to see others books, so I am very grateful for the suggestion.
As far as an approval process, I have a few questions. Would players need approval just for saving public directory books, or to their own directory as well? Could you explain the steps you see this process taking, from book creating to final approval?
I look forward to your reply.