Highly Customizable Damage Numbers

Highly Customizable Damage Numbers

This mod adds damage indicators to show the play how much damage each hit does to an entity, the indicators can be customized however the user wants with a wide variety of options available to tweak and play around with.

Make the indicators match the style of the modpack you're using by changing the font style, size, duration, animations, and more. You can even add your own font if you'd like!

This mod is completely standalone and does not depend on any mods other than the modloader itself.

Customization options

• Add your own custom font
• Define colors for different damage values
• Custom glyph for critical strikes (Optional)
• Adjust gap between numbers
• Gradient or Flicker color styling
• Shake and pulse
• Pop-in and Fade-out
• Scale and duration
• Damage based scaling

Customization options (Full list)

Detailed explanation of everything available in the in-game config screen:

Setting	Summary	Options
Preview	Displays how the font will look in-game, with animations and style choices applied	N/A
Font seleciton list	Allows to change between different fonts to use for the damage indicators, by default displays the four preloaded fonts	Every font currently loaded
Open folder	Opens the folder where the custom made fonts should go	N/A
" ? "	Opens a guide on your browser detailing how to add your own custom fonts to the game	N/A
Reload fonts	Refreshes the fonts used by the mod, should be used when the player adds a PNG to the fonts folder in order for the mod to generate the necessary resources and be able to show it in-game	N/A
Show option	Changes the distance at which indicators should spawn	Show All Show Close Disable
Critical indicator	Sets up under what conditions should the critical indicator appear (Only available if the font has a critical indicator glyph)	Never On critical hit After last threshold Both conditions must be true
Shake animation	Quickly wiggles the indicator in-place when it spawns	Enable / Disable Duration (in ticks) Intensity (in degrees)
Pulse animation	Grows and shrinks the indicator as if "pulsing" when it spawns	Enable / Disable Duration (in ticks) Max size (as a multiplier)
Fadeout	Fades the number away when reaching the end of the duration	Enable / Disable Duration (in ticks)
Pop-in	Quickly grows the number in size when it spawns instead of just appreaing	Enable / Disable Duration (in ticks)
Color style	Changes how the color of the damage indicator behaves	Enable / Disable Gradient style Flicker style
DBS	Enlarges damage indicators based on how much damage was done	Enable / Disable
Duration	Sets up how much should the indicators last	Duration (in ticks)
Size factor	Sets up how big should the indicators be	Size (as a multiplier)
Gap between digits	Changes the gap size between digits (Very important to change on certain fonts)	Separation (in pixels)
Threshold selector	Add or remove thresholds at which indicator color should change	Left click to add Right click to remove
HSV color selectors	Pick a color for each damage threshold	N/A

All of these can be tweaked with no limitation if modified in the saved_config.json file, located in the conifg directory

Some extra options available only in the json config

Setting	Summary	Options
inGameConfigEnabled	Enables or disables the icon shown in the minecraft options screen	true false
indicatorsMaxSpawnDistance	Changes the distance at which indicators render under the "Show Close" setting	Distance (In blocks)
debugMode	Allows to see entitiy names and damage amount when hitting an entity (not intended for gameplay)	true false
enableBlacklist	If enabled, the entites found in the blacklistedEntites list, will never spawn damage indicators	true false
blacklistedEntites	Entities here will never spawn damage indicators, names require the full namespace:entityname format, debug mode can help determine exact entity names	As many entities as needed

There is also the posibility of adjusting the flexibility of some sliders in-game (minimum and maximum amount selectable)

In-game settings

The in-game settings menu can be accessed through a small icon at the top left of the options screen, this icon can be disabled in the saved_config.json if desired.

Quick guide

To add your own custom fonts you need an png file with a 10:1 aspect ratio (or 11:1 if the font includes a special glyph for critical strikes) with the font drawn in 1234567890 order, the style can be anything as long as each character is not bigger than 32x32px or smaller than 8x8px. The files that follow the format can be added into the resources folder, reloading the resources or restarting the game will create the neccesary files and allow the font to be selected in-game.
The font name must be in characters a-z, 0-9 ._-

A more detailed guide can be accessed directly from the mod settings menu or below.

How to add your own font