# WanderingTrader<\/p>\n
**Fully customize Wandering Trader trades \u2014 with native Folia support.**<\/p>\n
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.<\/p>\n
## \u2728 Features<\/p>\n
\u2699\ufe0f **Complete Customization** \u2014 Define any item, any price, any amount
\n\ud83c\udfb2 **Weighted Trades** \u2014 Control how often each trade appears
\n\ud83d\ude80 **Folia Native** \u2014 Built for multithreaded servers from day one
\n\ud83d\udce6 **Zero Dependencies** \u2014 Just drop in and configure
\n\ud83d\udd04 **Hot Reload** \u2014 Change trades without restarting<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the JAR file
\n2. Place it in your `plugins` folder
\n3. Restart your server
\n4. Edit `plugins\/WanderingTrader\/config.yml`<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Commands<\/p>\n
| Command | Description |
\n|———|————-|
\n| `\/wt reload` | Reload the configuration |
\n| `\/wt list` | View all configured trades |
\n| `\/wt info` | Show plugin settings |<\/p>\n
**Permission:** `wanderingtrader.admin` (default: OP)<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Basic Settings<\/p>\n
“`yaml
\nsettings:
\n min-trades: 5 # Minimum trades per trader
\n max-trades: 8 # Maximum trades per trader
\n replace-all-trades: true # true = custom only, false = add to vanilla
\n“`<\/p>\n
### Creating Trades<\/p>\n
“`yaml
\ntrades:
\n elytra_trade:
\n enabled: true
\n result:
\n material: ELYTRA
\n amount: 1
\n cost:
\n material: DIAMOND_BLOCK
\n amount: 16
\n max-uses: 1
\n weight: 2 # Lower weight = rarer
\n“`<\/p>\n
### Enchanted Books<\/p>\n
“`yaml
\ntrades:
\n mending:
\n enabled: true
\n result:
\n material: ENCHANTED_BOOK
\n amount: 1
\n cost:
\n material: EMERALD
\n amount: 24
\n enchantments:
\n MENDING: 1
\n max-uses: 1
\n weight: 5
\n“`<\/p>\n
—<\/p>\n
## \ud83c\udfb2 How Weights Work<\/p>\n
Each trade has a `weight` value. When a Wandering Trader spawns, trades are randomly selected based on their weights:
\n– Higher weight = more likely to appear
\n– Weight of 10 is twice as likely as weight of 5
\n– Set `enabled: false` to disable a trade entirely<\/p>\n
—<\/p>\n
## \ud83d\udca1 Example Use Cases<\/p>\n
– **Custom Economy** \u2014 Sell rare items for specific currencies
\n– **Skyblock** \u2014 Provide unobtainable resources
\n– **Hardcore SMP** \u2014 Balanced alternative progression
\n– **RPG Servers** \u2014 Quest items and special gear<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Server:** Paper 1.21.4+ or Folia 1.21.4+
\n– **Java:** 21+<\/p>\n
—<\/p>\n
## \u2753 FAQ<\/p>\n
**Q: Do existing traders get new trades?**
\nA: No, only newly spawned traders use custom trades.<\/p>\n
**Q: Does this work on Paper?**
\nA: Yes! Works on both Paper and Folia.<\/p>\n
**Q: Can I add to vanilla trades instead of replacing?**
\nA: Yes, set `replace-all-trades: false` in config.<\/p>\n
—<\/p>\n
## \ud83d\udc1b Issues & Suggestions<\/p>\n
Found a bug or have an idea? Open an issue on GitHub!<\/p>\n","protected":false},"excerpt":{"rendered":"
Adds the ability to change trades of wandering trader. Aimed for folia support. By default is configured for “nether items for diamonds” trades. Support weighted list.<\/p>\n","protected":false},"featured_media":168415,"template":"","meta":{"_minecraft_slug":"wandering-trader-folia","_minecraft_project_id":"gu2WT42F","_minecraft_author":"Whitebrim","_minecraft_license":"MIT","_minecraft_downloads":33,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wandering-trader-folia.zip","_minecraft_size_bytes":16062,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:55:02.343104Z","_minecraft_date_created":"2026-02-02T20:50:41.633386Z","_minecraft_date_modified":"2026-01-29T15:34:05.388877Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wandering-trader-folia","_minecraft_icon_attachment_id":168415,"_minecraft_imported_at":"2026-06-09T19:38:54+00:00","_minecraft_import_hash":"5442e1acabd909fd40a3195b80eb769b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,125,89,137,127,128],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-168414","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n