SimpleDeathFinder [1.20 - 1.21.x] icon

SimpleDeathFinder [1.20 - 1.21.x] -----

A lightweight Paper/Spigot plugin that gives players a Recovery Compass on respawn and removes it on




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
info.png

✅ 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
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!
Resource Information
Author:
----------
Total Downloads: 149
First Release: Aug 15, 2025
Last Update: Aug 20, 2025
Category: ---------------
All-Time Rating:
0 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings