Highly Customizable Damage Numbers

This mod adds damage indicators that show the player 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/creating by changing the font style, size, duration, animations, colors, behaviour, and much 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.

Retro font

Customization options

Add your own custom font
Presets for easier use (v1.2)
Define colors for different damage values
Custom glyph for critical strikes
Healing numbers (v1.2)
Adjust gap between numbers
Gradient or Flicker color styling
Shake and pulse
Pop-in and Fade-out
Scale and duration
Damage based size
Distance based size and opacity (v1.2)
Opacity based on distance (v1.2)

Customization options – Full list

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

Setting	Summary	Options
Preset options
Preview	Displays how the font will look in-game, with animations and style choices applied	N/A
Font list	Allows to change between different fonts to use for the damage indicators, by default displays the four preloaded fonts	Every font currently loaded
Preset list (v1.2+)	Allows to change between different presets quickly	Every preset currently in the presets folder
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
General options
Show option	Changes the logic behind which indicators are chosen to spawn	`Show All` `Show Close` `Disable`
Indicator render range (v1.2+)	Changes the distance at which indicators should spawn if the previous option is set to “Show close”	`Distance (in blocks)`
Indicator opacity (v1.2+)	Sets the baseline opacity for the indicators	`Opacity (as percentage)`
Healing indicators (v1.2+)	Toggles healing indicators (Only available if the font has a healing indicator glyph)	`Enabled / Disabled`
Size factor	Sets up how big should the indicators be	`Size (as a multiplier)`
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`
Duration	Sets up how much should the indicators last	`Duration (in ticks)`
Critical heals (v1.2+)	Toggles if healing indicators can be able to spawn as also a critical if conditions are met (Only available if the font has a healing indicator glyph)	`Enabled / Disabled`
Gap between digits	Changes the gap size between digits (Very important to change on certain fonts)	`Separation (in pixels)`
Max indicators (v1.2+)	Sets up a hard cap for how many indicators can be rendered at the same time, if the cap is reached new indicators will override the oldest ones based on age	`Amount`
Show damage on self (v1.2+)	Toggles if damage on your own player should create and indicator (Highly recommended to avoid using full opacity when this setting is enabled)	`Enabled / Disabled`
Show healing on self (v1.2+)	Toggles if healing on your own player should create and indicator (Highly recommended to avoid using full opacity when this setting is enabled)	`Enabled / Disabled`
Color options
Color style	Changes how the color of the damage/healing indicator behaves	`Enable / Disable` `Gradient style` `Flicker style`
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
Animation options
Shake animation	Quickly wiggles the indicator in-place when it spawns	`Enable / Disable` `Duration (in ticks)` `Intensity (in degrees)</code`
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)`
Scale based on distance (v1.2+)	Increases indicator size the farther away they are to improve legibility (100% Strength means the indicator maintains it's size relative to the screen no matter the distance)	`Scale strength (as a percentage)` `Start at (in blocks)</code`
Opacity based on distance (v1.2+)	INterpolate opacity the farther away indicators are to avoid visual clutter	`Invisible at (in blocks)` `Start at (in blocks)</code`
Scale based on damage	Enlarges damage indicators based on how much damage was done	`Enable / Disable`

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`
`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)

Medieval font

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.

Mod settings menu

_This menu corresponds to pre v1.2_

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 (Pre v1.2)

Add your own font old guide

How to add your own font (v1.2+)

Add your own font new guide

Highly Customizable Damage Numbers

截图

介绍

Highly Customizable Damage Numbers

Customization options

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

Some extra options available only in the json config

In-game settings

Quick guide

常见问题

Highly Customizable Damage Numbers 支持哪些 Minecraft 版本？

Highly Customizable Damage Numbers 怎么安装？

评论