Locator bar extended

🧭 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)