Description: 2.4.4 - 2.5


Trading made easier

This plugin was basically created to set up easily "Admin shops" using the Citizens2 plugin.

But there where a lot of requests for additional options.

Now it's still a easy to set up "Admin shop", but for more advanced users

there is a possibility to use some extra features.



Wallets | dtlWallets | Patterns | Economy Manager (by vagrant326)

Dev Builds

Development builds of this project can be acquired at the provided continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Dev Builds 3.0


As because 2.5 is so bugged, that I can't work on it further, and 2.4.4 is not prepared for a lot of features, so Atm, I'm doing this plugin from scratch, this may take a while, but so far I've almost done basic code (lacks permissions, and commands), almost done Server trader and infinite, private, owner wallets.

I't might be hard to understand why I'm totally redoing the code, and making mosth things from scratch, but this really helps me to build this plugin without many issues that appeared when it was changing one and on on the core.

You also need to know that last "rework" was done over a half year ago, so really that code now is much more extensible, nicer, and will add some API, so you can bother other plugin devs to add support for this plugin ;) So i don't need to add million of plugins to it.

I will still update both current 2.5.0, and 2.4.4 builds for the next Bukkit builds. Thats all.

Also adding a lot of features, ppl requested earlier, like "starting stock", "stock size", "stock names". All three can be set globally and also there is a possibility to set specific values to each trader.

Also change the way management mode will be toggled. No more sticks to threat those poor traders, will toggle mm mode, and will open the trader stock.

If you want any feature added, just say it as long as I'm working on the plugin core, now it's almost everything possible to add. Books support also incoming.

For Auction Trait thirsty people, I'm also preparing this plugin to add this feature.

Base change, I've split the "trader" trait into 3 separate traits. "wallet", "trader", "banker".
The locale systems wont change at all, also most messages will persist (For now I hope so), anyway I will try to make it so to update the locale in such a way so you don't need to translate all things from scratch.

Also going to allow you to set your own "special blocks", you can set them 2, 3, 10 or even for each item a special value :)

adding also bit more commands, /trader price set <price> {match data}

/trader price set 3.33 log n:Super log

I hope you will like this update, but this will take some time. If there are ppl that want to work a bit with the incoming API and add suggestions, please contact me.

With greetings,


  • 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 and names!
  • Use one of 4 wallets that may affect the economy in different ways, and much more with an upcoming extension!


To install, all you need are these plugins: Vault, Citizens2 and any economy plugin supported by Vault.

Config defaults allows to create fast a Server trader, which is equal to an "Admin shop"

Configuration is explained here. (incoming).

Creating a Server Trader

To easily create this type of traders you just need to add the trader trait to an NPC, or use the /trader create command.


Add trait to an existing NPC:

/trait trader

Create a new Server Trader

/trader create Traders Name

This will create a default trader, with an infinite wallet, so money he has is limitless Need pictures? Click here! (Coming soon)

Managing a trader

To manage a trader you need to be Op, or have required permissions

Right clicking the trader with a stick will switch On/Off Manager mode for him.

When in MM, you just right click him again, and you will see an inventory, with 3 wools on the bottom right side.

To add an item to the traders stock just grab if from your inventory, and put it info the trader inventory. Don't shift click items!

To switch between selling and buying items click on the most bottom right wool.

To change the prices for items, click on the Black wool, it will show a message. Now you take any other item in the inventory, and click with it on the item you want to change the price for.

Left click will increase the price, right click will decrease the price

Special blocks:

  1. Stone counts as 1000 * amount
  2. Cobblestone counts as 100 * amount
  3. Dirt counts as 10 * amount
  4. Wooden Plank counts as 0.1 * amount
  5. Log counts as 00.1 * amount

angrylandmammal tutorial

This tutorial was created some time ago, it shows all basics you need to know how to set a trader, they may be some differences but most things are still the same. :)

Embed Removed:


dtlTraders v3.0

  1. ItemData suported 8/10+:
    - Name Done!,
    - Lore Done!,
    - Durability Done!,
    - Enchants Done!,
    - Stored Enchants Done!,
    - Color Done!,
    - Potions Done!,
    - Skulls Done!,
    - Fireworks Done!,
    - Books Soon!,
    - Other
  2. Traders
    1. Server Working on (lacks permissions and dupe debugging),
      - Selling to traders 90% done,
      - Buying from traders 90% done,
      - Managing traders 60% done,
      - API Events 20% done
    2. Player 0% done,
    3. Market 0% done
  3. Patterns 0% done
  4. Bankers 0% done
  5. Core
    - SQL logging planing,
    - Economy and wallets 100% done,
    - Commands 80% done,
    - Locale 1.0 100% done,
    - Locale 2.0 planning (github repo updating),
    - Settings 78% done,
    - Debugger 100% done
  6. API
    - Events 20% done,
    - Trader types 80% done,
    - Item data API 100% done - Item flag API 70% done

Converting from Cititraders

Cititrader saves are going to be loaded with "temporary" traits that this plugin uses, so when you have both plugins this may cause an error, it will also remove those traits so before converting be sure to make a backup

This is still a beta conversion tool so it might not convert all data or convert it a bit wrong but you just need to add to the config this node "cititrader.convert", under the "trader" configuration so it looks like this

        convert: true

After it's done best is to remove this. More over, Cititraders can't be on the server when converting


You can allso join my IRC channel on "", Link here. You are always welcome :)

Looking someone for

  • Documentation (who will update the wiki, I will tell him whatever he want's I just don't got the time to do it)
  • A logo design (I'm really week in this things, any help is welcome)


German translated by PLPatrick (v1.0.6 v2)

Polish translated by Robson9595 (v1.0.6)

Chinese Simplified translated by jessefjxm (v1.0.6) - (I'm impressed!)

Italian translated by xion87 (v1.0.6)

Thanks to

  • Lethe - for helping me a lot and still listening me
  • chasingcode - for developer support :) Thanks :D
  • Wreyth - for feedback
  • Instinx - for feedback
  • silentassasin - for feedback
  • Gizmoholm - for feedback
  • tehbeard - for helping me improve my programming skills


Posts Quoted:
Clear All Quotes