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

_ForgeUser6867917
- Join Date: 5/22/2011
- Posts: 21
- Member Details
#881 _ForgeUser6867917

View User Profile

Send Message

Posted Apr 21, 2012
Is it possible to to make a shared iconomy account and use it with chestshops. So 2 players could co-own a shop and access the $ together?

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

View User Profile

Send Message

Posted Apr 21, 2012
@erik1988 Ok, I'll check that, but it didn't happen to me :/ Have you got WorldGuard?

Rollback Post to Revision RollBack
_ForgeUser8762258
- Join Date: 4/18/2012
- Posts: 219
- Member Details
#879 _ForgeUser8762258

View User Profile

Send Message

Posted Apr 21, 2012
No i just try to place two chest beside each other. There is not any private signs or shops within close range. When i tried i was in a towny town, and im the mayor. But i think other people have had the same problem outside of towny.

When i had the problem i went back to 3.39 and then the problem seems to go away, but im not sure if its the version it self or if it was the rs of the server that solved the problem. I have put 3.40 back in now, and people are complaining that they cant make double chests.

THIS IS MY CONFIG:

PREFERRED_ECONOMY_PLUGIN: "iConomy"

Preferred economy plugin (iConomy, BOSEconomy, Essentials). If you do not want to specify this, leave it blank. REVERSE_BUTTONS: false
If true, people will buy with left-click and sell with right-click. ALLOW_LEFT_CLICK_DESTROYING: false
If true, if you left-click your own shop sign you won't open chest's inventory, but instead you will start destroying the sign. STACK_UNSTACKABLES: false
If true, ALL things (including food, etc.) will stack up to 64 SERVER_ECONOMY_ACCOUNT: "northkonto"
Economy account's name you want Admin Shops to be assigned to ADMIN_SHOP_NAME: "Admin Shop"
First line of your admin shop should look like this SHOP_CREATION_PRICE: 500
Amount of money player must pay to create a shop LOG_TO_FILE: false
If true, plugin will log transactions in its own file LOG_TO_CONSOLE: true
Do you want ChestShop's messages to show up in console? LOG_TO_DATABASE: false
If true, plugin will log transactions in EBean database GENERATE_STATISTICS_PAGE: false
If true, plugin will generate shop statistics webpage. STATISTICS_PAGE_PATH: "plugins/ChestShop/website.html"
Where should your generated website be saved? RECORD_TIME_TO_LIVE: 600
How long should transaction information be stored? STATISTICS_PAGE_GENERATION_INTERVAL: 60
How often should the website be generated? USE_BUILT_IN_PROTECTION: true
Do you want to use built-in protection against chest destruction? PROTECT_CHEST_WITH_LWC: false
Do you want to protect shop chests with LWC? PROTECT_SIGN_WITH_LWC: false
Do you want to protect shop signs with LWC? MASK_CHESTS_AS_OTHER_BLOCKS: false
Do you want to mask shop chests as other blocks? HIGHLY EXPERIMENTAL, CAN LAG! SHOW_MESSAGE_OUT_OF_STOCK: true
Do you want to show "Out of stock" messages? SHOW_TRANSACTION_INFORMATION_CLIENT: true
Do you want to show "You bought/sold... " messages? SHOW_TRANSACTION_INFORMATION_OWNER: true
Do you want to show "Somebody bought/sold... " messages? TOWNY_INTEGRATION: false
Do you want to only let people build inside shop plots? WORLDGUARD_INTEGRATION: false
Do you want to only let people build inside plots? TAX_AMOUNT: 10
Percent of the price that should go to the server's account. (100 = 100 percent) SHOP_REFUND_PRICE: 500
How much money do you get back when destroying a sign? IGNORE_CREATIVE_MODE: true
Do you want to allow using shops to people in creative mode? ALLOW_MULTIPLE_SHOPS_AT_ONE_BLOCK: false
Do you want to allow other players to build a shop on a block where there's one already? SHOP_INTERACTION_INTERVAL: 400
(In 1/1000th of a second) How often can a player use a shop sign? TOWNY_SHOPS_FOR_OWNERS_ONLY: true
If true, only plot owners are able to build inside a shop plot. If false, every town's resident is able to build there. SERVER_TAX_AMOUNT: 10
Percent of the price that should go to the server's account when buying from an Admin Shop HEROES_EXP: 100
How much Heroes exp should people get for creating a ChestShop? BLOCK_UPDATE: false
EXPERIMENTAL: Should every ChestShop transaction result in a block update? ALLOW_PARTIAL_TRANSACTIONS: true
Can shops be used even when the seller doesn't have enough items? (The price will be scaled adequatly to the item amount)

ALLOW_SIGN_CHEST_OPEN: true

Can shop's chest be opened by owner with right-clicking a shop's sign? WORLDGUARD_USE_FLAG: false
Do you want to only let poeple build inside region flagged by doing /region regionName flag chestshop allow?
Rollback Post to Revision RollBack
AcrobotPL
- Join Date: 6/12/2011
- Posts: 1,321
- Member Details
#878 AcrobotPL

View User Profile

Send Message

Posted Apr 21, 2012
@erik1988 Hmm, but is the chest protected?

Rollback Post to Revision RollBack
_ForgeUser8762258
- Join Date: 4/18/2012
- Posts: 219
- Member Details
#877 _ForgeUser8762258

View User Profile

Send Message

Posted Apr 21, 2012
A guy commented on this problem on the deadbolt page. seems like it might be a conflict. I only get "[shop] you dont have premssion to do that" in the chat window when i try to place a chest next to another chest.

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

View User Profile

Send Message

Posted Apr 21, 2012
@ryguy147 Well, I think I could add the option.

And if someone's name is longer than 15 chars, it gets saved to longName.storage file inside plugins/ChestShop/, and it looks like:

"15charactername: 16characternamee"

@iiAnderson Did you read the FAQ?

@Switch0r I've replied to you. If you can't see the ticket, here is its link:

http://dev.bukkit.org/server-mods/chestshop/tickets/168-chestshop-is-not-working-anymore-with-towny/

@erik1988 Any errors? I didn't really change anything.

Rollback Post to Revision RollBack
_ForgeUser8234082
- Join Date: 1/10/2012
- Posts: 106
- Member Details
#875 _ForgeUser8234082

View User Profile

Send Message

Posted Apr 21, 2012
@Acrobot

Maybe an option on the config to toggle on/off? I really don't mind being 2 characters short on the first line.

And a bit off-topic, what happens when a player name is longer than 15 characters?

Rollback Post to Revision RollBack
_ForgeUser8535062
- Join Date: 3/5/2012
- Posts: 12
- Member Details
#874 _ForgeUser8535062

View User Profile

Send Message

Posted Apr 21, 2012
Does the chestShop.shop.create permission work as all ranks can create the chestshops despite one of them doesn't actually have the permission. Does it make a difference if they have the buy and sell permissions as they do have that.

Thanks for the assistance.

iiAnderson

Rollback Post to Revision RollBack
_ForgeUser6898239
- Join Date: 5/26/2011
- Posts: 323
- Member Details
#873 _ForgeUser6898239

View User Profile

Send Message

Posted Apr 21, 2012
I am downgrading to 3.39, made a ticket :)

Rollback Post to Revision RollBack
_ForgeUser8762258
- Join Date: 4/18/2012
- Posts: 219
- Member Details
#872 _ForgeUser8762258

View User Profile

Send Message

Posted Apr 21, 2012
for some weird reason people cant create dubble chest (not shops, just regular dubble chests) after the new update (3.40).

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

View User Profile

Send Message

Posted Apr 21, 2012
@asofold Yeah, actually I didn't think about it, but it sure is nice :D

@ihasamoose Huh... Can't reproduce it. Mind regenerating the config and setting its values again?

Rollback Post to Revision RollBack

_ForgeUser5797285

Join Date: 10/11/2010
Posts: 108
Member Details

#870 Posted Apr 20, 2012

@Acrobot

Sure thing.

PREFERRED_ECONOMY_PLUGIN: ""
#Preferred economy plugin (iConomy, BOSEconomy, Essentials). If you do not want to specify this, leave it blank.
REVERSE_BUTTONS: false
#If true, people will buy with left-click and sell with right-click.
ALLOW_LEFT_CLICK_DESTROYING: true
#If true, if you left-click your own shop sign you won't open chest's inventory, but instead you will start destroying the sign.
STACK_UNSTACKABLES: false
#If true, ALL things (including food, etc.) will stack up to 64
SERVER_ECONOMY_ACCOUNT: ""
#Economy account's name you want Admin Shops to be assigned to
ADMIN_SHOP_NAME: "Admin Shop"
#First line of your admin shop should look like this
SHOP_CREATION_PRICE: 0
#Amount of money player must pay to create a shop
LOG_TO_FILE: false
#If true, plugin will log transactions in its own file
LOG_TO_CONSOLE: true
#Do you want ChestShop's messages to show up in console?
LOG_TO_DATABASE: false
#If true, plugin will log transactions in EBean database
GENERATE_STATISTICS_PAGE: false
#If true, plugin will generate shop statistics webpage.
STATISTICS_PAGE_PATH: "plugins/ChestShop/Web/ShopStats.html"
#Where should your generated website be saved?
RECORD_TIME_TO_LIVE: 600
#How long should transaction information be stored?
STATISTICS_PAGE_GENERATION_INTERVAL: 60
#How often should the website be generated?
USE_BUILT_IN_PROTECTION: true
#Do you want to use built-in protection against chest destruction?
PROTECT_CHEST_WITH_LWC: false
#Do you want to protect shop chests with LWC?
PROTECT_SIGN_WITH_LWC: false
#Do you want to protect shop signs with LWC?
MASK_CHESTS_AS_OTHER_BLOCKS: false
#Do you want to mask shop chests as other blocks? HIGHLY EXPERIMENTAL, CAN LAG!
SHOW_MESSAGE_OUT_OF_STOCK: true
#Do you want to show "Out of stock" messages?
SHOW_TRANSACTION_INFORMATION_CLIENT: true
#Do you want to show "You bought/sold... " messages?
SHOW_TRANSACTION_INFORMATION_OWNER: true
#Do you want to show "Somebody bought/sold... " messages?
TOWNY_INTEGRATION: false
#Do you want to only let people build inside shop plots?
WORLDGUARD_INTEGRATION: true
#Do you want to only let people build inside plots?
TAX_AMOUNT: 0
#Percent of the price that should go to the server's account. (100 = 100 percent)
SHOP_REFUND_PRICE: 0
#How much money do you get back when destroying a sign?
IGNORE_CREATIVE_MODE: true
#Do you want to allow using shops to people in creative mode?
ALLOW_MULTIPLE_SHOPS_AT_ONE_BLOCK: false
#Do you want to allow other players to build a shop on a block where there's one already?
SHOP_INTERACTION_INTERVAL: 100
#(In 1/1000th of a second) How often can a player use a shop sign?
TOWNY_SHOPS_FOR_OWNERS_ONLY: true
#If true, only plot owners are able to build inside a shop plot. If false, every town's resident is able to build there.
SERVER_TAX_AMOUNT: 0
#Percent of the price that should go to the server's account when buying from an Admin Shop
HEROES_EXP: 100
#How much Heroes exp should people get for creating a ChestShop?
BLOCK_UPDATE: false
#EXPERIMENTAL: Should every ChestShop transaction result in a block update?
ALLOW_PARTIAL_TRANSACTIONS: true
#Can shops be used even when the seller doesn't have enough items? (The price will be scaled adequatly to the item amount)
ALLOW_SIGN_CHEST_OPEN: true
#Can shop's chest be opened by owner with right-clicking a shop's sign?
WORLDGUARD_USE_FLAG: true
#Do you want to only let poeple build inside region flagged by doing /region regionName flag chestshop allow?

Forge_User_61842651
- Join Date: 8/29/2011
- Posts: 2,535
- Member Details
#869 Forge_User_61842651

View User Profile

Send Message

Posted Apr 20, 2012
@Acrobot

It could later maybe filter colors :) - but ok, i am not nagging you, i don't need colors there.

Your own code?... Economy:"public static EcoPlugin economy;" ... the possibility to set it externally is great, so i can use my own economy without more overhead of further plugins!

You probably wouldnt have thought of making it private or default anyway ...

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

View User Profile

Send Message

Posted Apr 20, 2012
@LordKainzo Hmm, could you show me your config?

@shutka It's actually 3.40 in code, it just got converted :/

Rollback Post to Revision RollBack
Kainzo
- Join Date: 5/19/2011
- Posts: 1,174
- Member Details
#867 Kainzo

View User Profile

Send Message

Posted Apr 20, 2012
@Acrobot

http://pastie.org/3823260

Still seeing this spam every now and then.

Rollback Post to Revision RollBack
Forge_User_92605129
- Join Date: 7/5/2011
- Posts: 33
- Member Details
#865 Forge_User_92605129

View User Profile

Send Message

Posted Apr 20, 2012
To all having that error, delete your config and let it regenerate ;)

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

View User Profile

Send Message

Posted Apr 20, 2012
@ihasamoose @ThoLav @In5aN1aC

Hmm, it seems like I can't reproduce it. Mind showing me your config?

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

View User Profile

Send Message

Posted Apr 20, 2012
@hungoverfurbal Well, I don't know - just clean the plot after it's been used?

@asofold No, it doesn't filter colors.

Also, what do you mean internal economy interface? It's just hooking into built-in Register and, if found, Vault.

@ihasamoose @In5aN1aC @ThoLav

Ok, fixing that, I'm stupid :P It's nothing to be worried about though.

Rollback Post to Revision RollBack
_ForgeUser8318808
- Join Date: 1/26/2012
- Posts: 488
- Member Details
#862 _ForgeUser8318808

View User Profile

Send Message

Posted Apr 19, 2012
@ihasamoose

Hi,

same issue here. I'm using: git-Bukkit-1.2.5-R1.0-10-g5bcb960-b2155jnks

Rollback Post to Revision RollBack
1n5aN1aC
- Location: dalas
- Join Date: 2/7/2012
- Posts: 28
- Member Details
#861 1n5aN1aC

View User Profile

Send Message

Posted Apr 19, 2012
@ihasamoose Yeah, having same error loading 3.40 so i had to backdate back to 3.39, which still works fine.

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