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. |
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_13_cc3f87cc.png" alt="Player Heads" width="700" />
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_14_0291358f.png" alt="Player Heads" width="700" />
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_15_b5eab2a1.png" alt="Player Heads" width="700" />
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_16_c95233f1.png" alt="Player Heads" width="700" />
🧭 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
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_18_af66919c.png" width="700" />
🎨 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
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_20_b99de0d4.png" alt="Team Borders" width="700" />
🎯 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
<img src="https://goldmedia.top/uploads/gallery/locator-heads_desc_21_444b5707.png" alt="Filter" width="700" />
🔗 Dependencies
Required
Optional (Recommended)
Compatibility
| Mod | Compatibility |
|---|---|
| Flashback | Automatically hides the locator bar and compass while viewing replays. |
| Gnetum | Integrates with Gnetum's Info Bar to prevent HUD overlap. |
👥 Credits
- Original Head Rendering Concept & Code — MCRcortex

🔧 Update Help
💡 Feature Requests
- Always show XP bar — TechPro424

- Static border — Starrider37

- Compass — xisumavoid
and Zedaph 
All Versions
+ Add Version### Changed
- Updated to 26.3
- Replaced Hud mixin with
HudElementRegistryfor compass rendering, improving compatibility with Gnetum ([#21](https://github.com/Haage001/locator-heads/issues/21)). Thanks to [decce6](https://github.com/decce6) (Gnetum dev) for the fix.
- Fixed singleplayer world creation getting stuck on the loading screen ([#27](https://github.com/Haage001/locator-heads/issues/27)).
- Updated to Minecraft 26.2
### Added
- Added "Only Show Nearby Player Heads" toggle under General ([#24](https://github.com/Haage001/locator-heads/issues/24)).
### Changed
- Removed custom player marker distance ([#24](https://github.com/Haage001/locator-heads/issues/24)).
### Fixed
- Fixed player heads not showing while riding a horse when "Always Show XP Bar" is enabled ([#15](https://github.com/Haage001/locator-heads/issues/15)).
### Added
- Added "Player marker distence" option under General (empty = infinite distance).
### Fixed
- Compass cardinal markers now use the same visibility window behavior as heads.
### Added
- Re-Added Cloth Config powered settings screen.
- Re-Added Mod Menu integration to open config in-game.
### Changed
- Reimplemented head size scaling.
### Changed
- Updated to Minecraft 26.1
### NOTE
- Modmenu and cloth config is not tested in this beta build!**
- Added "Switch Cardinal to Coordinates" option to compass settings that swaps N/S/W/E to +Z/-Z/+X/-X
- Compass now automatically hides when viewing Flashback replays
### Changed
- Compass now stays visible when chat is open
- Compass now stays visible when inventory is open
- Fixed compass rendering multiple times per frame causing visual artifacts
- Fixed compass shadow rendering to use proper outline instead of built-in drop shadow
example of issue: <br>
<img width="300" height="55" alt="image" src="https://github.com/user-attachments/assets/a1a63825-a29d-4b4a-8c41-02a6cf768faa" />
<img width="300" height="55" alt="image" src="https://github.com/user-attachments/assets/912b01c5-b8c1-499a-b323-f6d4f72c7413" />
- Fixed crash when Cloth Config is not installed
Bug fixes:
- Cloth config is not optional as intended.
### Fixed
- Compass now hides with the rest of the UI when F1 is pressed
### Added
- Added new settings tab "Compass"
- Compass overlay showing cardinal directions (N, E, S, W)
- Feature requested by [xisumavoid](https://youtube.com/@xisumavoid) and [Zedaph](https://www.youtube.com/channel/UCPK5G4jeoVEbUp5crKJl6CQ)
- Hex color picker for compass color
- Toggle for compass shadow/outline
### Changed
- Static border color now uses hex colors (replaces preset colors)
- Added "Always Show XP Bar" option in General Settings. <br>
credit to [Lemonszz](https://github.com/Lemonszz) for most of the work to this update,
added the ability to render only names by turning off head rendering.
added static border colours to only one colour.
>Made the include/exclude option also remove the vanilla-coloured dot.
> Added option to show names when the player list is shown.
> Added an animation for toggling name display.
> Added showed names in colour when team colouring is enabled.
> Team colouring is now off by default.


