Smart Trade System
Last Update: 1.1 [1.21+ compatible] [1.21.11 tested]



A robust, high-performance, and secure trading solution for your server. Optimized for Paper 1.21.1 and fully compatible with Java & Bedrock (Geyser) players.

How to Trade
│➜ Initiate Use /trade [player] and wait for them to /trade accept.
│➜ Select Items Click items in your inventory
│➜ to add them to the trade window.

│➜ Protection Blocks: Click on the icon of:
│➜ Golden Shovel to increase + 100 claimblocks or
│➜ Wooden Shovel to remove - 100 claimblocks
│➜ to trade or sell your claim blocks.

│➜ Currency Click on the icon of:
│➜ Emerald to increase + 100 coins or
│➜ Redstone to remove - 100 coins
│➜ to offer Economy Coins.



│➜ Update Status Click your Eye of Ender to refresh the window.
│➜ This is the only button that does not reset the ready status.
│➜ Confirming Click the Moss Block to confirm.
│➜ If the other player is ready, their glass turns Green
│➜ and yours turns Orange.
│➜ Reset Any modification (except the Eye of Ender)
│➜ cancels confirmations, resetting the status glass to Yellow.
│➜ Completion Once both confirm, items go to your secure storage.
│➜ Use /trade chest to collect them safely.



1.1 ChangeLog: Fixed Lore on Heads.



Main Features
│➜ Cross-Platform Sync: Integrated "Ender Eye" manual refresh
│➜ system to prevent visual desync for Bedrock players.
│➜ Triple Economy: Support for physical items, Vault (Coins),
│➜ and GriefPrevention (Claim Blocks) in the same UI.
│➜ Zero-Loss Policy: All received items are sent to a virtual
│➜ Security Chest to prevent loss from full inventories.
│➜ Anti-Scam Logic: 3-second safety countdown that resets
│➜ automatically if any item or value is changed.
│➜ Atomic Transactions: Secure processing ensures trades
│➜ happen in a single tick, preventing duplication exploits.
│➜ Discord Integration: Built-in async system to log every
│➜ successful trade directly to your Discord channel.

│➜ Bilingual Support: Native messages_en.yml and
│➜ messages_pt.yml files generated on first run.
│➜ UUID Support: Persistent tracking for players,
│➜ ensuring compatibility with name changes and Geyser.
│➜ Optimized Performance: All heavy tasks (Discord/Logs)
│➜ run asynchronously to ensure zero TPS spikes.

Commands
│➜ /trade player Sends a secure trade invitation.
│➜ /trade accept Accepts a pending invitation (30s timeout).
│➜ /trade chest Opens your virtual chest to retrieve items.
│➜ /trade reload Instantly reloads configs and languages.
│➜ /trade help Shows the interactive help menu.

Permissions
│➜ trade.use Basic permission to send invites and trade
│➜ (Default: Everyone).
│➜ trade.accept Permission to accept incoming trade requests.
│➜ trade.chest Permission to access the virtual recovery chest.
│➜ trade.admin Master permission to reload and manage plugin.

Configuration (config.yml)
│➜ request-timeout: Set how long an invite stays active (Default: 30s).
│➜ economy-per-click: Configure the increment for Vault coins.
│➜ claim-blocks-per-click: Set the amount of blocks added per click.
│➜ discord-webhook-url: Paste your Webhook URL for audit logs.
│➜ language: Switch between "en" and "pt" with one line.

Important Notice
│➜ Java 21 Required: This plugin is built for 1.21.1+
│➜ environments and requires Java 21 to run.
│➜ Soft Dependencies: Works best with Vault and
│➜ GriefPrevention installed for full economy support.
│➜ Safety First: Always use /trade chest to collect items;
│➜ this prevents items from falling on the ground.
│➜ Sync System: Encourage players to use the Ender Eye
│➜ button to verify trades before clicking "Accept".
│➜ Support: If you find any bugs or have suggestions, please
│➜ contact the developer or open an issue on GitHub.

Developed with ❤️ by Comonier