NexusTrade

---

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:

```java com.nexustrade.api.NexusTradeProvider ```

Main API interface:

```java 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 NexusTrade, NexusTrade, NexusTrade, NexusTrade, NexusTrade, and a real NexusTrade, NexusTrade is built for that.