Wandering Trader Folia

WanderingTrader

Fully customize Wandering Trader trades — with native Folia support.

A simple, lightweight plugin that lets you define exactly what the Wandering Trader sells. Perfect for custom SMP servers, skyblock, or any server where you want control over trader inventory.

✨ Features

⚙️ Hot Reload — Define any item, any price, any amount 🎲 Hot Reload — Control how often each trade appears 🚀 Hot Reload — Built for multithreaded servers from day one 📦 Hot Reload — Just drop in and configure 🔄 Hot Reload — Change trades without restarting

---

📥 Installation

1. Download the JAR file 2. Place it in your `plugins` folder 3. Restart your server 4. Edit `plugins/WanderingTrader/config.yml`

---

🛠️ Commands

| Command | Description | |---------|-------------| | `/wt reload` | Reload the configuration | | `/wt list` | View all configured trades | | `/wt info` | Show plugin settings |

Permission: `wanderingtrader.admin` (default: OP)

---

⚙️ Configuration

Basic Settings

```yaml settings: min-trades: 5 # Minimum trades per trader max-trades: 8 # Maximum trades per trader replace-all-trades: true # true = custom only, false = add to vanilla ```

Creating Trades

```yaml trades: elytra_trade: enabled: true result: material: ELYTRA amount: 1 cost: material: DIAMOND_BLOCK amount: 16 max-uses: 1 weight: 2 # Lower weight = rarer ```

Enchanted Books

```yaml trades: mending: enabled: true result: material: ENCHANTED_BOOK amount: 1 cost: material: EMERALD amount: 24 enchantments: MENDING: 1 max-uses: 1 weight: 5 ```

---

🎲 How Weights Work

Each trade has a `weight` value. When a Wandering Trader spawns, trades are randomly selected based on their weights: - Higher weight = more likely to appear - Weight of 10 is twice as likely as weight of 5 - Set `enabled: false` to disable a trade entirely

---

💡 Example Use Cases

- RPG Servers — Sell rare items for specific currencies - RPG Servers — Provide unobtainable resources - RPG Servers — Balanced alternative progression - RPG Servers — Quest items and special gear

---

📋 Requirements

- Java: Paper 1.21.4+ or Folia 1.21.4+ - Java: 21+

---

❓ FAQ

Q: Do existing traders get new trades? A: No, only newly spawned traders use custom trades.

Q: Does this work on Paper? A: Yes! Works on both Paper and Folia.

Q: Can I add to vanilla trades instead of replacing? A: Yes, set `replace-all-trades: false` in config.

---

🐛 Issues & Suggestions

Found a bug or have an idea? Open an issue on GitHub!