⇄ 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 two 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 that changes colour during the countdown (green → yellow → red)
• Cancel button always visible for a safe exit

💰 Money Trading (Vault)

• Left-click: small step | Right-click: large step (both configurable)
• Per-trade maximum money cap to prevent extreme transactions
• Real-time balance verification at every step and again at trade completion

⏱️ Smart Countdown System

• Animated Boss Bar countdown with colour progression
• Separator colour mirrors the boss bar state
• Title screen overlay on trade complete and trade cancel
• If either player changes the trade contents, the countdown resets automatically

🔒 Exploit Prevention

• Items placed during the countdown are locked — no adding/removing during the final seconds
• Shift-click, number-key swap and off-hand swap are all validated against the blacklist
• Drag operations into trade slots are fully blocked
• Double-verification of balances immediately before money is transferred
• Items always returned safely if the trade is cancelled, even on server shutdown

📊 Trade Statistics

• Per-player persistent stats: trades completed, items sent/received, money sent/received
• /trade stats [player] visible in-game; works for offline players too
• Stored in data/stats.yml — easy to read and back up

📝 Trade Logging

• Every completed trade written to logs/trades.log with full detail:
  • Timestamp, both player UUIDs, every item on both sides, money amounts

🌍 Multi-Language

• Ships with English and Turkish out of the box
• Every single message — including GUI labels — lives in lang/en.yml / lang/tr.yml
• Missing keys automatically fall back to English; you'll never see a broken message
• Switch language with one line in config.yml: language: "en" or language: "tr"

⚙️ Fully Configurable

Option	Default	Description
request-timeout	60s	Seconds before an unanswered request expires
countdown-seconds	5s	Ready countdown length
cooldown-seconds	30s	Wait time between trades
money-step	100	Left-click money increment
money-step-large	1000	Right-click money increment
max-money	1,000,000	Max money per trade
blacklisted-items	list	Materials that cannot be traded
blacklisted-worlds	list	Worlds where trading is disabled
bossbar-countdown	true	Toggle the boss bar
show-title	true	Toggle title screens
log-trades	true	Toggle trade logging
track-stats	true	Toggle statistics tracking

---

🛠️ Commands

Command	Description	Permission
/trade <player>	Send a trade request	hypetrade.use
/trade accept	Accept an incoming request	hypetrade.use
/trade deny	Deny an incoming request	hypetrade.use
/trade cancel	Cancel your active trade	hypetrade.use
/trade stats [player]	View trade statistics	hypetrade.stats
/trade list	List all active trades	hypetrade.admin
/trade forcecancel <player>	Force-cancel a trade	hypetrade.admin
/trade reload	Reload config & language	hypetrade.admin

---

🔑 Permissions

Permission	Default	Description
hypetrade.use	everyone	Use /trade
hypetrade.admin	op	Admin commands
hypetrade.stats	everyone	View own stats
hypetrade.stats.others	op	View others' stats
hypetrade.bypass.cooldown	op	Skip cooldown
hypetrade.bypass.worldblacklist	op	Trade in blacklisted worlds

---

---

🚀 Installation

1. Download HypeTrade.jar and place it in your /plugins folder
2. Make sure Vault and EssentialsX and an economy plugin are installed
3. Start your server — config.yml and both language files are created automatically
4. Set language: "en" or language: "tr" in config.yml
5. Run /trade reload after any config change — no restart needed

---

---

❓ FAQ

Q: Can players trade in creative mode? A: Yes, unless you add their world to blacklisted-worlds.

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

Q: Can I add my own language? A: Yes! Copy en.yml to lang/xx.yml, translate every value, and set language: "xx" in config.

Q: Is duplication possible? A: No. Items are locked during the countdown, shifts and hotbar swaps are validated, and a final balance check runs before any money changes hands.

---

Made with ❤️ by xXantares_peek