BookShop
Players can publish their written books in a shop, so other players can buy the written books. There are two ways of creating a BookShop:
- When the player holds a book and quill item while hitting the sign, the text in the book is copied.
- When the player places some books in the chest beneath the sign, the plugin will duplicate the item in the chest every time it is sold. Thus nobody has to write books more than once.
Please note:
- AdminShops always duplicate the book!
It works the same way than a publisher: It copies the book in the chest and sells it to the player.
Features
- Publication of written books
- backup of books into a file
- Restoring books
- Give a default book to every new player
- Give a book to every player who joined the server before.
- Give a book to a player
- Statistics for every book (how often it was sold)
- Admins can impose taxes.
- Player can only publish written books.
- Admins can create AdminShops that always duplicate the book regardless of the settings in the config file.
Dependencies
- iConomy 5 or iConomy6 or Vault or Register
- PermissionsEX or bPermissions or GroupManager or BukkitPermissions
The shop
To create a shop, you have to place an empty chest first. Then you can create a sign with following content
Please note: Only ONE book per shop is allowed!
Line | Text |
---|---|
1 | [BookShop] |
2 | |
3 | The books name (automatically added after closing the chest with the book), but you can let it empty ;) |
4 | price of the book |
OR:
Line | Text |
---|---|
1 | [BookShop] |
2 | |
3 | The books name (automatically added after closing the chest with the book), but you can let it empty ;) |
4 | price of the book:price of the book if the player has a book and quill in the hand |
To create an AdminShop:
Line | Text |
---|---|
1 | [BookShop] |
2 | AdminShop |
3 | The books name (automatically added after closing the chest with the book), but you can let it empty ;) |
4 | price of the book |
To create a Newspaper shop:
Line | Text |
---|---|
1 | [BookShop] |
2 | Newspapers |
3 | The books name (automatically added after closing the chest with the book), but you can let it empty ;) |
4 | price of the newspapers |
With the newspaper shop you are able to sell several books at a time. E.g. a book with rules and a book with a plugin info. If the player hits the sign he receives the two books.
If you don't like the keywords on the sign, you can edit them in the Shopconfig.yml´file!
At the end it should look like this:
Permission nodes
Action | Permission node |
---|---|
Create a shop | BookShop.create |
Create a shop of an other player | BookShop.create.other |
Sell books of other players | BookShop.sell.other |
Create a Adminshop | BookShop.create.admin |
Use the shop | BookShop.use |
Destroy own shop | BookShop.create |
Destroy shop of someone else or AdminShop | BookShop.create.admin |
Message to admins that someone created a shop | BookShop.admin |
Command | Permission node | Explanation |
---|---|---|
/BookShop setwelcomebook | BookShop.setwelcomebook | Sets a book which has every new player in the inventory |
/BookShop removewelcomebook | BookShop.removewelcomebook | Unsets a book which has every new player in the inventory |
/BookShop giveall | BookShop.giveall | Gives a book to every player who joined the server before |
/BookShop give | BookShop.give | Gives a book to a player |
/BookShop backupbook | BookShop.backupbook | Backups a book |
/BookShop loadbook | BookShop.loadbook | Loads a book |
/BookShop reload | BookShop.reload | Reloads the plugin |
/BookShop debugfile | BookShop.debugfile | Turn the debugfile on and off |
/BookShop internet | BookShop.internet | Turns the internet access on and off |
/BookShop version | BookShop.version | Shows the current version of BookShop |
/BookShop update | BookShop.admin | Updates the plugin to the latest vesrsion on dev.bukkit.org |
/BookShop deletedebug | BookShop.admin | Deletes the debugfile to give you free space on the hdd |
/BookShop log | BookShop.admin | Returns the current size of the debugfile |
/BookShop toggle | BookShop.admin | Turns BookShop immediately off |
/BookShop language <language> | BookShop.admin | Select the ingame language (by default english) |
/BookShop help | BookShop.help | Returns all command which the player can execute |
/BookShop showdebug | BookShop.showdebug | Shows you console messages ingame |
First, I love this plugin. It does what is says and it seems to do it quite well. I am currently running it on 1.4.2.
My one suggestion is that there be the ability to "unsign" a book.
Thanks and keep up the AWESOME work!
i have an idea :D
How about instead of the sign just reading the chest below it like it currently does.
You link the sign to the chest by makin the sign first, then your are prompted to right-click the chest your wanting to link to it.
Kinda like the dltraders for citizens and their chests.
If you did it like that you could hide the chest somewhere so double chests can be used without worry.
@ibhh
Ah, so that's what the sneak part in the code did... Maybe mention this somewhere? At least on this page? :)
Btw:
Before: "I will sell you this book."
After: "I sold you this book."
@DrinQ
Sneak and hit a shop with the book and the plugin shows some details from the book, also how often it was selled.
But I like your idea to have a command. The player holds a book in the hand an execute /bookshop info.
Hey again :) I'm glad that you liked my suggestion.
I have another one. I was looking through your features and found "Statistics for every book". "Hmm.. where can I find this?" I asked myself.
So I looked through the code and found that an int called "selled" was saved to a text file for each book. This would be a good way of accessing it if every author on the server had access to this text file... Which they of course don't.
I think this would be extremely easy to add a command for, so I really hope that you'll consider doing it.
Maybe something like: /BookShop stats author "nameofthebook"
@Enrux
None. They are unused at the moment :)
What is their function?
TaskRepeat: 30
DelayTimeTask: 30
@DrinQ
Sounds good, I am going to think about this feature.
This is a really great plugin, we use it on our server and it works very well. I have a suggestion: Book summaries: The player gets a summary of the book in the chat, if supplied by the shop creator, when he/she right clicks the BookShop sign.
@arriej
You are not using Vault, right? That was a huge bug, fixed now ;)
Hello,
Since the new update i am having trouble with the permissions from the plugin. They have the bookshop.use permission but people still cannot buy books.
i am using CB 1.3.2-R2.0 bookshop: 3.3 and bpermissions.
Thanks
@omgitsmit
@Shadix64
@omgitsmit
Thank you for reporting this issiue. Bugfix is waiting for approvial.
@Shadix64
Do you have any Auto-kit or Starting items plugin? I have a feeling it may be over writing the book that the shop plugin is giving the new players.
@omgitsmit
Me neither. It'd be nice to have, but it's not working for me.
Is the setwelcomebook working for anyone? I can't seem to get it to give new players the starting book, even with GiveBookToNewPlayers: true in my congif.yml.
The hold-book-and-quill-to-buy system is somewhat vague in the post, and clunky in the server. It would make a lot more sense to have an original copy in the first slot of the chest, and empty books (just normal books, not written, not book and quill) in the chest. Once the books are gone, the shop is out of stock, and all the copies are gone.
@ibhh
What I was saying is that I don't like how you see the chest in front of the sign, I want the chest to be hidden from view, which is why I want the sign and chests to be linked. Also, there is a plugin called SignShop that has the same linking system that I mentioned, and more than 5 servers use that, so there shouldn't be an excuse that only 5 will use it.
Unless there is some way to link them, I didn't see anything about moving the chest in the tutorials.
@Oohoa
May I implement this, but this is only a extra feature. How often will that feature be used? At the end maybe five servers use this feature because there are some admins with a lot of time to read all the tutorials. ;)
Is there any plan to make this not require a chest to be under it, but somewhere else in the future? Like punch a chest with redstone and then the sign to link them together?
@k7iwon
I've seen your error reports. It seems to me that you've edited the config and added the korean language. Iam sorry but this config.yml supports only ASCI letters. So you load this book but the plugin cant display the success message :(
May you must choose english as language. Hope this statement helps. P.S.: When I read the error reports yesterday, I was shocked about this Null-exceptions. Therefore thanks for the message.