DtlTraders/managing: Difference between revisions

From Citizens Wiki
No edit summary
(przepisane teksty na calej stronie - lethe)
 
(4 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''
# 6 different wallets
 
<div style="width:100%;border-top: solid 1px silver"></div>
<div style="width:100%;border-top: solid 1px silver"></div>
==== Stock managing ====
==== Stock managing ====
<b>Adding an item</b>
<b>Adding an item</b>
 
<br />
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.
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>
<b>Editing an item</b>
 
<br />
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.  
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>
<b>Removing an item</b>
 
<br />
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. ;>
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 />
<b>Switching between ''sell'' and ''buy'' stock (tab)</b>
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.
 
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>
<div style="width:100%;border-top: solid 1px silver"></div>


==== Price managing ====
==== Price managing ====
<b>Enabling the price managing</b>
<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:


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'''.  
#'''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


Once we clicked it we can show up and change prices for every item;
Examples:


 
    A single click with a block of drit increases the price by 10
<b>Showing up a price</b>
    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
To see the items current price just click it with an '''empty''' cursor.
 
 
<b>Changing a price</b>
 
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''.
 
* '''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$)
* '''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$)


<b>Price patterns (will be added in ver 2.0)</b>
<b>Price patterns (will be added in ver 2.0)</b>


Up from version 2.0 there will be added ''price patterns'', so you can set an pattern and assign it to a trader. Within that pattern you can set the default global prices for items set within a ''server trader''. So just add items and all other things will be done automatically! Until you don't change the price manually.
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.


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


==== Stack price ====
==== Stack price ====
Stack price flag is just an improvement for price managing so you don't need to calculate the price for 1 item to get the ''beloved price''. So lets say we want to set a stack of 3 dirts to cost 3$ but how we should do that? Setting the items price to <b>.66</b> will give us a partial win because the price will be <b>2.99</b>$. So here using the ''stack price'' flag is a way to fix this.  
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 toggle the flag you just need to '''right click''' the item in the '''stock management'''. From up now prices will be added for the whole stack.
To apply the price to the whole stack instead of a single item just '''right click''' the item.


<b>''Warning''</b>: so far toggling the ''stack price'' flag prevents opening the ''multiple amounts'' selection. It will be changed in near future.
<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>
<div style="width:100%;border-top: solid 1px silver"></div>


==== Global limits ====  
==== 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


# 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


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


==== Player Limits ====
==== 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.


Working on it.
Player limits are not implemented at this time.
== 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