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.
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 Pre v1.2)
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)
|
| 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)
|
| 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)
|
| Scale based on damage | Enlarges damage indicators based on how much damage was done |
Enable / Disable |
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)
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
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 4d ago | 1 | ||||
| 4d ago | 1 | ||||
| 13d ago | 1 | ||||
| 13d ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 |
- Fixes on the preset manager
- Updated readme on the config folder
- Healing indicators**
- Presets**
- Options for showing indicators on self
- Size based on distance
- Opacity based on distance
- Render range can now be adjusted in-game
- Base indicator transparency
### Fixes/Changes:
- Entire rework of the config screen**
- Animations were made smoother
- Significant optimization fixes for the config screen (oops)
- The color options were expanded to accomodate for healing indicators color settings
- Config screen was restructured and is hopefully more easy to navigate now
- The rendering pipeline was adjusted in order to work in minecraft 26.2+
- Impact that the indicators are having on the game performance can now be seen in the F3+1 pie chart (root.frame.render.world.level.submitFeatures.hicudan_indicators)
_Additionally, a stress test was performed rendering 200 indicators per tick at a size of 32px with every single animation setting enabled. Under these conditions the mod indicator rendering constituted about 2.6% of the total game load, due to these results the max baseline amount of indicators was increased significantly_
- Also fixed a small issue that caused fadeout to malfunction.