Sol's Damage & Health Indicator

Sol's Damage Indicator 

Supports Minecraft Forge 1.16.5, 1.20.1!

Author: solmochi

Need help, want to suggest a feature, or found a bug?

Join our community to catch exclusive early previews and upcoming changelogs before they go live!

***

Description

Sol's Indicator is a visual combat HUD mod that shows exactly how much damage you deal in real-time. See floating damage numbers on enemies, track your hit combos with a stylish center-screen HUD, monitor any entity's health with a crosshair indicator, and watch boss fights come alive with custom RPG-themed boss bars featuring per-player damage rankings and cinematic death animations.

⚠️ Works in two modes — install on both server and client for full accuracy (melee, projectiles, spells, abilities), or use client-only for basic melee tracking.

✅ Fully functionable and playable on a Single-Player World.

***

Features

Damage Indicator HUD

• Hit Counter & Combo Tracker — Displays hit count, "HIT" / "CRIT" text, and cumulative damage dealt on the center-right of your screen
• Throbbing Pulse Animation — Each hit triggers a scale pulse that stacks during rapid combos
• Critical Hit Detection — Crits display in green with "CRIT" text; relic crits show the multiplier (e.g., "CRIT 2.1x") in bright green
• Summary Phase — After 3.5 seconds of no hits, transitions to a summary showing total damage dealt with a dramatic pulsed "DAMAGE" label
• Auto-Fade — HUD fades out after 5 seconds of inactivity, then resets for the next combat
• Configurable Position — Can be placed on center-left or center-right of the screen

Floating Damage Numbers

• World-Space Numbers — Damage numbers float upward from hit entities and fade out over 1.5 seconds
• Color-Coded — Red for normal hits, green for vanilla crits, bright green for relic system crits
• Crit Multiplier Display — Relic crits show the multiplier suffix (e.g., "12.50 2.1x")
• Spawn Animation — Numbers scale up with a quick throb on spawn, then settle
• Random Spread — Multiple simultaneous numbers spread out slightly to avoid overlap
• Billboard Rendering — Numbers always face the camera in 3D world space

Custom Boss Bar HUD

• RPG-Themed Design — Fully replaces vanilla boss bars with a styled panel featuring gold frames, gradient health bars, and entity portraits
• Entity Portraits — Renders a live 3D model of the boss entity inside a framed portrait box
• Dynamic Sizing — Bar width auto-expands to fit long entity names and HP text
• Color-Matched Bars — Health bar color adapts to the entity's custom name color, boss bar color setting, or mob type (red/green/blue)
• HP Numbers — Shows exact current HP / max HP (formatted: e.g., "125.4K / 500.0K")
• Entity Titles — Displays CustomNPC titles below the entity name when available
• Multiple Boss Bars — Supports configurable max boss bars on screen (default: 3) with "+N more" overflow label
• Compact Mode — 2nd+ boss bars use a compact layout showing only your own damage contribution
• Stale Data Cleanup — Automatically clears damage progress when entities heal to full or die

Boss Damage Progress

• Per-Player Damage Tracking — Server tracks cumulative damage dealt by each player to boss entities
• Damage Percentage Display — Shows each player's damage as a percentage of the boss's max HP (e.g., "PlayerName: 10.83%")
• RPG Rank Styling — Top contributors get medal icons: crown for #1, diamonds for #2–3, arrows for #4+
• 2-Column Grid Layout — Top 5 contributors displayed in an organized grid with a "Damage Progress" header
• Self-Highlighting — Your own name is highlighted in green; other players appear in white
• Self-Append — If you're not in the top 5, your entry is appended separately so you always see your contribution
• Auto-Detection — Uses reflection to detect any entity with a ServerBossInfo field (supports vanilla + all modded bosses)
• Inactivity Pruning — Players are removed from the damage list after configurable minutes of inactivity (default: 5 min)

Boss Death Animation

• Cinematic Kill Sequence — When a boss dies, plays a 10-second dramatic overlay with multiple phases:

Entity Health Indicator

• Crosshair Target Health — Shows a health bar panel for the entity you're looking at
• RPG Panel Design — Matches the boss bar style with gold frame, portrait, and gradient health bar
• Live Entity Portrait — Renders a 3D model of the targeted entity
• HP & Armor Display — Shows heart icon + current/max HP and diamond armor icon with armor value
• Modded Entity Support — Formats names from registry paths (e.g., "cartaddon:revolutionary\_grunt" → "Revolutionary Grunt")

Client-Only Fallback Mode

• No Server Required — When the server doesn't have the mod, automatically falls back to client-side melee tracking via health deltas
• Seamless Switching — Detects server capability from the first damage packet; no manual configuration needed
• Melee Detection — Tracks attacks via AttackEntityEvent and monitors entity health changes each tick
• Vanilla Crit Detection — Detects vanilla critical hits (falling + sprinting conditions) in client-only mode

***

Installation

1. Install Minecraft Forge for 1.16.5 or 1.20.1
2. Download the mod .jar file
3. Place it in your .minecraft/mods folder
4. Launch Minecraft

For full features (all damage sources, boss tracking, death animations): Install on both server and client. For basic melee tracking: Client-only installation works — no server needed.

***

Configuration