All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Better Player Locator Bar
Projects / Mods

Better Player Locator Bar

by Bichal • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

Better Player Locator Bar

Version License Modrinth CurseForge Issues

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)

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21
Fabric
last yr. 1
1.21
Fabric
last yr. 1
1.21
Fabric
last yr. 1
🖼️

No gallery images uploaded.

# Updated to 1.21.2 and 1.21.3!
  • Fixed some render issues and ordering
  • Simplified code syntax
  • Centralized methods
  • Fixed render arrow mode
# Changelog

  • Version: 1.1.0**


## Summary

Version 1.1.0 refactors the rendering architecture, introduces robust asset detection, improves client-server synchronization, adds death markers, enhances configuration capabilities, and fixes multiple bugs. Backwards compatibility with existing configs and use cases is preserved.


## Major Enhancements & Additions

### Rendering & Architecture

  • Modular separation of rendering logic into:
  • RenderAddons
  • RenderUtils
  • TextureManager
  • TextureAnimator
  • Introduction of AssetScanner:
  • Scans the resource manager for textures under sprites/hud/
  • Builds lists of available dot styles, arrow styles, icon borders, death marker types
  • Caches texture dimensions to avoid repeated IO
  • Death markers persistence:
  • Hud.deathMarkers store marker data with timestamp and world position
  • Configurable limit of death markers
  • Automatic cleanup of old or out-of-range markers
  • Hybrid mode operation:
  • Handshake with server to detect mod presence
  • Fallback to local mode if server unresponsive beyond timeout (e.g. SERVER_TIMEOUT_MS)
  • Per-player overrides:
  • In config, allow per-player settings: color, icon style, border style


## Detailed Changes per Component

### Main / Mod Initialization

  • Register payload codecs for HandshakePayload and PositionUpdatePayload with PayloadTypeRegistry
  • Initialize server module (BetterPlayerLocatorBarServer) on common side
  • Add logging for handshake success/failure and mode switching events

### Client / Initialization

  • On resource reload, call AssetScanner.reload(...)
  • Instantiate Hud and register HudRenderCallback
  • In ClientPlayNetworking, register receiver for handshake and position update
  • Track lastServerUpdateTime; if exceeds threshold, switch to local mode

### HUD (BetterPlayerLocatorBarHud)

  • Maintain maps:
  • playerPositions
  • lastKnownPositions
  • currentIconPositions
  • lastPositionUpdateTime
  • tick() and updateRenderCache():
  • Filter players by distance and maxVisibleIcons
  • Sort by closeness or priority if needed
  • Easing & interpolation:
  • If distance jump is large (e.g. > 75% of bar width), snap to target
  • Else, advance position using easeInOutQuad
  • Separate rendering methods:
  • renderPlayerIcon()
  • renderDeathMarker()
  • renderArrow()
  • renderNameplate()
  • Hide logic:
  • shouldHideTarget() checks for sneaking, invisibility, helmet usage
  • Angle & FOV:
  • Use CONFIG.getFovMultiplier() to adjust icon horizontal shift
  • Alpha / fading:
  • calculateEdgeAlpha() and getDistanceAlpha() for smooth fade near edges or by distance
  • Texture selection:
  • getAdjustedTextureIndex(distance, config) picks animation frame

### AssetScanner

  • On reload, checks for presence of each expected texture (dots, outlines, arrows, markers, tags)
  • Builds lists: availableDots, availableArrows, availableDeathMarkers, etc.
  • Caches texture
...
### Fixed Fabric Loader incompatibility issue for newer versions
# Mod Changelog - Versions 1.21 & 1.21.1

## **UI & Visual Enhancements**
  • Redesigned and improved **configuration screen**, offering a sleek and more intuitive interface.
  • Custom widgets** inspired by Mojang's existing UI elements for a seamless and familiar experience.
  • Fully **restyled icons**, delivering a modern and polished look.

## **HUD Improvements**
  • Enhanced **HUD interaction**—visibility of XP bar icons now dynamically affects the overall interface behavior.

## **Performance & Code Optimization**
  • Major **code refactoring** to ensure optimal performance and efficiency across all systems.
## v0.2.1 - BETA | Network & Rendering Overhaul

### Core Changes
  • Added dual-mode operation (Server Mode and Local Mode)
  • Implemented automatic handshake system for mod detection
  • Added 5-second timeout for server updates before switching to local mode

### Network Improvements
  • New payload registration system compatible with Minecraft 1.21 / 1.21.1
  • Server now initiates handshake when players join
  • Improved network efficiency with 2-tick update intervals

### Rendering Fixes
  • Complete rendering logic overhaul
  • Fixed player position sorting and display issues
  • Improved handling of edge cases in both modes

### New Features
  • Added server compatibility detection
  • Configurable distance-based fading
  • Automatic fallback to local detection when needed

### Bug Fixes
  • Fixed all compilation errors from previous version
  • Resolved variable scope conflicts
  • Corrected player visibility checks
  • Fixed timeout detection logic

### Configuration Updates
  • Added new config options for fade distances
  • Added force local mode option
  • Maintained backward compatibility with old configs

### Optimizations
  • Reduced network overhead
  • Improved client-side caching
  • Better connection state handling

### Known Issues
  • Player visibility may still be limited on some servers in local mode
  • Initial detection may take 1-2 seconds after joining

### Migration Notes
  • Servers need v0.2.1 - BETA for full functionality
  • Clients automatically handle fallback to local mode
  • Existing configs remain compatible but gain new options
### 🖥️ **Customizable Interface**
  • Rounded icons** representing players.
  • Dynamic colors** with join animations.
  • Stylized borders** with smooth gradients.
  • Smooth animations** using lerp.
  • Height indicator** (arrow showing if a player is above or below).
  • Progressive transparency** based on distance (fades at 100 blocks, nearly invisible at 5000).
  • Option to display the player’s head** instead of a colored icon.
### 🎮 **Enhanced User Experience**
  • Smooth movements** with interpolation.
  • "Show Names" mode when pressing Tab**.
  • Automatic adjustment of the experience and status bars** when interacting with the HUD.
### 📡 **Server Synchronization**
  • Real-time location tracking** of other players in the bar.
  • Detect nearby players** without needing a minimap.
  • Supports official and TL Skin skins**.
  • Persistent data storage** for players outside render distance.
### ⚙️ **Advanced Configuration**
  • Complete settings menu** (F8).
  • Modify some of active functions**.
  • Coming JSON configuration editor (Experimental and maybe not functional)**.
  • HUD bar implementation above the experience bar.
  • Player tracking system with position-based icon placement.
  • Dynamic icon scaling based on distance and screen edges.
  • Smooth animations for icon movement.
  • Height difference indicators with arrows.
  • Basic skin support (official skins only).
  • Performance optimizations for real-time tracking.
> Full Changelog: [Changelog](https://github.com/bichal/BetterPlayerLocatorBar/commits/1.21)

🌟 Related Projects

Similar modifications and resources you might like

View all →
Coordinates Display
C

Coordinates Display

by Boxadactle

A basic mod that displays your Coordinates on the In-game HUD.

118
mod
Seamless Sleep
S

Seamless Sleep

by AquaLoco

Adds a smooth, cinematic transition between night and day when players sleep, enhancing the sleeping camera, HUD, and overall visuals. MADE IN HEAVEN!!!

52
mod
Geckolib
G

Geckolib

by Gecko

A 3D animation library for entities, blocks, items, armor, and more!

620
mod
Undead Nights - Zombie Horde Nights / Hordes
U

Undead Nights - Zombie Horde Nights / Hordes

by PeteMC

This Mod adds Horde Nights to the game, with hordes of Zombies hunting the player in a Zombie Apocalypse.

186
mod
Better Player Locator Bar Icon
Download Better Player Locator Bar
Select game version
Select platform