Waypoint Compass

Waypoint Compass is a tiny, mixin-free, client-only Fabric mod for players who just want a “drop a pin, find your way back” tool — without installing a whole minimap suite. Press a key, the spot is saved. Walk away, and a slim compass strip at the top of your HUD shows an arrow pointing back and how far you have to go.

Features

• One-key save. Press B anywhere to save your current X, Y, Z as a new waypoint. The mod confirms in the action bar (Waypoint saved: WP 1 (123, 64, -512)).
• HUD compass. A small bar at the top center of your screen shows an arrow, the waypoint name, and the live distance in meters / km. The arrow rotates as you turn, so “↑” always means “the waypoint is straight ahead”.
• Cycle through saved spots. Press N to switch which waypoint the compass is tracking. Great for multi-base setups.
• Delete the current pin. Press K to remove the waypoint you’re tracking. No menu required.
• Toggle the HUD. Press H to hide or re-show the compass without losing your saved points.
• Dimension-aware. Each waypoint remembers the dimension it was saved in. If you’re in the Nether and the waypoint is in the Overworld, the compass shows in Overworld instead of a misleading distance.
• Persistent. Waypoints are stored in config/waypoints.json and survive restarts.
• No mixins. No server install. Pure client mod — works on any server, including vanilla Realms.

Default keys

| Key | Action |
|—–|——–|
| B | Save current position as a new waypoint |
| N | Cycle to next saved waypoint |
| K | Delete the currently tracked waypoint |
| H | Toggle the HUD compass on/off |

Keys are read directly from the OS via GLFW, so they ignore Minecraft’s input routing — but they’re suppressed while a GUI (chat, sign edit, inventory) is open, so they won’t fire mid-type.

Cross-version

Tested on 1.21.8, 1.21.9, 1.21.10, 1.21.11. One JAR, one install.

Notes

• The compass shows horizontal distance (XZ), which is what you actually walk — height differences don’t inflate the number.
• This is intentionally NOT a minimap. There’s no in-world 3D marker; the whole point is “one HUD line, zero clutter.”