Smart HUD v1.0 — Changelog
> ## v1.0 — Initial Release
> - Built a modular widget system with a shared base class supporting position, opacity, scale, fade animations, and pulse-on-change effects
> - Implemented a centralized Widget Manager for registration, lookup, and batch operations across all widgets
> - Created a HUD Renderer with per-widget scaling via pose stack transformations
> - Added automatic layout saving and loading via JSON config files (layout.json, settings.json)
> - Widgets are only rendered when the player is in-game (hidden during debug screen, hidden GUI, and menu screens)
> - Coordinates — X/Y/Z with decimal precision, biome name, chunk coordinates, 16-point direction, light level, Diamond Zone and Ancient Debris zone indicators
> - Performance — FPS with 60-second average tracking, server ping, RAM usage with progress bar
> - Armor & Tool — equipment durability with cached item rendering (5-tick interval) and color-coded bars with low-durability blinking
> - Time & Moon — in-game clock, day counter, sunset/sunrise countdown, moon phase, sleep availability indicator
> - Food & Saturation — hunger level, saturation bar, starvation warning, exhaustion meter, healing indicator
> - Effects — active potion effects with Roman numeral levels, duration countdown, expiration blinking, beneficial/harmful color coding
> - Compass — horizontal compass bar with colored cardinal directions, degree ticks, and center heading indicator
> - Health — smooth animated health bar, absorption display, armor value, low-health blinking
> - XP Level — experience level, total XP, progress bar with percentage
> - Speed — movement speed in blocks/sec, max speed tracker, vertical speed, movement mode detection (walking, sprinting, flying, swimming, sneaking)
> - Light Level — block light and sky light values, gradient bar, mob spawn warning with blinking alert
> - Weather — current weather condition with icon, status message
> - Target Info — entity name, health bar with smooth animation, armor value, distance (appears only when looking at an entity)
> - Biome Info — biome name, temperature, precipitation type, dimension name, underwater indicator
> - Play Time — session timer, total world playtime from statistics
> - Death Counter — total deaths from world statistics with color-coded feedback
> - Server Info — singleplayer/server address, online player count, loaded entity count
> - Slime Chunk — slime chunk detection using seed-based algorithm (singleplayer only) with blinking indicator
> - Durability Alert — flashing warnings when any equipped item drops below 15% durability
> - Item Tracker — monitors 10 key resources (diamond, iron, gold, emerald, coal, redstone, lapis, netherite, arrows, ender pearls) with color-coded counts
> - Memory Graph — visual 60-second memory usage history graph with color-coded fill
> - Direction — 16-point compass direction, yaw in degrees, pitch, projected look-at coordinates
> - Inventory Space — free slot counter, fullness bar, blinking "FULL!" warning
> - Entity Radar — hostile, passive, and player entity counts within 32 blocks with nearest-hostile proximity alert
> - Real Time — system clock (HH:MM:SS) and date (DD.MM.YY)
> - Tips & Tricks — rotating gameplay tips every 30 seconds from a built-in database of 50+ tips, with fade-in animation
> - Block Info (Jade-style) — block name, mod origin, hardness value, required tool indicator, light emission, item icon preview (appears only when looking at a block)
> - CPS Counter — left and right clicks per second with max CPS tracker
> - Distance Traveled — total distance, sprint distance, fly distance with compact number formatting
> - Oxygen — air supply bar when underwater with low-oxygen blinking warning (auto-hides when not needed)
> - Held Item Info — item name, durability, stack count, mod origin, enchantment count, item icon
> - Spawn Compass — distance and directional arrow to bed spawn or world spawn point
> - Chunk Info — chunk coordinates, local position within chunk, entity count
> - Spawn Safety — scans nearby blocks for dark spawn-eligible spots, reports safe/unsafe status
> - Redstone Power — displays redstone signal strength at player position (auto-hides when zero)
> - Combat Log — recent damage events with fade-out animation, up to 5 entries, 5-second display time
> - Session Stats — session duration, mob kills, jump counter, total damage dealt
> - System Info — operating system, Java version, CPU core count, Minecraft version
> - Mini Map — 64×64 pixel overhead terrain map using heightmap and block map colors with player position marker
> - Nether Coords — automatic coordinate projection between Overworld and Nether (1:8 ratio)
> - Step Counter — walking step counter based on 0.78-block stride distance
> - Dark (default), Light, Neon, Minimal, Classic, Ocean, Jade, WAILA, Cyberpunk, Matrix, Retro, Blood, Gold, Pastel, Frost, Sunset, Void, Emerald
> - Each theme defines 13 color properties: background, border, text, secondary, dim, accent good/warn/bad/info, plus border toggle, text shadow, and padding
> - Minimal — coordinates, health, compass only
> - PvP — combat-focused: health, armor, effects, target, radar, food, durability alerts, compass
> - Explorer — navigation: coordinates, compass, biome, weather, time, light, direction, speed
> - Miner — mining essentials: coordinates, light, slime, armor, item tracker, durability alerts, inventory
> - Builder — building mode: coordinates, time, weather, inventory, real time, direction
> - Full HUD — all widgets enabled
> - Performance — debug: FPS, memory graph, server info, play time
> - Streamer — clean look: compass, health, effects, target
> ### Configuration Screen
> - Two-mode editor accessible via H keybind:
> - Settings mode — full-screen widget list with toggle switches, theme grid with live previews, preset cards with descriptions
> - Layout mode — full-screen drag-and-drop editor with grid lines, center alignment guides, snap-to-edge, and a floating popup for opacity/scale adjustment
> - Per-widget controls: enable/disable toggle, opacity slider (10%–100%), scale slider (0.5x–2.0x)
> - Mouse scroll support for long widget lists
> - Quick theme cycling from the top bar
> - All changes auto-saved on close
> - Only 3 widgets enabled on first launch: Coordinates, Health, Compass
> - On-screen notification on first load: "Press H to configure"
> - Notification system with slide-in animation, auto-dismiss, and color-coded messages (info, success, warning, error)
> ### Performance Optimizations
> - Armor widget caches item data every 5 ticks instead of every frame
> - Entity radar scans every 15 ticks
> - Item tracker updates every 20 ticks
> - Spawn safety scans every 30 ticks
> - Memory graph samples every 20 ticks
> - Mini map heightmap updates every 10 ticks
> - Chunk info entity count updates every 40 ticks
> - 20 ore entries with Y-level ranges, frequency, required tools, and descriptions
> - 30 biome entries with temperature, precipitation, resources, and descriptions
> - 35 mob entries with health, damage, hostility, spawn locations, and drops
> - 34 enchantment entries with max levels, applicable items, effects, and descriptions
> - 16 potion entries with durations, effects, and brewing recipes
> - 20 block entries with hardness, blast resistance, and descriptions
> - 30 food entries with hunger, saturation, and special notes
> - 6 tool tier entries with durability, speed, mining level, and enchantability
> - 20 structure entries with locations and loot descriptions
> - 3 dimension entries with Y-ranges and purposes
> - 17 crafting recipe hints
> - Full English (en_us) localization — 190 keys
> - Full Russian (ru_ru) localization — 146 keys
> - Covers all widget names, descriptions, editor labels, themes, presets, statuses, directions, weather, biomes, dimensions, items, and notifications
> - ColorUtils — lerp, gradient, rainbow, HSB conversion, darken, brighten, alpha manipulation
> - RenderHelper — progress bars, gradient bars, segmented bars, borders, right-aligned text, vertical gradients
> - SmartMath — lerp, clamp, smoothstep, pulse, easing functions, angle wrapping, distance calculations, time/distance/number formatting
