SimpleDeathFinder [1.20 - 1.21.x]

SimpleDeathFinder
Give players a Recovery Compass on respawn & auto-remove it near the death spot

✨ Features

• Automatic Recovery Compass on respawn (toggle in config).
• Auto-removal when within radius (default 5 blocks) of death location.
• Compasses are safely tagged via PDC – other compasses are untouched.
• Option to remove previously tagged compasses when issuing a new one.
• Helpful messages for cross-dimension cases (vanilla: compass spins).
• Lightweight periodic check (default: every 1s).
• Shows distance in meters to the death point when holding the compass (since v1.1.0).
• Tested on Paper/Spigot 1.20–1.21 (Java 17+).

️ Screenshots

✅ Compatibility

• Server: Paper/Spigot 1.20–1.21 (tested 1.21.4)
• Java: 17+
• Works fine with Geyser/Floodgate (server-side only).

Installation

1. Put SimpleDeathFinder-<version>.jar into plugins/.
2. Start server (creates plugins/SimpleDeathFinder/config.yml).
3. Adjust config if needed and /sdf reload.

⌨️ Commands

/sdf [reload|give <player>]
# /sdf reload    -> reload configuration
# /sdf give <p>  -> give a tagged recovery compass manually

Permissions

⚙️ Configuration (config.yml)

give-on-respawn: true

remove-on-approach:
  enabled: true
  radius: 5.0              # distance in blocks
  check-interval-ticks: 20 # 20 ticks = 1 second

remove-old-compasses: true  # remove previously tagged ones when giving a new one

messages:
  given: "&aYou received a recovery compass. It points to your last death location."
  arrived: "&7You arrived at your death location. The compass crumbles."
  full-inventory: "&eInventory full — the compass was dropped at your feet."
  other-dimension: "&eYour death location is in another dimension — the compass spins."

item:
  name: "&bRecovery Compass"
  lore:
    - "&7Points to your last death location."
    - "&7Where: &f{dim} &7@ &f{x}&7,&f{y}&7,&f{z}"
    - "&7Distance: &f{dist}m"   # new in v1.1.0

sound:
  arrived: "entity.experience_orb.pickup"

Placeholders in item.lore: {dim}, {x}, {y}, {z}, {dist}

Notes

• Uses vanilla RECOVERY_COMPASS tagged via PDC.
• At most one tagged compass is removed per tick per player.
• In another dimension the compass spins (vanilla) — a hint message is sent.
• Distance display is client-side text only; no heavy pathfinding is used.
• No console/log spam; clean enable/reload messages only.

❤️ Like it? A star on GitHub is appreciated!