# Locator Heads is a client-side Minecraft mod that displays nearby players as heads on your XP bar, making it easy to track their location and direction at a glance. Customize colors, borders, filtering options, and add a compass overlay to enhance your multiplayer experience.

---

⚙️ General Settings

- Enable/Disable Mod Chose weather or not mod is on or off. - Render Heads Choose if you want heads to be rendered (can be used to only show names) - Always show XP bar - Head Size Change the size of the heads - Show Player Names

| Player Name Option | Description | | -------------- | ---------------------------------------------------------------- | | **Never** | No names on the locator bar. _(default)_ | | **Always** | Names permanently visible above all player heads. | | **Looking At** | Names appear only when you look within a 30° | | **Player List**| Names show when the in-game player list is open. |

🧭 Compass

- Show Compass Toggle the compass overlay on or off - Compass Colour Customize the color of the compass direction letters using hex color picker - Compass Shadow Toggle black outline around compass letters for better visibility

🎨 Borders

- Enable Border If enabled the border is on - Border Thickness How many pixels thick the border should be - Border Style Can be eithere "TEAM_COLOUR" or "STATIC_COLOUR" - Static Border Colour Choose what colour the static border will have

🎯 Advanced Player Filtering

choose who appear on your locator bar: - **All Players** _(default)_ Shows everyone. - **Include Only** Display only the players listed in your filter. - **Exclude Only** Hide only the players listed, showing all others. **Filter Syntax** - Separate names by commas (`,`), semicolons (`;`), colons (`:`), or periods (`.`). > **Example:** > ``Jeb_, Dinnerbone; LadyAgnes``

--- ## 🔗 Dependencies ### Required

### Optional (Recommended)

### Compatibility | Mod | Compatibility | |------|---------------| | **[Flashback](https://modrinth.com/mod/flashback)** | Automatically hides the locator bar and compass while viewing replays. | | **[Gnetum](https://modrinth.com/mod/gnetum)** | Integrates with Gnetum's Info Bar to prevent HUD overlap. | --- ## 👥 Credits - **Original Head Rendering Concept & Code** — [MCRcortex](https://github.com/MCRcortex) ![MCRcortex](https://minotar.net/avatar/MCRcortex/24) --- ### 🔧 Update Help - **1.21.9** — [Lemonszz](https://github.com/Lemonszz) ![Lemonszz](https://minotar.net/avatar/Lemonszz/24) - **1.21.10** — [aport73](https://github.com/aport73) ![aport73](https://minotar.net/avatar/aport73/24) --- ### 💡 Feature Requests - **Always show XP bar** — [TechPro424](https://github.com/TechPro424) ![TechPro424](https://minotar.net/avatar/TechPro424/24) - **Static border** — [Starrider37](https://github.com/Starrider37) ![Starrider37](https://minotar.net/avatar/Starrider37/24) - **Compass** — [xisumavoid](https://youtube.com/@xisumavoid) ![xisumavoid](https://minotar.net/avatar/xisuma/24) and [Zedaph](https://www.youtube.com/channel/UCPK5G4jeoVEbUp5crKJl6CQ) ![Zedaph](https://minotar.net/avatar/Zedaph/24)

Haage

Organizations