CompassLocator

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

---

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

📥 Установка

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

💬 Поддержка

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

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