DtlTraders: Difference between revisions

dtlTraders	dtlTraders was created to easily setup admin shops for your server. Make and manage your shops with a GUI. Seriously, no hassle with configs and commands ;) Status: Released (Recreated V5) Version: 5.0.0 and up Owned by: 4Creation Former Author: Dandielo License: All rights reserved Source: Recreation version NOT open source. Old Source: Dandielo's source code can be found on GitHub Issues: Any buggs should be created on this page Bukkit Issues or on Discord Questions: You can send a mail to: [email protected] or join Discord Download: Find dtlTraders page on Spigot or Bukkit Donate: helps US continue working on future updates by donating <3 or buying dtlTradersPlus (premium version) dtlTradersPlus *
	dtlTraders was created to easily setup admin shops for your server. Make and manage your shops with a GUI. Seriously, no hassle with configs and commands ;) Status: Released (Recreated V5) Version: 5.0.0 and up Owned by: 4Creation Former Author: Dandielo License: All rights reserved Source: Recreation version NOT open source. Old Source: Dandielo's source code can be found on GitHub Issues: Any buggs should be created on this page Bukkit Issues or on Discord Questions: You can send a mail to: [email protected] or join Discord Download: Find dtlTraders page on Spigot or Bukkit Donate: helps US continue working on future updates by donating <3 or buying dtlTradersPlus (premium version) dtlTradersPlus *

Revision as of 05:27, 5 January 2019

About

This page is outdated, we are trying to make time to update this page, you can always check the updated one right here: Spigot

dtlTraders is trait for Citizens2 allowing to use NPCs as merchants.

Creating a basic trader and managing his stock is really easy, you need to know only one simple command (/trait trader) and all other things are achieved by using the provided GUI.

However you are not forced to use the trader interface if you don't want to, this plugin comes along with a bunch of commands, and a templating feature called patterns, this allows you to create, change, extend, merge shops in any way you want! You can also manage items and prices in shops using permissions, allowing you to change the shop content depending when a player has the required permission!

Also if you want you can translate each end-user part of the plugin into your language, as a result, this plugin also comes along with ready and built in translations into some languages. If you want to contribute a translation send US a mail to [email protected] .

Features

All working features, you can use with version 3.0.8

Selling items to players
Buying items from players
Easy adding, editing and removing items from a trader stock
Easy price setting mechanism
Allowing to open and set a sub-inventory with more specific amount choices for items
Prices set can apply to a unit or to the whole stack
Prices are calculated always for each added amount (in the sub-inventory) automatically and on the fly
Supporting ALL custom items the bukkit API provides!
Supporting 4 attribute modifiers described here!
A lot of settings, you can change to fit your needs
A advanced translation system allowing almost everything to translate!
Patterns allowing to setup traders even faster and permissions specific!
Pattern system along with the default-pattern allows to create shops using just one command!!!
The plugin has it's own API allowing to create custom Trader types and item attributes!
Much more incoming!

Getting started

To get this plugin working you will need to get the following plugins:

Citizens2
Vault
Vault supported economy plugin, like BOSEconomy, Fe
Vault supported permission plugin, like PermissionEx, Groupmanager

After you got all of them you can just simply put the dtlTradersx.x.x.jar into the plugin directory and start using this plugin.

For the most basic setup you need only to know one command, /trader create <name> that creates a trader or simply create an NPC and add the /trait trader to it.

How to:

Here are a bunch of helpful tutorials and links that can you help setting up a trader. You can also find here information about the advanced setup of this plugin.

If you lack some information you can always send US a mail to [email protected]

Basic setup

This tutorial shows how to create a trader from scratch, how to add, edit and remove items. It shows you how to set prices, manage stock item flags and how to use the multiple amounts feature.

I will also describe some config values, how they affect the game and in-game management of a trader and also which of them are trader specific.

@@ Line 1: / Line 1: @@
-{{Trait
+<div class="infobox" style="width: 295; font-size: 12px; background: #FFFFFF; float: right; border: 1px solid #CCC; margin-left:2.5em; padding: 9px;">
-| PICTURE      = DltTraders.png
+{{Box|
-| AUTHOR      = dandielo
+BORDER = #CCC|
-| NAME         = dtlTraders
+BACKGROUND = #80aaff|
-| VERSION    = 3.0 Beta
+WIDTH = 275|
-| CITIZENSBUILD  = See BukkitDev Page
+ALIGN = RIGHT|
-| DEVSTATUS    = Beta
+ICON = [[File:dtlTraders.png|450px]] |
-| DEPENDS     =  Citizens 2.0, Vault, and an economy plugin
+HEADING = ''' <span style="font-size:150%; line-height: 1.31em;"><font color="#80aaff"><center>dtlTraders</center></font></span> ''' |
-| DOWNLOADLINK  = http://dev.bukkit.org/server-mods/dtltraders/
+CONTENT =
-| DESCRIPTION  = Trader and Banker trait for Citizens 2.0. [https://github.com/Dandielo/DtlCitizensTrader/issues Issues page]
+<div class="padded" style="padding: 19px; font-family:camingodos-web, Helvetica; font-size:110%;">
-}}
-dtlTraders is a shop, item banking and economy plugin for Citizens2.
+''' dtlTraders ''' was created to easily setup admin shops for your server.
+Make and manage your shops with a GUI. Seriously, no hassle with configs and commands ;)
-<div style="border: solid 2px green; background-color: silver; padding:10px; width: 50%;"><p style="font-size: 20px;">Please see  http://dev.bukkit.org/server-mods/dtltraders/ for latest information</p></div>
+''' Status: ''' Released (Recreated V5)
+''' Version: ''' 5.0.0 and up
-== Version 3.0 ==
+''' Owned by: ''' [http://www.4Creation.pro 4Creation]
+''' Former Author: ''' Dandielo
+''' License: ''' [https://dev.bukkit.org/projects/dtltraders/license All rights reserved]
+''' Source: ''' Recreation version NOT open source.
+''' Old Source: ''' Dandielo's source code can be found on [https://github.com/Dandielo/dtlTraders GitHub]
+''' Issues: ''' Any buggs should be created on this page [https://dev.bukkit.org/projects/dtltraders/issues Bukkit Issues] or [https://discord.gg/fyabsMF on Discord]
+''' Questions: ''' You can send a mail to: [email protected] or [https://discord.gg/fyabsMF join Discord]
+''' Download: ''' Find dtlTraders page on [https://www.spigotmc.org/resources/dtltraders.35890/ Spigot] or [https://dev.bukkit.org/projects/dtltraders Bukkit]
+''' Donate: ''' helps US continue working on future updates by [http://www.4creation.pro/donate donating <3] or buying dtlTradersPlus (premium version) [http://www.4creation.pro/dtlTradersPlus dtlTradersPlus *]
+</div>
+}}
+</div>
+== About ==
+<span style="font-size:200%; line-height: 1.31em;"><font color="red"><center>This page is outdated, we are trying to make time to update this page, you can always check the updated one right here: [https://www.spigotmc.org/resources/dtltraders.35890/ Spigot]</center></font></span>
+'''dtlTraders''' is trait for Citizens2 allowing to use NPCs as merchants.
+Creating a basic trader and managing his stock is really easy, you need to know only one simple command (/trait trader) and all other things are achieved by using the provided '''GUI'''.
+However you are not forced to use the trader interface if you don't want to, this plugin comes along with a bunch of commands, and a templating feature called '''patterns''', this allows you to create, change, extend, merge shops in any way you want!
+You can also manage items and prices in shops using permissions, allowing you to change the shop content depending when a player has the required permission!
+Also if you want you can translate each end-user part of the plugin into your language, as a result, this plugin also comes along with ready and built in translations into some languages.
+If you want to contribute a translation send US a mail to [email protected] .
-With this version the whole plugin was recoded allowing to change a lot of core things. As because of this this plugin is really small right now but it will grow with time. Already now you got much more support for items like '''Written books''' or '''Custom Potions''', an much more config options.
 == Features ==
-* Allows to use 1 trader type
-* Displays prices in the traders stock and in a players inventory. So there is nod chat interface needed to see an items price.
-* Allows to use 3 different wallet types.
-* Compatible with almost each minecraft item
-== Security ==
+All working features, you can use with version '''3.0.8'''
-* Items that don't got a price set, are disabled from buying or selling. But they are still visible to players.
-* A lot of security measures to not allow any user getting free items.
+* '''Selling''' items to players
+* '''Buying''' items from players
+* Easy adding, editing and removing items from a trader stock
+* Easy price setting mechanism
+* Allowing to open and set a '''sub-inventory''' with more specific amount choices for items
+* Prices set can apply to a unit or to the whole stack
+* Prices are calculated always for each added amount ''(in the sub-inventory)'' automatically and on the fly
+* Supporting '''ALL custom items''' the bukkit API provides!
+* Supporting '''4 attribute modifiers''' described [http://minecraft.gamepedia.com/Attribute here]!
+* A lot of '''settings''', you can change to fit your needs
+* A '''advanced translation system''' allowing almost everything to translate!
+* Patterns allowing to '''setup traders even faster and permissions specific'''!
+* Pattern system along with the '''default-pattern''' allows to create shops using '''just one command'''!!!
+* The plugin has it's own API allowing to create custom Trader types and item attributes!
+* Much more incoming!
+== Getting started ==
+To get this plugin working you will need to get the following plugins:
+* '''Citizens2'''
+* '''Vault'''
+* Vault supported economy plugin, like '''''BOSEconomy, Fe'''''
+* Vault supported permission plugin, like '''''PermissionEx, Groupmanager'''''
+After you got all of them you can just simply put the '''dtlTradersx.x.x.jar''' into the plugin directory and start using this plugin.
+For the most basic setup you need only to know one command, '''/trader create <name>''' that creates a trader or simply create an NPC and add the '''/trait trader''' to it.
+== How to: ==
+Here are a bunch of helpful tutorials and links that can you help setting up a trader. You can also find here information about the advanced setup of this plugin.
+If you lack some information you can always send US a mail to support@4Creation.pro
+=== Basic setup ===
+This [http://wiki.citizensnpcs.co/DtlTraders/basics tutorial] shows how to create a trader from scratch, how to add, edit and remove items.
+It shows you how to set prices, manage stock item flags and how to use the '''multiple amounts''' feature.
+I will also describe some config values, how they affect the game and '''in-game management''' of a trader and also which of them are trader specific.
+=== Configuration ===
+http://wiki.citizensnpcs.co/DtlTraders/config
+=== Commands and Permissions ===
+http://wiki.citizensnpcs.co/DtlTraders/Commands
+http://wiki.citizensnpcs.co/DtlTraders/permissions
-== How to install ==
+=== Language and translations ===
-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 ==
+=== Advanced setup ===
-=== Trader types ===
+=== Patterns ===
-* '''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.
+=== Extending ===
-=== Banker types ===
+== Credits and thanks ==
-No types available right now
+<!--
-== Navigation ==
 {| class="wikitable" style="text-align: center; width: 500px"
 |-
 ! style="width: 100%; background-color:#ADD8E6" colspan="2" | '''DtlTraders'''
 |-
-| 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]
+| Configuration || | [http://wiki.citizensnpcs.co/DtlTraders/config Configuration] | [http://wiki.citizensnpcs.co/DtlTraders/Commands Commands] | [http://wiki.citizensnpcs.co/DtlTraders/permissions Permissions] | [http://wiki.citizensnpcs.co/DtlTraders/locale Locale]
 |-
-| 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]
+| Usage ||| [http://wiki.citizensnpcs.co/DtlTraders/managing Managing] | [http://wiki.citizensnpcs.co/DtlTraders/trading Trading] | [http://wiki.citizensnpcs.co/DtlTraders/banking Banking] |[http://wiki.citizensnpcs.co/DtlTraders/patterns Patterns]
 |-
-| 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]-->
+| Types || | [http://wiki.citizensnpcs.co/DtlTraders/traders Traders] | [http://wiki.citizensnpcs.co/DtlTraders/bankers Bankers] <!--| [http://wiki.citizensnpcs.co/DtlTraders/auctionhouse Auction House] | [http://wiki.citizensnpcs.co/DtlTraders/wallets Wallets]
 |-
-| Denizen Support || | [http://wiki.citizensnpcs.com/DtlTraders/denizen/commands Commands] <!--| [http://wiki.citizensnpcs.com/DtlTraders/denizen/triggers Triggers] -->
+| Denizen Support || | [http://wiki.citizensnpcs.co/DtlTraders/denizen/commands Commands] <!--| [http://wiki.citizensnpcs.co/DtlTraders/denizen/triggers Triggers]
 |}
+-->