Compass shows coordinates, biome, direction, and more

EN

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

Recovery Compass shows your last death position and related info

⚔️ 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

You can hold both compasses in different hands and use combined mode

🌍 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

The compass displays players in the locator

⚡ 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

Download the plugin .jar
Put it into your plugins folder
Restart the server
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.

RU

Обычный компас показывает координаты, биом, направление и другую полезную информацию

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+.

📥 Установка

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

💬 Поддержка

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