Simple Secure Real-Time Player-to-Player Item Exchange!


⭐ What is Addict-O-Trade?
Addict-O-Trade is a simple, lightweight plugin that lets players securely exchange items, Vault economy money, and XP levels in real-time through a shared GUI. Target a player visually or by name, send a trade request, and once accepted, both players see a synchronized inventory where they can deposit items, offer money/XP, validate the exchange, and complete the trade safely.

No permissions required — every player can trade right away!

✨ Key Features

• Real-Time Shared GUI: Both players share a single 54-slot inventory. Items placed on one side are instantly visible to the other player.
• XP & Economy Trade Support: Trade Vault money and XP levels directly inside the GUI. Safe and secure chat prompt session inputs protect against double clicks. Full verification at trade completion guarantees that no items or money are transferred unless players have the required funds and levels, preventing exploitation.
• Anti-Scam Dual Validation: Both players must click the green validate button. If either player modifies their items, money, or XP after validation, both validations reset automatically — preventing bait-and-switch scams.
• Smart Targeting: Use /trade while looking at a player to target them automatically via line-of-sight raycasting, or specify a player name directly.
• Proximity Required (3 Blocks): Both players must be within 3 blocks of each other to initiate or accept a trade — no long-distance trading!
• Movement Lock: Both players are frozen in place (X/Y/Z coordinates locked, look direction still free) during an active trade to prevent exploitation.
• Safety Cancellation: Logging out, dying, running commands, or closing the inventory during a trade automatically cancels the session and safely returns all items/money/XP. If a player's inventory is full, items are dropped at their feet.
• Protected Slot System: Players can only interact with their own trade slots. The other player's slots, separator line, and status panes are click-protected.
• Smart Shift-Click: Shift-clicking items from the player's inventory places them on the correct trade side automatically, merging with similar stacks when possible.
• 30-Second Invitation Timeout: Trade requests expire after 30 seconds if not accepted, keeping the system clean.
• Full Translation Support (i18n): All messages are fully localized in English & French. Use /lang to switch languages dynamically.

Commands & Permissions

Commands:

• /trade [player] - Proposes a trade to the targeted or named player.
• /tradea (Alias: /tradeaccept) - Accepts a pending trade request.
• /lang <fr|en> - Changes your preferred language.

Permissions:

• No permissions required — all players can trade by default.

⚙️ Installation Instructions

• Place Addict-O-Trade-1.1.jar in the /plugins/ directory. (Make sure Vault is installed if you want to trade money).
• Restart your server to generate configurations.
• Players can immediately start trading with /trade!