Paper 1.21+  ·  Vault Required  ·  EN / TR

HYPE TRADE

A feature-rich, secure and fully configurable player trading plugin. Boss bar countdowns, item blacklists, statistics tracking and full multi-language support.

Download on Modrinth Installation Guide
🪖
Player 1
▶
⇄
◀
⚔️
Player 2
What's inside

Features

🖥️
Shared GUI Inventory
Both players see the same 54-slot inventory in real time. Player skull icons show each trader's name, item count, and money offered at a glance.
⏱️
Boss Bar Countdown
When both players are ready, an animated boss bar counts down — green → yellow → red. The separator colour mirrors the boss bar state.
💰
Money Trading (Vault)
Left-click for small steps, right-click for large steps. Configurable max money cap. Final balance verification before any transfer.
🔒
Exploit Protection
Slots lock during countdown. Shift-click, number-key swaps, and off-hand swaps are all validated. Drag operations into trade slots are fully blocked.
📊
Trade Statistics
Per-player persistent stats: trades completed, items sent and received, money sent and received. Works for offline players too via /trade stats.
📝
Trade Logging
Every completed trade is written to logs/trades.log with timestamp, UUIDs, all items, and money amounts. Async — zero lag.
🌍
Multi-Language
Ships with English and Turkish. Every message, GUI label, and button text lives in editable lang/ files. Missing keys fall back to English automatically.
⚙️
Fully Configurable
Timeouts, cooldowns, money steps, blacklisted items, blacklisted worlds, boss bar toggle, title screen toggle — all in one clean config.yml.
⚡
Zero Lag
All file I/O (logging, stats saving) is dispatched to async threads. The main thread is never blocked. Safe for high-population servers.
Reference

Commands

/trade <player>
Send a trade request to another player. everyone
/trade accept
Accept the incoming trade request. everyone
/trade deny
Deny the incoming trade request. everyone
/trade cancel
Cancel your own active trade. Items are returned. everyone
/trade stats [player]
View trade statistics. Without argument shows your own stats. everyone
/trade list
List all currently active trades on the server. admin
/trade forcecancel <player>
Force-cancel any player's active trade. admin
/trade reload
Reload config.yml and language files without restart. admin
Setup

Configuration

config.yml

# Language: en or tr language: "en" trade: request-timeout: 60 countdown-seconds: 5 cooldown-seconds: 30 money-step: 100.0 money-step-large: 1000.0 max-money: 1000000.0 log-trades: true track-stats: true bossbar-countdown: true show-title: true blacklisted-items: - BEDROCK - BARRIER - COMMAND_BLOCK blacklisted-worlds: - "world_nether" - "world_the_end"

Options Reference

KeyDefaultDescription
language"en"Plugin language (en / tr)
request-timeout60Seconds before a request expires
countdown-seconds5Ready countdown length
cooldown-seconds30Wait time between trades (0 = off)
money-step100.0Left-click money increment
money-step-large1000.0Right-click money increment
max-money1000000Max money per single trade
log-tradestrueWrite trades to trades.log
track-statstrueSave statistics to stats.yml
bossbar-countdowntrueShow animated boss bar
show-titletrueTitle screen on complete / cancel
blacklisted-itemslistMaterials blocked from trades
blacklisted-worldslistWorlds where trade is disabled
Access Control

Permissions

hypetrade.use
Allows usage of /trade. Default: everyone.
hypetrade.admin
Access to list, forcecancel and reload commands. Default: op.
hypetrade.stats
View your own trade statistics. Default: everyone.
hypetrade.stats.others
View other players' statistics. Default: op.
hypetrade.bypass.cooldown
Skip the trade cooldown entirely. Default: op.
hypetrade.bypass.worldblacklist
Trade in blacklisted worlds. Default: op.
Getting Started

Installation

📦
Download JAR
Download HypeTrade.jar from Modrinth and place it in your server's /plugins folder.
🔌
Install Vault
Install Vault and an economy plugin such as EssentialsX or CMI if you haven't already.
🚀
Start Server
Start your Paper server. Config and language files are created automatically in plugins/HypeTrade/.
🌍
Set Language
Open config.yml and set language: "en" or language: "tr", then run /trade reload.
Localisation

Language Support

🇬🇧
English
language: "en"
The default language. All messages, GUI labels, boss bar text, title screens and admin responses are in English. Set language: "en" in config.yml to use it.
🇹🇷
Türkçe
language: "tr"
Tam Türkçe dil desteği. Tüm mesajlar, GUI etiketleri ve butonlar Türkçe olarak çevirilmiştir. Set language: "tr" in config.yml to use it.

💡 Custom languages: Copy lang/en.yml to lang/xx.yml, translate every value, and set language: "xx" in config.yml. Missing keys automatically fall back to English — you'll never see a broken message.

Requirements

Dependencies

☕
Paper 1.21+
Spigot/Bukkit not supported. Purpur ✓
Required
🏦
Vault
Economy bridge. Required for money trading.
Required
💎
Economy Plugin
EssentialsX, CMI, or any Vault-compatible economy.
Required

Java 21+ recommended  ·  Paper API 1.21.4

Help

FAQ

Does HypeTrade work on Spigot or Bukkit?
+
No. HypeTrade uses Paper-specific APIs (Adventure Component, Title, BossBar) that are not available on Spigot or Bukkit. You must run Paper 1.21 or a Paper-based fork such as Purpur. Folia is also not supported due to its different scheduler API.
What happens if a player disconnects mid-trade?
+
The trade is cancelled immediately via the PlayerQuitEvent handler. All items that were in the trade GUI are returned to their respective owners. No items are lost.
Can I add my own language?
+
Yes! Copy plugins/HypeTrade/lang/en.yml to lang/xx.yml (where xx is your language code), translate every value, and set language: "xx" in config.yml. Run /trade reload — no restart needed.
Is item duplication possible?
+
No. Items are locked during the countdown. Shift-click, number-key hotbar swaps, and off-hand swaps are all validated against the item blacklist. Drag operations into trade slots are fully cancelled. A final balance check runs before any money changes hands.
Will the plugin cause lag on my server?
+
No. All file I/O — writing to trades.log and saving stats.yml — is dispatched asynchronously to a worker thread. The main thread only handles in-memory operations that complete in microseconds.
Can players trade in creative mode?
+
Spectator mode players cannot trade. Creative mode players can trade by default. You can restrict specific worlds by adding them to the blacklisted-worlds list in config.yml.
How do I reload the config without restarting?
+
Run /trade reload in-game or from the console. This reloads both config.yml and the active language file. No restart or reconnect is required.
Where are trade logs and statistics stored?
+
Trade logs are written to plugins/HypeTrade/logs/trades.log. Player statistics are stored in plugins/HypeTrade/data/stats.yml. Both files are created automatically on first use.