Description

Hero text saying "Combat Numbers"

A mod dedicated to displaying fancy damage numbers.

Showcase of what a combat number looks like

NOTE: If you are on a lower GUI scale, the floating text may look too small. You can adjust Base Font Size on the mod config screen to help with that.

Features

Themes - Comes with built-in styles!

Damage Types - Shows different styles based on damage type.

Healing - Shows actual healing received. Hides numbers from regeneration to avoid being spammy.

Critical Hits - Special animations for crits? This mod got you covered.

Fully customizable - Damage skins, animations, even rules can be modified via datapacks and resource packs.

Highlights for v0.2.0

Added experimental support for Forge on 1.21.11. Please report any issues you find!

Installation

This is a client + server mod. If you are running a dedicated server, it has to be installed on the server as well as any clients connecting to it.

This mod relies on server hooks to figure out the actual damage amount and type. Without it, a vanilla client only receives health changes from the server and there's only so much we can do with just that info.

Compatibility

Combat Numbers should be compatible with most mods.

Works with Iris shaders, just make sure the mod's Render Mode config is set to "Screen" (default).

Please report any mod compatibility issues on GitHub.

Customization

You can add custom damage skins and animations. The mod provides built-in themes out of the box, but you can easily overwrite or extend them via resource packs or datapacks.

You can also customize server-side rules through datapacks. This is also how you can add compatibility for other mods. Examples of rules:

Example: Using a different animation for magic damage

{ "when": { "tags": ["minecraft:witch_resistant_to"] }, "then": { "animation": "combatnumbers:wave" } }

Example: Supporting other mods

{ "when": { "type": "your_mod:fire_spell" }, "then": { "skin": "combatnumbers:fire", "animation": "combatnumbers:impact" } }

Visit the GitHub page for the full guide on making a custom resource pack / datapack for this mod.

Motivation

Started off as a toy project in an older version of MC and later abandoned like 90% of my other projects. I like RPG modpacks, but sadly I came to the disappointing conclusion there's a lack of extravagrant Maplestory-style customizable damage numbers that nobody else other than me is going to ask for.

Future Plans

Backporting all the way to version 1.20.1 to support popular modpacks.
I do have plans to try and get a "client-only mode" going, it will fall back to using the not-so-accurate health deltas but hey at least you get to see pretty numbers.
Contributions are welcome, especially additional themes.