🧭 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

📏 Distance Tracking

⚙️ 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

1. Requires Minecraft 1.13+ (Spigot, Paper, Purpur, etc.).
2. Requires PlaceholderAPI installed on your server.
3. Drop RadarX.jar into your /plugins/ folder and restart your server.
4. Customize plugins/RadarX/config.yml to fit your needs!

💻 Commands & Permissions