ChestShop (iConomyChestShop)

Table of Contents

Acrobot released his first Android game, would you mind giving it a go?

ChestShop

A simple, yet very powerful system for making physical shops using signs and chests.

It's never been that easy to create shops! With features like shop protection and anti-lag protection, you won't have to worry about your server's economy anymore!

"Just works"! ChestShop supports almost all economy plugins by using Vault!

(Versions above 3.9.2 also support economy plugins using the Reserve API)

Some known compatible and incompatible economy plugins.

Please check if there are newer development builds before reporting issues!

If you are upgrading from a previous version of ChestShop please make sure to always read the warnings in the file's changelog!

The plugin by default submits anonymous stats about your server (player count, plugin/server version and type) to a public statistics websites (mcstats.org and bstats.org) in order to provide the developers with usage information. If you wish to opt out, you can do so in the PluginMetrics/config.yml and bstats/config.yml files. It also features an auto-update feature, which can be turned off in the config.

Frequently Asked Questions
Permissions
User-made tutorials
Download the latest stable version
Download the latest development version
Download 1.12.2 version
Download 1.8.8 version
Download older versions
API for plugin developers
Source code on GitHub
Crowdin Localization Project
Thread on Bukkit forums
IRC chat (#chestshop on irc.esper.net)
Discord Channel Joining through that invite auto subscribes you to important update notifications, if you don't want that use this invite.
bStats metrics

Additional modules for ChestShop:

Using shops

It's easy! Just right-click the sign to buy, left-click to sell. (You can configure the buttons in the config file!)

How to create a shop

Player shop


Place a chest on the ground
Place a sign 1 block away from the chest (for example, above it)
On the sign, write:
Leave the first line empty. It will be automatically filled with your name by the plugin (if you have the permission ChestShop.admin then you can create shops with the names of other players)
Second line is the amount of items to buy or sell
Third line is a combination of buy and sell prices. You need to have a price indicator (like 'B' - price that will apply to items BOUGHT by PLAYERS - or 'S' - the SELL price) near the price - the prices are separated by a colon (:)	Some of the possible price combinations: "B 5:5 S", "B 5", "S free"
The forth line will hold the id/name of the item. Write ? on the sign and the item will be autofilled with the one from the chest or you can click on the sign with the item afterwards. Optionally you can put the actual name on it. You can find out the name of the item you're holding by doing /iteminfo
Resulting Shop
	A person can buy 64 diamonds for 10 dollars and sell them back for 5 dollars from Phoenix616

If you want you can also take a look at this video tutorial.

Admin Shop - shop with unlimited items

Firstly, you've got to be sure that you've the ChestShop.admin permission or that you are an OP. To make an Admin Shop, simply put "Admin Shop" (configurable in config.yml) on the first line of the sign when creating the shop. Admin Shops do not require a chest!

Translations

The latest builds include translations for many languages. They are shipped with the plugin. If you want to help out translating messages check out the ChestShop Crowdin project!

Commands

/iteminfo - Get information about the item in your hand
/iteminfo <id/name> - Get information about the item with the given id or name
/shopinfo - Get information about the looked-at shop
/csgive <itemcode> [<amount>] [<player>] - Give item with a unique ChestShop code to a player
/cstoggle - Toggle buy and sell notificiation messages
/chestshop version - Display the ChestShop version
/chestshop reload - Reload the ChestShop config and translation messages. (This might not reload some features)
/csaccess - Toggles ability to buy/sell on shops while having admin/access permissions and normally being ignored

Permission nodes

	Description
ChestShop.shop.*	shop creation and buying/selling - it contains:
	ChestShop.shop.create.*	create all types of shops
	ChestShop.shop.buy	buy any item from shop
	ChestShop.shop.sell	sell any item to shop
ChestShop.mod	open any shop chest
ChestShop.admin	open any shop chest, destroy stores, create (admin) shops

A full list of permission nodes

Configurations

Besides defining which shops a player can create via permission you can also configure almost any aspect about the plugin in the automatically generated yml files. The more general settings are in the config.yml (with explaining comments), setting minimum/maximum prices is done via the priceLimits.yml and setting up admin shop discounts is done via the discounts.yml.

Please make sure to look through the generated configurations and see if the default settings are to your liking and fit your setup! Some of them (e.g. the IGNORE_ACCESS_PERMS) might result in shops seemingly not work for you if you are op or are in the wrong WorldGuard region, check that before reporting an issue!

Useful tips by players

How not to get bankrupt	A customisable price table
	Alternative price table

Compatibility

ChestShop directly hooks into the following plugins to provide additional functionality:

AuthMe (and forks like AuthMe Reloaded)
WorldGuard
Residence
LWC (and forks like LWCX and Modern-LWC)
Lockette
LockettePro
Deadbolt
SimpleChestLock
OddItem
Heroes
ShowItem

Metrics

This resource sends metrics data to McStats and bStats. You can opt-out of metrics for all plugins on your server by changing the settings in the PluginMetrics/config.yml and the bStats/config.yml file if you don't want any data to be send.

More info

Even more information can be found in the old plugin thread on the forums.

Got an error or suggestion?

Simply submit a ticket here!

If you have a Github account and have coding knowledge you can also directly open an issue on Github. (You can also fund them via IssueHunt!)

If you just need general help feel free to ask in the comments or join the #chestshop channel on Spigot's IRC network (irc.spi.gt, webchat)

Has ChestShop helped you or your server?

If you want to thank the team in a more materialistic way, feel free to donate or buy Phoeni616 a beer! :)

A shout-out to Acrobot's friend:

We believe that the music he makes is really stunning - you can decide it for yourself!

His SoundCloud account

If you have an issue then please open a ticket on GitHub or post on SpigotMC.org for faster replies to questions!

Comments

_ForgeUser12670571
- Join Date: 11/23/2013
- Posts: 2
- Member Details
#4164 _ForgeUser12670571

View User Profile

Send Message

Posted Dec 13, 2013
Hi

i have installed the plugin but it is not working, i have a 1.7.2 server running craftbukkit, i have tried uninstalling it and re downloading the plugin but it still will not create a sign, i have not changed anything in the config file. what am i doing wrong?

Rollback Post to Revision RollBack
_ForgeUser12739597
- Join Date: 12/2/2013
- Posts: 3
- Member Details
#4163 _ForgeUser12739597

View User Profile

Send Message

Posted Dec 13, 2013
Hey everyone,

I just installed the plugin and it works, but my econmy runs on essentials but every time someone tries to buy something it says that they don't have enough money but they do? Any tips???

Many thanks,

Rollback Post to Revision RollBack
_ForgeUser8318808
- Join Date: 1/26/2012
- Posts: 488
- Member Details
#4162 _ForgeUser8318808

View User Profile

Send Message

Posted Dec 13, 2013
@MaximumBlock

And what if Acrobot can implement it? I would store diamonds in a chest and set the sell price extreme expensive as 1.000.000, so nobody would bye! So I would have my storage.

Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#4161 AcrobotPL

View User Profile

Send Message

Posted Dec 13, 2013
@ThePuppySlayer Ah, sorry, I misread that.

priceLimits.yml works like that: It's divided in 2 basic sections: min and max. In 'min', you'll be specifying the minimum prices and in 'max', you will be configuring the maximum prices of items.

Both 'min' and 'max' categories are divided in two sections - 'buy_price' and 'sell_price'. They are named after the prices on the sign ('buy_price' = 'B' on the sign, 'sell_price' = 'S').

Then, in the buy/sell_price sections you have a list of pairs 'itemID: max/min price'

For example, if there is something like

max: buy_price: '988': 3.51 sell_price: '978': 3.52 min: buy_price: '979': 1.03 sell_price: '989': 0.51

It means that: the MAXIMUM prices for items are as follows:

for item with ID 988 - the maximum buy price (so the maximum price a player can pay for the item) is 5.53
for item with ID 978 - the maximum sell price (the price for which a shop can accept an item from a player) is 3.52

And MINIMUM prices are:

for 979 - the minimum buy price is 1.03
for 989 - the minimum sell price is 0.51

Hope I explained it clearly - tell me if something's still unclear.

@MaximumBlock Hmm, I will be trying to implement that but currently, it would be extremely hard.
Last edited by AcrobotPL: Dec 13, 2013

Rollback Post to Revision RollBack
_ForgeUser10493527
- Join Date: 2/1/2013
- Posts: 8
- Member Details
#4160 _ForgeUser10493527

View User Profile

Send Message

Posted Dec 12, 2013
I'm running this on a faction server with no chest protection and people are using the chest shops to make protected chests and store their items in them. Would it be possible to add a feature that force-checks the item in the chest?

Say if it says Diamond in the sign, it'll only let them put diamonds in the chest and if they try to create a chest shop on a chest with a random array of things in it, it blocks it?

Regrads, Max

Last edited by _ForgeUser10493527: Dec 12, 2013

Rollback Post to Revision RollBack
_ForgeUser10650672
- Join Date: 2/28/2013
- Posts: 15
- Member Details
#4159 _ForgeUser10650672

View User Profile

Send Message

Posted Dec 12, 2013
I meant the price-limit.yml... How do i set that up?

Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#4158 AcrobotPL

View User Profile

Send Message

Posted Dec 12, 2013
@ThePuppySlayer Inside the plugins/ChestShop/ folder, there is a file named "discounts.yml". In it, you can assign how much discount each group receives.

For example, if you write:

builder: 70

this means that a person from the "builder" group will pay only 70% of the price while BUYING from an ADMIN SHOP (it does not work in other cases to prevent money frauds).

@Epicme772 To be completely honest, there is a way, however a very hackish one. You'd have to disable Vault from within the plugin's code.

Rollback Post to Revision RollBack
_ForgeUser12797297
- Join Date: 12/12/2013
- Posts: 5
- Member Details
#4157 _ForgeUser12797297

View User Profile

Send Message

Posted Dec 12, 2013
Darn...

Rollback Post to Revision RollBack
_ForgeUser10650672
- Join Date: 2/28/2013
- Posts: 15
- Member Details
#4156 _ForgeUser10650672

View User Profile

Send Message

Posted Dec 12, 2013
I cant figure out how to do price limits D: Please Help. I know theres a file for it but i need a guide on how the config works. Thanks :D

Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#4155 AcrobotPL

View User Profile

Send Message

Posted Dec 12, 2013
@santocraft1 No problem! :)

@stgram Glad to hear that! I still cannot provide any "real" support for 1.7.2 though until the first beta/recommended build is out... As you can probably suspect, all possible bugs at the moment emerge from the fact that 1.7.2 is not production-ready.

@Epicme772 Not really, sorry.

Rollback Post to Revision RollBack
_ForgeUser12797297
- Join Date: 12/12/2013
- Posts: 5
- Member Details
#4154 _ForgeUser12797297

View User Profile

Send Message

Posted Dec 11, 2013
Is there a way to override vault so chestshop can use the essentials economy even if vault is installed?

Rollback Post to Revision RollBack
_ForgeUser8831190
- Join Date: 5/1/2012
- Posts: 288
- Member Details
#4153 _ForgeUser8831190

View User Profile

Send Message

Posted Dec 11, 2013
@Acrobot

1.7.2 for a week, absolutely no problems with your plugin. (only the item frames above your signs :S)

Last edited by _ForgeUser8831190: Dec 11, 2013

Rollback Post to Revision RollBack
Santocraft
- Location: Colombia
- Join Date: 9/19/2013
- Posts: 29
- Member Details
#4152 Santocraft

View User Profile

Send Message

Posted Dec 11, 2013
Uhm, thanks, I was in creative xD sorry but Thanks!

Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#4151 AcrobotPL

View User Profile

Send Message

Posted Dec 10, 2013
@larsima Yes, it is because you are not using Vault. Since Essentials' api has changed, I no longer support it out-of-the-box. (Also, please update your ChestShop version)

Rollback Post to Revision RollBack
_ForgeUser8916293
- Join Date: 5/19/2012
- Posts: 42
- Member Details
#4150 _ForgeUser8916293

View User Profile

Send Message

Posted Dec 10, 2013
@Acrobot: This plugin has worked great in the past, but now it's faltering. When I try to sell something, it takes the item(s), but gives me know money. When I try to buy something, no matter what, it says I don't have enough money. I don't believe this is Essential's fault. I think something is going wrong between them. Is it that I don't have Vault? I've included a screenshot that consists of me selling something after checking my balance, and it not going up after checking it once I sell the item.

http://postimg.org/image/kbo66egxl/

Info://** Essentials version: 2.12.1 ChestShop version: 3.7.1 CraftBukkit build: Spigot-1172 (1.7.2) Console Output: 2:54:18 PM [INFO] [ChestShop] Build_and_Break sold 1 Grass for 1.00 to Server Shop at [world] 397, 66, -651 Economy Plugin: Essentials (Yes, it's set to that in the config.) Thanks, larsima

Last edited by _ForgeUser8916293: Dec 10, 2013

Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#4149 AcrobotPL

View User Profile

Send Message

Posted Dec 10, 2013
@KingSarkasmus87 Hey again. You don't have to point out the irony, it's blatant. "I can see where you're coming from" means "to understand one's point of view", I'm not here to insult you.

I understand that you spent a lot of time working on your server, however I cannot say what went wrong. If you were running CraftBukkit 1.6, everything would be working fine, as the error you've posted is the first I've seen like that. The message says that a SHOP was removed - and since ChestShop doesn't remove any signs by default, it must have meant that somebody removed a sign (there was a bug where all signs were recognised as ChestShops while removing them, however this didn't automatically destroy any of them, it has just shown the message).

You're free to use any plugin you choose - I'm glad that you chose this one. I cannot provide any support for unsupported CraftBukkit builds like the 1.7.x are, though.

@santocraft1 Unfortunately, I cannot really support 1.7 builds at the moment, as they are of low quality, since Minecraft has changed a lot. However, check if you are not in creative mode. If so, by default ChestShop blocks such people from buying from shops (you can change that in the config file).

Rollback Post to Revision RollBack
_ForgeUser11006174
- Join Date: 4/20/2013
- Posts: 73
- Member Details
#4148 _ForgeUser11006174

View User Profile

Send Message

Posted Dec 10, 2013
@Acrobot It's irrelevant whre i am from, you've understand whats my problem, despite my bad english. I spend a lot of time and work for our server and your plugin break my work in a couple of minutes....

Thanks for your comment..... (ironie again)

Rollback Post to Revision RollBack
Santocraft
- Location: Colombia
- Join Date: 9/19/2013
- Posts: 29
- Member Details
#4147 Santocraft

View User Profile

Send Message

Posted Dec 10, 2013
@Acrobot Yes, my hand is empty when I'm trying to buy, but when I try to buy something, doesn't appear nothing! As I said, is just a normal sign! And I tried to crate again the shop, but still not works, says me "shop created perfectly" but when I try to right click on it (no-op) doesn't appear nothing! Tell me if I must install an especified version of craftbukkit 1.7.2!

Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#4146 AcrobotPL

View User Profile

Send Message

Posted Dec 9, 2013
@KingSarkasmus87 Hey - I can see where you're coming from and I'm sorry for that, however you should have been aware that running dev builds of CraftBukkit may lead to unexpected outcomes, like the one you outlined.

Rollback Post to Revision RollBack
_ForgeUser11006174
- Join Date: 4/20/2013
- Posts: 73
- Member Details
#4145 _ForgeUser11006174

View User Profile

Send Message

Posted Dec 9, 2013
Since 1.7.2 this Plugin has a lot of problems with other Plugins that use signs (f.e. join signs or tp signs). Chestshop have all my Commandsings teleport signs break. Now i must write all 200 signs new. YAY

This massages are in my log file:

[ChestShop] A shop belonging to was removed - - - at (world) (coords)

THANKS A LOT (thats ironie)

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.