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

Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5743 Phoenix616

View User Profile

Send Message

Posted Apr 28, 2019
What kind of errors do you get when using that server version? Please report them in a ticket or on the github issue tracker.

Once both the 1.13 ChestShop release and 1.14 server are in a more stable state (currently only non-production development builds with major issues are available) I will test the plugin myself on the new version, until then any reports are appreciated.

Rollback Post to Revision RollBack
Forge_User_98917713
- Join Date: 4/26/2019
- Posts: 6
- Member Details
#5744 Forge_User_98917713

View User Profile

Send Message

Posted Apr 28, 2019
In reply to Phoenix616:

i think it because of sign. there is 6 type of sign in 1.14 version.

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5752 Phoenix616

View User Profile

Send Message

Posted May 6, 2019
For anyone wondering: Signs are no longer an issue on the latest builds so please make sure you are running one of those when you are testing 1.14.

Rollback Post to Revision RollBack
eksybes
- Join Date: 3/17/2019
- Posts: 5
- Member Details
#5740 eksybes

View User Profile

Send Message

Posted Apr 17, 2019
How to change money item?
I would like to change the money item from "Gold nugget" to "Gold ingot"

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5741 Phoenix616

View User Profile

Send Message

Posted Apr 22, 2019
ChestShop does not provide any money item feature. Please refer to the plugin that you use for that on how to change the item used.

Rollback Post to Revision RollBack
akimbo224
- Join Date: 4/8/2019
- Posts: 1
- Member Details
#5738 akimbo224

View User Profile

Send Message

Posted Apr 8, 2019
Is there any chance you can add functionality to the "dried_kelp_block"? Or is there any I could manually add it? Thanks

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5739 Phoenix616

View User Profile

Send Message

Posted Apr 13, 2019
What kind of functionality do you mean? If you mean just selling it then that should work without issues. Just use the shortened ID of /iteminfo or the auto-fill function.

Rollback Post to Revision RollBack
leglesslass
- Join Date: 4/5/2019
- Posts: 4
- Member Details
#5732 leglesslass

View User Profile

Send Message

Posted Apr 4, 2019
I've been trying to get this to work in 1.13.2, and have tried a couple of different economy plugins, but no matter what I do I get "[Shop] Economy account from shop owner doesn't exist!" when trying to use player shops. Admin shops work fine, and correctly credit accounts.

I'm running paperclip-572, with ChestShop and Vault, and have tried gMoney and BConomy as economy plugins, which both give the same problem.

I hope this is a common problem with an "oh, you just need to set X" answer, but can provide more details if it isn't.

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5735 Phoenix616

View User Profile

Send Message

Posted Apr 5, 2019
This was figured out in irc: Both gMoney and BConomy don't properly implement the VaultAPI (the hasAccount check always returns false) resulting in them being incompatible with ChestShop.

Last edited by Phoenix616: Apr 5, 2019

Rollback Post to Revision RollBack
leglesslass
- Join Date: 4/5/2019
- Posts: 4
- Member Details
#5736 leglesslass

View User Profile

Send Message

Posted Apr 5, 2019
In reply to Phoenix616:

Yep, and thanks again!

In response to your suggestion I checked out TheNewEconomy, and it seems to be working thus far. It still requires a bit of configuration, but less so than EssentialsX.

It would be good to know if there are any simpler economy plugins that still work. Might it be worthwhile adding a list of ones that have been tested to the wiki, given that Vault's list is so badly out of date?

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5737 Phoenix616

View User Profile

Send Message

Posted Apr 7, 2019
Good idea. I've created a page that lists a couple of compatible and known incompatible ones already, if anyone has more please comment on that page :)

Rollback Post to Revision RollBack
Benjas1006
- Join Date: 5/31/2013
- Posts: 1
- Member Details
#5730 Benjas1006

View User Profile

Send Message

Posted Mar 17, 2019
I'm unable to sell items both from the 1.13 update like nautilus shells or items with enchantments. I've tried /iteminfo and for nautilus shells it responds as though there is nothing in my hand. For enchanted books it gives a long error

Shop Sign Error: Cannot generate code for item ...

Thank you!

on version 3.9.2 build 86

Last edited by Benjas1006: Mar 17, 2019

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5734 Phoenix616

View User Profile

Send Message

Posted Apr 5, 2019
You are using an old plugin version for 1.12, use the latest development builds linked at the top of the description for proper 1.13 support!

Rollback Post to Revision RollBack
shadyspades
- Join Date: 3/16/2019
- Posts: 1
- Member Details
#5729 shadyspades

View User Profile

Send Message

Posted Mar 15, 2019
How come when I place an admin shop, I can buy and sell but it doesn't show a transaction log even though I enabled it in the config. Other players can buy and sell but they don't see a transaction log, as well.

Last edited by shadyspades: Mar 15, 2019

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5733 Phoenix616

View User Profile

Send Message

Posted Apr 5, 2019
You need to provide more information, ideally you can open an issue to provide all your plugin and server versions and the config and shop setup.

Rollback Post to Revision RollBack
pvini07BR
- Join Date: 7/18/2018
- Posts: 9
- Member Details
#5726 pvini07BR

View User Profile

Send Message

Posted Mar 12, 2019
MAN WHY THE DEV BUILD IS NOT DETECTING VAULT AAAAAAAAA IT DOSENT WORKS IT DISABLES AUTOMATICALLY PLEASE FIX THAT

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5728 Phoenix616

View User Profile

Send Message

Posted Mar 14, 2019
See my answer on your github issue. You seem to be missing an economy plugin.

Rollback Post to Revision RollBack
pvini07BR
- Join Date: 7/18/2018
- Posts: 9
- Member Details
#5721 pvini07BR

View User Profile

Send Message

Posted Mar 7, 2019
i installed the plugin on the latest dev builds for 1.13.2, but when i execute any command, this appears on the console:

[ERROR] null

org.bukkit.command.CommandException: Cannot execute command 'chestshop' in plugin ChestShop v3.9.3-SNAPSHOT (build 114) - plugin is disabled.

at org.bukkit.command.PluginCommand.execute(PluginCommand.java:36) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:138) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at org.bukkit.craftbukkit.v1_13_R2.CraftServer.dispatchCommand(CraftServer.java:684) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.PlayerConnection.handleCommand(PlayerConnection.java:1585) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.PlayerConnection.a(PlayerConnection.java:1439) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.PacketPlayInChat.a(SourceFile:37) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.PacketPlayInChat.a(SourceFile:9) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.PlayerConnectionUtils.lambda$0(PlayerConnectionUtils.java:9) ~[craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.PlayerConnectionUtils$$Lambda$2234.000000008806F040.run(Unknown Source) ~[?:?]

at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) [?:1.8.0_192]

at java.util.concurrent.FutureTask.run(FutureTask.java:266) [?:1.8.0_192]

at net.minecraft.server.v1_13_R2.SystemUtils.a(SourceFile:199) [craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.MinecraftServer.b(MinecraftServer.java:839) [craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.DedicatedServer.b(DedicatedServer.java:382) [craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.MinecraftServer.a(MinecraftServer.java:792) [craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at net.minecraft.server.v1_13_R2.MinecraftServer.run(MinecraftServer.java:695) [craftbukkit-1.13.2.jar:git-Bukkit-77ca7ca]

at java.lang.Thread.run(Thread.java:813) [?:1.8.0_192]

Rollback Post to Revision RollBack
Phoenix616
- Join Date: 9/16/2012
- Posts: 306
- Member Details
#5722 Phoenix616

View User Profile

Send Message

Posted Mar 8, 2019
The plugin is disabled as stated at the top of the error. You'll have to look at the startup log to see why.

Rollback Post to Revision RollBack
pvini07BR
- Join Date: 7/18/2018
- Posts: 9
- Member Details
#5723 pvini07BR

View User Profile

Send Message

Posted Mar 9, 2019
In reply to Phoenix616:

oh i just see... The plugin cant detect Vault, but i already installed vault...

Last edited by pvini07BR: Mar 9, 2019

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