ChestShop (iConomyChestShop)
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:
ChestShop LegacyIds - allows usage of numeric and old pre 1.13 string IDs on signs
Notification module - to use with Notifications plugin (outdated)
Towny module - to use with Towny plugin
ChestShop Notifier - records all sales, even when the player is offline (Maintained by Phoenix616)
ChestShopTools - Enchantment info signs and empty shop notifier (Maintained by Phoenix616)
Adda - Item display icons above the chest, transaction limit, Discord alerts, per-player shop limit! (User-made)
ChestIcon - Icons for Chests, just like the Showcase plugin! (User-made, broken on newer versions)
Libelula Auto Shop - easy creation of admin shops, using Essentials (User-made)
ChestShopLimiter+ - limits the number of shops per player (User-made, abandoned)
ChestShopListing - Stores shops and transactions in SQL; adds related features including in-game search (User-made)
ChestShopConfirmation - confirmation screen before buying (User-made)
SearchChestShop - search for shops selling certain items (User-made)
BoltChestShop - Add support for Bolt container protections (Made by the Bolt author)
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
- /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
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!
If you have an issue then please open a ticket on GitHub or post on SpigotMC.org for faster replies to questions!


-
View User Profile
-
Send Message
Posted Sep 3, 2012I'm sorry but I can't figure out how to fix this.
[ChestShop] You lack the necessary HTML files in your plugins/ChestShop/HTML folder!
I want to have the HTML display but how do I make it work?
-
View User Profile
-
Send Message
Posted Sep 3, 2012Hi, I've just downloaded this plug-in.
It seems to work fine, but I'm able to reproduce an error.
If I put a SIGN (everywhere) and I wrote into it:
first line empty
second line: x (random text)
third line empty
fouth line: --> (it's a right arrow, minus minus greather than)
My server console returns this message:
02:57:43 [SEVERE] Could not pass event SignChangeEvent to ChestShop
org.bukkit.event.EventException
at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.ja
va:332)
at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.jav
a:62)
at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.j
ava:477)
at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.j
ava:462)
at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:1300)
at net.minecraft.server.Packet130UpdateSign.handle(SourceFile:46)
at net.minecraft.server.NetworkManager.b(NetworkManager.java:276)
at net.minecraft.server.NetServerHandler.d(NetServerHandler.java:109)
at net.minecraft.server.ServerConnection.b(SourceFile:35)
at net.minecraft.server.DedicatedServerConnection.b(SourceFile:30)
at net.minecraft.server.MinecraftServer.q(MinecraftServer.java:581)
at net.minecraft.server.DedicatedServer.q(DedicatedServer.java:212)
at net.minecraft.server.MinecraftServer.p(MinecraftServer.java:474)
at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:406)
at net.minecraft.server.ThreadServerApplication.run(SourceFile:539)
Caused by: java.lang.NumberFormatException For input string: ""
at java.lang.NumberFormatException.forInputString(Unknown Source)
at java.lang.Long.parseLong(Unknown Source)
at com.Acrobot.Breeze.Utils.MaterialUtil$Enchantment.getEnchantments(Mat
erialUtil.java:246
at com.Acrobot.Breeze.Utils.MaterialUtil.getEnchantments(MaterialUtil.ja
va:229)
at com.Acrobot.Breeze.Utils.MaterialUtil.getItem(MaterialUtil.java:182)
at com.Acrobot.ChestShop.Listeners.Block.SignChange.onSignChange(SignCha
nge.java:43
at sun.reflect.GeneratedMethodAccessor50.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.ja
va:330)
... 14 more
Is this a known bug?
-
View User Profile
-
Send Message
Posted Sep 3, 2012@phliptrip
The first # is what you are selling for, the second # is what people can sell it back to you for. eg. 250:50
-
View User Profile
-
Send Message
Posted Sep 3, 2012Well, i can not seem to buy or sell any thing from chest shop. Whenever i try to buy or sell, it says, "You can not buy here!" and same but with sell for selling!
-
View User Profile
-
Send Message
Posted Sep 2, 2012@strontkever
Doesn't work... yields a sign that says B 0:0 S and won't allow people to buy. If I make the sign 1:1 or something it works fine, but not 0.
-
View User Profile
-
Send Message
Posted Sep 2, 2012@phliptrip
use this format when creating your shop:
Admin Shop
64
0:0
Stone
must work
-
View User Profile
-
Send Message
Posted Sep 2, 2012Anyway i could have the chests sell writtenbooks that have custom text?
-
View User Profile
-
Send Message
Posted Sep 2, 2012A cool addition to this plugin now with the item frames would be if chest shop places a sign above the selling sign if there was room with the frame and the item being sold in it.
if this got added into the plugin then it would make my server
-
View User Profile
-
Send Message
Posted Sep 1, 2012Ok... Using PEX, ChestShop... here's the configs, no one can buy.
config.yml
http://pastebin.com/HkZWXEnz
permissions.yml
http://pastebin.com/LE1EwgTa
00:04:12 [INFO] Plugins (22): EconXP, Craftipedia, WorldEdit, CoreProtect, AutoGamemode, Vault, N3W_TheEndAgain, PermissionsEx, Modifyworld, AutoSaveWorld, CommandLogger, LWC, MobArena, TreeAssist, WorldGuard, MagicalSpells, dynmap, Dynmap-WorldGuard, WorldBorder, ChatManager, ChestShop, AdminCmd
Craftbukkit RB 1.3.1-R2.0
ChestShop 3.46
PEX 1.19.3
Setup shop as:
Admin Shop
64
B 0:0 S
Stone
It responds- "[Shop] Shop Successfully Created!"
When anyone right clicks or left clicks on it they get the message
"[Shop] You can't buy here!" (or sell if thats what the click would do)
No errors on console, no issues otherwise. No warnings on boot, etc. I tried wiping entire directory and re-setting up... no go. This isn't in a wg region.
-
View User Profile
-
Send Message
Posted Sep 1, 2012@erickingsr
dumbed down version: http://pastie.org/4647488
what would permissions have to do with this? would a permission allow someone to sell to a buy-only shop?
-
View User Profile
-
Send Message
Posted Sep 1, 2012@tentonaxe
Can you please post your permissions file in a pastie?
pastie.org
^ there....
Thanks, Eric
http://ckmgaming.net
-
View User Profile
-
Send Message
Posted Sep 1, 2012Now players are able to sell to my buy only shops. Help?
Shop example:
_ _ _ _ _ _
<empty>
1
B 5
Bucket
_ _ _ _ _ _
it lets them buy and sell buckets for 5 instead of just buy
-
View User Profile
-
Send Message
Posted Sep 1, 2012@Netcraazzy
This sounds like a simple world permissions issue. Verify in your permissions that the nodes are setup correctly for the various worlds...in other words, make sure the permissions you want are working and the ones you don't are negated properly. If you want, send me your permissions and I can help you solve this.
Thanks, Eric
http://ckmgaming.net
-
View User Profile
-
Send Message
Posted Sep 1, 2012@iMineing
Yes, it is possible to turn off those messages... \plugins\ChestShop\config.yml
Open the config.yml with a text editor (I recommend Notepad + +)... then scroll down until you find the below lines. Change them to your desire and save! You will need a server restart for the changes to take effect. (Do NOT do a /reload on your server! Highly NOT recommended :))
I personally like to turn off the Console Spam as well.... again in the config.yml just scroll down until you see:
Set it to false and you'll get no more spam in console! Isn't @Acrobot great for adding in all these features?
Thanks, Eric
http://ckmgaming.net
-
View User Profile
-
Send Message
Posted Sep 1, 2012@PunJedi
@Acrobot:
It is simple to disable the creation of shops for any particular group using PEX. I've tested and confirmed working with latest versions of:
NOTE: PEX is case-sensitive... I'm stating this because you used chestshop.shop.create in your original post complaining on this 'bug'. Also, it helps plugin developers if you post perms/logs when having issues with their plugins. It makes it much easier to assist you.
Thanks, Eric
http://ckmgaming.net
-
View User Profile
-
Send Message
Posted Sep 1, 2012Serious bug was a false alarm, deleting my chestshop folder fixed it. You may want to include that on your download page or something, it's a pretty big issue, lol.
-
View User Profile
-
Send Message
Posted Aug 31, 2012I'm sorry but I can't figure out how to fix this.
[ChestShop] You lack the necessary HTML files in your plugins/ChestShop/HTML folder!
I want to have the HTML display but how do I make it work?
-
View User Profile
-
Send Message
Posted Aug 31, 2012Is there a way I can make it so I don't recieve a notification everytime someone sells or buys to me? Cause I have the public shop signs with all my names on it and everytime someone does sell something or buy something I get spammed with <Name> has bought <Item/Block> from you for <Money>$
-
View User Profile
-
Send Message
Posted Aug 31, 2012@ihasamoose
The WG region flag issue was what I thought it was at first too. I did a test where I created a chest shop out in the wild where there are no WG regions with the same result. I'm guessing it's some sort of plugin conflict but I can't figure out what plugin would cause such a bug. My first guess is Towny as I continue to struggle with its crazy built-in protection system but after going through config files several times I can't find anything that stands out as causing this issue.
Here is a list of my current plugins, all are at latest release version unless stated: Announcer AntiXRay Buycraft ChestShop Citizens Essentials (main) Essentials (spawn) iConomy (v5.01) Lockette LogBlock MCFVote4Items* (custom votifier listener plugin) Minebackup MobArena MobBountyReloaded Multiverse-Core Multiverse-Inventories Multiverse-SIgnportals NoCheatPlus PermissionsEX Rankmarket SimpleRegionMarket (New non-Zorro managed one) SimpleSpleef (Evolution branch) Towny Advanced Towny Chat Votifier Worldedit WorldGuard XrayInformer Questioner
Anybody's insight on this would be appreciated. Been using ChestShop for ages, would hate to have to convert to Essentials shop signs over this dumb bug.
-
View User Profile
-
Send Message
Posted Aug 31, 2012@Acrobot
@ihasamoose
Serious bug, i don't know if its you guys vault or my economy plugin, but after ugprading the the beta version of chest shop as suggested by ihasamoose, players were able to buy things that they didnt have money for regardless of whether or not the chest shop even had anything in it.
For example, a diamond chest shop. It's empty and the player doesn't have any money. When he right clicks on the shop, he gets a diamond and can do it over and over. I'm using Vault and IConomy. Should i look to replace iconomy?
Edit: Heck, why do i even have iconomy? doesn't essentials have economy built-in?
Edit: confirmed it's not iconomy, disabling iconomy doesn't fix it.