BookshelfGUI
BookshelfGUI
About
BookshelfGUI is a small plugin that consists of simply adding a GUI to bookcases to store books. As this is the first release there are not many features, however should you want more feel free to ask!
Currently a bookshelf with a GUI can be created on placement of a bookshelf of on usage of /bookshelf new (default). Bookshelves can be any number of rows, with 2 at the default, and finally you will be given the option to customize your GUI title! By default it will be Bookshelf however it can range to anything (Less than a set number of characters or the client will crash).
Config
################################################# # +-------------------------------------------+ # # | BookshelfGUI : Config.yml | # # +-------------------------------------------+ # ################################################# # +-------------------------------------------+ # # | Editing This File | # # | | # # | For full documentation about this | # # | config file visit the Bukkit Dev page for | # # | BookshelfGUI or visit the website @ | # # | http://www.skittles-server.net/ | # # +-------------------------------------------+ # ################################################# #This is the number of rows your bookshelves have #Note: It's advised to stay below 6. chestRows: 2 #Bookshelf titles, can include colors in the form #of & followed by a color code. guiTitle: 'Bookshelf' #If true all bookshelves will be turned into #containers, if false players must manually do #it with /bookshelf new. autoContainer: false ################################################# # +-------------------------------------------+ # # | So far that's all it is. Soon, after some | # # | more development there'll be more | # # | config options, so leave suggestions! | # # | | # # | Thank you for using BookshelfGUI! | # # +-------------------------------------------+ # #################################################
This is your default config, all the details on what each section does is inside your config that is auto generated.
Commands and Permissions
The only commands are currently:
- /bookshelf reload to reload the plugin.
- /bookshelf new to create a new bookshelf GUI if the autoContainer part of the config.
The permissions for the plugin are as such:
permissions: bookshelfgui.*: description: Allows access to the full plugin. children: bookshelfgui.all: true bookshelfgui.use: true bookshelfgui.use: description: Allows permission to open a new BookshelfGUI. default: true bookshelfgui.reload: description: Allows a player to reload the plugin. default: op bookshelfgui.all: description: Allows a player to store any item (not just books). default: op children: bookshelfgui.use: true
Note: Players will only have permission to place book related items in bookshelves if they do not have permission for bookshelfgui.all.
The process for preventing this is/can be buggy.
Creative Monitor
This plugin also supports CreativeMonitor, which is a plugin for stopping your creative players abusing their gamemode. If you have CreativeMonitor installed the plugin will automatically work with CreativeMonitor to prevent players from accessing their GUI in creative.
Example Server
Skittles Server, the server I run, is a server which currently runs all of my plugins. Feel free to join the server at any time to see the bookshelf GUI in action, as well as it working along side CreativeMonitor.
places .java here we continue to the plugin!
@Dunbaratu
Hi, Support for this plugin will be slow because we are in development of a much bigger plugin, I will try and push a update for this plugin to fix these issues
I've had problems with books people write on the server being deleted or the contents wiped out by plugins before so I decided to give this plugin a test on a test server before using it on the real server. I'm glad I did. There's a major danger in using this plugin. It will DELETE BOOKS IF THE SERVER CRASHES. I tested this by doing a "kill -9" on the linux server command line to simulate what happens when the minecraft server dies without the ability to shut itself down nicely.
I highly recommend that the plugin should take the code it normally uses when writing the contents of bookshelves.yml upon server shutdown, and make sure to also run it at frequent intervals when the server is up - once every few minutes. That way the bookshelves.yml file is always present and up to date from the most recent time that happened. At the very least it shouldn't be DELETING the file upon loading the server, so that at least things revert to where they were when the server was last run, rather than deleting every book ever stored on a shelf (which is what it does now).
And of course it would be even better if the write that happens every few minutes was an atomic write such that it can't die halfway through writing the file (i.e. write to a temp filename and then rename that to the right name when the writing is done.)
This is an awesome plugin but unless something like that is done with it I just can't trust putting it on my server and I had to de-install it. I don't want to have to field complaints from users who lost all their work. I don't mean to be abusive in this comment. I hope the change I suggest would be simple and easy and not sound too demanding.
Hihi, First i want to say this is an amazing plugin. It has made our bookshelves way more useful than as just decorations and for enchanting tables....just a question...i am wondering if this is working in 1.6.2...i mean it did in 1.6.1 and that was awesome but now after i updated my bookshelves seem to be back to bookshelves again....meaning i cannot right click, left-click, shift click...nothing works T_T... if its not updated for 1.6.2 then i understand and will wait patiently...if it is working in 1.6.2 could you maybe help me figure out what i have done wrong ^_^
The permission bookshelfgui.all doesn't seem to work for me. using PermissionsBukkit is this right?
bookshelfgui.all: true
The VIP rank can only place book related items. http://pastebin.com/tbpmp66n
Could you add a list in the config for what items are allowed to be put in the chest? I'd like to put maps in there. Thanks for the plugin, nice work.
@LightningSh0ck
Doesn't allow for a customization in the number of rows, which is what I prefer about the chests.
How about using a dipenser GUI istead of chest
@Incompy
You just need to code a GUI
How did you get a custom GUI? I thought Bukkit API didn't support it.
This is a great plugin for RPG servers.
Kinda surprised that this isn't more popular, although 58 downloads is still pretty good.
@ScurvyCraft
Just added a feature that drops a bookshelf's inventory into the player's inventory when broken. Thanks for the suggestion.
If you (or someone) breaks the bookshelf, all of its contents are lost.