CitiTraders2
CitiTraders
Cititraders enables your citizens 2 NPCs to act as traders, buying and selling goods. It works good for admin shops and player shops alike. All traders use the inventory interface for buy/sell and players don't need any commands to interact with Traders.
You can see more details at CitiTraders Wiki
Setting Up A Trader
Interacting
- Right Click the NPC
- Opens the selling window, here the players will select what item they wish to purchase from the NPC
- Right Click the Item
- displays a price of the item
- Left Click the Item
- Opens the final sales window, from here a player can right click again for stack price, or left click to purchase the stack
- Left Click the NPC
- this will open the buy window for NPC, currently players need to just drag and drop items to the inventory and close the window, unpurchased items are dropped if NPC can't purchase these items (soon they will not be able to be dropped into the inventory if NPC can't purchase them)
Adding Stock
- Right Click the NPC with a BOOK in your hand
- This will open an inventory screen where you can place any items you want to sell, if an ADMIN shop these items will not be reduced with sales, but you still need to put 64 (or max stack) of an item to get a full listing of amount in sales window.
- Linked Chests
- If you have linked chests, adding stock is as easy as opening the chest that is linked to the trader, and adding what you want to it.
Commands
Commands Permissions are currently listed here for CitiTraders 2
Permissions
Limits/Profiles
Installation
Just place into the plugins folder and restart the server, make sure you have a working version of Citizens2 and Vault installed first
Requirements
- Citizens 2
- Vault with economy plugin such as BOSEconomy and permissions such as zPermissions.
- (Optional) Towny
TODO
- Add new text to localization file.
- Verify Towny support
Credits
- tehbeard - Original Author
- tenowg - Past Maintainer
- twillen - Current Maintainer
Need update :(
Why no updates ?
After this error no data is saved to citizens/save.yml
How do you make a banker so that players can store their things
Is it possible to modify the text in the inventory (left click buy etc) and the text when you buy or sell something (you don't have enough money to purchase this item, etc)? In the lang folder you can just set the text which appear when you create the trader. I'm french and i'm making a server so I would like to translate this awesome plugin =)
@Twillen
Thank you, this was very informative. I was always curious about why it would always break. I'll just get rid of every plugin I have and keep adding them back until I find the culprit. Thank you.
@OctopusPlaya
What issues are you having, for I haven't noticed any bug so far on my live server with 1.5.2 R0.1. I'm using Citizens 2.0.8 alpha 4, and CitiTrader2 2.0.6. I'm unsure if your issue may be another plugging.
Just as an fyi, every time Bukkit changes a version, the Citizens plugin will break due to how the mod overwrites some of the Minecraft server code. CitiTrader2 dose not, and this should allows older builds to continue to work. The only reason a version of CitiTrader2 will not work cross Bukkit version is if I implement features into the mod that are incompatible and prevents the new code from working with older Bukkit builds. (such as trap chests in 1.5+)
I'm not complaining about this plugin but, why is it so fragile to updates? Even with updates that just fix a few glitches and bugs will keep Citizens and itself from working.
I really hate to bother developers like this but, will there be a 1.5.2. version anytime soon? Sorry and thank you.
Hello Could you add default prices to items with different metadata? I want to make all of my npcs to buy everything what the player want's to sell so some kind of feature like this is very important for me and i think there are other admins who also needs that.
@CommodoreAlpha
Thanks for the report. I know of this bug, but I could never find what causes it. Try using /trader cancel or re-logging. I've forgotten about this bug, and I may review how it is handled.
For some reason, when I try setting something on a CitiTrader (wallet type, sellprices, etc.) the console will spew out this exception:
[WARNING] [CitiTrader] java.lang.NullPointerException General_Kosyginme.tehbeard.cititrader.TraderStatus@1b1890d
There's no stack trace, hence why I didn't PasteBin it.
@Twillen
Yeah, whatever problem I was having appears to have solved itself now.
Sorry for the confusion...
@The_Ant_Reaper
Did you find something broken? I did a few quick tests over the weekend with citizens 2.0.8 alpha 4 and didn't have an issue.
Awesome plugin, but please update to 1.5.2 soon!
At the moment citiTrader mod gives exception.. But that is due to: "16:22:40 [SEVERE] [Citizens] v2.0.8-SNAPSHOT (build 782) is not compatible with Minecraft v1.5.2. Disabling." so the citizens plugin is disabled and makes cititrader fail
@xtm4utb
Thanks, I'll look at it this weekend, but I don't foresee anything breaking, and CititTraders itself dose not need to be compiled against a specific version of bukkit (though the citizens mod dose).
If you find bugs, please let me know on github or here.
Please Update fast...
1.5.2 BUkkit
This plugin would have been perfect it it allowed users to use items as currency. Such as buy 2 cooked porkchop for 3 gold nuggets. Adding the ability to use items as currency would benefit this plugin alot. If that could be done, this would be perfect!
Thankyou, Alex. K
@ursak
Towny support predates my involvement with the Cititraders. I personally never have used Towny, and haven't been actively testing against it. At this time I'm not going to look into faction support, but I may look if there seems to be a large desire for it.