Custom Health HUD

A highly customizable health and experience HUD mod for Minecraft Forge 1.20.1 with advanced positioning, dynamic animations, and real-time JSON configuration.

✨ Key Features

🎯 Advanced Positioning System

• 9 anchor points: Position health/XP anywhere on screen (top_left, center, bottom_right, etc.)
• Independent positioning: Health and XP can be placed separately
• Pixel-perfect offsets: Fine-tune with X/Y coordinates

💖 Dynamic Heart Animations

• Low health pulsing: Hearts animate when health drops below threshold
• Damage effects: Screen shake and flash when taking damage
• Customizable wave system: Adjust intensity, speed, and spacing

🎨 Full Visual Customization

• RGB color control for health and experience
• Hardcore hearts automatically in hardcore worlds
• Absorption support (golden hearts from potions/golden apples)
• Adjustable heart spacing

⚙️ Real-Time Configuration

• Hot reload: Changes apply without restarting (5-second check interval)
• Auto-validation: Fixes corrupted configs automatically
• Preset configurations included
• Automatic backups

📋 Quick Setup

Config location: config/customhealthhud.json

Popular positions:

• Bottom center (vanilla-like): "healthAnchor": "bottom_center", "healthY": -10
• Top left corner: "healthAnchor": "top_left", "healthX": 10, "healthY": 10
• Center right: "healthAnchor": "center_right", "healthX": -100

Animation settings:

• Subtle: "waveIntensity": 0.2
• Normal: "waveIntensity": 0.5
• Intense: "waveIntensity": 0.8

🎮 Compatibility

• Minecraft: 1.20.1
• Forge: Latest stable versions
• Game modes: Survival, Adventure, Hardcore (disabled in Creative/Spectator)
• Client-side and Server-side

🔧 Perfect For

• Events: Custom positioning for overlays
• Resource pack users: Match your aesthetic
• Accessibility: Better visibility options

---

Edit the JSON config while in-game - changes apply automatically!