[ECON] ChestShop 3.35 (iConomyChestShop) - Chest&sign shop for economy plugins [1.1-R4]

ChestShop - DOWNLOAD(wget friendly link HERE)

BukkitDev thread

Frequently Asked Questions

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,

donate if you appreciate my effort =) Thanks

Requirements:

- Minecraft server that runs CraftBukkit

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

Optional:

- For Permissions: bPermissions, PEX, Permissions 2/3, any newer 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.

For ChestShop 3:

Bulgarian - Muff1Ncho

Czech - hofec

Danish - blasterweb

Deutsch - Linaks

Deutsch - Niklas4G

Deutsch - cruzer0

Deutsch (newest) - xGhOsTkiLLeRx

Deutsch (newest with umlauts) - PinguinAman

Dutch - Lakloplak

French- Chbrams

Hungarian - Anachen

Italian - Massimo1993

Polish - LeonidasPL

Portugese(Brasil) - viruzinbr

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

Slovenian - jEErc

Spanish - xX_Lirianer_Xx

Spanish - Croslicre

Swedish - sebbe35

For iConomyChestShop 2.75:

Czech - Tonysp

Deutsch - l1nkman

Dutch - iFearz

Dutch - tahu

French - couldn't find the author :/

Italian - Aselox

Polish - me

Russian - Lazy from http://www.mineclub.ru

Spanish - Trollkemada

Spanish - metakin

Permissions:

Easy to copy: http://pastebin.com/aBb36xwJ

ChestShop.shop.create - lets you create shop

ChestShop.shop.buy - lets you buy from shops

ChestShop.shop.sell - lets you sell to shops

ChestShop.nofee - lets you create shops for free

ChestShop.mod - lets you open other people's chests, but doesn't let you create admin shops

ChestShop.admin - ChestShop.mod + ability to create admin shops, etc.

You can also add ".itemID", where itemID is... well... item id.

ChestShop.shop.create.itemID - lets you create shop which buys/sells itemID.

ChestShop.shop.buy.itemID - lets you buy itemID from shops

ChestShop.shop.sell.itemID - lets you sell itemID to shops

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

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

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.

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)

Kenan's tutorial (French)

BassettGoesPro's tutorial

xrobau's tutorial

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

- @Epics for his great help

If something's not working

If you can both buy and sell, and your users can only buy, go to bukkit.yml and change spawn-radius to 0. 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?

Version 3.35

• Changed to the new, more robust event system
• Added partial transactions (You have 5 items, shop wants 10 - you can sell your items for half the price)
• Added a warning to the HTML generator
• Fixed Towny integration
• Fixed occasional ArrayOutOfBoundsExceptions
• Fixed an error when a shop couldn't be created because a sign (not shop sign) was on other side of the block
• Added SCL (SimpleChestLock) protection plugin to supported plugins
• Updated Metrics (and added a new asynch thread for startup)
• Removed Bukkit-1.0 workaround
• Fixed plugin.yml formatting

Version 3.34

• Added statistics to the plugin
• Added shop refund message
• Recoded Register for ChestShop
• Added VAULT support (Register is used when no Vault is found)
• Added Heroes exp option for granting exp for shop creation
• EXPERIMENTAL: Option to cause BlockState.update() every transaction (probably doesn't work, as Block.applyPhysics() is needed)
• Added ChestShop.nofee permission for free shop creation (and no refunds)
• Added a separate Admin Shop tax option

Version 3.33

• Fixed OPs being able to open Admin Shops, which have no inventory

Version 3.32

• Fancy sign formatting
• Fixed LWC, Lockette and Default protections
• Added restricted signs (Changed how they work)
• Added an option to use another name
• Fixed a bug where default protection was initialized too many times
• Disallowed players to place another chest near a shop chest
• Speeded up and fixed enchantment and durability in itemstacks
• Changed /iteminfo a bit
• Added /chestshop reload
• Added many default permission kits
• Fixed dye colors
• Added an option to allow towny residents place shops in their town

Version 3.31

• Fixed potion stacking and adding items to stacks with a different durability
• Modified /iteminfo a bit
• Added a message to the DBpage generator
• Added more functions to word datavalue
• Modified the SignChange fourth line formatting

Version 3.30

• Added selling/buying of Enchanted items
• Modified /iteminfo command to show enchantments (and their id)
• Fixed LWC problem
• Added an option to ignore creative mode
• Fixed broken inventory.addItem(ItemStack) (adds up to custom Material max stack amount now)

Version 3.29

• Fixed block destruction

Version 3.28

• Configured multiple protection plugins to work at once
• Added custom LWC protection limit message
• Fixed block destroying
• Added a new permission node, to let people create shops as other user (also usable for Towns, Factions etc.)

Version 3.24

• Fixed the plugin for java 6

Version 3.23

• Added WorldGuard support
• Fixed protection
• Added shop refund price
• Updated Register

Version 3.22

• Added option to tax all transactions
• Updated Register and BukkitEx
• Can't place shops in the wilderness (Towny)
• Fixed CraftBukkit's piston bug - no more try/catch

Version 3.21

• Added support for OddItem 0.8
• Fixed getRetractBlock

Version 3.2

• Updated Register
• Support for Townie's shop plots
• Doesn't load Towny older than 0.76.0.47 (Yeah, long, custom, difficult method)
• Replaced onBlockPistonRetract to use custom method instead of try/catch
• You won't sell to your own shop anymore
• Added Towny to dependencies

Version 3.12

• Added parenthesis in the code, fixed ALL the bugs

Version 3.11

• Fixed a bug with admin placed signs.

Version 3.1

• Changed how configuration works, so it works with plugin folder in different place
• Added support for Deadbolt
• By default, left clicking your own sign doesn't do anything
• Restricted signs now check if you've got permission ChestShop.group.groupName
• Added support for stacking unstackable things
• Updated Register
• Changed how plugins are loaded.

Version 3.04

• Added support for new Lockette
• Fixed LWC

Version 3.03

• Fixed new lines in configs
• Fixed sign protection
• Doesn't protect with LWC if the limit is reached
• Added a message when you paid for shop.
• Moderators CAN destroy shops now

Version 3.02

• Fixed item amounts bigger than a stack
• Fixed rare plugin start bug
• Fixed block protection

Version 3.01

• Fixed LWC bug

Version 3.00

• Changed the name to 'ChestShop' - as it supports many more plugins
• Re-coded everything from scratch
• Eliminated all known bugs
• Added support for many more economy plugins
• Removed /buy and /sell commands
• Opening chests by clicking the sign
• Chest can be now placed in 1 block radius from the sign
• Added chest masking (experimental)
• Added mod permission
• Changed Permissions from 'iConomyChestShop' to 'ChestShop'
• ...and probably much more, because I must have forgotten something