Compass Locator 3.5.1

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)

Compass Locator 3.5.0

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

Compass Locator 3.4.1 Forge

v3.4.1

◆ Added

• ➕ Added a configurable separator — the compass.separator symbol and colors.separator color are now read from the language file, so the {sep} divider can be restyled everywhere at once instead of being hard-coded
• ➕ Added an auto value for the language option — resolveLanguage(...) now follows the JVM/system language (Locale.getDefault().getLanguage()) and falls back to whichever bundled file actually exists
• ➕ Added death-point persistence — recorded death markers are now written to death-markers.txt and reloaded on startup, so the recovery compass survives a server restart

◆ Changed

• 🔧 Bumped the mod and all bundled configs to 3.4.1
• 🔧 Reworked the waypoint-range attributes — WAYPOINT_RECEIVE_RANGE / WAYPOINT_TRANSMIT_RANGE are now driven by a transient AttributeModifier (added/removed by id) instead of overwriting the base value, so the mod no longer clobbers other mods' modifiers or leaves a stale range after the compass is unequipped
• 🔧 Reworked separator rendering — the filled format is normalized and split on the {sep} token (legacy <sep-color><symbol> is normalized to {sep} first) and re-joined with the configured separator; {time} and {world} are appended as their own {sep}-joined segments
• 🔧 Config reload from the in-game settings screen is now marshalled back onto the server thread via server.execute(...), so reloadAndRefresh() runs thread-safely

◆ Fixed

• 🐛 Fixed unreliable death capture — death points are now recorded through LivingDeathEvent → onPlayerDeath(...) (and immediately saved), instead of being missed when the player respawned
• 🐛 Fixed coordinate rounding — with coordinate-decimals: 0, formatCoordinate(...) now uses Math.floor(...) so negative coordinates round down correctly instead of truncating toward zero
• 🐛 Fixed the "dead" recovery option not getting a divider — it now appends the {sep} segment like the other fields
• 🐛 Fixed a cross-thread crash when reloading the config from the client screen — the refresh no longer touches server state off-thread

Compass Locator 3.4.0 Forge

Port of the CompassLocator plugin for Minecraft 1.21.6+ Forge

Compass Locator 3.4.0 Fabric

Port of the CompassLocator plugin for Minecraft 1.21.6+ Fabric.

Compass Locator 3.4.0

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-действиях, выбрасывании предмета, смерти, респавне, смене мира, входе и выходе игрока
• 🐛 Исправлена читаемость и понятность конфига

Compass Locator 3.3.0

v3.3.0

◆ Удалено

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

◆ Добавлено

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

◆ Изменено

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

◆ Исправлено

• 🐛 Исправлены предупреждения при загрузке о существующих языковых файлов
• 🐛 Сокращен код

Compass Locator 3.2.1

v3.2.1

◆ Добавлено

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

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

Compass Locator 3.2.0

v3.2.0

◆ Добавлено

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

◆ Изменено

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