PlayerTrackerPlus — Changelog

🎉 v1.0.0 — Initial release

First public release of PlayerTrackerPlus for Minecraft Fabric.

✨ Core features

• Skin-face overlay on the locator bar — every dot on the player locator bar (introduced in MC 1.21.6) is replaced by the actual player's skin face, pixel-perfect aligned with the vanilla indicator.
• Friends list with two display modes:
  • ALL_PLAYERS — show a skin face for every nearby player.
  • FRIENDS_ONLY — only show faces for players in your saved list; everyone else keeps the vanilla dot.
• Quick toggle hotkey — press <kbd>F8</kbd> at any time to flip between modes. Rebindable from Options → Controls → Misc.
• Health-row lift — the hearts / food / armor row is gently raised a couple of pixels so the locator-bar faces have room to breathe. Configurable from 0 to 40 px (default 2).
• 100% client-side — no server install required, works on any server including vanilla dedicated servers.

🪟 In-game UI

• New PlayerTrackerPlus button in the bottom-right corner of:
  • The inventory screen (press <kbd>E</kbd>)
  • The game pause menu (press <kbd>Esc</kbd>)
• Clicking the button opens a management modal with:
  • Mode toggle button at the top (all players / friends only)
  • Search field that filters the player list as you type
  • Scrollable list of all known players (online + previously added friends)
  • One-click toggle per row: [+] adds, [-] removes — the same row updates in place, no duplicates
  • Done button to return to the previous screen
• Case-insensitive deduplication: online ReaperFxx + saved reaperfxx show as a single row.

⌨️ Commands (text alternative)

• /playertrackerplus add <name> — add a player to friends list
• /playertrackerplus remove <name> — remove a player
• /playertrackerplus list — print your current friends
• /playertrackerplus mode all — show all faces
• /playertrackerplus mode friends — show friends-only

1.21.6 ships full ClientCommandManager support (autocomplete). 26.1.2 uses a chat-intercept fallback because fabric-client-command-api-v2 was removed from fabric-api 26.x.

🌍 Localization

Translated into 7 languages — the mod automatically follows your Minecraft language setting:

• 🇺🇸 English (en_us)
• 🇪🇸 Español — España (es_es)
• 🇩🇪 Deutsch (de_de)
• 🇫🇷 Français (fr_fr)
• 🇧🇷 Português — Brasil (pt_br)
• 🇨🇳 简体中文 (zh_cn)
• 🇷🇺 Русский (ru_ru)

📦 Supported Minecraft versions

⚙️ Configuration

Settings live in .minecraft/config/playertrackerplus.json:

{
  "mode": "ALL_PLAYERS",
  "healthRowYOffset": 2,
  "friends": []
}

Edits take effect on the next world entry — no full Minecraft restart needed.

🔧 Technical notes

Render alignment

• 26.1.2: Mixin LocatorBarRendererMixin on LocatorBarRenderer.lambda$extractRenderState$1 replicates the vanilla x/y formula exactly:
  • centerX = Mth.ceil((guiWidth() - 9) / 2.0f) (float division + ceil, NOT integer division)
  • offsetX = floor(yaw * 173 / 120)
  • dotX = centerX + offsetX, dotY = barTop - 2
  • Draws the face via PlayerFaceExtractor.extractRenderState(graphics, skin, dotX, dotY, 9).
• 1.21.6: face overlay via HudRenderCallback (yarn Mixin port still pending). Position is approximated from the camera yaw.

Health row lift

• Mixin GuiHealthRowMixin wraps Gui.extractPlayerHealth with pose().translate(0, -offset) at HEAD and popMatrix() at RETURN, lifting armor + hearts + food together.

Architecture

• Two parallel Gradle projects: playertrackerplus-fabric/ (Stonecutter, 1.21.6) and playertrackerplus-fabric-26/ (standalone, 26.1.2). They could not be unified because Stonecutter breaks Loom's post-obfuscation auto-detection on 26.x subprojects.
• Different mappings (yarn vs Mojang) mean source classes diverge per project:
  • 1.21.6: MinecraftClient, DrawContext, Text, PlayerListEntry...
  • 26.1.2: Minecraft, GuiGraphicsExtractor, Component, PlayerInfo, PlayerSkin...
• Shared by hand-sync: PlayerTrackerPlusConfig.java, language assets, Gradle wrapper.

🐛 Known issues / roadmap

• The 1.21.6 build still uses the approximated HUD overlay; pixel-perfect Mixin port to yarn LocatorBar.method_70870 is planned for v1.1.
• Per-player UUID-keyed friends list (currently keyed by lowercase name) is on the table if the community asks for it.
• Modrinth / CurseForge changelog formatting may render some emoji as text; this is harmless.

Thanks for trying PlayerTrackerPlus! Bug reports and translation PRs are very welcome.