DtlTraders/config: Difference between revisions

From Citizens Wiki
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page contains the default configuration file and a brief description of available options. <br /><br /><b>Note:</b> Any other config nodes appearing in the <i>config</i> are at this moment not used.<br />
To be sure that everyone of you will understand the configuration file I have decided to explain each config option here, I will try to give you examples how it will affect the way you can use this plugin, and how helpful it can be if your using more advanced features.  


== Default config (v2.0) - (1.9.4+ compatible) ==
== Default config file ==


<div style="border: solid 1px black;padding:10px;padding-top:0px"><span style="white-space: pre;color:darkgreen;">
<pre>
<span style="color:red">#locale settings</span>
debug: critical
locale:  
#locale settings
<span>  file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">english.loc</tt></span>
locale:
<span>  basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">''</tt></span>
  #the choosen localization to load
  load: en
  #should the locale updated autmaticaly, (not implemented)
  auto-update: false
#logging settings
logging:
  #should transactions be logged? (false/FILE/SQL/WEB) , (not used at this moment)
  log: false
  #the foramt how transactions should be logged to FILE, (not used at this moment)
  log-format: ''
#statistics
statistics:
  #enable or disable statistics (not implemented)
  enabled: false
  #metrics should be enabled? (not implemented)
  metrics: false
#trader types related settings
trader:
  #sets if left clicking the Trader should damage him, if set to false the trader wont be damaged and the click will be handled as ManagerMode toogling
  #when the player meets the requirements (permissions, and right-click = false)
  #it this setting is set to true, manager modes is toggled only when sneaking
  allow-damage: false
  #item used to toggle between modes (air counts for anything)
  #transaction related settings
  transaction:
    #sets if buying and selling should be done after clicking on a item twice in a row
    double-click: false
  #manager mode related settings
  managing:
    #the starting stock when opening a trader (buy/sell)
    start-stock: sell
    #right click toggling (instead of left click, which is default from 3.0+)
    #Attention: When PvP is disabled in the world, and the NPC is Player-Type, left click may not work!
    #if r.click toggling is enabled the item needs to be other than AIR. If not set to an item "stick" item will be used.
    right-click: false
    item: 'air'
    #special blocks used when setting prices and limits, format => 'item_id value'
    special-blocks:
    - dirt 0.01
    - wood 0.1
    - log 10
    - cobblestone 100
    - stone 10000
  #stock related settings
  stock:
    #default starting stock (if this stock is set and not empty!, this does not apply for player traders)
    start-stock: 'sell'
    #default stock size in rows, min 1, max 6 (applied on creation)
    size: 6
    #default stock name format, how should be the traders stock named by default, {npc} tag for npc name
    format: '{npc}^r''s shop'
  #wallet related settings
  wallet:
    #default wallet type for traders (if set to infinite player traders will use "owner" type instead)
    type: 'infinite'
    #initial wallet money on creation (does not apply for player traders)
    money: 0.0
  #pattern related settings
  pattern:
    #default patterns applied to each market and server trader uppon creation (array setting)
    defaults: []
    #the file where patterns are saved
    file: 'patterns.yml'
  #book item related settings
  books:
    #the file where book datas are stored
    file: 'books.yml'
    #how should be books stored? (file)
    store: 'file'
  #player trader related settings
  player:
    #limits of player traders per player
    limit: 1
    #default stock size for player traders, if set overrides the stock.size setting
    size: 2
    #default stock name format, how should be the traders stock named by default, {npc} tag for npc name, and {player} for the traders owner
    #if set overrides the stock.format setting
    format: '{npc}^r''s shop, {player}''s company'
  #ui related settings
  ui:
    #item that will "link" to sell stock
    sell: wool:1
    #item that will "link" to buy stock
    buy: wool:2
    #item that will "link" back to a basic stock
    back: wool:14
    #item that will "link" to price managing
    price: wool:15
    #item that will "link" to limit managing
    limit: wool:3
    #item that will "unlock" the stock for eiding
    lock: wool:4
    #item that will "lock" the stock (saving all changes)
    unlock: wool:5
#denizen support related settings
denizen: []
</pre>


<span style="color:red">#wand settings</span>
== Debug ==
wands:
Plugins sometimes got a debug logger, this feature allows you and me easier bug tracking, if a bug shows up, changing this node to a lower priority value, will show more information about the plugin actions and behavior. The dtlTraders debugger got '''six''' logging levels, <span style="color:red">'''critical'''</span>, <span style="color:orange">'''high'''</span>, <span style="color:gold">'''normal'''</span>, '''low''', '''info''', '''none'''.
<span>  manage: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">280</tt></span>
<span>  settings: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">386</tt></span>


<span style="color:red">#trader settings</span>
trader:


<span style="color:red">#trader patterns settings</span>
Setting the level to '''none''' will totally mute the logger, so no error will be shown when anything goes wrong (unless its really serious).  
<span>  patterns:</span>
<span>    file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'patterns.yml'</tt></span>
<span>    default: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px"></tt></span>


<span style="color:red">#inventory "navigation"</span>
The <span style="color:red">'''critical'''</span> level setting shows only errors that totally break the plugin actions, so they are really rare and should be reported to the plugin dev.
<span>  inventory-navigation: </span>
<span>    sell-tab: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:5'</tt></span>
<span>    buy-tab: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:3'</tt></span>
<span>    manage-price: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:15'</tt></span>
<span>    manage-buy-limit: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:12'</tt></span>
<span>    manage-global-limit: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:11'</tt></span>
<span>    manage-player-limit: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:12'</tt></span>
<span>    return: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">35</tt></span>
<span>    amounts-return: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:14'</tt></span>


<span style="color:red">#banker settings</span>
The <span style="color:orange">'''high'''</span> level setting show errors that disturbed an action the plugin was performing, but did not changed the actions result.
bank:


<span style="color:red">#account defaults</span>
The <span style="color:gold">'''normal'''</span> level setting shows all things that can cause more serious problems.
<span>  max-tabs: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">9</tt></span>
<span>  tab-size: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">3</tt></span>


<span style="color:red">#economy defaults</span>
The '''low''' and '''info''' levels shows almost any information under the hood, these levels should not be used by server admins, nless you need information about the plugin behavior, the amount of data that will be sent by the logger will make the console unreadable.  
<span>  withdraw-fee: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">0.0</tt></span>
<span>  deposit-fee: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">0.0</tt></span>


<span style="color:red">#tab prices</span>
<span>  tab-prices: </span>
<span>    tab2: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">100.0</tt></span>
<span>    tab3: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">200.0</tt></span>
<span>    tab4: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">500.0</tt></span>
<span>    tab5: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">1000.0</tt></span>
<span>    tab6: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">2000.0</tt></span>
<span>    tab7: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">5000.0</tt></span>
<span>    tab8: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">10000.0</tt></span>
<span>    tab9: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">50000.0</tt></span>


<span style="color:red">#backend settings</span>
Additionally there are custom logging levels, but are used only for specific cases.  
<span>  player-accounts:</span>
<span>    file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">player_accounts.yml</tt></span>
<span>    basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">''</tt></span>
<span>  guild-accounts:</span>
<span>    file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">guild_accounts.yml</tt></span>
<span>    basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">''</tt></span>


<span style="color:red">#default money banker settigns</span>
=== Level relations ===
money-bank:
{| class="wikitable" style="" border="1"
<span>  exchange-item: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">388</tt></span>
|-
<span>  item-value: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">10.0</tt></span>
! Level
 
! Shows
<span style="color:red">#logger settings</span>
|-
logging:
| None, [false, disabled]
<span>  basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">''</tt></span>
| Nothing
 
|-
</span></div>   
| <span style="color:red">Critical</span>
<p style="font-size:20px;color:red">This section is going to be changed for the v2.0 release</p>
| <span style="color:red">Critical</span>
=== Locale ===
|-
<span style="white-space: pre;color:darkgreen;">
| <span style="color:orange">High</span>
locale:
| <span style="color:orange">High</span>, <span style="color:red">Critical</span>
<span>  file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">english.loc</tt><font color=black> - Name of the language file.</font></span>
<span>  basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">&nbsp;</tt><font color=black> - Path to the language file.</font></span>
</span><br />
'''Note:''' Bankers and traders use the same locale settings.
<div style="width:100%;border-top: solid 1px silver"></div>
=== Wand ===
<span style="white-space: pre;color:darkgreen;">
wands:
<span>  manage: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">280</tt><font color=black> - ID of the item used to toggle the manager-mode. <b>Default:</b> Stick.</font></span>
<span>  settings: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">386</tt><font color=black> - ID of the item used to toggle the display mode of the bank-type traders. <b>Default:</b> Book and Quill.</font></span>
</span>
<div style="width:100%;border-top: solid 1px silver"></div>
=== Trader ===
<span style="white-space: pre;color:darkgreen;">
trader:
<span>  patterns:</span>
<span>    file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'patterns.yml'</tt><font color=black> - the file name used to store patterns</font></span>
<span>    default: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px"></tt><font color=black> - default pattern applied to each <b>server trader</b> automatically</font></span>
<span>  inventory-navigation: </span>
<span>    sell-tab: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:5'</tt><font color=black> - ID of the item used to switch to the sell tab. <b>Default:</b> Lime Wool.</font></span>
<span>    buy-tab: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:3'</tt><font color=black> - ID of the item used to switch to the buy tab. <b>Default:</b> Light Blue Wool.</font></span>
<span>    manage-price: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:15'</tt><font color=black> - ID of the item used to enter the price edit mode. <b>Default:</b> Black Wool.</font></span>
<span>    manage-buy-limit: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:12'</tt><font color=black> - ID of the item used to enter the limit edit mode. <b>Default:</b> Brown Wool.</font></span>
<span>    manage-global-limit: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:11'</tt><font color=black> - ID of the item used to enter the global limit edit mode. <b>Default:</b> Blue Wool.</font></span>
<span>    manage-player-limit: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:12'</tt><font color=black> - ID of the item used to enter the player limit edit mode. <b>Default:</b> Brown Wool.</font></span>
<span>    return: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">35</tt><font color=black> - ID of the item used to return to the trader's main window. <b>Default:</b> White Wool.</font></span>
<span>    amounts-return: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">'35:14'</tt><font color=black> - ID of the item used to return to the trader's main window from the amount selection menu. <b>Default:</b> Red Wool.</font></span>
</span>
<div style="width:100%;border-top: solid 1px silver"></div>
 
=== Banker ===
<span style="white-space: pre;color:darkgreen;">
bank:
<span>  max-tabs: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">9</tt><font color=black> - Maximum number of tabs the user will be able to use. <b>Default:</b> 9.</font></span>
<span>  tab-size: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">3</tt><font color=black> - Maximum number of rows in each tab. <b>Default:</b> 3. <b>Note:</b> As each row contains 9 cells, the final storage space will contain (tab-size)*9 items. Maximum of 5 rows can be used.</font></span>
<span>  withdraw-fee: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">0.0</tt><font color=black> - The cost of taking items out of the bank. <b>Default:</b> 0.</font></span>
<span>  deposit-fee: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">0.0</tt><font color=black> - The cost of putting items into the bank. <b>Default:</b> 0.</font></span>
<span>  tab-prices: </span><font color=black> - This section allows you to set the cost of unlocking each tab.</font>
<span>    tab1: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">0.0</tt><font color=black> <b>Note:</b> Setting this value higher than 0 will force the player to have at least this much money before beeing able to use the banker.</font></span>
<span>    tab2: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">100.0</tt></span>
<span>    tab3: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">200.0</tt></span>
<span>    tab4: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">500.0</tt></span>
<span>    tab5: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">1000.0</tt></span>
<span>    tab6: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">2000.0</tt></span>
<span>    tab7: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">5000.0</tt></span>
<span>    tab8: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">10000.0</tt></span>
<span>    tab9: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">50000.0</tt></span>
</span>
<div style="width:100%;border-top: solid 1px silver"></div>
=== Backend ===
<span style="white-space: pre;color:darkgreen;">
<span>  player-accounts:</span>
<span>    file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">player_accounts.yml</tt><font color=black> - Name of the file containing player account information.</font></span>
<span>    basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">&nbsp;</tt><font color=black> - Path the file containing player account information.</font></span>
<span>  guild-accounts:</span>
<span>    file: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">guild_accounts.yml</tt><font color=black> - Name of the file containing guild account information.</font></span>
<span>    basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">&nbsp;</tt><font color=black> - Path to the file containing guild account information.</font></span>
</span>
<div style="width:100%;border-top: solid 1px silver"></div>
=== Money Bank ===
<span style="white-space: pre;color:darkgreen;">
money-bank:
<span>  exchange-item: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">388</tt><font color=black> - ID of the item used as a currency. <b>Default:</b> Emerald.</font></span>
<span>  item-value: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">10.0</tt><font color=black> - The currency's value. <b>Default:</b> 10.</font></span>
</span>
<div style="width:100%;border-top: solid 1px silver"></div>
=== Logging ===
<span style="white-space: pre;color:darkgreen;">
logging:
<span>  basedir: <tt style="color:black;background-color: #F8F8E0;border: solid 1px black;padding:0px 1px">&nbsp;</tt><font color=black> - Path to the log file.</font></span>
</span>
 
== Navigation ==
{| class="wikitable" style="text-align: center; width: 500px"
|-
|-
! style="width: 100%; background-color:#ADD8E6" colspan="2" | '''DtlTraders'''
| <span style="color:gold">Normal</span>
| <span style="color:gold">Normal</span>, <span style="color:orange">High</span>, <span style="color:red">Critical</span>
|-
|-
| 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] -->
| Low
| Low, <span style="color:gold">Normal</span>, <span style="color:orange">High</span>, <span style="color:red">Critical</span>
|-
|-
| 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]
| Info
| Info, Low, <span style="color:gold">Normal</span>, <span style="color:orange">High</span>, <span style="color:red">Critical</span>
|-
|-
| 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]-->
| Custom
| Custom
|}
|}
== Locale section ==
This section allows you to choose what language you want to use for this plugin and if it should auto update it if a new version was found.
    load: en
This node is used to choose the language you want to use, it first looks for a file with the name '''locale.<target>.yml''' in the '''locales''' folder, where the '''<target>''' part is the value you set in the '''load''' node, so for this example it would be '''locale.en.yml'''
It it is not present, it will try to look for that locale file in the plugins resources, if it fails to find it a second time a '''critical''' error is thrown, and the plugin will not work as it should.
    auto-update: false
<span style="color:darkcyan;font-weight:bold">Info:</span> This node is not used!
Setting the '''auto-update''' to '''true''' allows to manage locale updates, if a update is found ''(the locale version is higher)'' for the locale you are using, it will automatically replace all lines to the newest version.
== Trader section ==
All settings in this section affects the behavior of all traders on the server, so changing any setting here will affect every trader in game, however some settings will only affect new created traders.
<hr/>
    allow-damage: false
Allows you to change the behavior when '''left-clicking''' ''(damaging)'' a trader. When set to '''false''' it will disable any damage done to the trader, moreover it will check the player if he has permissions to toggle '''manager mode''', unless the '''right-click''' setting is set to '''true'''.
If you set this setting to '''true''' you can damage a trader ''(if other citizen settings allow this too)'' and toggling '''manager mode''' is only possible when '''sneaking'''.
=== Transactions ===
    double-click: false
Changes the click behavior when buying or selling, by default if set to '''false''' you sell and buy items clicking once on them, if set to '''true''' you will need to '''double-click''' the item to perform any action.
=== More coming soon! ===
== denizen section ==

Latest revision as of 01:36, 6 February 2014

To be sure that everyone of you will understand the configuration file I have decided to explain each config option here, I will try to give you examples how it will affect the way you can use this plugin, and how helpful it can be if your using more advanced features.

Default config file

debug: critical
#locale settings
locale:
  #the choosen localization to load
  load: en
  #should the locale updated autmaticaly, (not implemented)
  auto-update: false
#logging settings
logging:
  #should transactions be logged? (false/FILE/SQL/WEB) , (not used at this moment)
  log: false
  #the foramt how transactions should be logged to FILE, (not used at this moment)
  log-format: ''
#statistics
statistics: 
  #enable or disable statistics (not implemented)
  enabled: false
  #metrics should be enabled? (not implemented)
  metrics: false
#trader types related settings
trader:
  #sets if left clicking the Trader should damage him, if set to false the trader wont be damaged and the click will be handled as ManagerMode toogling
  #when the player meets the requirements (permissions, and right-click = false)
  #it this setting is set to true, manager modes is toggled only when sneaking 
  allow-damage: false
  #item used to toggle between modes (air counts for anything)
  #transaction related settings
  transaction:
    #sets if buying and selling should be done after clicking on a item twice in a row
    double-click: false
  #manager mode related settings
  managing:
    #the starting stock when opening a trader (buy/sell)
    start-stock: sell
    #right click toggling (instead of left click, which is default from 3.0+) 
    #Attention: When PvP is disabled in the world, and the NPC is Player-Type, left click may not work!
    #if r.click toggling is enabled the item needs to be other than AIR. If not set to an item "stick" item will be used.
    right-click: false
    item: 'air'
    #special blocks used when setting prices and limits, format => 'item_id value'
    special-blocks:
    - dirt 0.01
    - wood 0.1
    - log 10
    - cobblestone 100
    - stone 10000
  #stock related settings
  stock:
    #default starting stock (if this stock is set and not empty!, this does not apply for player traders)
    start-stock: 'sell'
    #default stock size in rows, min 1, max 6 (applied on creation)
    size: 6
    #default stock name format, how should be the traders stock named by default, {npc} tag for npc name
    format: '{npc}^r''s shop'
  #wallet related settings
  wallet:
    #default wallet type for traders (if set to infinite player traders will use "owner" type instead)
    type: 'infinite'
    #initial wallet money on creation (does not apply for player traders)
    money: 0.0
  #pattern related settings
  pattern:
    #default patterns applied to each market and server trader uppon creation (array setting)
    defaults: []
    #the file where patterns are saved
    file: 'patterns.yml'
  #book item related settings
  books:
    #the file where book datas are stored
    file: 'books.yml'
    #how should be books stored? (file)
    store: 'file'
  #player trader related settings
  player:
    #limits of player traders per player
    limit: 1
    #default stock size for player traders, if set overrides the stock.size setting
    size: 2
    #default stock name format, how should be the traders stock named by default, {npc} tag for npc name, and {player} for the traders owner
    #if set overrides the stock.format setting
    format: '{npc}^r''s shop, {player}''s company'
  #ui related settings
  ui:
    #item that will "link" to sell stock
    sell: wool:1
    #item that will "link" to buy stock
    buy: wool:2
    #item that will "link" back to a basic stock
    back: wool:14
    #item that will "link" to price managing
    price: wool:15
    #item that will "link" to limit managing
    limit: wool:3
    #item that will "unlock" the stock for eiding
    lock: wool:4
    #item that will "lock" the stock (saving all changes)
    unlock: wool:5
#denizen support related settings
denizen: []

Debug

Plugins sometimes got a debug logger, this feature allows you and me easier bug tracking, if a bug shows up, changing this node to a lower priority value, will show more information about the plugin actions and behavior. The dtlTraders debugger got six logging levels, critical, high, normal, low, info, none.


Setting the level to none will totally mute the logger, so no error will be shown when anything goes wrong (unless its really serious).

The critical level setting shows only errors that totally break the plugin actions, so they are really rare and should be reported to the plugin dev.

The high level setting show errors that disturbed an action the plugin was performing, but did not changed the actions result.

The normal level setting shows all things that can cause more serious problems.

The low and info levels shows almost any information under the hood, these levels should not be used by server admins, nless you need information about the plugin behavior, the amount of data that will be sent by the logger will make the console unreadable.


Additionally there are custom logging levels, but are used only for specific cases.

Level relations

Level Shows
None, [false, disabled] Nothing
Critical Critical
High High, Critical
Normal Normal, High, Critical
Low Low, Normal, High, Critical
Info Info, Low, Normal, High, Critical
Custom Custom

Locale section

This section allows you to choose what language you want to use for this plugin and if it should auto update it if a new version was found.

   load: en

This node is used to choose the language you want to use, it first looks for a file with the name locale.<target>.yml in the locales folder, where the <target> part is the value you set in the load node, so for this example it would be locale.en.yml


It it is not present, it will try to look for that locale file in the plugins resources, if it fails to find it a second time a critical error is thrown, and the plugin will not work as it should.


   auto-update: false

Info: This node is not used!

Setting the auto-update to true allows to manage locale updates, if a update is found (the locale version is higher) for the locale you are using, it will automatically replace all lines to the newest version.

Trader section

All settings in this section affects the behavior of all traders on the server, so changing any setting here will affect every trader in game, however some settings will only affect new created traders.



   allow-damage: false

Allows you to change the behavior when left-clicking (damaging) a trader. When set to false it will disable any damage done to the trader, moreover it will check the player if he has permissions to toggle manager mode, unless the right-click setting is set to true.

If you set this setting to true you can damage a trader (if other citizen settings allow this too) and toggling manager mode is only possible when sneaking.


Transactions

   double-click: false

Changes the click behavior when buying or selling, by default if set to false you sell and buy items clicking once on them, if set to true you will need to double-click the item to perform any action.


More coming soon!

denizen section