🤝 ShadowTrade

ShadowTrade is a modern, highly optimized, and incredibly secure GUI-based player trading plugin for Minecraft Paper servers. Built to match the quality of paid premium plugins, it allows your players to securely trade items, Vault economy money, experience levels, and PlayerPoints all within a sleek, fully animated interface.

✨ Core Features

• 100% Anti-Scam Architecture: Every known trading exploit is blocked out of the box. Shift-click exploits, inventory full drops, sudden disconnects, death during a trade, and last-second bait-and-switch scams are entirely prevented by a rigorous 3-Phase State Machine.
• Double Confirmation System: Both players must lock in their offers. If any player alters their items or money after pressing "Ready", all confirmations are instantly revoked and the 3-second countdown is canceled.
• Universal Item Support: Flawlessly trades NBT data, CustomModelData, enchantments, lore, Player Heads, and custom items from plugins like ItemsAdder, Oraxen, MMOItems, and EcoItems.
• Multi-Currency Support: Players can trade items alongside Vault Economy balances, Experience Levels, and PlayerPoints.
• Asynchronous Database Logging: Every completed and canceled trade is permanently logged to SQLite or MySQL, ensuring you have a complete audit trail without ever lagging your main server thread.
• Modern MiniMessage Translations: Say goodbye to legacy & color codes. Every message natively supports modern Hex colors, gradients, click-actions, and hover-texts.

🛡️ Unrivaled Security

ShadowTrade's TradeProtectionListener strictly monitors all interaction.

• Inventory Locking: Players are restricted to only their side of the trading GUI.
• Event Cancellations: If a player dies, teleports away, drops connection, or the server restarts unexpectedly, the trade session is immediately invalidated, and all items are safely returned to the owners' inventories or dropped securely at their feet.
• No Duplication Glitches: Completely immune to client-side desync, packet abuse, and hotbar swapping.

⌨️ Commands & Permissions

• /trade <player> - Send a trade request to an online player.
• /trade accept - Accept a pending trade request.
• /trade deny - Decline a pending trade request.
• /trade help - Display the help menu.
• /trade reload - Reload all configuration files seamlessly.

Permissions:

• shadowtrade.use — Basic access to send and receive requests. (Default: true)
• shadowtrade.admin — Access to admin monitoring commands. (Default: op)
• shadowtrade.bypasscooldown — Bypass the standard request spam-cooldown.
• shadowtrade.reload — Reload plugin files.

⚙️ Soft-Dependencies

ShadowTrade is highly independent but will automatically hook into these plugins if they are present on your server:

• Vault (For economy trading)
• PlayerPoints (For premium currency trading)
• PlaceholderAPI (For statistic tracking)

🚀 Optimization

Written with clean OOP principles and utilizing HikariCP for connection pooling, ShadowTrade boasts zero memory leaks and performs zero synchronous database queries. It's built on Java 21, specifically targeting Paper 1.21.x to ensure maximum thread safety for servers hosting 500+ concurrent players.