BookShelf

Logo_Glow

BookShelf

Current Version:
3.5 (Release)

Important Notice

As a result of recent events in the Bukkit community regarding copyright infringement, Bukkit ownership, and other dilemmas, development on BookShelf is currently on hiatus. Mojang is expected to release a new Plugin API ("Workbench") in which I will rewrite BookShelf to take advantage of. Your shelf contents WILL be compatible with the new plugin. They WILL NOT get erased! (As long as you hang onto your Shelves.db file)

I cannot give an ETA for development continuation.

Until then,

- Pew446

What is it for?

This plugin allows players to store books, maps, and more into those once useless bookshelves - just like chests! It encourages players to write books and store them in shelves, and can build onto your economy with libraries and bookstores by using the built in Vault support. Unlimited bookshelves make rule walls a thing of the past; store rule books inside an unlimited shelf, and every player can have one! Book Shelves are opened like a chest, by right clicking on the shelf. This opens a chest-like inventory that only allows the storage of books, maps, records, and paper. The items are stored in an SQLite database, so no setup is required to use this plugin! MySQL support is optional. These are just a few of the many features of BookShelf.

What are the Features?

  • Store books, maps, records (music discs), and paper in bookshelves!
  • Right click on shelves to open a familiar chest-like inventory!
  • Configurable top/bottom access. Disable it, and hide the shelves in your floor!
  • Create unlimited shelves that give out infinite copies! - Great for rule books, libraries, newspapers, city maps, and more!
  • Create shop shelves that work with any Economy! (Using Vault)
  • Combine unlimited and shop shelves to create a shop that has unlimited copies! - Great for server stores!
  • Create a donation shelf type that allows the owner to add/remove books, while other players can only add books! Good for library submissions!
  • You can only store books, maps, paper, and records.
  • Items maintain their position in the shelf; none of that "auto-sorting" business.
  • Runs on SQLite - No setup!
  • Can be configured to use MySQL instead of SQLite!!
  • Configurable shelf sizes! (Rows of 9, Max 6 rows)
  • Configurable default shelf names!
  • Each shelf can be individually named - Great for naming library sections!
  • Configure what types of books can be put into shelves!
  • When the shelf is broken, books drop like a chest - nothing is lost!
  • Reloading does not break the plugin!!
  • Support for LWC!
  • Support for Towny!
  • Support for WorldEdit!
  • Support for WorldGuard!
  • Simple Permissions!
  • Easy-to-remember Commands!
  • Signs can be placed on shelves!
  • Enable/disable certain shelves, all shelves with the same name, or Enable/Disable all shelves by default!
  • Multiple players can access the same shelf at the same time!
  • Disable selling books/paper to villagers!
  • Allow books/maps/paper/etc to only be stored in shelves! (No chests!)
  • Shelves have ownership!! Ops are owners of every shelf.

Videos!

Check out other videos by bizburns01 (Luigi_Vampa)!

Usage and FAQ

Click here to learn about the Config, Permissions, Commands, Economy, and read the FAQ!

Parlez-vous français?

Cliquez ici! (Merci, nefald!)

Forums

Need help? Want to give a suggestion? Report a bug? Testimonials? Have a server running BookShelf?
Check out the Forums!

Get Support

There are many ways to get support:

  • Post a ticket - I try to respond quickly to these.
  • Post a comment
  • Post on the Forums
  • PM me!
  • If it's urgent, email me at: mitcht (at) aptitekk (dot) com - Make sure I know you are asking about this plugin! :)

I'm happy to help! Don't be afraid.

Last notes

Thanks to Deathmarine for his awesomeness and code samples he let me learn off of!

Thanks to all the awesome people who made videos about BookShelf!

Thanks to lvk and softvelvet for the donations!

Please, leave suggestions and comments! If you find a bug please tell me! Thanks! :)

Git Source Code: https://bitbucket.org/Pew446/bookshelf

Please remember, if you use/modify my code you must also give this freedom to your users. Read up on GPLv2 before claiming my code as yours.

Need a plugin created for you? I'm on Fiverr!

Please Donate if my plugin has helped you out. Thanks! :)

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Hmmcrunchy Hmmcrunchy Sep 23, 2014 at 10:34 UTC - 0 likes

    @Pew446: Go

    hope you manage to port it over ok its a great plugin :)

    Join us at www.byte.org.uk

  • Avatar of NickDaKing NickDaKing Sep 11, 2014 at 21:51 UTC - 0 likes

    @Pew446: Go

    The only way you can improve the plugin is to rewrite it. Sorry :) But I wrote a book-plugin too. I sent you a PM.

    Last edited Sep 11, 2014 by NickDaKing

    BFAK:NickDaKing,56265,958dee72825df13db942d64efab6c43fb1a2268bb6a6bb37d6549db94b77678c

  • Avatar of Pew446 Pew446 Sep 11, 2014 at 21:15 UTC - 1 like

    @NickDaKing: Go

    I appreciate your concern for this plugin, and I realize that the code may seem messy. I wrote the majority of this plugin when I was still a beginner with Java, and it was mainly a learning experience which happened to find the interests of 28,000+ people. I am completely self taught and have had no guidance, so I am slowly learning new Java concepts which I can apply to this plugin. Unfortunately, due to the Bukkit DMCA, I will not be working on this plugin until further notice. I did plan to do a major rewrite of this plugin, part of which meant incorporating Prepared Statements to avoid SQL Injections (Which have never been a problem in this plugin, but I see how it may be one), but with much of the community falling apart it does not seem worthwhile to keep working on this plugin. Once Mojang releases an official Modding API, I will rewrite BookShelf to take advantage of it, while still being compatible with data from this plugin. I may also make a Forge plugin in the future. I am open to suggestions on what I can improve.

    BFAK:Pew446,90690606,a4668217b2c81de4503e2a500f57c77f16cdbaf2115b841e1898bd6b1007850b

  • Avatar of NickDaKing NickDaKing Sep 11, 2014 at 19:43 UTC - 0 likes

    I don't recommend you to use this plugin in non development enviroments. The code is very messy, in case very bad performance, no security checks (SQL injection greetings).

  • Avatar of felixlechat62 felixlechat62 Aug 31, 2014 at 17:58 UTC - 0 likes

    your next version 3.6 do you upgrade performance ?

  • Avatar of dilbukon dilbukon Jul 24, 2014 at 14:52 UTC - 0 likes

    I think this plugin is canceling the right-click event on bookshelves too quick if the bookshelf is not toggled on. Players are trying to place block around it, but it reverts back.

    Can you fix this by making it so that if it's a right-click event with items trying to be placed, it lets it through?

  • Avatar of dandanmoshiman13 dandanmoshiman13 Jul 20, 2014 at 17:51 UTC - 0 likes

    Do I have to use a money plugin if I'm going to use the plugin for the storing and unlimited books functions, not the shopping function?

  • Avatar of Toxicterror1991 Toxicterror1991 Jul 14, 2014 at 01:47 UTC - 0 likes

    @felixlechat62: Go yes this plugin works with towny. using it on my server too.

    Last edited Jul 14, 2014 by Toxicterror1991
  • Avatar of felixlechat62 felixlechat62 Jul 07, 2014 at 16:27 UTC - 0 likes

    hey gays, i speak french.

    J'aimerai avoir plus d'informations sur ce plugin concernant les option du support towny, j'utilise towny et j'aimerai savoir qu'elle avantage je pourrai avoir dans la configuration et l'utilisation du plugin bookshelf

    merci d'avance

  • Avatar of LeQuebecoisRiche LeQuebecoisRiche Jul 05, 2014 at 23:07 UTC - 0 likes

    Hey guys im using worldguard and i have 1 bug error ....

    You are not allowed to open BookShelves here!

    allow-chest ... tested allow-shop ... tested use allow ... tested

    /bsreload ... tested

    You are not allowed to open BookShelves here!

    Sorry for my english

Facts

Date created
Aug 07, 2012
Categories
Last update
Apr 18, 2014
Development stage
Release
License
GNU General Public License version 2 (GPLv2)
Curse link
BookShelf
Downloads
29,147
Recent files

Authors