# ⇄ 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***