CitiTraders: Difference between revisions
Aufdemrand (talk | contribs) No edit summary |
No edit summary |
||
| Line 3: | Line 3: | ||
| AUTHOR = tehbeard, tenowg | | AUTHOR = tehbeard, tenowg | ||
| NAME = CitiTraders | | NAME = CitiTraders | ||
| VERSION = 0. | | VERSION = 0.3 Beta | ||
| CITIZENSBUILD = 2.0 dev build #264 | | CITIZENSBUILD = 2.0 dev build #264 | ||
| DEVSTATUS = InDev | | DEVSTATUS = InDev | ||
| DEPENDS = Citizens 2, Vault, a permissions system and an economy system. | | DEPENDS = Citizens 2, Vault, a permissions system and an economy system. | ||
| DOWNLOADLINK = https://tenowg.ci.cloudbees.com/job/CitiTraders/# | | DOWNLOADLINK = https://tenowg.ci.cloudbees.com/job/CitiTraders/# | ||
| DESCRIPTION = Cititraders are NPCs that support interface-based trading. [https://github.com/ | | DESCRIPTION = Cititraders are NPCs that support interface-based trading. [https://github.com/tenowg/CitiTraders/issues Issues page] | ||
}} | }} | ||
| Line 26: | Line 26: | ||
[NAME] - Name of the NPC to create | [NAME] - Name of the NPC to create | ||
[TYPE] - type of NPC to create, (defaults to PLAYER if omitted) | [TYPE] - type of NPC to create, (defaults to PLAYER if omitted) | ||
| Line 39: | Line 38: | ||
# Hold the book | # Hold the book | ||
# Right click your trader while holding the book | # Right click your trader while holding the book | ||
# Place items into traders inventory | |||
== Setting Buy/Sell prices == | |||
:'''<code>/trader sellprice <amount></code> | |||
and | |||
:'''<code>/trader buyprice <amount></code> | |||
after either of these command, right click the trader with the item in hand, this will set that items price with '''this''' trader. Prices are not global. | |||
== Buying and Selling == | |||
=== Buy from a Trader == | |||
To purchased goods from a trader you need to '''Right Click''' a trader. This will open a trade (inventory) window that lists all the different types of items the trader has on hand. | |||
At this time you need to select the item you wish to purchase, '''Left Click''' on the item you wish to purchase, this will take you to the purchase window, here stacks of items will be made available, but only up to what the NPC has forsale. At this point you can '''Right Click''' to see the price of the stack, and '''Left Click''' to purchase the stack. | |||
=== Selling to a Trader === | |||
To sell to a trader first '''Left Click''' the trader, an inventory window will open, drag any item you want to sell to the trader to his window. Close the window. The prices will be caluculated and deposited into your account, any items he doesn't take will be dropped to the group on close. | |||
(This is going to be changed, Items the trader takes will be listed, and consumed on drop) | |||
Revision as of 14:25, 28 August 2012
File:CitiTraders.png
CitiTraders
| Author | tehbeard, tenowg |
| Version | 0.3 Beta |
| Citizens build | 2.0 dev build #264 |
| Other dependencies | Citizens 2, Vault, a permissions system and an economy system. |
| Download | Link |
Description: Cititraders are NPCs that support interface-based trading. Issues page
| |
CitiTraders is a set of Citizens 2.0 traits that gives NPCs the ability to:
- Buy and sell items for pre-set prices.
- Maintain an inventory.
- Work with Economy plugins to use bank accounts, owner accounts, or a per-npc account.
WARNING
CitiTraders is still very much a beta character, as such, it is recommended only for evaluation purposes at this time unless you accept the fact that something will probably be broken/cheatable with.
Installation
CitiTraders requires no configuration by itself. However it requires that you have Vault, an economy plugin that can be accessed via Vault and
Creating a new npc as a trader
/trader create [NAME] -type [TYPE]
[NAME] - Name of the NPC to create [TYPE] - type of NPC to create, (defaults to PLAYER if omitted)
Adding trader to an existing NPC
To add trader functionality to existing NPCs use:
/trait wallet
and
/trait stockroom
Accessing the storeroom of a trader
- Get a book
- Hold the book
- Right click your trader while holding the book
- Place items into traders inventory
Setting Buy/Sell prices
/trader sellprice <amount>
and
/trader buyprice <amount>
after either of these command, right click the trader with the item in hand, this will set that items price with this trader. Prices are not global.
Buying and Selling
= Buy from a Trader
To purchased goods from a trader you need to Right Click a trader. This will open a trade (inventory) window that lists all the different types of items the trader has on hand. At this time you need to select the item you wish to purchase, Left Click on the item you wish to purchase, this will take you to the purchase window, here stacks of items will be made available, but only up to what the NPC has forsale. At this point you can Right Click to see the price of the stack, and Left Click to purchase the stack.
Selling to a Trader
To sell to a trader first Left Click the trader, an inventory window will open, drag any item you want to sell to the trader to his window. Close the window. The prices will be caluculated and deposited into your account, any items he doesn't take will be dropped to the group on close. (This is going to be changed, Items the trader takes will be listed, and consumed on drop)