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
- Put SimpleDeathFinder-<version>.jar into plugins/.
- Start server (creates plugins/SimpleDeathFinder/config.yml).
- Adjust config if needed and /sdf reload.
⌨️ Commands
Code (Text):
/sdf [reload|give <player>]
# /sdf reload -> reload configuration
# /sdf give <p> -> give a tagged recovery compass manually
Permissions
simpledeathfinder.use |
Reserved for future features |
true |
simpledeathfinder.reload |
Use /sdf reload |
op |
simpledeathfinder.give |
Use /sdf give |
op |
⚙️ Configuration (config.yml)
Code (Text):
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!