NexusTrade

Modern and secure player-to-player trading for Paper servers.

Загрузки: 182
Подписчики: 0
Обновлён: 11 апреля 2026 г.
Лицензия: MIT

Опубликован 30 марта 2026 г.

Исходный код

💱 NexusTrade

Modern player-to-player trading for Paper servers

Compatibility: 1.21.1 to 26.1+ (and forks)

🎮 Support Discord

NexusTrade is a modern trade plugin for Paper servers focused on secure item and currency trading between players.

It includes trade menus, receipts, reviews, history, restrictions, Redis or memory sync, multiple SQL backends, and a public API for developers.

Everything can be customized through config.yml, messages.yml, and menus.yml.

✨ Main Features

🔒 Secure Trade Flow

Dedicated trade menu
Virtual inventory to reduce desync and duplication risk
Completion countdown
Movement, damage, teleport, and combat restrictions
Distance checks and blocked world support
Configurable item filters

💰 Currency Support

Item trading
Level trading
Economy support through Vault
Optional PlayerPoints support
Configurable currency icons, labels, and permissions
Java anvil editor and optional Bedrock amount input through Floodgate

📜 Receipts, Reviews, and History

Written receipt books
1 to 5 star review system
Archived trade history browser
Player review summaries
Spectator mode for staff

🌐 Persistence and Networking

MEMORY mode for single-server setups
REDIS mode for multi-server sync
SQLite, MySQL, MariaDB, and PostgreSQL
Active trade persistence
Archived trade storage
Safe reload handling

🛠️ Administration

/nexustrade reload
/nexustrade debug
/nexustrade stress on|off
Force-open trades for testing or moderation

🔌 Hooks and Integrations

Vault
PlayerPoints
WorldGuard
Floodgate

💻 Main Commands

Command	Description	Permission
`/trade`	Open your current trade or your active trade browser.	`nexustrade.trade`
`/t`	Alias of `/trade`.	`nexustrade.trade`
`/trade <player>`	Send a trade request, accept one, or reopen an existing trade with that player.	`nexustrade.trade`
`/trade ignore <player>`	Ignore or unignore trade requests from a player.	`nexustrade.ignore`
`/trade ignores`	View your ignored players list.	`nexustrade.ignore`
`/trade history`	Open your archived trade history.	`nexustrade.browse`
`/trade history <player>`	View archived trades for a specific player.	`nexustrade.browse`
`/trade spectate <player>`	Open that player's active trade in spectator mode.	`nexustrade.spectate`
`/trade rate set <tradeId>`	Open the review menu for a completed trade.	`nexustrade.review`
`/trade rate set <tradeId> <1-5>`	Save a direct rating for a completed trade.	`nexustrade.review`
`/trade rate show-trade <tradeId>`	Show both stored ratings for a completed trade.	`nexustrade.review.showtrade`
`/trade rate show-player [player]`	Show a player's review summary.	`nexustrade.review.showplayer`
`/trade amount <currency> <amount>`	Change your current currency offer in the latest open trade.	`nexustrade.currency.<currency>` or `nexustrade.admin`
`/nexustrade`	Open the main admin help panel.	`nexustrade.admin`
`/nt`	Alias of `/nexustrade`.	`nexustrade.admin`
`/nexustrade reload`	Reload config, messages, and menus safely.	`nexustrade.admin`
`/nexustrade debug`	Show runtime debug information and active trades.	`nexustrade.admin`
`/nexustrade stress <on\|off>`	Enable or disable stress mode.	`nexustrade.admin`
`/nexustrade opentrade <viewer> <target>`	Force-open a trade window for testing or moderation.	`nexustrade.admin`

🔧 API and Events

NexusTrade includes a public API for other plugins.

Main access point:

com.nexustrade.api.NexusTradeProvider

Main API interface:

com.nexustrade.api.NexusTradeApi

Available events include:

NexusTradeOpenEvent
NexusTradeCompleteEvent
NexusTradeCancelEvent
NexusTradeClaimEvent
NexusTradeReviewEvent

⚙️ Configuration

NexusTrade is designed to be easy to customize while still supporting advanced setups.

Main files:

config.yml
messages.yml
menus.yml

You can configure:

Storage mode
Redis sync
Currencies
Sounds
Restrictions
Trade distance
Receipt behavior
Review flow
Menu layouts
Bedrock amount input
Updater behavior

✅ Compatibility

Minecraft 1.21.1 to 26.1+
Paper
Leaf
Folia-supported
Purpur and compatible Paper forks
Spigot is not supported

📦 Installation

Download NexusTrade.jar
Place it in your server plugins folder
Start the server
Edit config.yml, messages.yml, and menus.yml
Use /nexustrade reload for simple changes

If you want a modern trade system with safe item handling, currencies, receipts, reviews, Redis sync, and a real plugin API, NexusTrade is built for that.

Ченджлог

1.0.1Релиз26.1, 26.1.1, 26.1.2 · 11 апреля 2026 г.

NexusTrade 1.0.1

Added

Public API and Bukkit events for external plugin integrations.
Floodgate support for Bedrock players when editing trade amounts.
New optional currency hooks:
- CoinsEngine
- ExcellentEconomy
- RoyaleEconomy
- UltraEconomy
- TokenManager
- RivalHarvesterHoes
Update checker with optional join notification for staff.
New config options for:
- disallowed-gamemodes
- number-formatting
- structured blacklist-items
- trade.cancel-on-close-while-ready
- collection overflow behavior
- menu and ready click cooldowns

Improved

Reworked the trade inventory into a safer virtual trade system.
Improved review, receipt, and history flow.
Better receipt item display and hover information.
History menu is now much lighter and avoids sending heavy written books every page refresh.
Cleaner startup output and improved plugin banner.

Fixed

Fixed the shared x action slot so it no longer disappears or renders incorrectly.
Fixed amount editing for money and experience not applying correctly.
Fixed anvil editor items leaking into the player inventory.
Fixed review button issues and archived trade loading.
Fixed review submission so each side can only rate once.
Fixed restriction handling so movement, damage, combat, and similar triggers correctly break ready/countdown state.
Fixed a bug where cancelling a trade could still let the other side continue editing.
Fixed spectator/third-party interaction risks on active trades.
Fixed history browsing and empty-history feedback.
Fixed broken ${version} showing in startup output.

Existing config.yml, menus.yml, and messages.yml files are not overwritten automatically, so new options may need to be merged manually.

1.0.0Релиз1.21.10, 1.21.11, 26.1 · 30 марта 2026 г.

NexusTrade is a trade plugin for Paper servers focused on secure item and currency trading between players.