DtlTraders: Difference between revisions

From Citizens Wiki

No edit summary
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="infobox" style="width: 295; font-size: 12px; background: #FFFFFF; float: right; border: 1px solid #CCCCCC; margin-left:2.5em; padding: 9px;">
<div class="infobox" style="width: 295; font-size: 12px; background: #FFFFFF; float: right; border: 1px solid #CCC; margin-left:2.5em; padding: 9px;">
{{Box|
{{Box|
BORDER = #ccc|
BORDER = #CCC|
BACKGROUND = #aaa|
BACKGROUND = #80aaff|
WIDTH = 275|
WIDTH = 275|
ALIGN = RIGHT|
ALIGN = RIGHT|
ICON = |
ICON = [[File:dtlTraders.png|450px]] |
HEADING = ''' dtlTraders ''' |
HEADING = ''' <span style="font-size:150%; line-height: 1.31em;"><font color="#80aaff"><center>dtlTraders</center></font></span> ''' |
CONTENT =  
CONTENT =  
<div class="padded" style="padding: 19px; font-family:camingodos-web; font-size:110%;">
<div class="padded" style="padding: 19px; font-family:camingodos-web, Helvetica; font-size:110%;">


''' dtlTraders ''' is a trait for Citizens2 allowing to create simple shops or advanced shop systems.
''' 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 ;)


''' Author: ''' dandielo
''' Original license: ''' MIT License


''' Version: ''' 3.0.8
''' Version: ''' 3.0.8


''' Status: ''' Release, in development
''' Author: ''' Dandielo


''' License: ''' [http://opensource.org/licenses/MIT MIT License]
''' Status: ''' Abandoned.


''' Source: ''' The source code can be found on [https://github.com/Dandielo/dtlTraders GitHub]
''' Source: ''' Original source code can be found on [https://github.com/Dandielo/dtlTraders GitHub]
 
''' Issues and tickets: ''' Any tickets should be created on this page [https://github.com/Dandielo/dtlTraders/issues GitHub Issues]
 
''' CI builds: ''' Check [http://www.wbs-wireless.com:9090/job/dtlTraders/ Jenkins] for latest builds, thanks to '''''DrBix'''''
 
''' IRC: ''' [http://webchat.esper.net/?nick=random_dtl_...&channels=dtlPlugins&prompt=1 #dtlPlugins on esper.net]
 
''' WebPage: ''' Some day I will link it :P


</div>
</div>
Line 37: Line 30:
== About ==
== About ==


'''dtlTraders''' is trait for Citizens2 allowing to use NPCs as merchants.  
<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>


Creating a basic trader and managing his stock is really easy, you need to know only one simple command and all other things are achieved by using the provided '''GUI'''.  
'''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!  
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!
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 build in translations into some languages.  
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 make a pull request on the GitHub page.
 


== Features ==
== Features ==
Line 74: Line 67:
* '''Citizens2'''  
* '''Citizens2'''  
* '''Vault'''
* '''Vault'''
* Vault supported economy plugin, like '''''BOSEconomy'''''
* Vault supported economy plugin, like '''''BOSEconomy, Fe'''''
* Vault supported permission plugin, like '''''PermissionEx'''''
* Vault supported permission plugin, like '''''PermissionEx, Groupmanager'''''


After you got all of them you can just simply put the '''dtlTraders.jar''' into the plugin directory and start using this plugin.
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 '''trader''' trait to it.
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.




Line 86: Line 79:
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.  
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 create a ticket on the issues page on GitHUb
If you lack some information you can always send US a mail to [email protected]


=== Basic setup ===
=== 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.  
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.  
It shows you how to set prices, manage stock item flags and how to use the '''multiple amounts''' feature.  


Line 99: Line 92:
http://wiki.citizensnpcs.co/DtlTraders/config
http://wiki.citizensnpcs.co/DtlTraders/config


=== Commands and usage ===
=== Commands and Permissions ===


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


=== Language and translations ===
=== Language and translations ===

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