TradeVault v1.0

---

Atomic Escrow Trading
Items are secured inside the trade session and only exchanged when both players confirm. No rushed drops, no trust-based trading, no unsafe handoffs.

Anti-Scam Countdown
After both players accept, TradeVault starts a final countdown. If someone changes their offer, the confirmation resets to help prevent last-second item switching.

Money Trading
Let players trade economy balance alongside items using Vault support. Money offers are shown directly in the trade interface.

Crash-Safe Recovery
If a server crash, restart or interruption happens during a trade, escrowed items can be recovered safely through the recovery system.

Flexible Trade Rules
Control how trading works on your server with cooldowns, permissions, blocked items, request rules and configurable behavior.

---

Simple Trade Requests
Players can request trades quickly and clearly, without confusing commands or risky manual item drops.

Clean Confirmation Flow
Both sides can review the offer, accept when ready, and rely on the countdown before the final swap happens.

Trade Toggle & Ignore List
Players stay in control. They can disable incoming trade requests or ignore specific players when needed.

---

Zero Dupe Design
TradeVault is built around controlled escrow logic so items are never duplicated, dropped unsafely or swapped outside the trade flow.

Safe Cancels
Trades can be cancelled cleanly before completion, returning items to the correct players without risky manual handling.

Runtime Protection
The system protects against common interruption cases such as disconnects, inventory changes, closing menus and unexpected trade state changes.

---

Trade History
Review completed and cancelled trades with useful details such as players, offered items, money values and trade results.

Live Reload
Reload configuration, messages and GUI settings without restarting your server.

Blacklist
Block specific items or restricted trade behavior to protect your economy and prevent abuse.

---

YAML Everything
Customize menus, messages, item names, lores, sounds and behavior through simple configuration files.

Clickable Messages
Create cleaner player flows with interactive chat messages for trade requests, accepts and actions.

Re-Skin the GUI
Adjust the trade interface to match your server style, including icons, labels, layout text and visual feedback.

---

Vault
Supports economy trading through Vault-compatible economy plugins.

PlaceholderAPI
Use placeholders to display useful trade and player information in messages or menus.

Permissions
Control access to trading features, admin tools and advanced behavior with your permissions plugin.

---

Paper & Purpur
Designed for modern optimized server software.

1.8.8 - Latest
Built to support a wide range of Minecraft server versions.

Java 8+
Compatible with common Java environments used by Minecraft servers.

Folia Support
Made with modern server compatibility in mind for supported setups.

---

1. Request
A player sends a trade request to another player.

2. Offer
Both players place items and optional money into the trade GUI.

3. Confirm
Each player accepts after reviewing the full offer.

4. Swap
After the countdown finishes, the trade is completed safely and atomically.

---

Recover Escrowed Items
Interrupted trades do not have to become lost items. Escrowed items can be restored through the recovery system.

Claim Safely
The recovery menu helps players or staff reclaim the correct items safely after an interrupted trade.

---

Player Commands

• /trade <player> - Send a trade request
• /trade accept - Accept a pending request
• /trade deny - Deny a pending request
• /trade toggle - Enable or disable trade requests
• /trade ignore - Ignore trade requests from specific players
• /trade history - View trade history
• /trade recovery - Open the recovery menu

Admin Commands

• /trade admin reload - Reload configuration
• /trade admin history - Review trade logs
• /trade admin recovery - Manage recovery tools

---