HudCompass (Fabric)

A HUD compass overlay that shows waypoints, cardinal directions, and (via the vanilla locator bar) death markers and other tracked waypoints — “see where you go.”

This is an unofficial Fabric port of gigaherz’s HudCompass, originally written for NeoForge. All credit for the original design, art, and waypoint/icon architecture belongs to the original author; this port adapts it to run on the Fabric loader and against MC 26.2’s APIs.

Disclaimer: This is a community port, not the original mod. It is not affiliated with, endorsed by, supported by, or maintained by gigaherz (David Quintana) or the upstream HudCompass project. For the original NeoForge mod, go to gigaherz/HudCompass. Report bugs found in this Fabric port here, not on the upstream repo — they’re two separate, independently-maintained codebases.

Features

• Compass HUD: cardinal directions, waypoint icons/labels, above/below arrows, fade/distance behavior
• Waypoints: add/remove via keybind, full in-game waypoint editor (add/edit/delete, per-world grouped, foldable)
• Multiplayer waypoint sync — server-authoritative, survives relog and a real disconnect/reconnect
• Server-side waypoint sources: bed/respawn-anchor spawn point, vanilla map banner/decoration markers, other-player tracking (team/all/none filtering)
• Vanilla locator bar mirroring, plus suppression of the vanilla locator bar while the compass HUD is visible (configurable)
• JourneyMap integration: mirrors JourneyMap’s own waypoints onto the compass, one-way/read-only (optional — JourneyMap not required)
• In-game config screen via ModMenu + Cloth Config (both optional — config/hudcompass.json can be hand-edited if neither is installed)

Every feature from the original NeoForge mod has been ported and confirmed working in-game.

Known, accepted gaps (carried over unchanged from upstream’s own unfinished state):

• The waypoint editor’s “change symbol” icon-picker button is a disabled placeholder — upstream’s own button is identically inert.
• JourneyMap-mirrored waypoints render as a generic tinted icon, not each waypoint’s real custom texture — upstream never finished this either.

Credits

• gigaherz (David Quintana) — original mod
• Romoslayer — Fabric 26.2 port

License

BSD 3-Clause, unmodified from upstream. Copyright (c) 2020, David Quintana (gigaherz).