WelcomeBook
WelcomeBookRecoded v1.0
The complete plugin for all things Books!
This plugin adds a load of useful features for managing books and providing information to your users.
Usage
Simply place the WelcomeBookRecoded.jar file into your /plugins directory and start/reload your server. Then read the documentation on how to use this plugin.
Current Features
- Players can make regular BookShops
- Admins can make infinite BookShops that never run out of stock
- Export books and save them to their own configuration file
- Supports as many books as you like
- Give users books when they join for the first time
- Give users books when they join every time
- Get books with a commad
- Give others books with a command
- Create commands to easily obtain books
- Have a universal cooldown on getting books which saves after restart/reload
- Turn a written book back into its editable form
- Edit a written book's title
- Edit a written book's author
- And much more!
Planned Features
- None, please suggest below.
BookShops
BookShops adds player and admin run 'chest' shops that allow players to sell books for free or at a price. You need Vault and a Vault supported economy plugin for this feature to work. For a tutorial on how to create BookShops click here.
Commands & Permissions
Click here for the commands and permissions.
Configuration
Click here for the configuration.
Change Log
Click here for the change log.
Notices
The plugin has been COMPLETELY recoded in WelcomeBookRecoded v1.0. Pretty much EVERYTHING has changed, so make sure to understand the new plugin.
If you are using a plugin such as AuthMe you must make sure that if that plugin has an inventory protect feature you must disable it. In AuthMe it's the setting ProtectInventoryBeforeLogin in the config.
Source
Source can be viewed on GitHub.
Statistics
Support the Development
If you find this plugin useful then please support the development of it by donating.
Donations so far:
Plugin is working okay. I am still messing with it. But my [BookShop] unlimited won't work I put the sign up above the chest & it reads [BookShop] TToken (name exported book) 0 [Admin]
BookShop & admin are both in blue. I look in the chest & there is nothing in it. Help?
This plugin is working perfect, was looking for this for long time! Keep this up :D
The plugin occasionally doesn't start up correctly. Sometimes I have to manually reload the plugin for it to work.
Few questions:
Can i edit a book from a text file and import it to my server as a book, would be very cool.
Also, are color codes supported?
@YoFuzzy3
I've tried this, however, that did not work out. :)
@BleachFlame
You have the same problem as this.
Should fix it.
Been using this plugin for some time, and I quite like it!
However, when I export the book my players are supposed to spawn with, and I "import" it back, the "ยง" that I use to color the books are replaced with "?", if I try to change this in the config manually it leaves me with an error, that looks a bit like this:
01:28:47 [SEVERE] null org.bukkit.command.CommandException: Unhandled exception executing command 'book' in plugin WelcomeBook v3.7 at org.bukkit.command.PluginCommand.execute(PluginCommand.java:46) at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:187) at org.bukkit.craftbukkit.v1_5_R2.CraftServer.dispatchCommand(CraftServer.java:546) at net.minecraft.server.v1_5_R2.PlayerConnection.handleCommand(PlayerConnection.java:980) at net.minecraft.server.v1_5_R2.PlayerConnection.chat(PlayerConnection.java:896) at net.minecraft.server.v1_5_R2.PlayerConnection.a(PlayerConnection.java:841) at net.minecraft.server.v1_5_R2.Packet3Chat.handle(Packet3Chat.java:44) at org.spigotmc.netty.NettyNetworkManager.b(NettyNetworkManager.java:176) at net.minecraft.server.v1_5_R2.PlayerConnection.d(PlayerConnection.java:110) at net.minecraft.server.v1_5_R2.ServerConnection.b(SourceFile:35) at org.spigotmc.netty.NettyServerConnection.b(NettyServerConnection.java:66) at net.minecraft.server.v1_5_R2.MinecraftServer.r(MinecraftServer.java:580) at net.minecraft.server.v1_5_R2.DedicatedServer.r(DedicatedServer.java:229) at net.minecraft.server.v1_5_R2.MinecraftServer.q(MinecraftServer.java:469) at net.minecraft.server.v1_5_R2.MinecraftServer.run(MinecraftServer.java:401) at net.minecraft.server.v1_5_R2.ThreadServerApplication.run(SourceFile:573) Caused by: java.lang.NullPointerException at com.fuzzoland.WelcomeBook.CommandBook.onCommand(CommandBook.java:220) at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44) ... 15 more
Any ideas? :)
@Mre30
You can create Admin Book Shops which have infinite stock.
If you reckon there's a bug to do with it then please open a support ticket with as much information as possible.
How can I set it, to where player books are unlimited?
I mean.... shouldn't that be an option? I don't see it.
EDIT*
So.. if you fill the chest with the same book, and you buy one, it clears the whole chest. Why?
@ursak
I don't see any need for books to be in separate files.
As for the logbooks thing, I'm sure you could find other ways to do what you're after. You can already give books to players with a command, so you could use another plugin to record that on MySQL.
I love how easy to import/export the books it is with this plugin and that it actually keeps the books intact. Been trying quite a few plugins for just being able to export/import.
I do however note that all books are saved in the same file. Is there a chance you'll chnage that to saving each book as a separate file some day?
Atm I'm going to use this for rules and starters guide that players get at login since it works wonders but if you, or anyone else know, or find, a plugin that works as easy as this but let you save books in mysql I'd love to know about it.
I have an idea of filling the world with logbooks from adventurers long gone, histories of the world and just regular books that I would be able to add to the site as well so that on each players profile on the page you'd be able to see the name of all books they'd found.
But this is awesome for the login-part. :)
@DipDub
If you enable the 'CharFix' option in the configuration file it will make it so all '&' is replaced by 'ยง'. Just be wary that if you enable this setting you must re-export all your books.
Why do you want this anyway? You can just export books from in-game, where you can write colour using 'ยง'.
I <3 your plugin :D It works good. Mybe u can add it so &[colorcode] will be replaced by: ยง[colorcode] It might work without, but our host does not support it. To make it work for evryone simpely add this:
to your book text string or behind the string (list) / array where u get it out of the config (I think). Example:
@LEOcab
Glad you like the plugin! :)
I don't really see adding a cool down to bookshops a very good solution. Maybe I can come up with a solution so rather certain books can't be traded with villagers. :)
Hello! I love your plugin. Now I don't have to direct people to my website every time they ask a question, haha. I just tell them to /getbooks and read page X of the server guide. Very awesome. :D
I have one issue though: some clever people kept using /getbooks to feed free books to villagers and become rich in emeralds. I added a cooldown to fix this with /getbooks, but I had to remove all my free [Admin] bookshops for advanced books that don't really come in handy for brand new players. So, could you add a cooldown for books too? Perhaps just for free admin books to avoid this conflict with NPCs? Thanks bro! :)
I finally updated the documentation. :)
@YoFuzzy3
Thank you very much! It works now. =)
@Bethedagny
First write a book in-game, hold it in your hand, then export it with /Book export <name>. After that add the book you exported earlier with /Book config firstjoin add <name>. Finally make sure the FirstJoin setting is on, just type in /Book config firstjoin change true to make sure.
I love the plugin, it's great, but I can't figure out how to add a book to the books people get on first login. Is there a page that explains how to do this? Thank you. =)
Update has been approved! I'll update the documentation later today. :)