Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for kasperoid

Displays coordinates, direction, biome and locator bar while holding a compass. Compass ∙ Death Compass ∙ Locator Bar ∙

Report CompassLocator?

Release
3.5.1

kasperoid released CompassLocator version 3.5.1 on July 18, 2026

v3.5.1

◆ Added

  • ➕ Added support for Minecraft 26.2
  • ➕ Added the recovery_compass.persist-deaths option — death points are saved to deaths.yml and survive a server restart
  • ➕ Added cross-platform keep-after-death — the recovery compass is now kept on death on Spigot too, not only Paper

◆ Changed

  • 🔧 Bumped the plugin version and all configs to 3.5.1
  • 🔧 Migrated the action bar from the deprecated BungeeCord chat API to Adventure (sendActionBar(Component)); legacy § color codes still work
  • 🔧 Plugin version is now read via getPluginMeta().getVersion() with a safe fallback for older cores
  • 🔧 PlayerMoveEvent now refreshes the action bar only on block-coordinate changes instead of every movement (including head rotation) — far fewer packets
  • 🔧 Inventory events (InventoryClickEvent / InventoryDragEvent) now trigger a state recalculation only when a compass is actually involved (hand / slot / cursor), not on every click in any chest
  • 🔧 keep-after-death now uses pure Bukkit API (items removed from drops and restored on respawn) instead of the Paper-only getItemsToKeep()

◆ Fixed

  • 🐛 Fixed an NPE that crashed the recovery compass every tick when the death world was unloaded or deleted — getWorldName(...) is now null-safe and returns "Unknown"
  • 🐛 Fixed a crash on malformed format strings — distance-format / time-formats now run through a guarded safeFormat(...) that warns instead of throwing
  • 🐛 Fixed the locator bar flickering for all players whenever someone equipped/unequipped a compass — ensureWorldLocatorBarEnabled() no longer re-applies setGameRule(LOCATOR_BAR, true) on every refresh (re-setting it broadcast a packet to every client in the world)

Information

Published onJuly 18, 2026
Downloads0

Platforms

Paper Paper (1.21-26.2)