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)

How to Install Better Player Locator Bar (Mod)

Better Player Locator Bar by Bichal is verified for Fabric across Minecraft versions 1.21, 1.21.1, 1.21.2, 1.21.3 (latest release: v1.1.2, file size: 228 KB). Follow the steps below to install it safely from ModCraft.tv:

  1. Click the Download button above and select your Minecraft version (1.21, 1.21.1, 1.21.2, 1.21.3) and platform (Fabric).
  2. Make sure you have the compatible loader or environment installed for Fabric.
  3. Move the downloaded Better Player Locator Bar file into your Minecraft .minecraft/mods folder and launch the game.

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
Carpet AMS Addition
C

Carpet AMS Addition

by 1024_byteeeee

A fabric-carpet extension mod. It offers some interesting and useful features.

997
mod
woodwalkers
w

woodwalkers

by ToCraft

Transform into a mob!

650
mod
Geckolib
G

Geckolib

by Gecko

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

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