Damage Engine

Damage Engine

Damage Engine shows your combat in clear numbers: how much damage you deal, how many hits you chain, where each hit lands, and how the target is doing.

> Install it on both client and server for the full experience. If the server does not have it, the client can still show damage numbers in a limited client-only mode.

***

Features

Floating Damage Numbers

• Damage numbers appear in the world at the hit location, not on a fixed HUD corner.
• Separate colors and animations for normal hits, crits and kills, with custom kill text.
• Numbers scale with distance, so nearby hits are readable and far ones stay subtle.
• Enhanced and cloud animation modes, plus an in-game animation editor.
• Add particle effects to animations and preview them directly in the editor.
• Optional merge mode: fast hits on the same target combine into one number.
• Optional entity tracking: the number follows a moving target.
• Heal numbers and global damage numbers for hits dealt by other players.
• Damage overflow option: show the full damage dealt instead of stopping at the target's remaining health.

HUD Modules

• Total Damage — damage dealt in the current fight, with configurable color tiers.
• Combo Counter — consecutive hits, for example x5.
• Progress Bar — shows when the current combo will reset.
• Damage History — recent hits, newest first, with smooth slide animation.
• Target Info — the last target's name, 3D entity preview, health values and an animated health bar with damage-tail and heal effects. A perception filter can hide targets you can neither see nor hear.
• Rating — an S / A / B / C / D grade based on combos, hits and crits.

HUD Editor and Layout

• Drag, resize and arrange every module in-game, with undo and redo.
• HUD inertia: modules smoothly follow camera movement, with adjustable strength.
• Left/right alignment for the damage display.

Quality of Life

• Number formatting: separators (1,000) and abbreviation (1.5K).
• Configurable decimal places for totals and floating numbers.
• F1 compatibility: optionally hide the HUD with the vanilla GUI.
• Multiple config profiles for different servers or playstyles.
• Debug options for raw damage info and live rating score.

***

Client-Only Mode

When the server does not have Damage Engine installed, the client estimates damage from health changes.

• Works for most mobs and players without installing anything on the server.
• Limited accuracy: the attacker, crits and projectile hits cannot always be identified, and the number position is estimated.

***

Configuration

• Open the config screen with the config key binding or from Mod Menu.
• Edit the HUD layout directly in-game through the HUD editor.
• Colors, timings, distances, animations and number formats are configurable in-game.

Key Bindings

All keys are unbound by default and can be assigned in the controls menu:

• Open Config — open the configuration screen.
• Toggle HUD — show or hide the whole HUD.
• Clear Damage — reset the current session and remove floating numbers.

Commands

• /damage_engine clear — clears current damage data.

***

Links

• Source: <https://github.com/Ovear-Mitama/Damage-Engine>
• Issues and suggestions: <https://github.com/Ovear-Mitama/Damage-Engine/issues>

Licensed under the MIT license.