# 🧭 RadarX **RadarX** is a lightweight, highly-optimized Minecraft plugin for Spigot and Paper servers. It provides custom **[PlaceholderAPI](https://modrinth.com/plugin/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___%` | Arrow pointing toward specific X, Y, Z coordinates | | `%radarx_arrow_xz__%` | Arrow pointing toward specific X, Z coordinates | | `%radarx_arrow_player_%` | Arrow pointing toward another online player | ### 📏 Distance Tracking | Placeholder | Description | |---|---| | `%radarx_distance_xyz___%` | 3D distance (meters/blocks) to X, Y, Z | | `%radarx_distance_xz__%` | 2D distance (meters/blocks) to X, Z | | `%radarx_distance_player_%` | 3D distance to another online player | --- ## ⚙️ Configuration (`config.yml`) ```yaml 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 | Command | Description | Permission | |---|---|---| | `/radarx reload` | Reloads configuration | `radarx.admin`

RadarX

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details