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

AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#3606 AcrobotPL

View User Profile

Send Message

Posted Jun 20, 2013
@LTCR - are your players in creative mode?
- what is the outcome of /csversion?
- do you get any errors in the console?
- how does your shop look like?

Rollback Post to Revision RollBack
_ForgeUser11051649
- Join Date: 4/28/2013
- Posts: 8
- Member Details
#3605 _ForgeUser11051649

View User Profile

Send Message

Posted Jun 19, 2013
Ok I'm having trouble. I just installed it and setup a Admin Shop. But when the players go to it and right click nothing happens. I added the permission node to them. The chestshop.shop.* and still nothing happens. I use GroupManager is that why?

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

View User Profile

Send Message

Posted Jun 19, 2013
@Typical_Name Unfortunately, nope (a long time, at least). I'm one-man-team, and it's kind of hard to manage a golden mean between life stuff and programming.

@Melodytune There is no permission node for /iteminfo - maybe another plugin is blocking the command?

Rollback Post to Revision RollBack
_ForgeUser7947984
- Join Date: 11/25/2011
- Posts: 338
- Member Details
#3603 _ForgeUser7947984

View User Profile

Send Message

Posted Jun 18, 2013
@Acrobot

Alright, it's great to hear that someone's interested in this! :D
Do you have any ETA?

Rollback Post to Revision RollBack
_ForgeUser10588839
- Join Date: 2/18/2013
- Posts: 6
- Member Details
#3602 _ForgeUser10588839

View User Profile

Send Message

Posted Jun 18, 2013
Hello, Thank you for the plugin.

My players are not able to use /iteminfo.

They get a "You don't have permission for that.' Error.

There isn't a permission node for /iteminfo. So how do I give them perms for it?

Thank you.

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

View User Profile

Send Message

Posted Jun 18, 2013
@Typical_Name Kind of - I'm still implementing it, as it's essentially the same as re-writing half of the plugin - that's why it is taking so long.

@quentin421 They already can be sold. Do /iteminfo while holding one.

@PHubbles You are probably running an outdated ChestShop/Vault version.

Rollback Post to Revision RollBack
_ForgeUser11688094
- Join Date: 6/18/2013
- Posts: 2
- Member Details
#3600 _ForgeUser11688094

View User Profile

Send Message

Posted Jun 17, 2013
I have a server with Vault and EssensialsEco and im running ChestShop. The problem is that when a player buys/sells something their balance doesn't change in response to the buying/selling. The message, "you have sold.../you have bought..."etc. appears but their balance isn't changed. They still get the item but at no cost to them. Why is this? I can't figure it out as everything in the config files seem to be in order. Please help.

Rollback Post to Revision RollBack
TheTrueThaumaturge
- Location: Calgary
- Join Date: 10/22/2012
- Posts: 18
- Member Details
#3599 TheTrueThaumaturge

View User Profile

Send Message

Posted Jun 17, 2013
Can you make it so that you can sell Player Heads? I have a plugin (Heads), and want to be able to sell Herobrine Heads. :D

Rollback Post to Revision RollBack
_ForgeUser7947984
- Join Date: 11/25/2011
- Posts: 338
- Member Details
#3598 _ForgeUser7947984

View User Profile

Send Message

Posted Jun 17, 2013
Any progress on this ticket? Multiple currency support is very important to me, and ChestShop is the only shop plugin that's expressed interest in adding it. http://dev.bukkit.org/bukkit-plugins/chestshop/tickets/658-add-multiple-economy-support/

Rollback Post to Revision RollBack
_ForgeUser8268780
- Join Date: 1/16/2012
- Posts: 61
- Member Details
#3597 _ForgeUser8268780

View User Profile

Send Message

Posted Jun 17, 2013
I am trying to use the discounts part of chest shops with my admin shops. I just removed the # and added the permission yet its not adding the discount its reducing the full amount

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

View User Profile

Send Message

Posted Jun 16, 2013
@ProjectInfinity The shop is validated in SignChangeEvent - you can call your own validation there and just create a PreShopCreationEvent.

@tanki123 Unfortunately, it's not reverse compatible. Sorry! :C

Rollback Post to Revision RollBack
_ForgeUser7997979
- Join Date: 12/2/2011
- Posts: 9
- Member Details
#3595 _ForgeUser7997979

View User Profile

Send Message

Posted Jun 16, 2013
@Acrobot

It is the release candidate for CB 1.4.7. Which is the correct version for the CB I have now. Unless you can clarify if the latest version is reverse compatible, I will not update.

Any other possibilities?

Rollback Post to Revision RollBack
_ForgeUser6851956
- Join Date: 5/20/2011
- Posts: 572
- Member Details
#3594 _ForgeUser6851956

View User Profile

Send Message

Posted Jun 15, 2013
@Acrobot

I thought the whole point of PreShopCreationEvent was so that I could do the validation myself and other things that happen pre shop creation..

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

View User Profile

Send Message

Posted Jun 15, 2013
@ProjectInfinity Yup, that's how it works now. You'll have to check for sign validity yourself and then call a new PreShopCreationEvent with your new sign.

@tanki123 Outdated ChestShop version - that might be the problem.

@tmarshall619 Do /iteminfo while holding the armour.

@HansaHalim1515 Thanks!

@Toaster_of_Ovens Well then, unfortunately that means that your server software is broken.

@oOTh0mas This comment Bug my page.... Correct please.

Rollback Post to Revision RollBack
_ForgeUser9817898
- Join Date: 10/15/2012
- Posts: 5
- Member Details
#3592 _ForgeUser9817898

View User Profile

Send Message

Posted Jun 15, 2013
This plugin Bug my server... Update please.

Rollback Post to Revision RollBack
_ForgeUser6855906
- Join Date: 5/20/2011
- Posts: 3
- Member Details
#3591 _ForgeUser6855906

View User Profile

Send Message

Posted Jun 15, 2013
@Acrobot

I have updated ChestShop to its latest version already sir

Rollback Post to Revision RollBack
_ForgeUser9749959
- Join Date: 10/6/2012
- Posts: 12
- Member Details
#3590 _ForgeUser9749959

View User Profile

Send Message

Posted Jun 14, 2013
@Acrobot

http://pastebin.com/A7hNizQV heres the link to the chestshop Indonesian translation

Rollback Post to Revision RollBack
_ForgeUser8822116
- Join Date: 4/29/2012
- Posts: 7
- Member Details
#3589 _ForgeUser8822116

View User Profile

Send Message

Posted Jun 14, 2013
Hello, I was going to ask if there was any way you could make colored leather armor available to sell in Admin Shops? We are using theme colors for our faction, and would like to hand out infinite free armor of the faction's colors.

Rollback Post to Revision RollBack
_ForgeUser7997979
- Join Date: 12/2/2011
- Posts: 9
- Member Details
#3588 _ForgeUser7997979

View User Profile

Send Message

Posted Jun 14, 2013
@Acrobot

Chest shop version is 3.50-t0053

Well just incase you didnt understand correctly, your "Longer name" is too long for the sign. This is causing only the first part of the item to be on the sign where in this case its the mod name.

The problem is since the plugin reads from the sign, and not from a flat file, the first item scanned through the item list that correlates with the sign is used. In this case, "twilightforest" on the sign made the plugin thought it is "twilightforest tile tflog" instead of the intended "twilightforest item charmoflife1"

What I seek as resolution is a way to modify the item name just for this plugin. So that it is easier for people to know what the item is instead of reading the mod author's convention of naming items. "Charm of Life 1" is easier to understand than "twilightforest item charmoflife1". Either this or a way to force it to show the item id of X:

Last edited by _ForgeUser7997979: Jun 14, 2013

Rollback Post to Revision RollBack
_ForgeUser6851956
- Join Date: 5/20/2011
- Posts: 572
- Member Details
#3587 _ForgeUser6851956

View User Profile

Send Message

Posted Jun 14, 2013
Apparently I can't get this to work when the currency part of ChestShop is not the default B (Buy) or S (Sell). The code simply does not get ran at all.

@EventHandler(priority = EventPriority.NORMAL) public void onPreShopCreationEvent(PreShopCreationEvent event){ System.out.println(event.getSign().getLines()); }

As you can see, I am not doing anything weird. I am just trying to see if the event itself ACTUALLY gets fired even if something is wrong with the syntax. Apparently it does not and just creates as a regular sign, thus stopping me from using a custom currency (or syntax if you want to put it like that).
Last edited by _ForgeUser6851956: Jun 14, 2013

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