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
Made a banner! You're free to use it wherever!
(25% actual size)
and here's some bigger versions:
50% actual size: http://dl.dropbox.com/u/43717161/Plugins/CitiTraders2/cititraders2-50pc.png
Full Size: http://dl.dropbox.com/u/43717161/Plugins/CitiTraders2/cititraders2.png
Ok I found a way to pull standard potions names out of vault, so the next update will have better support for potions. If there is no name for the potion in vault, I'll include the data value to make price management easier on server admins.
I'll look into better book support and named item support before releasing this change. I'll release 2.0.4 with how ever far I get by 3-15.
@OctopusPlaya
Glad to hear its working for you. I'll look into it. Tonight I'm looking into just how to retrieve the detailed name of a potion, and i'm finding it not quite as simple as it sounds. I'll definitely look into custom names next.
@Twillen
Okay, I finally got it working. I just took out Citizens all together, booted it with Citizens again, shut it down. Then booted it with CitiTraders2 and they work. Thank you so much for helping me.
P.S.
Will it ever be possible to sell renamed items from an anvil?
@Debzy86
Debzy, I'm having no issues buying and selling potions. I do see one issue that'll try to address is the text for all potions just states potions. I'll see if I can update the display of the text to include the type of potion it is, for its hard to tell what potion you set to buy / sell in game.
@TMGaming
If it's failing to run, there should be an error message during start up of the server, they'll give us a clue on what went wrong. If Cititrader did load, what dose it display when you do /trader?
I have installed Citizens,cititraders, vault, and boseconomy and I cant even create a trader :( Help?!
@Debzy86
Sorry for the slow response Debzy. Off the top of my head I cant think of any reasons that potions would have stop working, but I'll test it tonight when I get home. Also check that the stock of potions in the chest are identical to the ones used to set the price.
With items with durability, the durability of the item is apart of a specific item. An iron sword with full durability is a different item then an iron sword with 99% durability, witch is different then an iron sword with 50% durability.
Traders are still not showing all items added, Any idea why? Or why the potions won't sell?
@trkah
You can change the name with the standard citizens commands.
http://wiki.citizensnpcs.com/Commands
/npc rename <Name>
How do you change a traders name?
@OctopusPlaya
Can you let me know what build of Citizens you are using, and possibly any other Citizens modes your using. I'm going to be verifying this week that Cititraders still works with 2.0.7 Beta, right now I have only been testing with 2.0.7 alpha. Also kinda a long shot, but double check that you don't have any outdated Cititrader jars still in your plugin folder.
@Twillen
Dang! I updated it and it still just gives me back the options for Citizens 2.
Actually, the second error i reported (can't finish sale) seems to be limited to potions
I've found another issue, when players left click the item it does open the final sales window, but the item isn't in it for players to finish the transaction?
Hello! I absolutely love this plugin, but it doesn't register all the items, have you got them all added? It links chests fine and lets me set the prices for any item, but when you click on the trader it doesn't show all the items. Ones that i have noticed so far are iron armor (except for iron boots), apples, carrots and melon slices, redstone repeaters, sticky pistons, flowers, most saplings, various mob eggs... x
@Blanclour
I've never tried a renamed item with a trader before, and I'll play around with it soon. For books, I can look into it. It's been quite awhile since I last read about coding books, but last I read about copying / storing books, it was quite hackish.
@OctopusPlaya
Interesting, what version of citizens are you on? Also what other citizens mods do you use. That text back almost seems like its coming form Citizens, and not Cititraders. I've been coding and testing everything against Citizens 2.0.7 alpha that you can get off dev.bukkit.
@OctopusPlaya
Wait for the update to go through today, then update your server with the new version. Hopefully it'll fix your issue. Does this issue occur after reloading the server's plugins with the /reload command? I've only encountered the same thing when doing that, but otherwise can't replicate the issue.
@Twillen
Thank you for responding, no I don't get back any error. I just get back the commands from Citizens 2 when I do /Trader. If I do /Trader Create I will get some like "Did you mean /Trader Clear?". I'm also the server operator so I have all permissions. So yes, I do have the "traders.command.*" permission.