---

Overview

Better Chat Heads seamlessly injects real-time player head avatars next to chat messages within multiplayer environments. Engineered to enhance spatial awareness and visual readability in high-traffic chat streams, this client-side utility features intelligent skin synchronization pipelines and advanced regex pattern matching to support complex, rank-heavy server message formats without impacting frame rendering times.

---

Key Features

• Contextual Avatar Injection — Dynamically renders player heads alongside validated multiplayer chat vectors, fully supporting secondary skin layers, overlays, hats, and hair geometry.
• Smart Skin Sync+ & Live Swap — Features an automated retry pipeline for initially unresolved skin textures, transitioning smoothly from default asset fallbacks (Steve/Alex) to verified player skins in real-time.
• Per-Server Profile Isolation — Automatically preserves unique configuration parameters customized to individual server environments.
• Adaptive Pattern Ingestion — Utilizes a local learning cache to dynamically index, memorize, and parse server-specific chat prefixes, rank structures, and custom message separators.
• Granular UI Scaling — Includes options for compact layout modes, custom head introduction animations, and adjustable frame-timing variables.
• Zero Server Overhead — Operates entirely within the local client runtime. Features an integrated configuration panel and optional Mod Menu compatibility with instant state saving.

---

Installation Guide

1. Dependency Verification: Ensure the target environment has the correct iteration of the Fabric API installed.
2. Deployment: Place the compiled BetterChatHeads binary payload directly into your local mods directory.
3. Initialization: Launch the runtime client and access the localized configuration panel layout to adjust pacing and cache rules.

---