Locator Display

Just a Client-Side Locator Bar Color Display Mod

Locator Display is a client-side Minecraft mod that adds a customizable symbol next to player names in the tab list, colored exactly like their locator bar color.

Features

• Displays a customizable colored symbol before each player's name in the tab list.
• Customize the symbol by choosing one of the characters in the preset or by specifying a custom one: ⬤, ▌, ⬛, ★, ◆, ▶, ✚, ✖
• Display an icon or a texture instead of a symbol.
• Choose to color player names.
• Proximity Detection shows how far or near a player is from you.
• Allows disabling the locator bar and only displaying the experience bar.
• Choose to use the Server-Provided or the official Mojang UUID for accurate colors.
• Falls back to a deterministic offline UUID for players not registered with Mojang.
• Fully client-side; works on any SMP.
• Turns off in servers with thousands of players in the tab list(minigames, pvp servers)

Requirements

• Minecraft 1.21.6+
• Fabric Loader 0.19.3+
• Java 21+
• ModMenu (recommended)

Installation

1. Download the appropriate .jar
2. Place the file into your .minecraft/mods folder
3. Launch Minecraft with Fabric Loader

How It Works

1. The mod fetches the player's UUID either from the client or from the public Mojang API.
2. It computes a color from the UUID using the same algorithm as the locator bar.
3. The specified symbol is prepended to the player's name in the tab list.

Configuration

The mod is configurable with ModMenu:

Options:

• Enabled → to turn the mod on and off
• Icon Type → Select either Texture or Symbol
• Icon → Near, Nearby, Far, Distant, Bowtie
• > Custom (max length 3) or > Custom texture PATH → If Custom was specified in the previous selection, put your custom configuration here
  • Custom Symbol:
  • input at most 3 characters
  • those characters will be prepended to the player name
  • the character must be renderable by Minecraft
  • Example: >> Player_Name
  • Custom Icon:
  • Allows instance-loaded textures to be used
  • modid:block/custom_block
  • accepts only directories inside the textures/ directory of any instance
  • for Minecraft, any texture inside: block, colormap, effect, entity, environment, font, gui, item, map, misc, mob_effect, painting, particle, trims
  • Example input:
    • block/dirt
    • minecraft:item/iron_sword
    • hud/heart/full.png
    • minecraft:textures/block/glowstone.png → the correct input, the mod formats everything into this
  • Recommended: Use light textures(ones that do not contain a lot of dark pixels)

• Advanced Options:
  • UUID Source → can either be Server-Provided or Official Mojang(from the Mojang API)
  • Proximity Detection → Disables icon customization, makes the icon smaller or bigger like the locator bar. For players in a different dimension, a bowtie will be displayed.
  • Color Name → change the color of the player names into their locator bar color
  • Disable Locator Bar → as the name suggests, forces only the Experience Bar to appear
• Defaults → sets all options to the defaults
• Done → Saves the configuration and exits

Disclaimer

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

License

Code: GPL-3.0-only
Assets (logo/icon): CC BY-NC-ND 4.0 (see LICENSE-ASSETS)

Contributing

Open an issue if you find a bug or have a feature request. If you want to contribute code-wise, make sure to check the TODO file and opened issues. By contributing to this repository you agree that all additions/modifications will be licensed under GPLv3-only and you agree to allow distribution in compiled form.

Credits

Based on the Fabric example mod template (CC0).