Community listing page, reviews may not be monitored by the author.
Highly Customizable Damage Numbers
No reviews yet
Adds damage indicators with a wide variety of customization options and the ability to change the font of the numbers via image loading.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
Runs entirely on the client. Works on vanilla servers.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
Highly Customizable Damage Numbers
HICUDAN is a mod that adds damage numbers on-hit, with a strong focus on customization. It lets you create and use your own custom fonts as in-game damage indicators by simply providing an image containing the ten digits, plus an optional eleventh character for critical hits. The mod is fully standalone and does not require any dependencies.
This mod was at first aimed to provide modpack developers with an easy to use framework through the in-game configuration and the extensive set of options available, however it ended up still user friendly enough to just straight up be used by anyone. It comes with four different fonts already available from first download.
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


In-game settings
Modpack developers can disable the in-game mod settings menu 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.
A more detailed guide can be accessed directly from the mod settings menu.
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
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.
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)
How to add your own font (v1.2+)
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Get it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources