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 Feb 3, 2013@zodanemir Hey - hmm, well, are you sure you do have the proper item? Also, which item are you testing it on?
-
View User Profile
-
Send Message
Posted Feb 3, 2013@Acrobot
Hey
Thanks for the quick update, i tried the older version. It now allows me to buy items, (numbercount shown on selecting it and dropping it again in your slot). When trying to sell though, it now says i don't have any items to sell.
-
View User Profile
-
Send Message
Posted Feb 3, 2013@ShadowKillerx The option is only used if you're not using Vault, and it's when some people had multiple economy plugins.
@Siickest Ok :)
@meiamsome Awesome! Actually, the release version should allow selling books by default, but this seems fine too! :D
@forster82 Well, you receive money when you sell something through ChestShop?
@zodanemir Unfortunately, that's an issue with Tekkit - it uses an old CraftBukkit build, which has a bug in it :C
I have no idea which CB build it might be based on, but probably using ChestShop 3.46 would fix your error.
-
View User Profile
-
Send Message
Posted Feb 3, 2013Hi there,
I have my own server up and running since 2 days now and i am trying to setup shops for more cashflow to use towny. I tried different shop plugins but this one appealed the most. Unfortunatly, despite the fact that all permissions are working and shops can be setup. Buying or selling items takes money from you or gives it to you without removing any items from your inventory (or adding to it). I tried this with different basic items like stone, cobblestone, dirt... all the same issue. I am using Tekkit Lite 0.5.7. with the server running on Forgemod with bukkitforge in coremods. The version of Chestshop i am using is v3.50 t0041, other plugins installed are: - Essentials - Vault - Worldguard - Worldedit - Permissions - Towny - Bukkitcompat
All are running the latest versions. I hope you can help me.
Thanks ahead!
-
View User Profile
-
Send Message
Posted Feb 3, 2013The plugin and everything works i installed vault i got essentials but how do i receive money
-
View User Profile
-
Send Message
Posted Feb 3, 2013Used the nice API to make ChestShops work for written books in my plugin! Check it out: PrintingPress
-
View User Profile
-
Send Message
Posted Feb 3, 2013I downloaded the latest !! And I have 3000 dollars and Im gonna buy a steak for 16 dollars but I can¨t?! What is the problem..
It just says. You don't have enough money!
You can sell the items that says on the Admin shop but you can't buy em why?!
EDIT: My Vault plugin had on some weird way got deleted and thats why they could not buy. Problem fixed
-
View User Profile
-
Send Message
Posted Feb 3, 2013Btw. What is the differece when im ussing:
PREFERRED_ECONOMY_PLUGIN: "iConomy"
or
PREFERRED_ECONOMY_PLUGIN: ""
I know that second option will use Vault to works, but what is the difference?
Optimization or something?
-
View User Profile
-
Send Message
Posted Feb 2, 2013@Acrobot: Thank you. It worked.
-
View User Profile
-
Send Message
Posted Feb 2, 2013@alexmarkey Yup, it fixes it.
@seryon Well, you've got to write the "Admin Shop" in the first line yourself. The fact that you're an admin doesn't mean you can't have a personal shop!
When you'll put "Admin Shop" (or whatever you configured) as the first sign line, you'll find that you don't need a chest anymore.
-
View User Profile
-
Send Message
Posted Feb 2, 2013Previous problem solved.. seems like the server doesn't like \chestshop reload.. it has to be stopped for changes to take "real" effect.
Now i have a persistent but not critical problem. Even when i'm opped, with all permissions, chestshop seems not to recognize me as an admin. It doesn't write the "Admin_Shop_Name", but my own name, and shop with no chest doesn't work: "Couldn't find a chest!"
-
View User Profile
-
Send Message
Posted Feb 2, 2013@Acrobot
Does that dev build have my fix in it? where they could make chest shops in places where not permitted?
-
View User Profile
-
Send Message
Posted Feb 2, 2013@Acrobot
So the taxes for the plugin isn't like real world taxes where if you buy something for 100, they you actually pay 107, if it is 7%, and that 7% just goes away and the same for selling, where you get 7% less and so on? Or, is it where they bought something for 100 and then 7 is created and goes into whatever account you assign?
-
View User Profile
-
Send Message
Posted Feb 2, 2013Hi,
I made towny/worldguard integration false, gave ChestShop.shop.* permissions to everyone and even tho no one, besides the admin, can create a shop... am i missing something?
Message: "You can't create a shop here!" Using ChestShop v3.46
-
View User Profile
-
Send Message
Posted Feb 2, 2013@flaremonk1 If you're using the test versions - yeah.
@ShadowKillerx :)
@midnightfang22 The tax should be subtracted from the amount you get.
-
View User Profile
-
Send Message
Posted Feb 2, 2013How do I get the taxes to work? I set a % for it to take/add to and the price doesn't tack on, or am I thinking of "taxes" wrongly?
-
View User Profile
-
Send Message
Posted Feb 2, 2013@flaremonk1
Sure
@Acrobot
I had to be blind <lol> i was looking in the config twice.
-
View User Profile
-
Send Message
Posted Feb 2, 2013does this work with 1.4.7?
-
View User Profile
-
Send Message
Posted Feb 2, 2013@jaimecamara Sorry, but I do not understand.
-
View User Profile
-
Send Message
Posted Feb 2, 2013Acrobot downloaded your translation and even then continues to the local.yml and bugar I wonder what do I do?