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).