ENGLISH
CompassLocator is a lightweight and highly configurable plugin for Minecraft servers that enhances both the normal compass and the recovery compass.

It adds a clean and useful action bar while keeping the vanilla feel of the game — and in Minecraft 1.21.6+, it can also enable the Locator Bar when holding a normal compass.

✨ Features

• Normal Compass
  • Shows coordinates
  • Shows biome
  • Shows facing direction
  • Can show world and time of day
  • Supports the Locator Bar in 1.21.6+
• Recovery Compass
  • Shows your last death location
  • Can show world, time since death, and distance
  • Useful even if the player does not want to open F3

• ⚔️ Combined Mode
  • Hold a normal compass in one hand and a recovery compass in the other
  • Display both types of information at the same time
• Highly Customizable
  • Flexible config.yml
  • Adjustable colors, icons, formats, separators, and display options
  • Toggle individual elements on or off

• Localization
  • Language files
  • Translated biome, world, and direction names
  • Easy to edit and extend
• Advanced Debug Tools
  • Debug mode
  • Viewer/target state logging
  • Attribute write logging
  • Action bar debug output
  • Extra diagnostic commands

⚡ New in 3.4.0

• Added Locator Bar support for the normal compass
• The normal compass can now show both:
  • the action bar
  • the Locator Bar
• Reworked and expanded configuration
• Added target rules for Locator Bar visibility
• Improved debugging and diagnostic commands
• Improved localization and config readability

Configuration
The plugin includes a detailed and user-friendly configuration system. You can:

• enable or disable individual features
• customize action bar formats
• configure colors and icons
• change translated names of biomes, worlds, and directions
• control Locator Bar behavior
• configure who should appear in the Locator Bar
• use advanced debug settings when needed

Requirements

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

Note: the Locator Bar feature requires Minecraft 1.21.6+.

Installation

1. Download the plugin .jar
2. Put it into your plugins folder
3. Restart the server
4. Edit config.yml and language files if needed

Support
If you have questions, suggestions, or found a bug, feel free to leave a comment or send a private message in Telegram.

Copyright (c) 2026 kasperoid All rights reserved.

РУССКИЙ

CompassLocator — это лёгкий и гибко настраиваемый плагин для Minecraft-серверов, который улучшает обычный компас и возвратный компас.

Плагин добавляет удобный и информативный action bar, сохраняя ванильный стиль игры. А в Minecraft 1.21.6+ он также поддерживает Locator Bar при удержании обычного компаса.

✨ Возможности

• Обычный компас
  • показывает координаты
  • показывает биом
  • показывает направление взгляда
  • может показывать мир и время суток
  • поддерживает Locator Bar в 1.21.6+
• Возвратный компас
  • показывает место последней смерти
  • может показывать мир, время после смерти и расстояние
  • удобно для игроков, которые не хотят использовать F3

• ⚔️ Совмещённый режим
  • можно держать обычный компас в одной руке, а возвратный — в другой
  • информация от обоих компасов будет отображаться одновременно
• Гибкая настройка
  • удобный config.yml
  • настройка цветов, иконок, форматов, разделителей и поведения
  • возможность включать и отключать отдельные элементы

• Локализация
  • языковые файлы
  • переведённые названия биомов, миров и направлений
  • легко редактируется и расширяется
• Расширенный debug
  • debug-режим
  • логи состояний viewer/target
  • логи записи атрибутов
  • отладка action bar
  • дополнительные диагностические команды

⚡ Что нового в 3.4.0

• Добавлена поддержка vanilla Locator Bar для обычного компаса
• Обычный компас теперь может одновременно показывать:
  • Action Bar
  • Locator Bar
• Переработан и расширен конфиг
• Добавлены правила отображения игроков в Locator Bar
• Улучшены debug и диагностические команды
• Улучшена локализация и читаемость конфига

Настройка
Плагин имеет подробный и понятный конфиг. Вы можете:

• включать и отключать отдельные функции
• настраивать форматы action bar
• менять цвета и иконки
• редактировать названия биомов, миров и направлений
• настраивать поведение Locator Bar
• управлять тем, кто будет отображаться в Locator Bar
• использовать расширенные debug-настройки при необходимости

Требования

• Spigot / Paper / Purpur / совместимые ядра
• Minecraft 1.21+
• Java 21

Важно: функция Locator Bar требует Minecraft 1.21.6+.

Установка

1. Скачайте .jar плагина
2. Поместите его в папку plugins
3. Перезапустите сервер
4. При необходимости настройте config.yml и языковые файлы

Поддержка
Если у вас есть вопросы, предложения или вы нашли баг — оставьте комментарий или напишите в личные сообщения в Telegram.

Copyright (c) 2026 kasperoid Все права защищены.