DZTradeHub — The Complete Minecraft Economy System

DZTradeHub is a comprehensive and modular economy plugin for PaperMC 1.21.1, developed in Java 21. It unifies every aspect of a Minecraft server’s economy — banks, bounties, casinos, auctions, kits, and a full marketplace — into a single, stable, and secure framework designed for both survival and role-play servers.

DZTradeHub gives players an economy that actually feels alive: money moves between banks, marketplaces restock dynamically, and every trade, sale, or game is tied together through one consistent economy engine powered by DZEconomy.

---

🏦 Banking System

The plugin’s banking system is the foundation of DZTradeHub. Players can open secure, password-protected bank accounts and manage their currency through an interactive GUI. Each account supports multiple currencies (*Money, MobCoin, Gem) and comes with its own taxes, limits, and perks.

Key features:

7 default banks (Money, MobCoin, Gem, MMo, MG, MoG, Central)

3 account types — Savings, Interest, and Business

Loan and repayment system with adjustable interest rates

Global tax configuration for deposits and withdrawals

Level progression to reduce taxes and increase interest

Secure PBKDF2 password hashing with per-account salt

Anti-brute-force protection and session-token verification

Reception queue with anti-hijack session tokens

Bank-to-bank and player-to-player transfers

Automatic interest payouts for interest accounts

The system is fully data-driven: admins can modify tax values, loan rates, or enabled currencies per bank through YAML configuration or in-game GUIs.

Commands:

Player

• /bank — Open bank list GUI. — dztradehub.bank
• /bank list — List all available banks. — dztradehub.bank
• /<bank_name> — Quick open GUI for a specific bank (e.g., /money-bank, /central-bank). — dztradehub.bank
• /<bank_name> create <SAVINGS|INTEREST|BUSINESS> <password> — Create account in that bank. — dztradehub.bank
• /<bank_name> help — Show bank help and usage. — dztradehub.bank
• /bank help — General bank help (aliases for bank-related usage). — dztradehub.bank
• In-GUI actions (via bank GUI): deposit, withdraw, transfer to another account, transfer to another bank, loan request, change password, delete account — dztradehub.bank (checked per action)

Notes: GUI prompts may require chat password entry; queue token/session required to access reception.

Admin

• /bank create <name> — Create a new bank (opens bank configuration GUI). — dztradehub.bank.admin
• /bank delete <name> — Delete a bank. — dztradehub.bank.admin
• /bank rename <old> <new> — Rename a bank. — dztradehub.bank.admin
• /bank config <name> — Open bank configuration GUI for <name>. — dztradehub.bank.admin
• /bank reload — Reload bank configs (if implemented). — dztradehub.admin or dztradehub.bank.admin

---

🛒 Marketplace & Shops

DZTradeHub introduces a robust marketplace system composed of multiple areas, each with its own set of shops. It supports buy, sell, and both transaction types and integrates directly with the banking system.

Dynamic pricing based on supply and demand

Queue-based checkout and reception systems

Rank-based access and transaction limits

Stock management with automatic restocks

Shop linking for stock transfers

6 prebuilt areas with over 50 shops and 2000+ items

Admins can easily create new areas and shops with commands like /dzth create-area or /dzth create-shop, configure queues, or connect shops for shared inventory.

Commands:

Player

• /sell — Open area & shop selection GUI to sell items. — dztradehub.use
• /sell <area> — Open shop selection for an area. — dztradehub.use
• /sell <area> <shop> — Open sell interface for a specific shop. — dztradehub.use
• /sellall — Sell all inventory (requires specifying area & shop or configured default). — dztradehub.use
• /sellall <area> <shop> — Sell all items to the specified shop. — dztradehub.use
• /sellhand — Sell item in hand (requires specifying area & shop or configured default). — dztradehub.use
• /sellhand <area> <shop> — Sell the hand item to specified shop. — dztradehub.use

Admin

• /dzth create-area <name> — Create a new marketplace area. — dztradehub.admin
• /dzth delete-area <name> — Delete an area. — dztradehub.admin
• /dzth rename-area <old> <new> — Rename an area. — dztradehub.admin
• /dzth create-shop <area> <shop> — Create a shop in area. — dztradehub.admin
• /dzth delete-shop <area> <shop> — Delete a shop. — dztradehub.admin
• /dzth rename-shop <area> <old> <new> — Rename a shop. — dztradehub.admin
• /dzth config <area> <shop> <reception|checkout> ... — Configure shop queue & settings. — dztradehub.admin
• /dzth link-shop <area> <sell_shop> <buy_shop> — Link sell/buy shops for stock transfer. — dztradehub.admin
• /dzth unlink-shop <area> <shop> — Unlink shop. — dztradehub.admin
• /dzth add-item <area> <shop> — Add item via GUI. — dztradehub.admin
• /dzth add-item <area> <shop> <item> <currency> <min> <max> <buy|sell|both> — Quick-add item. — dztradehub.admin
• /dzth remove-item <area> <shop> <item> — Remove item from shop. — dztradehub.admin
• /dzth list — Overview of areas/shops. — dztradehub.use / dztradehub.admin (varies)
• /dzth areas list — List areas. — dztradehub.use
• /dzth shops list — List shops. — dztradehub.use
• /dzth items list — Show item counts. — dztradehub.use
• /dzth migrate <flatfile|mysql|sqlite> — Migrate storage. — dztradehub.admin
• /dzth reload — Reload configs. — dztradehub.admin
• /dzth credits — Show credits/about info. — dztradehub.use
• /dzth help — Show help for marketplace admin commands. — dztradehub.admin

---

💰 Player Economy Systems

DZTradeHub also includes multiple gameplay-oriented economy modules:

🎯 Bounty System

Create and manage bounties with GUI support

Reward types include all currencies and items

Automatic payout to killers and refund on deletion

Persistent storage and logging

Commands:

• /bounty — Open bounty GUI. — dztradehub.bounty
• /bounty create <player> — Start bounty creation (opens GUI). — dztradehub.bounty
• /bounty delete <number> — Delete an existing bounty by its ID. — dztradehub.bounty
• /bounty list — List all bounties (GUI or chat). — dztradehub.bounty
• /bounty manage [number] — Manage a bounty (open management GUI). — dztradehub.bounty
• /bounty help — Show bounty help and usage. — dztradehub.bounty

🎰 Casino System

Two fully configurable mini-games: Main Command: */cashino - Open GUI with CoinFlip & Jackpot.

CoinFlip: single or double player mode with wagers

Commands:

• /coinflip — Open coinflip GUI. — dztradehub.casino
• /coinflip single <currency> <amount> <heads|tails> — Quick single-player coin flip bet. — dztradehub.casino
• /coinflip double <currency> <amount> <heads|tails> <player> — Challenge another player. — dztradehub.casino
• /coinflip accept [number] — Accept a numbered coinflip request. — dztradehub.casino
• /coinflip deny [number] — Deny a numbered coinflip request. — dztradehub.casino
• /coinflip requests — Open requests GUI (challenge requests). — dztradehub.casino
• /coinflip requests list — List pending requests in chat with numbers. — dztradehub.casino
• /coinflip help — Show coinflip help. — dztradehub.casino

Jackpot: slot-machine game with 3-5 rows and customizable multipliers

Commands:

• /jackpot — Open jackpot GUI (slot machine). — dztradehub.casino
• /jackpot <currency> <amount> <rows> — Quick spin (rows = 3,4,5). — dztradehub.casino
• /jackpot help — Show jackpot multipliers and rules. — dztradehub.casino

🔨 Auction House

Player-to-player auctions using multiple currencies

Price-reduction or timed bidding models

Automatic expiry and refund handling

GUI management and persistent database entries

Commands:

• /ah — Open auction browsing GUI. — dztradehub.auction
• /ah add — Open create-auction GUI. — dztradehub.auction
• /ah add-hand-item <currency> <actual> <maxdrop> <drop> <time> <unit> <queue> <increase> — Quick-add an auction with parameters. — dztradehub.auction
• /ah list — List your auctions in GUI/chat. — dztradehub.auction
• /ah manage [number] — Manage an auction by number (GUI). — dztradehub.auction
• /ah remove <number> — Cancel or remove an auction by ID. — dztradehub.auction
• /ah help — Auction help. — dztradehub.auction

📦 Kits System

/kit for shop-linked kits, /kits for claimable packs

Configurable cooldowns, ranks, and currency costs

Easily link kits to marketplace areas for direct sales

• /kit — Open kit-area shops. — dztradehub.use
• /kits — List claimable kits or manage kits UI. — dztradehub.use
• /kits claim <name> — Claim a named kit (if permitted / cooldown clear). — dztradehub.use
• /kits list — List available claimable kits. — dztradehub.use
• /kits create <name> — Create kit (opens GUI). — dztradehub.admin
• /kits create <name> <currency> <price> <cooldown> <item:amount>... — Quick-create kit via command. — dztradehub.admin
• /kits delete <name> — Delete kit. — dztradehub.admin
• /kits link <kit> <area> <shop> — Link kit to a given shop. — dztradehub.admin
• /kits unlink <kit> — Unlink kit. — dztradehub.admin

---

🔐 Security & Reliability

Security is built into the plugin’s core. Every transaction and player interaction passes through validated systems designed to prevent exploits.

Security features:

PBKDF2 password hashing with 65k iterations

Account lockouts after failed login attempts

Sanitized inputs to prevent injection or corruption

Thread-safe account operations using locks

Database transactions for deposit/withdraw safety

Audit logging for admin commands

Error handler that hides internal exceptions from players

Automated database backups before critical operations

Periodic health checks and automatic reconnects for database connections

All database operations run asynchronously, ensuring the main server thread remains responsive even with large datasets.

---

🧱 Storage and Integration

DZTradeHub works out of the box with three storage options:

FlatFile (YAML) — easy to set up for small servers

SQLite — local database with zero configuration

MySQL — external server for large or networked environments

Switch between them anytime using /dzth migrate , with no data loss. All tables — banks, accounts, transactions, auctions, bounties, and shops — are automatically created and versioned.

---

📑 Others

Bank Payment Integration (Marketplace checkout)

• Payment flow done in GUI during checkout — choose between pocket (inventory) or bank payment.
• Bank payment requires entering password (chat) and uses dztradehub.bank permissions.
• No specific single command; checkout GUI handles payment.

General & Utility Commands

• /tradehub — Browse all marketplace areas (main GUI). — dztradehub.use
• /tradehub help — Show general plugin help. — dztradehub.use
• /dzth credits — Show credits and plugin info. — dztradehub.use
• /dzth migrate <type> — Storage migration (admin). — dztradehub.admin
• /dzth reload — Reload plugin configs. — dztradehub.admin
• /dzth help — Main help. — dztradehub.use / dztradehub.admin

Audit / Admin Tools & Security

• Admin audit logging runs automatically; no manual command required.
• BackupManager runs before critical ops; configuration via YAML and /dzth config options.
• Optional security/maintenance commands (if implemented in future): health checks, metrics endpoints — permission dztradehub.admin.

Permissions

Suggested core permission nodes (match the README):

• dztradehub.admin — Full admin access
• dztradehub.use — Basic user access
• dztradehub.bank — Bank access
• dztradehub.bank.admin — Bank admin
• dztradehub.auction — Auction access
• dztradehub.casino — Casino access
• dztradehub.bounty — Bounty access
• dztradehub.rank.* — Rank related perms (default/vip/admin)

---

⚙️ Requirements

PaperMC 1.21.1 or newer

Java 21 or newer

DZEconomy v1.2.0 or newer

---

🧠 Why Choose DZTradeHub?

Instead of installing five different economy plugins, DZTradeHub gives you one well-integrated system that handles every aspect of player trading and banking. It’s built with scalability and security in mind — async loading, clean GUI interfaces, and full admin control — making it suitable for both small community servers and large multiplayer networks.

---

DZTradeHub: A unified, secure, and extensible economy framework for PaperMC 1.21.1 servers — balancing realism, gameplay depth, and performance. The third plugin from DemonZ Development