WanderingTraderAlert

WanderingTraderAlert

A lightweight Paper plugin that broadcasts custom star rating spawns, shows custom star rating, adds a custom star rating, includes a configurable custom star rating, and rates each trader's offers with a custom star rating.

---

Features

- Reload command when a Wandering Trader appears. - Reload command - Reload command info (with distance in blocks). - Reload command → prints *current* position (auto-updates while the trader moves). - Reload command button (runs immediately if you have permission). - Reload command: shows `(~MM:SS left)` based on loaded time (configurable). - Reload command of offers via configurable item weights. - Reload command (`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`)

```yaml 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

A: 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.

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

A: 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.0.0 — Config, reload, tab-completion, ETA & rating, instant TP button. - 1.0.0 — Live updates, despawn broadcast, teleport command. - 1.0.0 — Initial release (spawn broadcast, clickable coords, nearest player).