WanderingTraderAlert

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.

---

Features

• Global spawn broadcast when a Wandering Trader appears.
• Despawn message as broadcast
• Nearest player info (with distance in blocks).
• [Show Coordinates] → prints current position (auto-updates while the trader moves).
• [Teleport] button (runs immediately if you have permission).
• Despawn ETA: shows (~MM:SS left) based on loaded time (configurable).
• Custom rating (★) of offers via configurable item weights.
• Config file (config.yml) for messages, timing, rating weights, etc.
• Reload command: /traderalert reload

---

Commands

• /tradercoords <uuid> — show live coordinates (+ ETA & rating).
• /traderteleport <uuid> — teleport to the trader (instant).
• /traderalert reload — reload the config.

Permissions

• traderalert.use — use Show Coordinates (default: true)
• traderalert.teleport — use Teleport button / command (default: op)
• traderalert.admin — /traderalert reload (default: op)

---

Configuration (config.yml)

despawn_millis: 2400000       # 40 minutes loaded time
update_period_ticks: 40       # update every ~2s

rating:
  enabled: true
  weights:
    NAUTILUS_SHELL: 5
    CORAL_BLOCK: 4
    MOSS_BLOCK: 3
    DRIPSTONE_BLOCK: 3
    PACKED_ICE: 2
    PODZOL: 2
    GLOW_BERRIES: 1
    SAND: 1
    DYE: 1

messages: spawn_title: "A Wandering Trader spawned!" closest_fmt: "The Wandering Trader is closest to {player} ({blocks} blocks)" no_players: "No players in the same world." click_show: "[Show Coordinates]" coords_fmt: "Wandering Trader @ {world}: x={x}, y={y}, z={z}" remaining_fmt: " (~{mm}:{ss} left)" rating_fmt: " [Rating: {stars}]" teleport_btn: "[Teleport]" no_perm_tp: "[Teleport]" no_perm_hover: "No permission. Ask an admin." teleport_hover: "Click to teleport" despawned: "A Wandering Trader despawned." reloaded: "WanderingTraderAlert config reloaded."

---

##  Installation
1. Download the latest JAR.
2. Drop it into your server's `plugins/` folder.
3. Start the server (first run will generate `config.yml`).

---

##  FAQ
**Q:** Does the Wandering Trader have levels?  
**A:** No — unlike villagers, Wandering Traders don't level up. The plugin provides a *custom* star rating based on the trades it spawns with.

**Q:** What if a trader unloads?  
**A:** Despawn ETA counts *loaded* time only. When the entity unloads, the timer pauses.

**Q:** Can I change messages/timings?  
**A:** Yes, everything lives in `config.yml`. Use `/traderalert reload` to apply changes.

---

##  Compatibility
- Paper 1.21.x. Other forks may work but aren't officially supported.

---

##  Changelog
- **1.1.0** — Config, reload, tab-completion, ETA & rating, instant TP button.
- **1.0.1** — Live updates, despawn broadcast, teleport command.
- **1.0.0** — Initial release (spawn broadcast, clickable coords, nearest player).