
HeartDev
API that allows developers to easly access the health bar rendering system
Screenshots

About this Mod
--- Please, do not dowload versions named as "devOnly" or something similar, with 4 numbers on their version (like x.y.z.t) or marked as "alpha" version. These may contain bugs or may not be consistent, so please read the changelog of that particular version where you there will be pointed out the next working version to install.
Disclaimer: This library takes inspiration form the Colorful Hearts mod, from which I used the rendering system to understand the rendering of the hearts, after that a revisited the rendering system to match my needs. Even though there was no collaboration, i respect the license system and therefore i want to credit the amazing job of other developers that let their mod open source and that made this one possible. Here is an insight of the Colorful Hearts:
- Mod name: Colorful Hearts [-> Link to the MOD]
- Mod License: MIT license (on 16/06/2025 for 1.21.1)
- Mod author: Terrails [-> Link to his PROFILE]

This Library allows developers to easily access the render health bar system, overriding textures and hearts behavours.
It is possible to change the behavior and textures of hearts and the health bar, dynamically and, with a little setup, also simply.
The library provides some effects that can be activated, thus changing the appearance of the hearts, so that you can easily test them.
Finally, textures are provided that can be used for testing or to create your desired heart bar.
--- The full wiki is available! (Needs a re-check, to know more read heartdev-1.0.5 changelog)
|| For any bug or concerns, please post a comment on the CurseForge comments page, describing the bug, || the Minecraft version and the NeoForge version (if possible). I'll be fixing the bug as soon as possible!!
|| If you want this library to be available on multiple versions, pls write a comment asking that particular || verion, since i will probably only update the mod for the main versions availble, by default.
HeartDev Trailer
Available Versions
How to Install HeartDev on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.4).
Install Mod
Open the mod browser in the dashboard and search for "HeartDev". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.4, 1.21.3, 1.21.2 (+2 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
HeartDev server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.4). You can switch loaders with one click in the panel.
Is HeartDev compatible with neoforge?
HeartDev officially supports neoforge for Minecraft 1.21.4, 1.21.3, 1.21.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with HeartDev – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if HeartDev consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install HeartDev with just one click on your server.