GlymeraTrade

GlymeraTrade - Safe Player-to-Player Trading

Let your players trade items and money safely, without anyone getting scammed. A shared trade window, live offer preview, two-step confirmation and an atomic swap - plus money support through GlymeraMerchant or any VaultUnlocked economy.

Don't miss my other exciting projects — take a look at GlymeraCraft's Profile Discord: https://discord.gg/s5NRFWfxgy

---

What is GlymeraTrade?

GlymeraTrade gives your server a proper, scam-proof trading system. A player runs /trade <name>, the other accepts, and a shared trade window opens for both. Each side adds items (and optionally money), both see each other's offer update live, and the deal only goes through once both players confirm. Items and money change hands at the exact same moment - all or nothing.

No more "drop it on the ground and trust me" trades.

---

How it works

1. Player A runs /trade <player>. Player B gets a request and runs /trade accept.
2. A trade window opens for both players at the same time.
3. Add items: click an item in your inventory (bottom of the window) to move it into Your offer. Click an item in Your offer to take it back. The item leaves your real inventory while it sits in the offer, so it can never be duplicated.
4. Add money: type an amount and press Set money (if an economy is available).
5. Both players press Confirm. A short countdown runs, then items and money are swapped atomically.

Anti-scam protections

• Both must confirm - nothing happens until both sides agree.
• Any change resets both confirmations. If someone adds, removes or changes anything after confirming, both confirmations are cleared and both must confirm again. This kills the classic "swap the item at the last second" trick.
• Atomic swap - items and money move together or not at all.
• Live colour feedback - a side turns green the moment that player confirms (visible to both); the title turns green when both have confirmed.
• Cancel / close / disconnect - cancelling, closing the window or leaving the game cancels the trade and returns every offered item.

---

Money support (optional)

GlymeraTrade can include money in a trade, pulled from whichever economy your server runs:

• GlymeraMerchant - used directly, no extra plugins needed.
• VaultUnlocked - any VaultUnlocked-compatible economy works through Vault.

Both are optional. If neither is installed, GlymeraTrade simply runs as an item-only trading plugin - it always loads.

The source is chosen automatically (auto): GlymeraMerchant first, then VaultUnlocked. You can force a specific backend in the config.

---

Commands

Command	Description
/trade <player>	Send a trade request to a player
/trade accept	Accept the pending trade request
/trade deny	Decline the pending trade request

---

Configuration

Config file: mods/de.glymera_GlymeraTrade/config.json

Option	Default	Description
confirmSeconds	3	Countdown (seconds) after both confirm, before the swap completes
requestExpireSeconds	60	How long a trade request stays valid
allowMoney	true	Allow money to be part of a trade
moneyBackend	"auto"	auto, merchant, vault or none
currencyName	"gold"	Display name of the currency
currencySymbol	"g"	Display symbol of the currency
blacklistedWorlds	[]	Worlds where trading is disabled
blacklistItems	[]	Item IDs that cannot be traded (exact or substring match)

---

Notes

• Both players must be online and in the same world to start a trade. Distance does not matter - you can trade across the whole map.
• Trading uses a click-to-move interface (Hytale custom UI does not support drag-and-drop item slots).