# WanderingTraderAlert<\/p>\n
A lightweight Paper plugin that broadcasts **Wandering Trader** spawns, shows **live coordinates**, adds a **direct Teleport button**, includes a configurable **despawn ETA**, and rates each trader’s offers with a **custom star rating**.<\/p>\n
—<\/p>\n
## Features
\n– **Global spawn broadcast** when a Wandering Trader appears.
\n– **Despawn message as broadcast**
\n– **Nearest player** info (with distance in blocks).
\n– **[Show Coordinates]** \u2192 prints *current* position (auto-updates while the trader moves).
\n– **[Teleport]** button (runs immediately if you have permission).
\n– **Despawn ETA**: shows `(~MM:SS left)` based on loaded time (configurable).
\n– **Custom rating (\u2605)** of offers via configurable item weights.
\n– **Config file** (`config.yml`) for messages, timing, rating weights, etc.
\n– **Reload command**: `\/traderalert reload`<\/p>\n
—<\/p>\n
## Commands ### Permissions —<\/p>\n ## Configuration (`config.yml`) rating: messages: —<\/p>\n ## Installation —<\/p>\n ## FAQ **Q:** What if a trader unloads? **Q:** Can I change messages\/timings? —<\/p>\n ## Compatibility —<\/p>\n ## Changelog This plugin send a message to the chat when a trader spawns<\/p>\n","protected":false},"featured_media":168444,"template":"","meta":{"_minecraft_slug":"wanderingtraderalert","_minecraft_project_id":"nqYmyn05","_minecraft_author":"BrnSvr","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":58,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wanderingtraderalert.zip","_minecraft_size_bytes":14032,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:50:57.442665Z","_minecraft_date_created":"2025-10-23T07:00:39.291433Z","_minecraft_date_modified":"2025-10-18T19:19:56.444992Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wanderingtraderalert","_minecraft_icon_attachment_id":168444,"_minecraft_imported_at":"2026-06-09T19:39:41+00:00","_minecraft_import_hash":"cae60e038a1a6731398f80a113d9e960","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[137,127,867,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-168443","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-mobs","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","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
\n– `\/tradercoords
\n– `\/traderteleport
\n– `\/traderalert reload` \u2014 reload the config.<\/p>\n
\n– `traderalert.use` \u2014 use Show Coordinates *(default: true)*
\n– `traderalert.teleport` \u2014 use Teleport button \/ command *(default: op)*
\n– `traderalert.admin` \u2014 `\/traderalert reload` *(default: op)*<\/p>\n
\n“`yaml
\ndespawn_millis: 2400000 # 40 minutes loaded time
\nupdate_period_ticks: 40 # update every ~2s<\/p>\n
\n enabled: true
\n weights:
\n NAUTILUS_SHELL: 5
\n CORAL_BLOCK: 4
\n MOSS_BLOCK: 3
\n DRIPSTONE_BLOCK: 3
\n PACKED_ICE: 2
\n PODZOL: 2
\n GLOW_BERRIES: 1
\n SAND: 1
\n DYE: 1<\/p>\n
\n spawn_title: “A Wandering Trader spawned!”
\n closest_fmt: “The Wandering Trader is closest to {player} ({blocks} blocks)”
\n no_players: “No players in the same world.”
\n click_show: “[Show Coordinates]”
\n coords_fmt: “Wandering Trader @ {world}: x={x}, y={y}, z={z}”
\n remaining_fmt: ” (~{mm}:{ss} left)”
\n rating_fmt: ” [Rating: {stars}]”
\n teleport_btn: “[Teleport]”
\n no_perm_tp: “[Teleport]”
\n no_perm_hover: “No permission. Ask an admin.”
\n teleport_hover: “Click to teleport”
\n despawned: “A Wandering Trader despawned.”
\n reloaded: “WanderingTraderAlert config reloaded.”
\n“`<\/p>\n
\n1. Download the latest JAR.
\n2. Drop it into your server’s `plugins\/` folder.
\n3. Start the server (first run will generate `config.yml`).<\/p>\n
\n**Q:** Does the Wandering Trader have levels?
\n**A:** No \u2014 unlike villagers, Wandering Traders don’t level up. The plugin provides a *custom* star rating based on the trades it spawns with.<\/p>\n
\n**A:** Despawn ETA counts *loaded* time only. When the entity unloads, the timer pauses.<\/p>\n
\n**A:** Yes, everything lives in `config.yml`. Use `\/traderalert reload` to apply changes.<\/p>\n
\n– Paper 1.21.x. Other forks may work but aren’t officially supported.<\/p>\n
\n– **1.1.0** \u2014 Config, reload, tab-completion, ETA & rating, instant TP button.
\n– **1.0.1** \u2014 Live updates, despawn broadcast, teleport command.
\n– **1.0.0** \u2014 Initial release (spawn broadcast, clickable coords, nearest player).<\/p>\n","protected":false},"excerpt":{"rendered":"