HypeTrade

A feature-rich, secure and fully configurable player trading plugin for Paper 1.21+

---

Overview

HypeTrade provides a polished, real-time chest-GUI trading system between İwo players. Both players see the same shared inventory, can offer items and money simultaneously, and must both click Ready before a configurable countdown completes the trade. Every step of the trade is protected against duplication exploits, inventory manipulation, and unexpected disconnects.

---

Features

Intuitive GUI

• Shared 54-slot inventory: Both players see the same screen in real time.
• Player skull icons: Showing each trader's name, item count and money offered.
• Animated separator: Changes colour during the countdown (green → yellow → red).
• Cancel button: Always visible for a safe exit.

Money Trading (Vault)

• Flexible Steps: Left-click for small increments and Right-click for large steps (both configurable).
• Security: Per-trade maximum money cap to prevent extreme transactions.
• Verification: Real-time balance verification at every step and again at trade completion.

Smart Countdown System

• Visual Aids: Animated Boss Bar countdown with colour progression.
• Title Screens: Overlay on trade complete and trade cancel.
• Auto-Reset: If either player changes the trade contents, the countdown resets automatically.

Exploit Prevention

• Anti-Dupe: Items placed during the countdown are locked. No adding/removing during the final seconds.
• Strict Validation: Shift-click, number-key swap, and off-hand swap are all validated against the blacklist.
• Safe Returns: Items always returned safely if the trade is cancelled, even on server shutdown.

---

Commands & Permissions

Command	Description	Permission
/trade <player>	Send a trade request	hypetrade.use
/trade accept	Accept an incoming request	hypetrade.use
/trade stats	View trade statistics	hypetrade.stats
/trade reload	Reload config & language	hypetrade.admin

---

Installation

1. Download HypeTrade.jar and place it in your /plugins folder.
2. Ensure Vault and an economy plugin are installed.
3. Start your server to generate the default config.yml.
4. Set your preferred language in the config: language: "en" or language: "tr".
5. Run /trade reload to apply changes.

---

FAQ

Q: What happens if a player disconnects mid-trade? A: The trade is cancelled immediately and all items are returned to their owners safely.

Q: Is duplication possible? A: No. Items are locked during the countdown, and final balance checks run before any transaction occurs.

---

Made with ❤️ by xXantares_peek