ВЕРСИИ (7)

### **v3.6.0** ## **◆ Added** - ➕ Added a clock HUD — hold a clock to see the in-game time, the day number, and the weather right in the action bar - ➕ Added death and lodestone markers directly on the locator bar — a colored dot shows where you died (while holding a recovery compass) and where your compass's lodestone is - ➕ Added a height hint to the recovery compass — an up/down arrow and the vertical distance to your death point - ➕ Added a direction arrow to the recovery compass — points toward your death point based on where you're facing - ➕ Added the option to hide low-health players from the locator bar — players at 20% health or below vanish from the bar until they heal - ➕ Added per-world control for the locator bar — you can turn it off completely in specific worlds - ➕ Added the `/cl info` command — shows what the plugin is, who made it, the version, and where to download it ## **◆ Changed** - 🔧 Bumped the plugin version and all configs to 3.6.0 - 🔧 The clock works independently of the compasses — you can hold it alongside a compass or on its own - 🔧 The recovery compass's height hint and direction arrow only kick in when you're in the same world where you died > ℹ️ **Note:** the death/lodestone dots on the locator bar need the **PacketEvents** plugin installed on the server. Without it, everything else still works normally — those two dots just don't show up.

### **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 (раз в секунду), чтобы он не исчезал ### ◆ Изменено - 🔧 Улучшена производительность — обновление только при изменении данных - 🔧 Добавлена поддержка поворота головы для обновления направления