🤝 TradePlugin

A secure, feature-rich, and modern trading system for Paper 1.21.11 with an intuitive split-screen GUI and powerful admin tools.

✨ Features

🖥️ Interactive Split-Screen GUI: A clean 54-slot trading interface with a central divider, individual player item areas, and clear Ready/Not Ready status indicators.

💬 Chat Requests & Clickable Buttons: Send requests via /trade . Targets receive interactive chat messages with clickable [Accept] and [Deny] buttons powered by MiniMessage.

⏱️ Configurable Timeout: Requests automatically expire after a set time (default: 180 seconds), fully customizable in the config.yml.

🛡️ Advanced Anti-Dupe Protection: Safeguards server economy by blocking shift-clicking, number-key hotbar swapping, and unauthorized inventory manipulation during active trades.

🔒 Admin Control (Blacklist): Administrators can toggle trading abilities on or off for specific players (/trade toggle ), preventing problem users from trading.

📜 Automatic Logging & Inspector: Every completed trade is automatically recorded into a trades.log file with timestamps and item details. Admins can easily check a player's history using /trade logs .

⌨️ Full Tab Completion: Seamless command completion for player names and subcommands.

🎮 Commands & Permissions

Command	Description	Permission
trade <player>	Send a trade request to an online player.	Default (Everyone)
/trade accept <player>	Accept a pending trade request.	Default (Everyone)
/trade deny <player>	Deny a pending trade request.	Default (Everyone)
/trade toggle <player>	Enable or disable trading for a specific player.	tradeplugin.admin.toggle
/trade logs <player>	View the recent trade history of a player.	tradeplugin.admin.logs

🔑 Permissions

permissions:
  tradeplugin.admin.toggle:
    description: Allows toggling trade status for players.
    default: op
  tradeplugin.admin.logs:
    description: Allows viewing trade audit logs.
    default: op

⚙️ Configuration (config.yml)

# Time in seconds before a trade request expires
request-timeout: 180

messages:
  prefix: "<dark_gray>[<gold>Trade<dark_gray>] <reset>"
  request-sent: "<green>Trade request sent to <yellow>%player%<green>. It expires in %time% seconds."
  request-received: "<green>You received a trade request from <yellow>%player%<green>!"
  accept-button: "<green><bold>[Accept]</bold>"
  deny-button: "<red><bold>[Deny]</bold>"
  accepted: "<green>Trade started!"
  denied: "<red>Trade request denied."
  cancelled: "<red>The trade was cancelled."
  success: "<green>Trade completed successfully!"
  expired: "<red>The trade request has expired."
  no-request: "<red>You have no pending request from this player."
  not-found: "<red>Player not found or not online."
  already-trading: "<red>This player is currently trading with someone else."
  cannot-trade-self: "<red>You cannot trade with yourself."
  shift-click-disabled: "<red>Shift-clicking is disabled in the trade window."
  
  # Admin Messages
  trade-disabled-self: "<red>Trading has been disabled for you by an administrator."
  trade-disabled-other: "<red>This player is currently not allowed to trade."
  admin-toggle-on: "<green>Trading for <yellow>%player% <green>has been <bold>enabled</bold>."
  admin-toggle-off: "<red>Trading for <yellow>%player% <red>has been <bold>disabled</bold>."
  no-permission: "<red>You do not have permission to perform this action!"
  no-logs-found: "<yellow>No trade log entries found for this player."