[ECON] ChestShop 3.50 (iConomyChestShop) - Chest&sign shop for economy plugins [1.5.1]

ChestShop - click to download

BukkitDev thread

Frequently Asked Questions

For developers - API

GitHub downloads

WGET-friendly download

An easy way to create shops - no protection plugin needed!

You don't need to be on-line to earn money anymore!

I've put a LOT of effort into making this plugin,

you can donate if you appreciate my effort =)

Requirements:

- Minecraft server that runs CraftBukkit

- An economy plugin supported by Register or Vault, for example iConomy, BOSEconomy or Essentials Eco.

Optional:

- For Permissions: bPermissions, PEX, or any other permission plugin

- For additional protection: LWC, Lockette, Deadbolt

- For other item names (aliases): OddItem

Setup:

Copy the .jar file from the .zip you downloaded into /plugins folder.

You can also copy the example files if you want to generate statistics page.

Translations:

You can change the plugin's language, here's a list of all user-made translations.

If you want to update or submit a translation, feel free to PM me.

Bulgarian - Muff1Ncho

Czech - LordPgsa

Chinese (Simplified) - tab415263

Danish - blasterweb

Deutsch (newest) - xGhOsTkiLLeRx

Deutsch (newest with umlauts) - PinguinAman

Deutsch (ChestShop 3.50 version) - RasCas

Dutch - marinus15

French- Chbrams

Hungarian - Anachen

Italian - Massimo1993

Korean - Zwing87

Norwegian - _AlexN_ and TheUnkownGamer

Polish (ChestShop 3.50) - Holls1

Polish - Holls1

Portugese (Brasil) - FelipeMarques14

Romanian - Mafios from www.minecraft-romania.com

Russian - VADemon from http://minemania.ru/

Slovak - LordPgsa

Slovenian - jEErc

Spanish - thxaaaa

Swedish - Maxell

Turkish - Developer

Traditional Chinese - hellboyincs

Vietnamese - etrubi1 from http://minevn.com/

Permissions:

http://dev.bukkit.org/server-mods/chestshop/pages/permission-nodes/

How to create a ChestShop?

- Place a chest, if you haven't already.

- Place a sign 1 block near the chest (for example, above the chest)

- On the sign, write:

(Item name can actually be item ID or alias)

First line will be filled in by the plugin automatically.

Price is a combination of buy and sell price.

You have to have B near buy price (people buy from you), and S near sell price (people sell to you).

If you have both B and S, separate them with a colon - :

For example:

means that AcrobotPL wants to sell 64 diamonds for 10 currency, and buy them back from you for 5 currency.

Also, if you put "free" instead of price, it is free to buy or sell

- Now, when you finish editing the sign, if LWC is turned on in config, shop will be automatically created.

Also, if your default protection is turned on in the config, people won't be able to break chest, sign or the block the sign is on.

Here's a helpful sheet which can help you adjust your server's prices made by vagrant326.

What is an Admin Shop?

Admin shop is the shop that doesn't require a chest, because it has infinite stock.

If you sell to it, the items will disappear, and if you buy from it, items will magically appear.

To create one, you have to be Admin/OP. Just put "Admin Shop" (or anything specified in config file) on the first line of the sign.

Restricting shops to some groups or regions

You can either use permissions, or you can just put a sign ABOVE shop sign (you need to be in that group to create the sign) to restrict it to players with ChestShop.group.groupName permission

The syntax is:

[restricted]

firstGroupName

2ndGroupName

3rdGroupName

Only those groups will be able to use that shop

To restrict a shop to some regions:

- If you're using Towny, turn TOWNY_INTEGRATION on. Residents will be able to create shops in economy plots (either their or, if specified in config, any)

- If you're using WorldGuard, you can use an experimental "chestshop" flag. Turn WORLDGUARD_INTEGRATION on and flag a region. (f.e. /region flag ChestShopRegion chestshop allow)

Do you want to limit the maximum prices for items?
Well, there's an app.... wait, not that : P
You can use an experimental feature in ChestShop.
In your config.yml, add lines like:
max-buy-price-5: 14
max-sell-price-5: 15

That means that the maximum price for items BOUGHT by PLAYER is 14, and items SOLD by PLAYER using the shop is 15.

You can also use a global setting, like this:
max-sell-price: 200

That means that the maximum price for items SOLD to PLAYER is 200 (if there is, for example, a max-sell-price-5 found, it will be used instead of the global sell price)

USING SHOPS

You could buy and sell by right and left clicking the sign for a long time.

Now it's the only way to use the shops.

It's SIMPLE!

Just LEFT-CLICK to SELL to shop, and

RIGHT-CLICK to BUY from shop.

(This can be changed in the config file)

DESTROYING SHOPS

If you want to delete your old shop, simply SNEAK and destroy the sign.

It's that easy =)

STOCKING THE SHOPS

You can either open the chest and stock it up, or click on your own sign - it will open chest's inventory (that way you can have chests not openable by other people for sure )

ItemInfo command

It's a simple command that shows item information.

If you use it without any arguments, it shows you information about the item you're holding.

If you specify item id or item name after the command, it will show you information about that item.

Source code

ChestShop is Open-Source =)

You can find its code on https://github.com/Acrobot/ChestShop-3

Tutorials:

Hungarian Tutorial (By Anachen)
Samkio's tutorial

MichaelMitchellM's tutorial

emolkbro's tutorial

Lyc0sa's tutorial

Minecraftzero's tutorial

iKrissssy's tutorial

JeetTol's tutorial (Old version of plugin)

Illuminatica23's tutorial (German)

TheGamePlaza's tutorial (German)

OblivianMinecraftCom's tutorial (German)

MBukkit's tutorial (German)

Kenan's tutorial (French)

BassettGoesPro's tutorial

xrobau's tutorial

deery50's plugin spotlight

Mordazo360's tutorial (Polish)

adrimat08's tutorial (Spanish)

TechHutus' tutorial

koz4christ's review/tutorial

Mc Mod Spotlight - Rattar27

Setting up server's economy (By MichaelMitchellM)

Sample shops:

Eqvaliser's shop

Thanks to:

- kali876, ziomekYOYO and Herocraft server for testing the plugin and finding every little bug =)

- Everyone who uses this plugin - really big thanks for this, I never thought it will be so popular

- Everyone who provided translation - many people's lives will be easier now

- @Nijikokun for Register

- @LennardF1989 for awesome Persistence Reimplemented

- @Temaska for fixing the plugin while I was on holidays

- @VADemon for providing a great support for other users

- @Euthyphro for his patience and really good bug spotting

- vagrant326 for making a great price sheet

- @Epics for his great help

- @RobinR for the awesome enchantment code generator

If something's not working

You can't change the sign color - that breaks the formatting.

If that's not the issue, please give me this information, so I can help you faster.

- CraftBukkit version (type /version in chat)

- ChestShop version (type /csversion in chat)

- Your economy plugin (iConomy? BOSEconomy? other one?)

- Have you got any Permission plugin? Which one?

Changelog can be found on BukkitDev - http://dev.bukkit.org/server-mods/chestshop/files/[/SPOILER][/url]