Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
Platforms
Tags
Creators
Details
Licensed MIT
Published 2 days ago
Updated 2 months ago
🧭 RadarX
RadarX is a lightweight, highly-optimized Minecraft plugin for Spigot and Paper servers. It provides custom PlaceholderAPI placeholders to calculate real-time distances and relative 2D directional radar arrows (↑, ↗, →, ↘, ↓, ↙, ←, ↖) pointing toward players or coordinates relative to where the viewer is looking.
Perfect for minigames, Factions, Survival, and SMP servers to display objectives in scoreboards, action bars, title screens, or holograms!
✨ Features
- 🎯 Relative Directional Arrows: Displays a 2D arrow pointing toward a target player or coordinate relative to the player's current view (yaw).
- 📏 3D & 2D Distance Tracking: Calculate exact 3D distance or horizontal 2D distance (ignoring Y level).
- ⚡ Aggressive In-Memory Caching: Configurable cache time to ensure ZERO TPS impact, even when refreshed 20 times per second in scoreboards.
- 🌌 Cross-Dimensional Support: Custom indicator when the target is in a different dimension (e.g., Nether/End).
- ⚙️ Fully Configurable: Customize all arrow symbols, distance formats, offline messages, and cache durations.
📝 Placeholders
Placeholders can be used anywhere PlaceholderAPI is supported (Scoreboards, ActionBars, Holograms, Tab, Chat, etc.):
🏹 Directional Radar Arrows
| Placeholder | Description |
|---|---|
%radarx_arrow_xyz_<x>_<y>_<z>% |
Arrow pointing toward specific X, Y, Z coordinates |
%radarx_arrow_xz_<x>_<z>% |
Arrow pointing toward specific X, Z coordinates |
%radarx_arrow_player_<name>% |
Arrow pointing toward another online player |
📏 Distance Tracking
| Placeholder | Description |
|---|---|
%radarx_distance_xyz_<x>_<y>_<z>% |
3D distance (meters/blocks) to X, Y, Z |
%radarx_distance_xz_<x>_<z>% |
2D distance (meters/blocks) to X, Z |
%radarx_distance_player_<name>% |
3D distance to another online player |
⚙️ Configuration (config.yml)
format:
different_world: "N/A"
player_offline: "Offline"
distance_text: "%distance%m"
round_distance: true
optimization:
# Cache time in milliseconds (prevents TPS drop on fast scoreboard updates)
cache_time_ms: 500
arrows:
front: "↑"
front_right: "↗"
right: "→"
back_right: "↘"
back: "↓"
back_left: "↙"
left: "←"
front_left: "↖"
📦 Requirements & Installation
- Requires Minecraft 1.13+ (Spigot, Paper, Purpur, etc.).
- Requires PlaceholderAPI installed on your server.
- Drop RadarX.jar into your /plugins/ folder and restart your server.
- Customize plugins/RadarX/config.yml to fit your needs!
💻 Commands & Permissions
| Command | Description | Permission |
|---|---|---|
/radarx reload |
Reloads configuration | radarx.admin |


