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

⚙️ Complete Customization — Define any item, any price, any amount
🎲 Weighted Trades — Control how often each trade appears
🚀 Folia Native — Built for multithreaded servers from day one
📦 Zero Dependencies — 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

Permission: wanderingtrader.admin (default: OP)

⚙️ Configuration

Basic Settings

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

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

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

• Custom Economy — Sell rare items for specific currencies
• Skyblock — Provide unobtainable resources
• Hardcore SMP — Balanced alternative progression
• RPG Servers — Quest items and special gear

📋 Requirements

• Server: 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!