1.x/Trader: Difference between revisions

From Citizens Wiki

< 1.x

No edit summary
Line 1: Line 1:
'''Traders''' allow trading of items for virtual currency. The trader can both buy and sell items to the player, and uses an intuitive interface to facilitate this. '''Warning:''' may be exploitable under lag until bukkit creates inventory events.
'''Traders''' allow trading of items for virtual currency. The trader can both buy and sell items to the player, and uses an intuitive interface to facilitate this. '''Warning:''' may be exploitable under lag until bukkit creates inventory events.
== Permissions ==
To stock a trader, one requires the permission 'citizens.trader.modify.stock'. To trade with the trader, give users the permissions 'citizens.trader.use.trade'.


== Commands ==
== Commands ==

Revision as of 13:52, 8 October 2011

Traders allow trading of items for virtual currency. The trader can both buy and sell items to the player, and uses an intuitive interface to facilitate this. Warning: may be exploitable under lag until bukkit creates inventory events.

Permissions

To stock a trader, one requires the permission 'citizens.trader.modify.stock'. To trade with the trader, give users the permissions 'citizens.trader.use.trade'.

Commands

[] - Mandatory
() - Optional

Command - command's syntax
Args Description - description of the command's arguments
Require Selected - whether the command requires an NPC to be selected
Require Ownership - whether the commands requires you to be the owner of the NPC
Permission - command's permission node
Description - short description of the command

Command Args Description Require Selected Require Ownership Permission Description
/trader help None false false citizens.trader.use.help View the help page for traders
/trader money (give/take) (amount) give/take - whether to give or take money from a trader
amount - amount to give or take
true true citizens.citizens.trader.modify.money to modify; citizens.trader.use.showmoney to view the current balance Control a trader's balance
/trader list [buy/sell] buy/sell - whether to display the buy or sell list true false citizens.trader.use.list View a trader's buying/selling list
/trader unlimited None true true citizens.trader.modify.unlimited Toggle a trader as having an unlimited stock
/trader buy/sell [item] [price] item - item to add to the list
price - price of the item being added
true true citizens.trader.modify.stock Change the stock of a trader
/trader clear [buy/sell] buy/sell - whether to clear the buy or sell list true true citizens.trader.modify.clearstock Clear the stock of a trader

FAQ

Why does my trader let players dupe items?
This is due to lag and is a bug with Citizens/Bukkit. Citizens requires inventory events (that's programmer-speak), which Bukkit is not close to implementing.

Why won't you add Spout support so traders aren't buggy?
Spout is a great API for client-side additions to Bukkit. However, we are not interested in supporting it server-side. We don't want people to feel forced to download Spout if they want to use trader NPCs.