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

1. Download NexusTrade.jar
2. Place it in your server plugins folder
3. Start the server
4. Edit config.yml, messages.yml, and menus.yml
5. 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.