CompassLocator

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)

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

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

v3.3.0

◆ Удалено

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

◆ Добавлено

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

◆ Изменено

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

◆ Исправлено

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

v3.2.1

◆ Добавлено

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

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

v3.2.0

◆ Добавлено

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

◆ Изменено

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