TradeHUB v1.0

---

---

⚠ The problem with every other marketplace plugin

You have players. You have an economy. You install an auction house plugin.
Then:

• Items disappear when a transaction partially fails and nobody rolls anything back
• Buy orders get posted by broke players - no funds locked, your economy is fiction
• Server stutters every time someone opens the GUI - database calls blocking the main thread
• Custom items render as "1x Paper" - Nexo, ItemsAdder, anything with NBT just breaks
• Your network has to run 3 separate markets because there's no shared backend

These aren't edge cases. They're the default behaviour of most free plugins.

---

---

What you get

■ Two markets. One GUI.
A sell market and a buy order market - both accessible from the same clean interface. Players list items to sell. Players post buy orders for items they need. The marketplace connects them automatically. Real supply and demand, not just a basic item dump.

■ True escrow - buy orders that actually mean something.
When a player creates a buy order, the full payment is locked immediately. Not promised. Locked. Cancel the order - refund. Order expires - refund. Someone fulfills it - payment goes to the seller minus the configured tax. No IOUs. No bounced payments. No exploits.

■ Nothing is ever lost.
Expired listings, cancelled orders, full inventories - every single item lands in the player's personal mailbox and waits until they claim it. Zero item loss. Zero support tickets about vanished items.

■ Full item fidelity. Every byte preserved.
Enchantments, lore, CustomModelData, Nexo IDs, ItemsAdder items - stored as raw NBT bytes and reconstructed identically on delivery. Items look and behave exactly as they were listed. No stripping. No corrupting. No "1x Paper".

■ Structurally anti-dupe.
Every transaction runs inside an atomic SQL transaction with row-level locking. If any step fails - withdrawal, item removal, mailbox insert - the entire operation rolls back. There is no sequence of clicks or timing that can duplicate an item.

■ Zero main-thread lag.
Every database operation - GUI load, search, listing creation, purchase - runs on a dedicated async executor. Your main thread is never touched. No TPS drops. No stuttering on busy servers.

■ Smart listing merge.
List the same item at the same price twice? TradeHUB merges them - but only if every byte of NBT matches. Different enchants, different lore, different custom model data? Separate listings, always. No unwanted merges between distinct items.

■ Full transaction history GUI.
Paginated logs showing every purchase, sale, and listing creation - with the actual traded item as the icon, complete with its original lore and NBT. Players can audit their own trade history. Admins can pull logs for any player.

■ Configurable tax system.
Charge a flat listing fee on every post. Deduct a flat or percentage-based tax from the seller on each completed sale. Drive server revenue or sink currency from your economy - fully controlled from config.yml.

■ Discord webhook integration.
New sell listings and buy orders post as rich embeds to your Discord channel automatically. Configure per market type, minimum price threshold, and embed color. Keep your community engaged outside the game.

■ Multi-server network support.
Point every node at one shared MySQL database. Listings, orders, mailboxes, and logs are global across your entire network. No BungeeCord plugin. No Redis. No extra dependencies.

---

Why TradeHUB outperforms the competition

---

Who this is for

TradeHUB is built for server owners who take their economy seriously:

• Survival & SMP servers - give players a proper, player-driven market that makes your economy feel alive
• RPG & MMO servers - full NBT preservation means custom gear, potions, and quest items trade exactly as intended
• Economy & towny servers - the tax system and buy orders turn your market into a real economic engine
• Networks & BungeeCord setups - one MySQL backend, all servers share the same market with zero extra infrastructure
• Servers with custom items - Nexo and ItemsAdder items display and trade correctly, out of the box

If you're running a server where the economy matters - where items have real value and players care about fair trades - this is the plugin you've been looking for.

---

Commands

---

Permissions

---

Configuration snippet

---

Multi-server setup

Switch database.type to mysql and point every server at the same database. Set a unique server-id per node. That's it - shared listings, shared orders, shared mailboxes, shared logs. No additional plugins. No Redis. No message broker.

---

Installation

1. Drop tradehub.jar into your /plugins folder
2. Install Vault + any economy plugin (EssentialsX, CMI, etc.)
3. Start the server - config and SQLite database are created automatically
4. Optionally switch to MySQL by setting database.type: mysql in config.yml and restarting

Requirements: Paper or Purpur 1.21+ · Java 21+ · Vault + economy plugin

---