BookManager Reloaded
This is a reboot of BookManager that has sadly been unmanaged since August and has at least one game breaking bug, this version has that fixed and adds some additional features such as the ability to spawn books in player's inventories the first time they join the server.
Below is the description for BookManager:
Have you written a book with the new book and quill, and realized that you needed to edit something after you signed it? This plugin is for you. If you need to edit the body of the book, you can unsign the book so that you can edit it and sign it again. Just need to rename it? There's also a one-command method in this plugin that allows you to rename books. You can copy a book, and you can require players to use up the materials that make a book and quill. You can also change the author of a book (want a book written by Herobrine or Notch?) and save books as .txt files on the server. Permissions is supported, and this plugin uses separate permissions for editing your own books vs other people's books.
Setup Very simple. All you need to do is put the jar in your plugins folder. That's it :)
Commands There are eight commands in this plugin:
/unsign
Unsigns the book that you are holding (the highlighted item in your hot bar)
/rnbook <name>
Renames the book that you are holding
/rnauth <name>
Changes the author name for the book that you are holding. Note: this changes ownership, so if you take a book from someone who can't edit other people's books and you change the author name, that player cannot edit that book anymore.
/copybook [amount]
Copies the held written book, taking away a book, ink sack, and a feather (unless they either have the "free" permission or are in Creative mode). You don't need to specify an amount when using this command if you only want one copy.
/savebook <save name>
Saves a book as .txt files. Each page is a numbered .txt file inside a folder by the name of the book. Saved books can be found in the folder plugins/BookManager. Also found in the folder is a file called conf.yml. See below for details.
/loadbook <save name>
Takes a saved (or edited or new) book from the plugin folder and turns it into a book in-game.
/deletebook <save name>
Deletes a saved book in the plugins folder
/listbooks
Lists all the books saved in the plugins folder
Saved Books
When you save a book, it makes a folder who's name is whatever you set the save's name to be. The folder can be found in your plugins/BookManager folder. Inside that folder should be a bunch of numbered .txt files. Each one represents a page in the book. You can edit these files directly if you want. Note: there is no error-detection for when you make a page too long. I actually don't know what will happen if you make the pages too long (most likely either cutting it off or a graphical error), so be careful how long you make the files.
In the folder is also a file called conf.yml. This is the configuration file in YAML format for the book. The settings are as follows:
title
The title of the book
author
The author name of the book
available
Whether or not the book is avaiable to everybody with bookmanager.loadbook permission
free
Whether or not players need to use up the materials for a book and quill to get the book
Permissions
There are eight main nodes (one for each command): ===
bookmanager.unsign
allows players to unsign their own books (defaults to everybody)
bookmanager.rnbook
allows players to rename their own books (defaults to everybody)
bookmanager.rnauth
allows players to change the author of books (defaults to OPs only)
bookmanager.copy
allows players to copy a book (defaults to everybody)
bookmanager.savebook
allows players to save book as .txt files on the server (defaults to OPs only)
bookmanager.loadbook
allows players to get books saved in the plugin folder as written books (defaults to everybody)
bookmanager.deletebook
allows players to delete saved books in the plugin folder (defaults OPs only)
bookmanager.listbooks
allows players to list all the saved books they have access to (defaults to everybody)
There are five sub nodes, all defaulting to OPs only:
bookmanager.unsign.other
allows players to unsign other player's books
bookmanager.rnbook.other
allows players to rename other player's books
bookmanager.copy.free
allows players to copy a book without using any materials
bookmanager.loadbook.all
allows players to access all saved books
bookmanager.laodbook.free
allows players to load books without using any materials
If you give a player one of these nodes, you don't need to give them the respective main node (for example, if a player has "bookmanager.unsign.other", that player does not need to be given the permission "bookmanager.unsign")
There are also three general permissions (for easier permissions control for admins):
bookmanager.none
removes all permissions from player for this plugin
bookmanager.default
allows player to edit their own books and make copies from materials
bookmanager.admin
allows player to edit any book and make copies for free
Great news, I found an fantastic way of storing books that should end all headaches with disappearing books from /listbooks.
I have finished the listing, saving and loading of books in the new save/load system, all I need to do for it to be finished is implement the remainder of features currently found in BookManager, such as being able to stop people from loading books they do not own etc.
The above should not take long though. Expect an update soon. :)
@Strelet12
Probably because you don't run a permissions manager.
Strange, I still get that "You don't have permission to change the author name of books" error, even though I am the OP and I actually don't use permissions (Since you know, friends-only server, not public)
Must I use permissions somehow?
Or is it because of being outdated, and I must wait for an update?
@devman45
Coming soon! I am looking to fix a few bugs at the same time. The biggest change is that the load/save system will go through a rewrite to reduce the amount of file pointers and clean everything up a little bit.
Update?!
@Ukaok
I will definitely take a look at this. I have never tried to use color codes in it before though, how did you do it? &color, or using §color?
Hey, I used to have colour codes in my title and my author name, but now I can't. I believe its because of 1.5, so I would really appreciate an update. Please help, I would like to get the colour codes in the title and author name working again! :)
Thanks
Great Plugin Really Love it for my server library. It cost $10 to rent a book for 1 day and its a 200 fine if they lose it. Players love it.
Confirmed working on CB 1.4.7 R1.0
@devman45
There is no need to. I am using this on 1.4.7 R1.0 myself.
Please update to 1.4.7 R1.0
@gvlfm78
Does it not work with 1.4.7 R1.0?
Could you update to bukkit 1.4.7 R1.0 ?
Could you please remove the /help entry of Bookmanager, as I disallow every features to be accessed directly.
@PackerbackrGJ85
Nope, book names has to be one word. That is a non problem, book titles can be anything though. If you need "spaces", do /savebook book_with_more_than_one_word.
I've noticed that you can put spaces in authors names now (Thanks!) does it not work for book names though?
I have confirmed the bug with /listbooks, it seems like the java method dir.listFiles() is having trouble finding all the files and directories.
In the screenshot that was sent to me, BookManager would find a lot of books but not all, when I got the same files and tested it on my development machine which happens to be running Windows (not sure if platform has anything to say yet), I noticed that it would only display the first three books.
Not entirely sure how to fix this yet as I've never seen anything like this before, as for now it seems like /listbooks is something you shouldn't rely on.
@PackerbackrGJ85
Answered.
I posted a ticket in the Tickets area linked above. But I was having an error loading the plugin (newest version, 1.2, with Cb 1.4.6 R0.3). If anybody else is having a similar issue and managed to find a fix, please let me know, thanks!
spot on! Thanks,