[ECON] ChestShop 3.42 (iConomyChestShop) - Chest&sign shop for economy plugins [1.2.5-R2]

Acrobot · May 22, 2012 at 9:48 AM

ChestShop - click to download

BukkitDev thread

Frequently Asked Questions
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 or BOSEconomy
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.

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
Korean - Zwing87
Polish - LeonidasPL
Portugese(Brasil) - viruzinbr
Romanian - Mafios from www.minecraft-romania.com
Russian - VADemon from http://minemania.ru/
Slovenian - jEErc
Spanish - xX_Lirianer_Xx
Spanish - Croslicre
Swedish - Maxell
Traditional Chinese - hellboyincs

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

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)
Kenan's tutorial (French)
BassettGoesPro's tutorial
xrobau's tutorial
deery50's plugin spotlight
Mordazo360's tutorial (Polish)

adrimat08's tutorial (Spanish)
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.42

Fixed stats page generation

Version 3.41

Reformatted code

Switched from YamlConfiguration to BreezeConfiguration (from ChestShop 4)

Fixed getDouble()

Instead of checking for Admin Shops, we just pass in a new AdminShop Container

Created events for shop creation, protection checks and protection creation

Expanded string data value parsing, for example - you can use "Ocelot Monster" on the sign

Collected all external plugin wrappers in a single folder

Instead of using statics, now we use objects

Fixed enchantments for armour

Made config more readable

Added a setting for removing empty shops

Switched from System.out to logger

Also, switched from ugly file logging to Java's native one (FileHandler)

Added an option to tax transactions even when SERVER_ECONOMY_ACCOUNT is empty

Changed the Container interface

Version 3.40

Now you can set a global max buy/sell price by adding "max-sell-price: 5" in the config. (Of course, same goes for buy price)

Changed the Metrics class to point to the new mcstats.org site

Removed BLOCK_UPDATE config option (which didn't work at all)

Changed message formatting, so instead of "You bought 1 STONE" you get "You bought 1 Stone"

Added WorldGuard container protection

Fixed chest protection bypassing bug

Added ALLOW_SIGN_CHEST_OPEN option to let server owners decide if they want players to be able to open chest's inventory by clicking on their shop sign

Added WORLDGUARD_USE_FLAG option to let server owners decide if they want to use the custom, but hacky WorldGuard flag (/region flag regionName chestshop allow/deny) or to just disallow building in the "wild"

Version 3.39

Fixed chests in 1.2.3

Formatting

Warning about old Bukkit version

Renamed "TOWNY_CANNOT_CREATE_SHOP_HERE" to "CANNOT_CREATE_SHOP_HERE" to avoid confusion

Renamed "NOT_ENOUGH_LWC_PROTECTIONS" to "NOT_ENOUGH_PROTECTIONS" and changed its message

Fixed armour enchantments

Logging shop location

Fixed Heroes for the newest version

Removed redutant plugin object

Added dev-url for CraftBukkitUpToDate

Removed redutant plugins from softdepend

Fixed a bug when the player interacts with a shop with a sign in hand

Version 3.38

Fixed an issue with LWC (defaulting to public protection)

Fixed an issue with admins not receiving the refund when destroying a shop

Version 3.37

Added a warning if spawn-radius isn't set to 0

Deleted a few outdated plugins from built-in Register

System.out -> System.err for errors

Blocked buying if you're holding a sign in your hand (allows, for example, for sign editors to work)

Updated Heroes package

Fixed WG integration (no longer throws errors, but uses ugly workaround)

Fixed a small bug in Register plugin loading message

Removed version checking for OddItem, WorldGuard and LWC

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

iSushi · Feb 13, 2011

Acrobot said: ↑

You should use LWC,
http://forums.bukkit.org/threads/se...ight-inventory-protection-management-230.967/

Thank you
Could you link to that in your post?...

I thought that plugin did something else, ugh, seen it before, but never read it. It seems really really good and helpful, so thanks a lot

unrivaledneo · Feb 13, 2011

Bilkokuya said: ↑

Trying it with:

For some reason it's saying that the sign format is incorrect (no matter what I've tried). Does anybody have any suggestions? There is currently nothing in the server.log.

I got this but found it came from the plugin signtrader which i had installed also

Aurélien ROMMELAERE · Feb 13, 2011

I can't use it, why? ...
When I do /create or /use, nothing..
Help me please !! Thank you

unrivaledneo · Feb 13, 2011

just set up the sign as described. When the player right licks they buy it. Pretty simple and yet so great.

iSushi · Feb 13, 2011

unrivaledneo said: ↑

just set up the sign as described. When the player right licks they buy it. Pretty simple and yet so great.

Oh... I wish my players licked my signs

unrivaledneo · Feb 13, 2011

Nice, ID are alot easier however i still cant get it to sell color wool, only gives white.

iSushi · Feb 13, 2011

Also, mr or miss developer. You're sure you can't add a file that converts text to id's?...

Incendia · Feb 13, 2011

yea, look around and find an items.db and use that please :3

And fix colored wools xD

McSpuds · Feb 13, 2011

Going to load this tonight.. looks good so far.

dfdgsdfg · Feb 13, 2011

Small question. How do I protect signs?

iSushi · Feb 13, 2011

dfdgsdfg said: ↑

Small question. How do I protect signs?

lol, read up.

PandaVidya · Feb 13, 2011

Can someone help me? Its not working :/ idk whether its a problem with iconomy or this plugin. the only commands related to iconomy that working are /money and /money ?

any help

uncovery · Feb 13, 2011

does it sell and buy or only sell?

tygreen19 · Feb 14, 2011

doesnt work on build 325. if the user doesnt have the permissions it shows the message permissions blah blah blah.
but if they do have the right permissions it doesnt do anything.

EDIT:
nvm didnt realize that the ID number was used by default.

this is EXACTLY what i wanted in my server.

i dont want the players to have an infinite pool of items to buy.

thank you!

uncovery · Feb 14, 2011

This works fine with Worldguard when people setup their shop in their areas.

iSushi · Feb 14, 2011

PandaVidya said: ↑

Can someone help me? Its not working :/ idk whether its a problem with iconomy or this plugin. the only commands related to iconomy that working are /money and /money ?

any help

Any errors?...
The iConomy core only gives you those commands, but when you download this plugin it should work fine.

Nate204 · Feb 14, 2011

I got this working great, but players can destroy the signs?.... Is that just me?

bdot · Feb 14, 2011

You have to use LWC for protections.

Worldguard regions have also been said to be working fine.

iFooZy · Feb 14, 2011

When i start my server i says iConomyChestSrop enabled in the cmd
But right after that it says iConomyChestShop permission systen not enabled

Why is that, anyone help?

sharef · Feb 14, 2011

a possible solution to the offline character permission check:
only check creator permissions at creation, and if they have the correct permissions, store the sign/chest location in a sqlite db, or a csv, or w/e your persistence style preference is
then when the buyer right-clicks on the sign, check the persistence file for the validation

just an idea....

you might also use point/command style setup
step 1: place chest
step 2: point at chest
step 3: type /somecommand
step 4: place sign

you could have the /somecommand flag the player to set their next sign to be attached to the chest
this way you could put the chests in a quadruple thick obsidian vault of gtfo, and have the signs out front
EDIT: do NOT use /shop for this, i will rage at you for being the third econ plugin to do so....
EDIT 2: better idea, have the player wack the chest with the sign before placing it, gets rid of /command usage.

excellent work so far though, i have been waiting for one of these....

Arisilde · Feb 14, 2011

Is it possible to make this without needing to put the item type on the sign? So vendors could just stock it with whatever they want and the plugin reads what is removed and charges the player who removes it if they are not the vendor? I feel like that would be a lot more versatile and user friendly.

Mercury · Feb 14, 2011

Hey, is it possible when you write ID on sign, it automatically transforms to name?
So it will be more easier to find stuff.

Acrobot · Feb 14, 2011

I've got a terrible headache at the moment, so I'll update the plugin when I can
@Arisilde - I think I'll make it optional, so you could edit config file if you want to do it that way
@Mercury - Transforming to name wouldn't work, because it currently works incorrectly :/
@sharef - the SIGN.CHANGED event doesn't work at the moment, so I can't check if someone placed a shop sign, but I think I can use the commands
@iFooZy - you probably don't have Permissions plugin.
@Nate - you could use worldGuard for protecting the shop
@uncovery - it currently does only sell, I'll make it buy things in future releases
@iSushi - the text-to-id is broken at the moment, could ANYONE tell me how to use
Code:
for (Material m : Material.values()) {
            if (m.name().toLowerCase().startsWith(name.toLowerCase())) {
                return m.getId();
            }
        }
so it starts at the last index and goes to the first?

I'll fix the coloured wools soon, it gave me NullException last time, but I think I know how to fix it.

sharef · Feb 14, 2011

i don't think you would need a sign changed, you can check sign content which works fine
use onleftclick (i'm not in bukkit yet, comming from hmod)
check item in hand == sign and block hit == chest
store position of chest
then flag the player so the next sign, regardless of content is the shopsign
if they do incorrect syntax, tell them that their a nub and try again

Dragonvine · Feb 14, 2011

The Item ID doesnt seem to work for me at the moment mate. :/
Is it working for everyone else?
I think I'm doing it right..

Dragonvine
1
5000
42

Doesnt seem to work :O

Acrobot · Feb 14, 2011

Did you download the version 0.2, and did you paste everything to /plugins folder?
Also, be sure you have "useID: true" in your plugins/iConomyChestShop/config.yml

PandaVidya · Feb 14, 2011

iSushi said: ↑

Any errors?...
The iConomy core only gives you those commands, but when you download this plugin it should work fine.

no no errors. just nothng happens :/

Dragonvine · Feb 14, 2011

Did you download the version 0.2, and did you paste everything to /plugins folder?
Also, be sure you have "useID: true" in your plugins/iConomyChestShop/config.yml

I just reinstalled the plugin and it worked, thanks anyway.

LucidLethargy · Feb 14, 2011

Can you use this to sell stacks of items? For instance, if I want to sell cobblestone it would be too expensive at 1 coin per unit.

Oh, also if you could make this work like the old iTrade plugin (with stock and buying) it would be AMAZING. Simply put, I want to make my banks work again, where you put gold ingots in chests, then poof you have some coins when you click the sign!

So selling would be nice, but selling to the SERVER would be awesome

uncovery · Feb 14, 2011

could you setup alternative location options for the sign such as in front of the chest? That would be great!

Log in or Sign up

[ECON] ChestShop 3.42 (iConomyChestShop) - Chest&sign shop for economy plugins [1.2.5-R2]

Acrobot

iSushi

unrivaledneo

Aurélien ROMMELAERE

unrivaledneo

iSushi

unrivaledneo

iSushi

Incendia

McSpuds

dfdgsdfg

iSushi

PandaVidya

uncovery

tygreen19

uncovery

iSushi

Nate204

bdot

iFooZy

sharef

Arisilde

Mercury

Acrobot

sharef

Dragonvine

Acrobot

PandaVidya

Dragonvine

LucidLethargy

uncovery

Share This Page

[ECON] ChestShop 3.42 (iConomyChestShop) - Chest&sign shop for economy plugins [1.2.5-R2]

Share This Page

Useful Searches