DtlTraders/managing: Difference between revisions

From Citizens Wiki
No edit summary
(przepisane teksty na calej stronie - lethe)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Introduction ==
== Introduction ==
<b>What does this managing means?</b>
Managing a trader is in essence changing its variables. Several aspects of npc traders can be controlled in this way. Managing differs between each trader type, because each has its own function and they don't work in the same way.
 
Mainly, ''managing'' a trader, tells about changing his variables. We can change the traders ''owner'' or ''wallet'', but also we can ''manage'' his stock, or in other words inventory. Managing is different for each trader type, because every type has got his own ''features''.
 
<b>How much differs the managing systems?</b>
 
The biggest difference is how we ''add'', ''edit'' and ''remove'' items within the traders stock. Any other managing like ''price managing'' or ''limits managing'' are similar and often easy to make it up how it works.
 
<b>Is there a way to manage traders with commands?</b>
 
So far i didn't created commands to ''add'', ''edit'' or ''remove'' items, but I will add it, so be prepared for ''commands'' update in near future.
 
 


So far only basic commands have been adeed, but far more will be included in a future update. At this time it is not possible to fully manage a trader using only commands.
== Server trader ==
== Server trader ==
==== Features ====
==== Features ====
Lets list some features we can use
# buy and sell tabs (max 51 slots each)
 
# global limits
# has got a buy and sell stock (max 51 slots)
# player limits (currently not working, will be fixed in a future update)
# allows to set ''global limits''
# prices can be set per item or per item stack
# allows to set ''player limits'' (at this moment it's broken, will be fixed till 2.0R)
# items can be sold in several customizable stack sizes
# allows to toggle ''stack price'' format
# six different wallets types
# allows to add ''multiple amounts''
<div style="width:100%;border-top: solid 1px silver"></div>
# 6 different wallets
 
 
==== Stock managing ====
==== Stock managing ====
<b>Adding an item</b>
<b>Adding an item</b>
<br />
To add an item into a ''server trader's'' stock just drag and drop the item from your inventory. That's it.<br />
The buy/sell tab layout is saved after every change so items will always appear in the slots they were added to. This allows you to arrange the offered goods in any way you want.<br />
<br />
<b>Editing an item</b>
<br />
If you want to relocate an item that is already in the trader's stock just drag it to a new location. Item iformation is retained, the only thing that will change is it's position.<br />
<br />
<b>Removing an item</b>
<br />
To remove an item so it can no longer be sold/bought simply drag and drop it to your inventory.<br />
<br />
<b>Switching between the sell and buy tabs</b><br />
In the lower right corner of the trader's inventory are several differently colored wool blocks (this can be changed to anything you want in the config file). The rightmost one switches between selling and buying items. A message will appear when you successfully switch tabs.


To add an item into a ''server traders'' stock we just take an item from our inventory and put it into the traders inventory. Thats it. When an items is added it saves it's slot and appears always in this slot. So we can arrange the inventory displayed to a customer.
<div style="width:100%;border-top: solid 1px silver"></div>


==== Price managing ====
<b>Enabling the price managment</b><br />
Added items don't have a price assigned to them. To be able to set it you have to click the black wool (the middle one if changed to something else). To exit the price edit mode simply click it again.<br />
<br />
<b>Checking the current price</b><br />
To see an item's current price just click it with an '''empty''' cursor.<br />
<br />
<b>Changing the price</b><br />
Change in the price value is dependent on:


<b>Editing an item</b>
#'''type of interaction'''
##right click decreases the price
##left click increases the price
#'''item used'''
##wood counts as * 0.01
##log counts as * 0.1
##dirt counts as * 10
##cobblestone counts as * 100
##items not listed above count as * 1


When we pickup an item in the traders stock it will inform us about this, we can now change it's position in the inventory. Nothing else will be change just the items position.
Examples:


    A single click with a block of drit increases the price by 10
    Ten clicks with a block of soul sand increase the price by 10
    One right click with 10 blocks of dirt deacreases the price by 100


<b>Removing an item</b>
<b>Price patterns (will be added in ver 2.0)</b>
 
But we have got an idea we don't want to sell anymore an item, it makes players too strong, so we grab that item and put it back into out inventory. Done!. This item has never been in the traders stock. ;>
 


<b>Switching between ''sell'' and ''buy'' stock (tab)</b>
Price patterns let you create several pricing profiles and quickly switch between them. Additionally with a pricing pattern active adding any item included in the profile will automatically set it's price. You can still change the price manually.


But we also want to allow players sell items to the trader, how we do this? In the right bottom corner are three different wool colors (if not changed in the config file). So far wee need to know that the most right items is a toggle between a traders ''sell'' and ''buy'' tab. It will be announced to us which tab has been toggled.
<div style="width:100%;border-top: solid 1px silver"></div>


==== Price managing ====
==== Stack price ====
<b>Enabling the price managing</b>
To easily set the desired price when selling multiple items at once you can turn on the stack price setting. Usually you just set the price of a single item and it gets multiplied by the number of items in the stack. The above option gives you direct control over the final price so you don't have to use fractions when you want to set the price to a specific number. 


But wait, all items I've added into the traders inventory don't got a price! So, thats an job for the '''black wool'''! This default wool enables the ''price managing'' for items found in the traders inventory. If we click it, it will change its color to ''white'', that means always '''go back to stock managing'''.  
To apply the price to the whole stack instead of a single item just '''right click''' the item.


Once we clicked it we can show up and change prices for every item;
<b>''Warning''</b>: Stack price and amount selection menu cannot be used together. This will be changed in the near future.


<div style="width:100%;border-top: solid 1px silver"></div>


<b>Showing up a price</b>
==== Global limits ====
Limits are used to control how many items can be bought in a given time frame. Buying an item decreases the limit counter and when it reaches zero the item is no longer offered. When a set amount of time has passed the limit counter resets back to its original value and the item can be bought again.


To see the items current price just click it with an '''empty''' cursor.
To place limits on the number of offered items click the blue wool


# right click lowers the limit
# left click raises the limit
# shift right click decreases the time it takes for the limit to reset
# shift left click increases the time it takes for the limit to reset


<b>Changing a price</b>
<div style="width:100%;border-top: solid 1px silver"></div>


To change the items price, you just need to take any item you got in the inventory and click with it on a ''stock item''.
==== Player Limits ====
Player limits work the same as above. The only difference is that the limit is applied individualy per player instead of a global effect.


* '''left click''' will increase the price by the amount of the holding item (so clicking an ''stock item'' with '''3 wool''' will increase the price by 3$)
Player limits are not implemented at this time.
* '''right click''' will decrease the price by the amount of the holding item (so clicking an ''stock item'' with '''2 emerlands''' will decrease the price by 2$)
== Navigation ==
{| class="wikitable" style="text-align: center; width: 500px"
|-
! style="width: 100%; background-color:#ADD8E6" colspan="2" | '''DtlTraders'''
|-
| Usage || | [http://wiki.citizensnpcs.com/DtlTraders/managing Managing] | [http://wiki.citizensnpcs.com/DtlTraders/trading Trading] | [http://wiki.citizensnpcs.com/DtlTraders/banking Banking] <!-- | [http://wiki.citizensnpcs.com/DtlTraders/patterns Patterns] -->
|-
| Configuration || | [http://wiki.citizensnpcs.com/DtlTraders/config Configuration] | [http://wiki.citizensnpcs.com/DtlTraders/Commands Commands] | [http://wiki.citizensnpcs.com/DtlTraders/permissions Permissions] | [http://wiki.citizensnpcs.com/DtlTraders/locale Locale]
|-
| Types || | [http://wiki.citizensnpcs.com/DtlTraders/traders Traders] | [http://wiki.citizensnpcs.com/DtlTraders/bankers Bankers] <!--| [http://wiki.citizensnpcs.com/DtlTraders/auctionhouse Auction House] | [http://wiki.citizensnpcs.com/DtlTraders/wallets Wallets]-->
|}

Latest revision as of 09:30, 11 September 2012

Introduction

Managing a trader is in essence changing its variables. Several aspects of npc traders can be controlled in this way. Managing differs between each trader type, because each has its own function and they don't work in the same way.

So far only basic commands have been adeed, but far more will be included in a future update. At this time it is not possible to fully manage a trader using only commands.

Server trader

Features

  1. buy and sell tabs (max 51 slots each)
  2. global limits
  3. player limits (currently not working, will be fixed in a future update)
  4. prices can be set per item or per item stack
  5. items can be sold in several customizable stack sizes
  6. six different wallets types

Stock managing

Adding an item
To add an item into a server trader's stock just drag and drop the item from your inventory. That's it.
The buy/sell tab layout is saved after every change so items will always appear in the slots they were added to. This allows you to arrange the offered goods in any way you want.

Editing an item
If you want to relocate an item that is already in the trader's stock just drag it to a new location. Item iformation is retained, the only thing that will change is it's position.

Removing an item
To remove an item so it can no longer be sold/bought simply drag and drop it to your inventory.

Switching between the sell and buy tabs
In the lower right corner of the trader's inventory are several differently colored wool blocks (this can be changed to anything you want in the config file). The rightmost one switches between selling and buying items. A message will appear when you successfully switch tabs.

Price managing

Enabling the price managment
Added items don't have a price assigned to them. To be able to set it you have to click the black wool (the middle one if changed to something else). To exit the price edit mode simply click it again.

Checking the current price
To see an item's current price just click it with an empty cursor.

Changing the price
Change in the price value is dependent on:

  1. type of interaction
    1. right click decreases the price
    2. left click increases the price
  2. item used
    1. wood counts as * 0.01
    2. log counts as * 0.1
    3. dirt counts as * 10
    4. cobblestone counts as * 100
    5. items not listed above count as * 1

Examples:

   A single click with a block of drit increases the price by 10
   Ten clicks with a block of soul sand increase the price by 10
   One right click with 10 blocks of dirt deacreases the price by 100 

Price patterns (will be added in ver 2.0)

Price patterns let you create several pricing profiles and quickly switch between them. Additionally with a pricing pattern active adding any item included in the profile will automatically set it's price. You can still change the price manually.

Stack price

To easily set the desired price when selling multiple items at once you can turn on the stack price setting. Usually you just set the price of a single item and it gets multiplied by the number of items in the stack. The above option gives you direct control over the final price so you don't have to use fractions when you want to set the price to a specific number.

To apply the price to the whole stack instead of a single item just right click the item.

Warning: Stack price and amount selection menu cannot be used together. This will be changed in the near future.

Global limits

Limits are used to control how many items can be bought in a given time frame. Buying an item decreases the limit counter and when it reaches zero the item is no longer offered. When a set amount of time has passed the limit counter resets back to its original value and the item can be bought again.

To place limits on the number of offered items click the blue wool

  1. right click lowers the limit
  2. left click raises the limit
  3. shift right click decreases the time it takes for the limit to reset
  4. shift left click increases the time it takes for the limit to reset

Player Limits

Player limits work the same as above. The only difference is that the limit is applied individualy per player instead of a global effect.

Player limits are not implemented at this time.

Navigation

DtlTraders
Usage Managing | Trading | Banking
Configuration Configuration | Commands | Permissions | Locale
Types Traders | Bankers