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.

Player Heads

Player Heads

Player Heads

Player Heads

🧭 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

Team Borders

Team Borders

🎯 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

Filter

🔗 Dependencies

Required

Fabric API

Optional (Recommended)

Cloth Config API

👥 Credits

Original Head Rendering Concept & Code — MCRcortex

🔧 Update Help

1.21.9 — Lemonszz
1.21.10 — aport73

💡 Feature Requests

Always show XP bar — TechPro424
Static border — Starrider37
Compass — xisumavoid and Zedaph