DtlTraders: Difference between revisions

Revision as of 01:42, 17 November 2012

Author	dandielo
Version	2.0-RC (v0.5)
Citizens build	2.0.3 dev build #470
Other dependencies	Citizens 2.0. Vault and an economy plugin
Download	Link
Description: Trader trait for Citizens 2.0. Issues page

A first release version will be available soon!

Eventually DtlTraders will offer several trader types which allow creation of admin shops, player-owned shops, enchant shops, bankers and similar. The author is also working hard to make an auction house npc a reality.

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

Features

At this time four different trader types are available, each has its own specific purpose.

Server trader - Admin shop, fully customizable to meet your needs.
Player trader - Allows players to set up and manage their own traders.
Money banker - Enables the use of in-game items as a currency (set in the config). You can withdraw your money as an item to store or trade with another player. (Only limited testing was done, feel free to report any problems)
Player banker - atm it lacks only permissions setup, but it can be still buggy so be aware

Locale support

Almost any message displayed by this plugin can be very easily modified.

DtlTraders is available in english only at this moment.

If you are willing to help translate this plugin to a different languange please contact the author.

Installation

Updating from 1.9.04 to 1.9.4

When you are moving from version 1.9.04 you need to remove the config.yml, and the locale.yml. It's needed to move to the new config and locale system.

Dependencies

Citizens 2.0 or 2.0.1
Vault
economy plugin (vault compatible)

Installation steps

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

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

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 the following command:
/trait trader
be sure to respawn the npc for the changes to take effect.

There are two ways you can accomplish the above when creating a completely new character. The first one is to use:
/npc create trader name -- trait trader

The second way is taking advantage of the trader command. It has 3 optional arguments that control the type, wallet (for traders) and entity type. Arguments can be supplied in any order.
/trader create trader name [t:<trader-type>] [w:<wallet-type>] [e:<entity-type>]
if you don't supply any arguments the plugin will default to a server trader type with infinite wallet.

Creating a banker

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

Commands

A complete list of available commands and their description can be found here.

Permissions

A complete list of permission nodes and their description can be found here.

Types

A list of supported trader types can be found here.

Server Trader Tutorial - by Inexion (THANKS :D)

More information

The wiki pages are currently beeing updated, any missing information should show up in the coming days. If you have any questions or ideas to implement you can usually find me on the esper.net IRC channel #dtlTraders. You can also e-mail me at [email protected] .

Version 2.0RC 0.72

A lot of updates was added to this version, so be prepared for a refreshing wind ;>

Added a new trader type, it's total base on patterns, you need to set him what he will buy from the user and you need to set the prices for how many he will sell that stuff.
refreshed patterns and added more functions to them, now you can create "tiers" in the "prices" section, allowing you to set prices for different "permission groups"! To allow a player use a "tier" you need to add him a simple perm, like: "dtl.trader.tiers.tier1".
also added "multipliers" for price patterns, base is 1.0, so you can easily change all prices by an "multiplier" ;)
fixed many bugs: crashing without denizen plugin, permission bugs, pattern issues, some messaging issues, and a lot of other smaller things...
added also "Lores" and special Names for "managing items"! Now you won't see "lime wool" but "Buy stock!"
changed the pricing system, from up now prices are calculated for each player separately, so tiering is available!
more changes soon! :D

Navigation

DtlTraders
Usage	Managing \| Trading \| Patterns
Configuration	Configuration \| Commands \| Permissions \| Locale
Types	Traders \| Bankers
Denizen Support	Commands \| Triggers

@@ Line 95: / Line 95: @@
 The wiki pages are currently beeing updated, any missing information should show up in the coming days. If you have any questions or ideas to implement you can usually find me on the '''[http://esper.net/publicirc.php esper.net IRC]''' channel [irc://irc.esper.net/dtlTraders #dtlTraders]. You can also e-mail me at [email protected] .
 <br />
-== Version 1.9.6 ==
-# added ''Sold'' trigger (denizen)
-# added ''Bought'' trigger (denizen)
-# added ''Transaction'' trigger, counts for both triggers ''sold'' and ''bought'' (denizen)
-# minor bug fixes
-# locale update
-== Version 1.9.5 ==
+== Version 2.0RC 0.72 ==
-# changed the /trader pattern command
+A lot of updates was added to this version, so be prepared for a refreshing wind ;>
-# fixed pattern issues
+# Added a new trader type, it's total base on patterns, you need to set him what he will buy from the user and you need to set the prices for how many he will sell that stuff.
- - items defined in will now be treated as pattern items, and won't be saved<br />
+# refreshed patterns and added more functions to them, now you can create "tiers" in the "prices" section, allowing you to set prices for different "permission groups"! To allow a player use a "tier" you need to add him a simple perm, like: "dtl.trader.tiers.tier1".
- - fixed the issue with the items arrangement and slot settings '''s:-1'''<br />
+# also added "multipliers" for price patterns, base is 1.0, so you can easily change all prices by an "multiplier" ;)
- - fixed an issue not properly removing a pattern
+# fixed many bugs: crashing without denizen plugin, permission bugs, pattern issues, some messaging issues, and a lot of other smaller things...
-# added manager mode for '''player banker''' now you can set for every banker their own fee for withdraws and deposits (more incoming)
+# added also "Lores" and special Names for "managing items"! Now you won't see "lime wool" but "Buy stock!"
-# added a few /banker commands
+# changed the pricing system, from up now prices are calculated for each player separately, so tiering is available!
-# ADDED DENIZEN COMMANDS! they are not big but always a new way to interact with traders ;> atm only for server traders supported a description will be provided soon ;>
+# more changes soon! :D
- - TRADER_TRANSACTION [START/CANCEL] (SELL/BUY)<br />
- - TRADER_PATTERN [SET/REMOVE] (PAT:pattern_name)
-# some code cleanup and minor locale fixes. ''As always it's recommended to delete the locale file''
-== Version 1.9.4 ==
-# Added transactions patterns, now you can make patterns and assign them to traders!
-# Added logging system for player trader owners, you can easily call the last transactions made by you'r trader
-# Commands are now separated ''/trader'' and ''/banker''
-# Permissions was been redone, i hope they are now more readable
-# Locale file was redone, it has now an easier system to translate (but still it's not the end system)
-# Added Simple-clans, Factions, Towny wallets! (if you wish a wallet to add just say it)
-# Added more messages, now you know why a transaction failed (still needs some improvements ;P)
-# The configuration file has been changed (needed to move many things you of the "trader" section)
 == Navigation ==