🧭 LocatorBarExtended

LocatorBarExtended is a lightweight, client-side Fabric mod for Minecraft 1.21.11 that transforms the vanilla Locator Bar into a feature-rich, customizable navigation hub.

Instead of trying to remember who is assigned to which colored diamond, see actual player skin heads and clean nicknames directly on your compass bar!

---

🌟 Key Features

• 👤 Player Skin Avatars: Renders player heads directly on the bar with full support for 3D second layers (hats, crowns, glasses).
• 💬 Enhanced Bubble Badges: Nicknames float above icons in clean, stylish badges featuring a pointer arrow directed down to the player's head.
• 🧹 Clean Nicknames Mode: Tired of server prefixes and rank icons cluttering your screen (like 🐉 or [VIP])? Toggle Clean Nicknames to display pure, raw Minecraft usernames.
• ⭕ Pixel-Cut Rounding: Smooth out avatar corners to match your style — from 0% (sharp square) to 50% (pixel-cut bevel) and 100% (circular avatar).
• 🎨 Per-Player Customization:
  • Customize individual highlight frame colors.
  • Revert specific players to vanilla diamond icons with custom tint colors.
  • Adjust custom nickname colors and scale per player.
• 🌐 Cascading Scopes (Global & Server): Settings are intelligently inherited. Change a nickname color on a specific server without losing your global player profiles!
• 🤖 Auto-Discovery: Encountered players are automatically recorded in the config, ready for quick tweaking in the GUI.
• ⚙️ In-Game GUI: Fully integrated with YetAnotherConfigLib (YACL v3) and Mod Menu — open anytime via /ble gui or Mod Menu.
• 🌍 Bilingual Support: Complete out-of-the-box localization for English and Russian (en_us, ru_ru).

---

⌨️ Client Commands (/ble)

You can tweak every setting on the fly using the client command /ble (or /locatorbarextended):

Command	Description
/ble gui	Open the in-game configuration screen
/ble reload	Reload configuration from disk
/ble global clean_nicknames <true|false>	Toggle clean usernames (strip server rank emojis)
/ble global mode <head|icon>	Set global display mode
/ble global head_size <4-24>	Adjust base head size on the bar
/ble global rounding <0-100>	Adjust pixel-cut corner rounding percentage
/ble global highlight <true|false> [color]	Toggle global colored outline
/ble global enhanced <true|false>	Toggle bubble badges vs classic text
/ble player <name> mode <head|icon> [scope]	Override mode for a specific player
/ble player <name> icon_color <color> [scope]	Set custom diamond icon color for a player
/ble player <name> highlight <true|false> [color] [scope]	Set custom highlight for a player
/ble player <name> nickname_color <color> [scope]	Set custom nickname text color
/ble player <name> reset [server|global]	Reset player overrides to inherit from Global

Color formats supported: Hex (#FF0000, 0x00FFCC) and common color names (red, green, blue, gold, yellow, purple, white).

---

🛡️ Anti-Cheat & Fair Play

[!NOTE]
100% Client-Side & Fair-Play Safe!
LocatorBarExtended does NOT grant wallhack or radar cheats. It only repaints the data already sent by vanilla Minecraft:

• If the server disabled the locator bar (/gamerule locator_bar false), the mod displays nothing.
• Players hidden by vanilla mechanics (sneaking/crouching, invisibility effect, mob heads/carved pumpkins, spectator mode) will NOT appear on the bar.

---

📦 Requirements & Installation

1. Install Fabric Loader (version 0.16.0+ for Minecraft 1.21.11).
2. Drop the following mods into your .minecraft/mods directory:
   • LocatorBarExtended
   • Fabric API (Required)
   • YetAnotherConfigLib (YACL) (Required for configuration screen)
   • Mod Menu (Optional, for settings access via Mods list)

---

🇷🇺 Нажмите сюда для описания на русском языке

О моде

LocatorBarExtended — клиентский мод для Minecraft 1.21.11, преображающий ванильную полосу локатора (Locator Bar).

Вместо безликих цветных ромбиков мод отображает на панели лица игроков со скином и никнеймы в стильных плашках со стрелочкой.

Ключевые фичи:

• Головы скинов: Рендер лиц игроков со вторым слоем (шляпы, очки).
• Режим «Чистые ники»: Автоматически вырезает серверные префиксы, эмодзи и ранги (вроде значков драконов 🐉), оставляя чистый ник игрока.
• Плашки Bubble: Стильный полупрозрачный бейдж со стрелочкой к голове.
• Пиксельное закругление: Срез углов аватара от 0% (квадрат) до 100% (круг).
• Хайлайт и цвета: Возможность индивидуально обвести игрока цветной рамкой или покрасить его ванильную иконку.
• Каскадные скоупы: Настройки для конкретного сервера не сбивают глобальные параметры.
• Полная локализация: Меню и команды полностью переведены на русский язык.
• Честная игра: Мод не отображает игроков в приседе, под невидимостью или в тыквах.