Changelog

0.0.1 - 2026-07-13

First public cleanup release of Player Head Hud.

Added

• Added a player-head overlay above nearby players.
• Added stacked overlay content in the order: avatar, name, distance.
• Added avatar-only default display when the target is not expanded.
• Added expansion when aiming at the player body or the head icon area.
• Added automatic name and distance display when the player is close enough and unobstructed.
• Added distance-based avatar sizing with configurable minimum and maximum sizes.
• Added fixed-size hover enlargement for the avatar.
• Added real player skin support with Steve fallback when skin lookup fails.
• Added switching between the custom player-head overlay and vanilla name rendering.
• Added configurable maximum distance for distance text.
• Added support for showing only the name when the target is too far away for distance text.
• Added long-distance fade support with an option to disable fading entirely.
• Added an option to hide the full overlay beyond a long-range threshold.
• Added Chinese comments in the generated config file.

MapWriter Compatibility

• Added optional compatibility with MapWriter-Mite.
• Added nearby player head rendering on the minimap.
• Added optional player names below minimap heads.
• Added a dedicated minimap name display mode toggle.
• Added a dedicated hotkey for cycling minimap name display modes.

Team Compatibility

• Added optional compatibility with the team mod.
• Added team-aware world overlay rendering.
• Added fallback to vanilla names for players outside the local team.
• Added team-aware minimap head filtering.

ManyLib Compatibility

• Added optional compatibility with ManyLib.
• Added in-game config editing support.
• Added in-game hotkey editing support.
• Added runtime sync between ManyLib hotkey changes and the mod config file.

Hotkeys

• Added F7 as the default hotkey for switching between player-head overlay mode and vanilla name mode.
• Added F4 as the default hotkey for cycling minimap player-name display modes.
• Added support for changing those hotkeys in the vanilla controls menu.

Config Updates

• Changed auto_show_distance to an integer-based setting.
• Changed distance_text_max_distance to an integer-based setting.
• Changed the default minimap name toggle hotkey from F8 to F4.

Fixes And Stability

• Removed unrelated template features and dependencies from the original project base.
• Fixed cases where vanilla player names were not correctly replaced.
• Fixed cases where some config size values did not apply after editing the config file.
• Fixed inconsistent scaling behavior between hover enlargement, minimum size, and distance scaling.
• Fixed long-distance cases where the head overlay could disappear entirely.
• Fixed fade behavior being affected incorrectly by background and render-distance state.
• Fixed distance text showing too many decimal places by switching it to integer display.
• Fixed translation keys appearing on screen instead of localized text.
• Fixed cases where the entire player head overlay failed to render.
• Fixed render-state restoration issues in the MapWriter rendering path.
• Fixed edge cases around team-state queries during world transitions.
• Fixed incorrect fallback behavior for default hotkeys.
• Added logging for config save failures to help troubleshooting.

Code Cleanup

• Refactored hotkey registration and synchronization logic to reduce duplication.
• Added and updated README and changelog documentation.