✦ Waypoints

A navigation plugin for Paper 1.21.4 and any versions above that lets players set, track, and follow custom waypoints through a clean inventory GUI without feeling like cheating or being overpowered

Waypoints gives players a physical compass item to open a GUI menu of saved locations. Following a waypoint shows a boss bar with live distance and fires a particle trail every 10 seconds pointing toward the target, so you always know which way to walk without the game playing itself for you.

🧭 Getting Started

Run /waypointwand to receive the Waypoints compass. Right-click it at any time to open the waypoint list. You can also open the list directly with /waypoints.

⚠️ Note: /waypoints is this plugin's command, not Minecraft's built-in /waypoint (no "s"). The vanilla command is unrelated — use this one.

📋 How It Works

Browsing waypoints — The list GUI shows all saved waypoints as clickable items displaying their name, coordinates, and world. If more than 45 waypoints exist, arrow buttons on the bottom bar let you page through them. Waypoints you are currently following are highlighted in green.

Following a waypoint — Clicking a waypoint opens a detail screen where you can toggle follow on or off. Following a waypoint does two things: it adds a boss bar at the top of your screen showing the waypoint's name, exact coordinates, and your live distance in blocks, and every 10 seconds it spawns a line of particles starting just in front of your head and pointing straight toward the target. You can follow as many waypoints simultaneously as you like.

Adding waypoints (OPs only) — Operators see a + Add Waypoint button in the list GUI. Clicking it starts a short chat-driven flow: type the name, type coordinates or here to capture your current position, then pick an icon from the icon selection GUI. The waypoint is saved immediately and persists across restarts.

⚖️ Fair for SMP

Waypoints deliberately avoids teleportation. Getting to a waypoint still requires you to physically travel there, which preserves the economy of distance that makes SMP servers feel meaningful. The particle trail and boss bar are navigation aids, not shortcuts — the same information you could get from writing coordinates on a sign, just more convenient. Players who want to explore freely are not disadvantaged, and no one can skip travel time or bypass terrain that other players had to cross.

📦 Requirements

• Paper 1.21.4 or newer (compatible with 1.21.11)
• Java 21