DtlTraders: Difference between revisions

From Citizens Wiki

No edit summary
 
(107 intermediate revisions by 4 users not shown)
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    = Beta
WIDTH = 275|
| CITIZENSBUILD  = 2.0 dev build #294
ALIGN = RIGHT|
| DEVSTATUS    = InDev
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 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%;">
}}


This plugin was developed with the purpose to be easy and flexible in use.
''' 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 ;)


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.
''' Original license: ''' MIT License


== Project overview ==
''' Version: ''' 3.0.8


=== Beta statsu ===
''' Author: ''' Dandielo
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 ===
''' Status: ''' Abandoned.
Here is the [http://dev.bukkit.org/server-mods/dtltraders/ Bukkit Dev page] of this item where you can download the latest version.


=== GitHub wiki ===
''' Source: ''' Original source code can be found on [https://github.com/Dandielo/dtlTraders GitHub]
I'm also creating a [https://github.com/Dandielo/DtlCitizensTrader/wiki GitHub Wiki] with explained permissions/commands and examples for trader types/wallets etc.


</div>
}}
</div>
== About ==
<span style="font-size:200%; line-height: 1.31em;"><font color="red"><center>This page is outdated, an external author maintains a fork on [https://www.spigotmc.org/resources/dtltraders.35890/ Spigot], they provide support on [https://discord.gg/fyabsMF Discord]</center></font></span>
'''dtlTraders''' was a 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.


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


# Server trader - this type is used as a Admin shop, so it should be only managed by Administrators
All working features, you can use with version '''3.0.8'''
# 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
 
# 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)
* '''Selling''' items to players
# Player banker (beta) - atm it lacks only permissions setup, but it can be still buggy so be aware
* '''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 [email protected]
 
=== Basic setup ===


=== Locale support ===
This [http://wiki.citizensnpcs.co/DtlTraders/basics tutorial] shows how to create a trader from scratch, how to add, edit and remove items.  
You can change mostly any message in the plugin, so if you are running a German server you can change all messages to German.
It shows you how to set prices, manage stock item flags and how to use the '''multiple amounts''' feature.
I'm also looking for some people who are willing to help translate this into few other languages :)


== Instalation ==
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.
# Download the plugin: 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 ===


Here you can get the currently used [https://github.com/Dandielo/DtlCitizensTrader/wiki/Installation config file]. Anny additional configuration nodes found in the '''config.yml''' are currently for beta/development use, so don't change them
http://wiki.citizensnpcs.co/DtlTraders/config


=== Commands and Permissions ===


== How to start ==
http://wiki.citizensnpcs.co/DtlTraders/Commands


=== Creating a trader ===
http://wiki.citizensnpcs.co/DtlTraders/permissions
To create a trader you can add a trait to an existing npc by using this command
<br />
'''/trait trader'''
<br />
and then you will need to re-spawn it
<br />
<br />
Another way is to create the trader already with this trait using
<br />
'''/npc create name here -- trait trader'''
<br />
<br />
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.
<br />
'''/trader create trader name [t:<trader-type>] [w:<wallet-type>] [e:<entity-type>]'''


<br />
=== Language and translations ===
if you don't supply any arguments it will create a "server trader" with the "infinite wallet"


=== Creating a banker ===
=== Advanced setup ===
Bankers can be only created by the '''/trader''' command.
'''/trader create Name t:money-bank'''
or
'''/trader create Name t:player-bank'''


=== Patterns ===


=== Commands ===
=== Extending ===  
A full description of all used commands you can find [https://github.com/Dandielo/DtlCitizensTrader/wiki/Commands here].


=== Permissions ===
== Credits and thanks ==
A full list of used permissions is available [https://github.com/Dandielo/DtlCitizensTrader/wiki/Permissions here].


=== Types ===
<!--
Here you can find the whole list of all [https://github.com/Dandielo/DtlCitizensTrader/wiki/Trader-Types Trader Types].


== More information ==
{| class="wikitable" style="text-align: center; width: 500px"
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).
|-
! style="width: 100%; background-color:#ADD8E6" colspan="2" | '''DtlTraders'''
|-
| 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.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.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.co/DtlTraders/denizen/commands Commands] <!--| [http://wiki.citizensnpcs.co/DtlTraders/denizen/triggers Triggers]
|}
-->

Latest revision as of 12:29, 16 December 2022

DtlTraders.png
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 ;)

Original license: MIT License

Version: 3.0.8

Author: Dandielo

Status: Abandoned.

Source: Original source code can be found on GitHub


About

This page is outdated, an external author maintains a fork on Spigot, they provide support on Discord

dtlTraders was a 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.

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.

Configuration

http://wiki.citizensnpcs.co/DtlTraders/config

Commands and Permissions

http://wiki.citizensnpcs.co/DtlTraders/Commands

http://wiki.citizensnpcs.co/DtlTraders/permissions

Language and translations

Advanced setup

Patterns

Extending

Credits and thanks