DtlTraders

From Citizens Wiki

Revision as of 19:33, 9 September 2012 by Dandielo (talk | contribs) (→‎Navigation)

File:DltTraders.png

DtlTraders


Author dandielo
Version 1.9 Beta
Citizens build 2.0 dev build #294
Other dependencies Citizens 2.0. Vault and an economy plugin
Download Link
Description: Trader trait for Citizens 2.0. Issues page

This page will change during the whole "Beta" phase, so be aware of any changes!

This plugin was developed with the purpose to be easy and flexible in use.

It will have a big variety of trader types, allowing to create "Admin shops", "Player shops", "Enchant Shops", "Bankers" and maybe "Auction house npcs". And this isn't the end, so if you got an idea for a trader, just mail it, and I will see if it possible to create with this plugin.


Navigation

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




Features

So far this plugin got a possibility to use four different trader types, each has his own exceptional purpose.

  1. Server trader - this type is used as a Admin shop, so it should be only managed by Administrators
  2. Player trader - this type allows a player to manage his own trader, so he can set items he want to sell and also set items he wan' to buy
  3. Money banker (beta) - an money banker is like a exchange spot, you can display player's money as an item (set in the config) and manage the money buy adding/removing items from it (I've tested him only on my server, so it can be buggy, feel free to test)
  4. Player banker (beta) - atm it lacks only permissions setup, but it can be still buggy so be aware

Locale support

You can change mostly any message in the plugin, so if you are running a German server you can change all messages to German. I'm also looking for some people who are willing to help translate this into few other languages :)



Installation

Dependencies

  1. Citizens 2.0
  2. Vault
  3. economy plugin (vault compatible)

Installation steps

  1. Download the latest build at: http://dev.bukkit.org/server-mods/dtltraders/
  2. Put the **dtlTrader.jar** file in the plugins directory

The plugin will generate default configuration files when it is run for the first time.

Installation is explained here with configuration nodes

Configuration

All configuration nodes can be found here http://wiki.citizensnpcs.com/DtlTraders/config




How to start

Creating a trader

To create a trader you can add a trait to an existing npc by using this command
/trait trader
and then you will need to re-spawn it

Another way is to create the trader already with this trait using
/npc create name here -- trait trader

And the last way is using the trader command. It has 3 optional arguments allowing to set the type, wallet (for traders) and entity type. You can set the arguments in any order.
/trader create trader name [t:<trader-type>] [w:<wallet-type>] [e:<entity-type>]


if you don't supply any arguments it will create a "server trader" with the "infinite wallet"

Creating a banker

Bankers can be only created by the /trader command. /trader create Name t:money-bank or /trader create Name t:player-bank


Commands

A full description of all used commands you can find here.

Permissions

A full list of used permissions is available here.

Types

Here you can find the whole list of all Trader Types.



More information

There is still a lot of information to add or update here and in the wiki, but I will do this everyday. If something is not clear you can find me on the esper.net IRC channel #dtlTraders. Byt sometimes I don't got the time to be there ;<