Skip to content

BetterPlayerLocatorBar is a Minecraft Fabric mod that adds a HUD bar above the experience bar, displaying colored icons representing nearby players. The icons dynamically adjust based on distance, visibility, and height differences while maintaining smooth animations and an improvement over Mojang's existing player indicator system.

License

Notifications You must be signed in to change notification settings

bichal/BetterPlayerLocatorBar

Repository files navigation

Better Player Locator Bar

Version License Modrinth CurseForge Issues Discord

Better Player Locator Bar is a Fabric mod. It shows players in a HUD bar above the XP bar. You can customize icons, borders, fades, and more.

🎯 Features

  • HUD bar with icons representing nearby players and death markers
  • Customizable icon style: default, minimal, mojang, bowtie (shift + click)
  • Icon border styles: rounded or squared
  • Option to show player names and heads
  • Vertical arrows when height difference is significant by player camera or position
  • Distance-based fading (configurable start, end, alpha min/max)
  • Smooth interpolation using easing
  • Asset detection: scans included textures in sprites/hud/
  • Client/server sync via handshake and position payloads; fallback to local mode
  • Config UI (F8 in game or use ModMenu), preview, per-player overrides (color, icon, border...)
  • Death markers persistence and cleanup

📸 Gallery

A preview of how you would see other players with the mod
HUD
A preview of a player on the HUD

OnePlayerBarPreview

A preview of two players on the HUD

TwoPlayerBarPreview

This would be a preview of the settings screen so you can customize it as much as you want

ConfigScreenPreview

Now you can customize your friends icons

PlayerCustomPreview

Dependencies

  • Fabric API
  • ModMenu (recommended but opcional)

Installation

  1. Install Fabric Loader and Fabric API
  2. Place the .jar mod file into your mods/ folder
  3. Run Minecraft

Known Issues & Limitations

  • Only works in Fabric, no Forge/NeoForge/... support (yet? 🥀)
  • It can become inaccurate
  • There may be rendering issues in other parts of the HUD
  • You will most likely encounter problems with the order of the icons and the experience bar
  • It is not possible to change the color of your dot/head (yet...)

License

The contents of this repository and mod, are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. (Canonical URL)

About

BetterPlayerLocatorBar is a Minecraft Fabric mod that adds a HUD bar above the experience bar, displaying colored icons representing nearby players. The icons dynamically adjust based on distance, visibility, and height differences while maintaining smooth animations and an improvement over Mojang's existing player indicator system.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages