DtlTraders

File:DltTraders.png

DtlTraders

Author	dandielo
Version	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 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.

Project overview

Beta statsu

This plugin is still beta because some of the "types" you can use are still little buggy or aren't finished. At this moment there are two stable types, you can use and be sure nothing will be duped or lost. All other types are still in development.

Bukkit Dev page

Here is the Bukkit Dev page of this item where you can download the latest version.

GitHub wiki

I'm also creating a GitHub Wiki with explained permissions/commands and examples for trader types/wallets etc.

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 (alpha) - it's like an additional inventory you can access only through this npc. It has 1-9 bank tabs and allows to store a lot of items.

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 :)

Instalation

1. Download the plugin: 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.

Here you can get the currently used config file. Anny additional configuration nodes found in the config.yml are currently for beta/development use, so don't change them

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 with everyday, is somethings are not clear you can find me on the esper.net IRC on these channels (dtlTraders, citizens).