Перейти к содержимому
Mineforgian

CompassLocator

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

Загрузки
128
Подписчики
4
Обновлён
20 июня 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 26 марта 2026 г.

Исходный кодСообщить об ошибке
CompassLocator Banner

Version Minecraft Platform Java

Modrinth Side Telegram

📌 What is this?

CompassLocator is a plugin that adds useful compass information directly to the action bar.

No more opening F3. Just hold a compass and see:

  • where you are
  • which direction you're facing
  • what biome you're in
  • where you died last time

✨ What does the compass show?

Normal Compass

  • Coordinates (adjustable precision — integer or decimal)
  • Current biome
  • Cardinal direction (North/South or N/S — as you prefer)
  • Time of day (optional)
  • World name (optional)
  • If the compass is linked to a lodestone — shows lodestone coordinates

Recovery Compass

  • Where you last died (coordinates)
  • Which world
  • Time since death
  • Distance to death location

Combined Mode

  • Hold a normal compass in one hand and a recovery compass in the other
  • The action bar shows information from both at once

📡 Locator Bar (for 1.21.6+)

With a normal compass in hand, you can see other players on the radar (like a minimap). Range is configurable — up to the entire world.

🖼️ Screenshots

Normal Compass Recovery Compass Combined Mode Locator Bar

🎮 For Players

  • Works right out of the box — just hold a compass
  • Information only appears when you're holding a compass
  • No need to download anything on the client (except for Locator Bar — that requires Minecraft 1.21.6+)
  • Recovery compass shows the way to your items after death

🛠 For Server Admins

The plugin is highly configurable via config.yml:

  • Which information is shown (coordinates, biome, direction, world, time)
  • Coordinate precision (integer or decimal)
  • Short or full cardinal directions
  • Action bar update frequency
  • Who is visible in Locator Bar (everyone / only compass holders)
  • Enable/disable any module
  • Language (Russian, English, or auto-detect)
  • And much more

📥 Installation

  1. Download the .jar file
  2. Put it in your plugins/ folder
  3. Restart the server
  4. Done! (Optionally, edit config.yml)

⚙️ Requirements

  • Minecraft 1.21+
  • Paper / Spigot / Purpur (or compatible forks)
  • Java 21

Locator Bar requires Minecraft 1.21.6+ on the client.

🔄 There's also a client mod version!

A separate client-side mod for Fabric and Forge on Minecraft 1.21.6 — 26.1.2.

Functionality will differ from the plugin (client-side capabilities are broader). Details — after release.

👉 CompassLocator — Mod Version

❓ FAQ

Do I need to install anything on the client? No. The plugin runs on the server. For Locator Bar, you need Minecraft 1.21.6+ on the client.
Does the compass work in both hands? Yes, you can hold it in either hand. Both are checked.
What if the compass is linked to a lodestone? The plugin will show lodestone coordinates after your own coordinates. If the lodestone is broken, you can configure it to show the last known coordinates.
Does the recovery compass drop on death? Configurable. If you enable the option, the compass stays in your inventory even on death (when keepInventory is disabled).
What's the difference between the mod and the plugin? The plugin is for the server, the mod is for the client. Functionality is similar but the mod has access to more client-side features.

🔗 Links

Modrinth Telegram

© 2026 kasperoid — All Rights Reserved

Ченджлог

3.5.1Релиз26.1.1, 26.1.2, 26.2 · 20 июня 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)
3.5.0Релиз26.1.1, 26.1.2, 26.2 · 9 июня 2026 г.

v3.5.0

◆ Added

  • ➕ Added lodestone support for the normal compass — shows the bound lodestone's coordinates and the direction to it
  • ➕ Added a separate "Lodestone broken" state with a real block check (lag-free — only in already-loaded chunks)
  • ➕ Added the compass.use-lodestone-target option
  • ➕ Added the compass.show-last-known-lodestone-when-broken option (show the last known coordinates instead of the "broken" label)
  • ➕ Added the compass.format-preset option:
    • classic
    • compact
    • minimal
  • ➕ Added the recovery_compass.format-preset option:
    • classic
    • compact
    • minimal
  • ➕ Added the recovery_compass.keep-after-death option — the recovery compass is no longer dropped on death
  • ➕ Added the messages.lodestone-broken string to the language files (ru / en)
  • ➕ Added translatable distance units:
    • messages.meters
    • messages.kilometers
    • messages.unknown
  • ➕ Added auto-update for config.yml — new keys are appended while existing settings are preserved
  • ➕ Added auto-update for the language files lang/ru.yml and lang/en.yml

◆ Changed

  • 🔧 Bumped the plugin version and all configs to 3.5.0
  • 🔧 config-version is now automatically synced with the plugin version on startup
  • 🔧 Extended the normal compass logic with lodestone handling without losing the old behavior (coordinates, biome, direction, time, world)
  • 🔧 The recovery compass and dual-mode now respect the format presets
  • 🔧 The recovery compass distance now uses translatable units (m / km)

◆ Fixed

  • 🐛 Fixed: after a plugin update the old config.yml was not topped up with new keys (you had to delete the config manually)
  • 🐛 Fixed: on an old language file the "Lodestone broken" label was shown in English
  • 🐛 Fixed lodestone "broken" detection — Bukkit used to return the stored position even after the block was destroyed, so the "broken" state never triggered
  • 🐛 Fixed leftover English strings by moving distance units (m / km / unknown) into the language files
3.4.0Релиз26.1, 26.1.1, 26.1.2 · 25 мая 2026 г.

v3.4.0

◆ Добавлено

  • ➕ Добавлен vanilla Locator Bar для обычного компаса на Minecraft / Paper 1.21.6+
  • ➕ Обычный COMPASS теперь может одновременно показывать старый actionbar и locator bar
  • ➕ Добавлен отдельный раздел locator-bar в config.yml
  • ➕ Добавлена настройка, кого показывать в locator bar:
    • everyone
    • normal_compass
    • any_compass
  • ➕ Добавлены дополнительные настройки locator bar:
    • force-world-gamerule
    • restore-gamerule-on-disable
    • visible-range
    • hidden-receive-range
    • equip-pulse-delay-ticks
    • unequip-restore-delay-ticks
    • unequip-final-refresh-delay-ticks
  • ➕ Добавлены настройки обновления целей locator bar
  • ➕ Добавлена настройка compass.show-world
  • ➕ Добавлена настройка settings.clear-actionbar-when-no-compass
  • ➕ Добавлена настройка settings.send-death-reminder-on-join
  • ➕ Добавлена настройка settings.update-actionbar-on-move
  • ➕ Добавлена настройка settings.update-period-ticks
  • ➕ Добавлен config-version
  • ➕ Добавлен расширенный debug-раздел в config.yml
  • ➕ Добавлены новые debug-настройки:
    • log-events
    • log-viewer-state-changes
    • log-target-state-changes
    • log-attribute-writes
    • log-actionbar-text
    • log-viewer-refreshes
    • status-targets-limit
  • ➕ Добавлены новые команды:
    • /cl status [player]
    • /cl refresh [player|all]
    • /cl debug <on|off|toggle>
  • ➕ Добавлены новые permission-ноды для status, refresh и debug
  • ➕ Добавлен перевод биома sulfur_caves → Серные пещеры

◆ Изменено

  • 🔧 Полностью переработан config.yml
  • 🔧 Конфиг переведен на русский язык
  • 🔧 В конфиг добавлены подробные комментарии, пояснения и примеры
  • 🔧 Возвращена расширенная шапка конфига в дружелюбном стиле
  • 🔧 Логика locator bar сделана на vanilla waypoint attributes без замены старого actionbar
  • 🔧 Обычный компас теперь не теряет свои прошлые функции при включении locator bar
  • 🔧 Улучшена система reload и обновления состояний игроков
  • 🔧 Улучшена структура языковых файлов
  • 🔧 Улучшена диагностика и вывод отладочной информации
  • 🔧 Улучшено описание и читаемость настроек для обычных пользователей
  • 🔧 Подготовлена более удобная конфигурация для публикации и поддержки

◆ Исправлено

  • 🐛 Исправлена проблема, из-за которой locator bar мог не появляться или работать нестабильно
  • 🐛 Исправлена проблема, из-за которой locator bar мог не исчезать после убирания компаса
  • 🐛 Исправлена логика отображения игроков в locator bar
  • 🐛 Исправлен конфликт между locator bar и старым actionbar обычного компаса
  • 🐛 Исправлено поведение обычного COMPASS, чтобы он снова показывал координаты, биом, направление и другие старые данные
  • 🐛 Исправлены обновления состояния при смене слота, смене руки, кликах в инвентаре, drag-действиях, выбрасывании предмета, смерти, респавне, смене мира, входе и выходе игрока
  • 🐛 Исправлена читаемость и понятность конфига
3.3.0Релиз26.1, 26.1.1, 26.1.2 · 16 мая 2026 г.

v3.3.0

◆ Удалено

  • 🗑️ Удалена неиспользуемая система Waypoint Range
  • 🗑️ Удален обработчик onPlayerRespawn
  • 🗑️ Удален механизм keep-alive
  • 🗑️ Удалена поддержка Folia

◆ Добавлено

  • ➕ Добавлена мультиязычность
  • ➕ Добавлена настройка языка в config.yml
  • ➕ Добавлена настройка количества знаков после запятой в координатах
  • ➕ Настройка debug-mode
  • ➕ Новые иконки

◆ Изменено

  • 🔧 Локализация из config.yml вынесена в отдельные файлы
  • 🔧 Частота обновления с 20 до 10 тиков
  • 🔧 Новая логика обновления
  • 🔧 Настройка цветов перемещена в языковые файлы
  • 🔧 Время суток и другие форматы переведены в языковые файлы

◆ Исправлено

  • 🐛 Исправлены предупреждения при загрузке о существующих языковых файлов
  • 🐛 Сокращен код
3.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 26 марта 2026 г.

v3.2.1

◆ Добавлено

  • ➕ Добавлена совместимость со всеми ядрами: Paper, Purpur, Spigot, Folia

Для Folia рекомендуется использовать версию 3.2.0!

3.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 26 марта 2026 г.

v3.2.0

◆ Добавлено

  • ➕ Добавлена настройка use-short-directions — короткие названия направлений (С, В, Ю, З) вместо полных
  • ➕ Добавлено отображение времени суток (День/Ночь/Утро/Вечер) с настраиваемыми иконками
  • ➕ Добавлен keep-alive механизм обновления action bar (раз в секунду), чтобы он не исчезал

◆ Изменено

  • 🔧 Улучшена производительность — обновление только при изменении данных
  • 🔧 Добавлена поддержка поворота головы для обновления направления

Комментарии

Загружаем…