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

_ForgeUser7001725
- Join Date: 6/12/2011
- Posts: 57
- Member Details
#2320 _ForgeUser7001725

View User Profile

Send Message

Posted Dec 30, 2012
@Acrobot

No, I was using 00038, which is why I was asking if it was fixed in the latest one.

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

View User Profile

Send Message

Posted Dec 30, 2012
@megge208

No problem :)

@luigi_vampa

Exactly :)

Rollback Post to Revision RollBack
_ForgeUser7920713
- Join Date: 11/21/2011
- Posts: 146
- Member Details
#2318 _ForgeUser7920713

View User Profile

Send Message

Posted Dec 30, 2012
@phlegacy

Bonemeal is a dye like cocoa beans and lapis. they are all ink sacs on the shop sign.

Rollback Post to Revision RollBack
_ForgeUser8389381
- Join Date: 2/8/2012
- Posts: 21
- Member Details
#2317 _ForgeUser8389381

View User Profile

Send Message

Posted Dec 30, 2012
@Acrobot

haha lol, my bad. I changed the value to an integer but restarted the server afterwards so the loaded value overwrote my changed one. Sorry to bother you.

Rollback Post to Revision RollBack
_ForgeUser10041138
- Join Date: 11/26/2012
- Posts: 36
- Member Details
#2316 _ForgeUser10041138

View User Profile

Send Message

Posted Dec 30, 2012
My admins were setting up admin shops and when one of them put the ID for bonemeal, the 4th line said "Ink Sac:15". But you purchase bonemeal... I'm not sure what the deal is with that lol but it's not right.

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

View User Profile

Send Message

Posted Dec 30, 2012
@megge208

TAX_AMOUNT should be an integer.

@strontkever

Not really.

@FireZtreaM

Hmm, that's weird - please report it as a ticket in the "Tickets" section :D

Rollback Post to Revision RollBack
_ForgeUser6911912
- Join Date: 5/28/2011
- Posts: 187
- Member Details
#2313 _ForgeUser6911912

View User Profile

Send Message

Posted Dec 30, 2012
is there a way to block having multiple shops on a single(double) chest? empty shops dont get removed if theres multiple shops on the same chest

Rollback Post to Revision RollBack

_ForgeUser8389381

Join Date: 2/8/2012
Posts: 21
Member Details

#2312 Posted Dec 30, 2012

@Acrobot: I get this error message on 1.4.6-R0.1 and R0.2 with both t0039 and t0038 :/

13:43:09 [INFO] [ChestShop] Enabling ChestShop v3.50t0039
13:43:09 [SEVERE] Error occurred while enabling ChestShop v3.50t0039 (Is it up to date?)
java.lang.IllegalArgumentException: Can not set static int field com.Acrobot.ChestShop.Configuration.Properties.TAX_AMOUNT to java.lang.Double
        at sun.reflect.UnsafeFieldAccessorImpl.throwSetIllegalArgumentException(UnsafeFieldAccessorImpl.java:164)
        at sun.reflect.UnsafeFieldAccessorImpl.throwSetIllegalArgumentException(UnsafeFieldAccessorImpl.java:168)
        at sun.reflect.UnsafeStaticIntegerFieldAccessorImpl.set(UnsafeStaticIntegerFieldAccessorImpl.java:96)
        at java.lang.reflect.Field.set(Field.java:680)

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

View User Profile

Send Message

Posted Dec 30, 2012
@muggerfugger

You need to update ChestShop to the latest TEST VERSION, however you won't be able to sell named items.

@xeNiumw0w

Just delete %amount from the file - it's now all in %item, because ChestShop's 3.50 core allows for multi-item transactions.

@Slipswhitley

Yeah, I thought of doing that. Mind creating a ticket for it?

@BBFChaser

Put the template files in plugins/ChestShop/HTML/ folder, turn on stats generation.

Rollback Post to Revision RollBack
_ForgeUser8573327
- Join Date: 3/12/2012
- Posts: 159
- Member Details
#2310 _ForgeUser8573327

View User Profile

Send Message

Posted Dec 30, 2012
How can i set up a statistics website?

Rollback Post to Revision RollBack
_ForgeUser7843085
- Join Date: 11/10/2011
- Posts: 125
- Member Details
#2309 _ForgeUser7843085

View User Profile

Send Message

Posted Dec 30, 2012
Hey can you please add a PreShopCreationEvent. I have a plugin that gives people the ability to buy different MobSpawners and I want to add Blaze Spawner as a possible shop item.

Methods

getLine() - returns the string of a line on the shop sign

isCancelled() - Returns true if the shop is cancelled either by a incorrect item ID etc. . .

setCancelled() - Set whether or not the event is cancelled

setMessage() - Set the message sent to the player when making the shop

getPlayer() - Self Explainatory

getMessage() - Get the message sent to the player after making the shop

And any more you can think of

I am happy to donate if you add this,

Thanks Slips.

Rollback Post to Revision RollBack
_ForgeUser8859395
- Join Date: 5/7/2012
- Posts: 145
- Member Details
#2308 _ForgeUser8859395

View User Profile

Send Message

Posted Dec 30, 2012
(You'll have to edit your local.yml file - %amount was removed!)

What did you mean? Change %amount to ?. You did not tell us what we must do with that.

Rollback Post to Revision RollBack
_ForgeUser7667119
- Join Date: 10/7/2011
- Posts: 38
- Member Details
#2307 _ForgeUser7667119

View User Profile

Send Message

Posted Dec 29, 2012
seems to be a problem when players use the anvil to rename items. chestshop gives money for item they are selling, but it never takes the item from them.

I was able to resolve this for now using http://dev.bukkit.org/server-mods/anvil-block/

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

View User Profile

Send Message

Posted Dec 29, 2012
@Durand1w

Exactly, you can't unfortunately sell fireworks yet.

@xLoGiiKzZo

Are you using the latest test version? I highly doubt it.

Rollback Post to Revision RollBack
Durand1w
- Join Date: 9/18/2011
- Posts: 47
- Member Details
#2305 Durand1w

View User Profile

Send Message

Posted Dec 29, 2012
Just wondering if anyone else has experienced an issue selling fireworks via chest shop. I'm not sure if it is an issue with the Bukkit Beta or Chest Shop, but the individual fireworks types do not have an item id and using the generic 'firework' allows the selling of fireworks, but they become generic and do not actually fire the original contents (shooting duds).

Rollback Post to Revision RollBack
_ForgeUser7001725
- Join Date: 6/12/2011
- Posts: 57
- Member Details
#2304 _ForgeUser7001725

View User Profile

Send Message

Posted Dec 29, 2012
Yes there is a duplication glitch. It only seems to work with enchanted items. You put the enchanted item in the chest, then create the Shop sign (place the sign infront of the chest) and then when someone buys the item, it never gets removed from the Chest but the player who bought it receives the item.

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

View User Profile

Send Message

Posted Dec 29, 2012
@denden216

There is no duplication glitch. There is one, in Bukkit - https://bukkit.atlassian.net/browse/BUKKIT-3021 - however you can just turn off a setting in the config.

@Niknox

It uses the stacking information provided by Bukkit.

@BoyDerAmBlockChillt

I believe so, because ChestShop only uses Bukkit's API.

Rollback Post to Revision RollBack
_ForgeUser8008795
- Join Date: 12/3/2011
- Posts: 45
- Member Details
#2302 _ForgeUser8008795

View User Profile

Send Message

Posted Dec 29, 2012
WARNING: Do not use this plugin there is a duplication glitch... I removed it asap.

Rollback Post to Revision RollBack
_ForgeUser9983915
- Join Date: 11/15/2012
- Posts: 110
- Member Details
#2301 _ForgeUser9983915

View User Profile

Send Message

Posted Dec 29, 2012
I've got a bug I think: If you buy Pistons or Sticky Pistons they don't get stacked on each other.

Rollback Post to Revision RollBack
_ForgeUser7081562
- Join Date: 6/28/2011
- Posts: 75
- Member Details
#2300 _ForgeUser7081562

View User Profile

Send Message

Posted Dec 29, 2012
Is ChestShop compatible with Libigot? I always getting an error when using CHestShop...

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