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 Jan 10, 2013I've searched without any info on how to link to the html pages on a Hosting Provider.
I entered the correct path "myserverip:port/plugins/ChestShop/website.html" and get an error:
My website is not hosted on my server, but in a totally different location, is there a way to add iframes that links to it? Like Dynmap.
-
View User Profile
-
Send Message
Posted Jan 10, 2013Nevermind - I read back and the found out how to fix the dupe bug - Thank you :)
-
View User Profile
-
Send Message
Posted Jan 10, 2013@Arsky
Happens the same to me, can't create shops, not even Admin Shops. Since I updated to 1.4.6 Using CS 3.50 t0041
-
View User Profile
-
Send Message
Posted Jan 10, 2013@typhoonwes Yes, but can you show me how exactly does it look like?
@InvisiCraftOfficial o.o
Hmm, that's really weird - mind creating a ticket for it?
-
View User Profile
-
Send Message
Posted Jan 10, 2013Acrobot, NONE of the protection enchanted armor works with /iteminfo! It says 311-2 etc for protection II, 311-9 for protection IX
-
View User Profile
-
Send Message
Posted Jan 9, 2013@Acrobot
Shop sign if typed correctly like it should be ant when you click "done" it just hangs on the wall. Just like a regular sign with all the basic text you always type to create a shop but without creating the actual shop.
Not a single error was given in the chat.
-
View User Profile
-
Send Message
Posted Jan 9, 2013@Acrobot
sorry.
They look like normal text signs It does not fall off.
No, We do not run offline mode.
-
View User Profile
-
Send Message
Posted Jan 9, 2013@typhoonwes Again, please define what "does not work" means. Does the sign fall off? How does your sign look like? Are you running an offline-mode server?
-
View User Profile
-
Send Message
Posted Jan 9, 2013@Acrobot
no errors shows up. it just does not work. All the shops that are there now are working, but no one can create any shops. Not even OP.
Permissions are set right..
-
View User Profile
-
Send Message
Posted Jan 9, 2013@zeshan321 Seriously...? It's repeated at least once per comment page, with the same outcome - just update your ChestShop.
-
View User Profile
-
Send Message
Posted Jan 9, 2013@zSwayz There is one already. SHOP_INTERACTION_INTERVAL in the config.
-
View User Profile
-
Send Message
Posted Jan 9, 2013Every once in a while i see out cpu spike up to 95% when players are buying from the admin shop. Is there a way to cap how many times they may hit a sign, and possibly add a cooldown for signs?
-
View User Profile
-
Send Message
Posted Jan 9, 2013@Scipione Yup. That's because there is a possibility that many items will be sold. Use event.getStock() and InventoryUtil.mergeSimilarStacks() to get your items :)
@InvisiCraftOfficial It's limited to Protection 9 because I had to create a system for encoding the enchantments on sign, and it looks like:
firstly we take all the enchantments and we encode them like:
XXYXXYXXY
where XX is the enchantment ID and Y - the level. As you can see, 9 is the highest level that can be encoded. Then, I convert it to base32.
I'll see what I can do about the pick.
@KittyHopHop Yup. When making a shop, just put some fake name on the first line of the sign.
@typhoonwes @Arsky What do you mean by "can't create shops"? Any messages in chat? Console?
@Sharkykzn Sure :D If you could PM me your server's ip, I'll try to get back to you on the server when I find time.
-
View User Profile
-
Send Message
Posted Jan 9, 2013@typhoonwes
Its the way you set it up
<username> =Line 1 <number of items> =Line 2 B 2:2 S =Line 3 <item.e.gDiamond> =Line 4
be careful the S should be after the amount your selling it for
-
View User Profile
-
Send Message
Posted Jan 9, 2013"Can someone help me. no one can create chest shops. The ones that has been place a while back works to buy and sell.. but no one can make any shops, Not Even OP. All permissions are set right.
I even reloaded the chest shop config file... but still nothing. Is there any other plugin that can cause it not to work???"
I am having same issue :(
-
View User Profile
-
Send Message
Posted Jan 9, 2013@Acrobot
Quote: "@Sharkykzn: Go Hmm... Weird, and what is your in-game name? BTW, sorry, I do not support offline-mode servers - if there's any problems with nicknames."
Server is online mode, and IGN is my registered premium account name. Some plugins may be messing with this. Have set up a online test server, running Spigot, v3.50 t0041 and most the plugins I have on live server, not all loaded yet, going through process of elimination, and your latest release is working under my IGN as Op. Will continue testing and get back to you.
-
View User Profile
-
Send Message
Posted Jan 8, 2013None of the protection enchantments on armor work.
-
View User Profile
-
Send Message
Posted Jan 8, 2013Can someone help me. no one can create chest shops. The ones that has been place a while back works to buy and sell.. but no one can make any shops, Not Even OP. All permissions are set right.
I even reloaded the chest shop config file... but still nothing. Is there any other plugin that can cause it not to work???
-
View User Profile
-
Send Message
Posted Jan 8, 2013Is there a way I can make Admin Shop but for chests, like if players buy alot of food I want it to run out so people need to sell food in the shop. :) Any ideas how to do this?
-
View User Profile
-
Send Message
Posted Jan 8, 2013Even protection 9 armor does NOT work with /itemid!