🧭 KPlayerFinder

Lightweight Minecraft plugin (Spigot/Paper 1.16+) that reveals a player's direction and approximate distance.

Features

• Arrow direction (↑ ↗ → ↘ ↓ ↙ ← ↖) and distance in blocks, shown in chat and as a subtitle
• Permission-based profiles with individual cooldown, delay, subtitle duration and error margin
• Configurable location fuzzing — exact coordinates are never exposed
• Protection permission to opt out of being found
• Cross-world handling with optional world name
• Full HEX (&#FFFFFF) and legacy (&a) color support in messages

Commands

Command	Description
/kpf find <player>	Locate a player
/kpf reload	Reload the config

Aliases: /kplayerfinder, /finder, /playerfinder, /fd

Permissions

Permission	Default	Description
kplayerfinder.admin	op	Reload and cooldown bypass
kplayerfinder.profile.default	everyone	Base finder profile
kplayerfinder.protected	nobody	Cannot be found

Profiles are matched top to bottom — the first one the player has wins. Permission names are configurable.

Installation

1. Drop KPlayerFinder-<version>.jar into plugins/.
2. Restart the server.
3. Tune plugins/KPlayerFinder/config.yml.

Building

Requires JDK 8+.

gradle build

Output: build/libs/KPlayerFinder-<version>.jar

License

Released under the MIT License. Redistribution and derivative works must keep the original copyright notice.

---

Need Minecraft plugins or server setup? Telegram: @core2k21