NexaTrade | Secure Trade System v1.0.0

NexaTrade​

• Safe GUI Trading — clean two-sided trade menu with player offers, partner offers, confirm buttons, currency controls, status display, and final countdown.
• Anti-Dupe Escrow System — items placed into the trade GUI are removed from the player and stored in escrow until the trade is completed, cancelled, or rolled back.
• Item Snapshot & Fingerprint — item data is captured and validated using material, amount, display name, lore, enchantments, durability, custom model data, PersistentDataContainer data, serialized data, and container contents.
• Recursive Container Checks — shulkers, barrels, bundles, and other container items can be scanned recursively to prevent hidden blacklisted or illegal items.
• Double Confirmation — both players must confirm the trade before the final countdown starts.
• Offer Locking — once both players confirm, the offer is locked and cannot be changed during countdown.
• Rollback & Recovery — disconnects, timeouts, validation failures, full inventories, currency failures, plugin shutdowns, Redis issues, and exceptions can trigger a safe rollback flow.
• Claim Storage — if items cannot be returned because a player inventory is full, they can be moved into claim storage instead of being lost.
• Receipt & History System — completed trades generate receipt data with player info, server info, item/currency summary, transaction ID, status, and timestamp.
• Timeline & Replay Records — trade events can be stored for moderation, dispute handling, and replay review.
• Signed Audit Logs — audit records can be verified to detect tampering.
• Multi-Currency Support — supports Vault, CoinsEngine, EXP, internal balances, and command/PlaceholderAPI based custom currencies.
• Marketplace Offers — players can create public item offers with escrowed items and currency prices.
• Contract Trades — players can create targeted item-for-currency contracts for specific players.
• Scheduled Trades — create controlled trades that execute after a configured delay.
• Trade Templates — save repeated offers as private or public templates.
• Reputation & Reviews — players can leave ratings, build trust scores, and view reputation data.
• Scam Reports & Disputes — receipt-based scam reports and dispute records help staff investigate trade issues.
• Refund Records — staff can create refund records, with optional automatic refund behavior depending on configuration.
• Risk & Fairness System — optional price database and fairness checks can warn staff about suspicious or unbalanced trades.
• Admin Moderation Tools — browse active trades, spectate sessions, freeze trades, rollback sessions, review logs, export receipts, and verify audit records.
• Cross-Server Ready — optional Redis-based request, response, session update, commit, rollback, heartbeat, and global player lock support.
• SQL Persistence — SQLite for local/single-server usage and MySQL/MariaDB for production network setups.
• Full YAML Configuration — configure modules, messages, GUIs, currencies, limits, reputation, marketplace, prices, webhooks, blacklist rules, and more.

• SIMPLE — basic safe local trading with confirm, countdown, logs, receipt, and history.
• SAFE — default secure mode with escrow, item snapshots, fingerprints, blacklist checks, rollback, history, admin logs, and signed audit logs.
• NETWORK — Redis, cross-server sync, global player locks, distributed sessions, and production SQL requirements.
• ECONOMY — marketplace, public offers, contracts, price database, fairness score, and fee/tax systems.
• ENTERPRISE — cross-server trading, marketplace, reputation, disputes, refunds, replay, webhooks, REST API, and smart risk checks.
• CUSTOM — use exactly the module values configured in modules.yml.

PREPARE -> LOCK -> VALIDATE -> WITHDRAW -> DELIVER -> DEPOSIT -> ACK -> COMPLETE

• Remove the item from the player and store it in escrow.
• Create an item snapshot.
• Generate and validate an item fingerprint.
• Scan container contents recursively.
• Check blacklist rules.
• Detect illegal or suspicious items.
• Reset confirmations when offers change.
• Rollback safely if validation fails.

• Online player heartbeat
• Server heartbeat
• Trade request and response messages
• Session update messages
• Commit and rollback signals
• Global player locks
• Cross-server session snapshots

• Vault economy
• CoinsEngine
• EXP
• Internal balance
• Command-based custom currencies
• PlaceholderAPI-backed custom currencies

• Marketplace Offers — players can escrow an item and list it publicly for a currency price.
• Contract Trades — players can send targeted item-for-currency trade terms to a specific player.
• Scheduled Trades — items can be escrowed and executed later based on a configured delay.
• Templates — players can save repeated trade offers for faster reuse.

• Positive, neutral, and negative reviews
• Trust score
• Reputation tiers
• Completed trade count
• Negative review count
• Scam report records
• Dispute records
• Refund records

• Browse active trade sessions
• View admin logs
• Spectate trades in read-only mode
• Freeze and unfreeze sessions
• Rollback active sessions
• Start or stop the global trade system
• Review receipts and replay records
• Export receipt data as JSON
• Verify signed audit logs
• Create refund records

• Vault
• CoinsEngine
• PlaceholderAPI
• WorldGuard
• Floodgate
• Geyser

• modules.yml
• config.yml
• messages.yml
• currencies.yml
• limits.yml
• reputation.yml
• marketplace.yml
• prices.yml
• guis/trade.yml
• guis/currency.yml
• guis/currency-input.yml

/trade help
/trade <player>
/trade accept [player]
/trade deny [player]
/trade toggle
/trade ignore <player>
/trade history
/trade receipt <receipt-id>
/trade review <receipt-id> <1-5> [comment]
/trade scamreport <receipt-id> <reason>
/trade dispute <receipt-id> <reason>
/trade reputation <player>
/trade claims

/trade offers
/trade offer create <currency> <price>
/trade offer cancel <id>
/trade offer accept <id> [amount]
/trade contract create <player> <currency> <amount> <hours>
/trade contract accept <id>
/trade contract cancel <id>
/trade scheduled create <player> <currency> <amount> <minutes>
/trade template create <name> <currency> <amount> [public]

/nexatrade help
/nexatrade reload
/nexatrade browse
/nexatrade logs
/nexatrade spectate <session-id>
/nexatrade replay <receipt-id>
/nexatrade export <receipt-id>
/nexatrade verifyaudit <audit-id>
/nexatrade start
/nexatrade stop
/nexatrade rollback <session-id>
/nexatrade freeze <session-id>
/nexatrade unfreeze <session-id>
/nexatrade refund <receipt-id> [type] [notes]

trade.use
trade.accept
trade.toggle
trade.history
trade.reputation
trade.crossserver
trade.offer.create
trade.offer.marketplace
trade.bypass.cooldown
trade.bypass.limit
trade.bypass.blacklist
trade.admin
trade.admin.active
trade.admin.logs
trade.admin.spectate
trade.admin.cancel
trade.admin.freeze
trade.admin.refund
trade.admin.reputation
trade.admin.stop
trade.admin.reload
trade.admin.*
nexatrade.use
nexatrade.admin
nexatrade.admin.reload

• Escrow-first item handling
• Rollback and recovery logic
• Multi-currency support
• Cross-server expansion path
• Marketplace and contracts
• Receipts, history, replay, and audit logs
• Reputation, scam reports, and disputes
• Admin tools for real moderation
• Fully modular configuration