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.
![[IMG]](https://raw.githubusercontent.com/iconic/open-iconic/master/png/graph-2x.png)
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)![[IMG]](https://raw.githubusercontent.com/iconic/open-iconic/master/png/check-2x.png)
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! :)
%2526business%253dandrzejp%2540dysleksja.pl%2526bn%253dPP-DonationsBF%253abtn_donateCC_LG.gif%253aNonHosted%2526cancel_return%253dhttp%253a%252f%252fdev.bukkit.org%252fserver-mods%252fchestshop%252f%2526lc%253dUS%2526item_name%253dChestShop%2b(iConomyChestShop)%2b(from%2bBukkit.org)%2526cmd%253d_donations%2526rm%253d1%2526no_shipping%253d1%2526currency_code%253dUSD){kind=small}
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!
Comments
-
Phoenix616 Owner
-
AcrobotPL Author
-
dmulloy2 Maintainer
-
View User Profile
-
Send Message
Posted Apr 4, 2012@UnitedFactions
That is fine with me, Acrobot, your plugin works flawlesly since 1.8 with Worldguard ;) Can you please stop worldguard integration and let it work as before :)
I dont need the worldguard checks :) I want to turn them off
-
View User Profile
-
Send Message
Posted Apr 4, 2012@notcam45 Well, you could read the FAQ.
You can either:
@Hangar First option - that would be hard to do at the moment, the transactions can be stored in a database, but using it would be harder.
Second - yeah, I can do that :)
Last one - well, I can't do anything with it :/ Blame Notch
-
View User Profile
-
Send Message
Posted Apr 3, 2012There is an issue on my server were players without chestshop.shop.create can still create shops, they are using the signs to protect thier chests, by selling air. I was wondering if this issue could be solved I only want donors to be able to create chestshops.
-
View User Profile
-
Send Message
Posted Apr 3, 2012It would be nice if shop owners could type a command to see what has sold, sorted by most recent, and page through that. I find you feel a bit disconnected from the whole 'shopkeeping experience' when you login, see money in your account but have to run around trying to figure out which thing put it there. A simple accounting/history would be lovely (and makes tons of sense for a shop plugin?).
Secondly, I'd like an option to check that the item written on the sign matches what's in the chest. I've seen so many chests that don't work because the sign is wrong. For example, netherwart has 2 items codes, but only 1 works. Maybe a command that you can type, then touch the chest and it will tell you the codes for what's inside. This is different than doing /iteminfo name, because it would tell you what's actually inside the chest, and you would never have to guess, or have the confusion like in the case of netherwart.
Finally, potion codes (like seen here: http://www.gamefaqs.com/boards/606524-/61609571 ), require you to make another sign saying what's really in the box since the code doesn't mean anything to people. I'm not sure if there's a better way to do that but I wish there was.
-
View User Profile
-
Send Message
Posted Apr 3, 2012@Acrobot That is fine with me, Acrobot, your plugin works flawlesly since 1.8 with Worldguard ;) Can you please stop worldguard integration and let it work as before :)
I dont need the worldguard checks :) I want to turn them off <3
-
View User Profile
-
Send Message
Posted Apr 3, 2012@weja93 That's your economy plugin's issue. You can configure SHOP_INTERACT_INTERVAL in config.
@UnitedFactions Sorry, been really busy, I probably did what I could :/ WorldGuard doesn't provide any methods to help me do so, so I don't know if I'll continue the WG integration.
-
View User Profile
-
Send Message
Posted Apr 3, 2012Dear Acrobat, I hope you are doing well.
I hope you don't forget to patch the worldguard thing / on / off switch? or perhaps make it so that Worldguard loading before Chestshop handles correctly without removing the permission to place shop signs in that region (global)
I do not need the worldguard check function ;) However I use worldguard regions for users though to let them make shops in these regions.
-
View User Profile
-
Send Message
Posted Apr 3, 2012Buying fast items laggs the whole server horribly. I have 100 players online and it freezes if you buy something quickly.. WTF?
_FIXED? I removed all loggins and shit, and now it works without problem. Thanks
-
View User Profile
-
Send Message
Posted Apr 3, 2012@Acrobot
Hi,
nice, I never saw this plugin, I searched for something like that. Thanks al lot for that information. I'll give it a try.
-
View User Profile
-
Send Message
Posted Apr 3, 2012is there a way to make the admin shops function like player shops.
i want the admin shops to have the same infinite money, as it does now i just want them to rely on chest contents rather than infinitely
NEVERMIND: i figured it out, just set seller to any nonplayer name that doesnt match the "Admin Shop".
-
View User Profile
-
Send Message
Posted Apr 3, 2012@ThoLav Oh :P
You can already do that. ChestShop works with OddItem, so when you install it, it will use OddItem's names.
http://dev.bukkit.org/server-mods/odditem/
@Mormon_Mafia http://dev.bukkit.org/server-mods/chestshop/pages/faq/
@Geoneo97 That doesn't rename the shops. That only allows you to place NEW admin shops with the name of (here) "Shop"
-
View User Profile
-
Send Message
Posted Apr 3, 2012HELP i have a serer with iconomy and chestshop it works gread no errors ! now bei problem: when i rename in chestshop in the config file: ADMIN_SHOP_NAME: "Admin Shop" to ADMIN_SHOP_NAME: "Shop" The game is still on the shop signs Admin how can I rename the
sry my english is bad
-
View User Profile
-
Send Message
Posted Apr 3, 2012Ok, for some reason I can't buy or sell from an AdminShop. I do own it, it is in a Residence that I own, and I do not bother pasting the Permissions stuff, because it has never been necessary before. I deopped myself, and am, in Survival mode, but when i go to buy from and Admin Shop, or sell, it says "You can't [sell or buy] here!" Any ideas on how to fix?
-
View User Profile
-
Send Message
Posted Apr 3, 2012@Grimlock257
Hi,
I should have explained it better. ;) The name of the items should also be in this messages or local.yml, however you will name it. Like Grimlock257 in his post. I hope it's now better explained.
messages.en.yml
messages.de.yml
messages.fr.yml
So users, who don't understand english knew what is sold/buyed in this shop.
-
View User Profile
-
Send Message
Posted Apr 3, 2012@ThoLav ... There is already such a file, called local.yml
ChestShop was one of the first plugins that supported translations.
You can find already-made translations in the main plugin thread, first post.
@bwinkl04 Well, you can do something like that if you just make a ChestShop and put some weird name on the first line of the sign.
-
View User Profile
-
Send Message
Posted Apr 3, 2012Hi Acrobot,
if you change the messages, what about a file named messages_[language].yml, where all messages are stored. So that anybody can configure to his needs. I will translate to german. and I'll give it to you.
in config.yml
-
View User Profile
-
Send Message
Posted Apr 3, 2012Love this plugin, looking for one thing...
I would like to have admin shops that when clicked, sell the item to the clicker (charges the clickers account), but gives the item to a predetermined player.
So, player_A clicks the sign for diamond sword at $200 and $200 is removed from their account, but the sword is automatically added to player_B's inventory.
I was thinking the first line of the sign would be who the receiving player is an @ sign like:
@player_B 1 b200 diamondsword
and these shops would not have the ability to buy items from players.
-
View User Profile
-
Send Message
Posted Apr 3, 2012@Hangar Yeah, it should work, but I don't control saving it - Bukkit's persistence system does it.
@Grimlock257 Sure, I'll do that.
@KittyHopHop Yeah, I forgot about that. Fixing it now.
-
View User Profile
-
Send Message
Posted Apr 3, 2012USE_BUILT_IN_PROTECTION: false
I try to blow someones shop chest and shop sign with TNT, doesnt work at all:( And I dont have any other protection plugins that would block that.
-
View User Profile
-
Send Message
Posted Apr 2, 2012Is mySQL logging working? I'm getting a "cs_transactions" table created with the config option set to true but it remains empty even after I know purchases have been made. Is that the right table?