DtlTraders: Difference between revisions

Revision as of 21:14, 22 December 2012

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

This content is outdated! A new description will be created if all things are ready.

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

Allows to use 3 different trader types, each type has his own features
Use price patterns to create pricing tiers for your VIP ranks
Use item patterns to set prices for damaged items!
Displays prices using the new Bukkit API for item lores!
Use one of 7 wallets that may affect the economy in different ways

How to install it

To install it you need basically three plugins: Citizens 2, Vault any Economy plugin supported by Vault. It's also recommended to use a Permission plugin. Always try to have latest version of these plugins.
After you gathered all of them you can start using dtlTraders.

All default permissions to manage a trader should be added by default when you are Op.

How to start

Depending of what do you want to achieve, you should choose a trader or banker type first. Each type has his own features, and behaves different in some cases.
Available types are listed below with a short description and basic information what features this types use.

Trader types

Server trader - Is used as a Admin shop, by default this type has an infinite wallet, allowing him to have never ending money! By default any item added to his stock is also infinite, so you can buy as many and sell as many to him. It's also the default created type by the /trader create command. It's used to allow players sell junk or buy general items. You can set any pattern to him and set any wallet type. You can also limit selling and buying items from/to him.
Market trader - It's quite similar to a Server trader but this type can be only managed through patterns. Pattern for this trader are specific, because of his behavior. You set for him only items he may buy, if a player sell items to him, he will automatically sell them to other players. So no infinite items ;)
Player traders - This type allows to create shops by regular players, there is no way to duplicate an item, or to bug them with any click combination, and prevents using patterns and infinite wallets.

Banker types

Money banker - This type is not really a fully functional type, it just provides a way to exchange money into items and items into money. So grabbing an gold ingot from it would grab, lets say 100$ from your account. The item and it's value can be changed in the config.
Private banker - This type provides a item banking feature, allowing players to stock items to it. Each account may have up to 9 tabs, and each tab may have 45 items in it, and this makes a quite big stockroom. Its still early beta, so many things are static and can't be changed.
Guild banker - For now it's just a project, but when it's going to be done, it will allow to stock items and share them to players from the same faction, clan or town. Maybe with a feature to assign ranks or players for tabs.

Navigation

DtlTraders
Configuration	Permissions
Usage
Types
Denizen Support

@@ Line 14: / Line 14: @@
 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.
+* Allows to use 3 different trader types, each type has his own features
+* Use price patterns to create pricing tiers for your VIP ranks
+* Use item patterns to set prices for damaged items!
+* Displays prices using the new Bukkit API for item lores!
+* Use one of 7 wallets that may affect the economy in different ways
+== How to install it ==
+To install it you need basically three plugins: '''Citizens 2''', '''Vault''' any '''Economy''' plugin supported by Vault. It's also recommended to use a '''Permission''' plugin. Always try to have latest version of these plugins.<br />
+After you gathered all of them you can start using dtlTraders.<br /><br />
+''All default permissions to manage a trader should be added by default when you are '''Op'''.''
+== How to start ==
+Depending of what do you want to achieve, you should choose a trader or banker type first. Each type has his own features, and behaves different in some cases.<br />
+Available types are listed below with a short description and basic information what features this types use.
+=== Trader types ===
+* '''Server trader''' - Is used as a '''Admin shop''', by default this type has an infinite wallet, allowing him to have never ending money! By default any item added to his stock is also infinite, so you can buy as many and sell as many to him. It's also the default created type by the ''/trader create'' command. It's used to allow players sell junk or buy general items. You can set any pattern to him and set any wallet type. You can also limit selling and buying items from/to him.
+* '''Market trader''' - It's quite similar to a ''Server trader'' but this type can be only managed through ''patterns''. Pattern for this trader are specific, because of his behavior. You set for him only items he may buy, if a player sell items to him, he will automatically sell them to other players. So no infinite items ;)
+* '''Player traders''' - This type allows to create shops by regular players, there is no way to duplicate an item, or to bug them with any click combination, and prevents using patterns and infinite wallets.
+=== Banker types ===
+* '''Money banker''' - This type is not really a fully functional type, it just provides a way to exchange money into items and items into money. So grabbing an ''gold ingot'' from it would grab, lets say 100$ from your account. The item and it's value can be changed in the ''config''.
+* '''Private banker''' - This type provides a ''item banking'' feature, allowing players to stock items to it. Each account may have up to 9 tabs, and each tab may have 45 items in it, and this makes a quite big stockroom. Its still early beta, so many things are static and can't be changed.
+* '''Guild banker''' - For now it's just a project, but when it's going to be done, it will allow to stock items and share them to players from the same ''faction'', ''clan'' or ''town''. Maybe with a feature to assign ranks or players for tabs.
+<!--
-# 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
 <br />
 === Locale support ===