DZTradeHub

# DZTradeHub — The Complete Minecraft Economy System (OUTDATED WILL BE UPDATED AFTER V3 OF DZECONOMY)

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` `/` — Quick open GUI for a specific bank (e.g., `/money-bank`, `/central-bank`). — `dztradehub.bank` `/ create ` — Create account in that bank. — `dztradehub.bank` `/ 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 ` — Create a new bank (opens bank configuration GUI). — `dztradehub.bank.admin` `/bank delete ` — Delete a bank. — `dztradehub.bank.admin` `/bank rename ` — Rename a bank. — `dztradehub.bank.admin` `/bank config ` — Open bank configuration GUI for ``. — `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 ` — Open shop selection for an area. — `dztradehub.use` `/sell ` — Open sell interface for a specific shop. — `dztradehub.use` `/sellall` — Sell all inventory (requires specifying area & shop or configured default). — `dztradehub.use` `/sellall ` — Sell all items to the specified shop. — `dztradehub.use` `/sellhand` — Sell item in hand (requires specifying area & shop or configured default). — `dztradehub.use` `/sellhand ` — Sell the hand item to specified shop. — `dztradehub.use` #### Admin `/dzth create-area ` — Create a new marketplace area. — `dztradehub.admin` `/dzth delete-area ` — Delete an area. — `dztradehub.admin` `/dzth rename-area ` — Rename an area. — `dztradehub.admin` `/dzth create-shop ` — Create a shop in area. — `dztradehub.admin` `/dzth delete-shop ` — Delete a shop. — `dztradehub.admin` `/dzth rename-shop ` — Rename a shop. — `dztradehub.admin` `/dzth config ...` — Configure shop queue & settings. — `dztradehub.admin` * `/dzth link-shop ` — Link sell/buy shops for stock tra