Mods / HealthBar
Authors: StachoPL, KnewOne
Side: Client
Created: Apr 28th at 12:00 PM
Last modified: 1 day ago
Downloads: 11717
Follow Unfollow 243
Recommended download (for Vintage Story 1.21.0-pre.1 - 1.21.6):
healthbar_1.3.0.zip
1-click install
HealthBar Mod
A lightweight, client-side mod that shows every creature’s health in a clean, game-style bar above the head.
The bar scales with distance, changes colour as HP drops, animates smoothly when damage is taken, and features a subtle dark background with a stone-frame border that fits the Vintage Story aesthetic.
Note that the healthbar is currently only showing the currently selected mob. Meaning the one you hover over and which is in range of that hover.
| Feature | Details |
|---|---|
| Stylish pixel bar | Stone-frame border, dark backdrop, colour-shifting fill (green → yellow → red). |
| Distance-aware scaling | Bar and text shrink as you step back, keeping the HUD tidy. |
| Smooth damage animation | Fill slides to the new value instead of snapping. |
| Fade-in / fade-out | Appears only when you target the entity, then fades out. |
| Configurable everything | Colours, thresholds, size, fade speed, vertical offset… all in JSON. |
| Tiny footprint | Pure client mod. Safe to add or remove at any time. |
⚙️Configuration
Please use Configlib. Alternatively:
Edit the fileVintagestoryData/ModConfig/HealthBarSettings.json.Every entry is optional – delete a line to restore its default value.
| Key | Default | Description |
|---|---|---|
BarWidth |
66 | Total width of the bar (pixels on your screen). |
BarHeight |
6.6 | Total height of the bar (pixels). |
VerticalOffset |
22 | Vertical distance (pixels) above the mob’s head. Increase for tall entities. |
FadeInSpeed |
0.3 | Seconds it takes to fully fade in after the bar becomes visible. |
FadeOutSpeed |
0.5 | Seconds it takes to fade out after you stop looking / the timeout expires. |
LowHealthThreshold |
0.25 | ≤ 25 % HP → bar switches to LowHealthColor. |
MidHealthThreshold |
0.60 | ≤ 60 % HP (and > 25 %) → bar switches to MidHealthColor. |
LowHealthColor |
"#FF4444" | Hex colour when HP ≤ LowHealthThreshold. |
MidHealthColor |
"#FFCC00" | Hex colour when HP ≤ MidHealthThreshold but > LowHealthThreshold. |
FullHealthColor |
"#44FF44" | Hex colour when HP > MidHealthThreshold. |
FrameColor |
"#CCCCCC" | Hex colour of the stone-style border around the bar. |
| Mod Version | Mod Identifier | For Game version | Downloads | Released | Changelog | Download | 1-click mod install* |
|---|---|---|---|---|---|---|---|
| 1.3.0 | healthbar | 229 | 1 day ago | healthbar_1.3.0.zip | 1-click install | ||
|
Improve performance by reducing expensive call, add settings to limit calculation fov, cap bar entities amount, add vertical bar offset scaling | |||||||
| 1.2.0 | healthbar | 1404 | Nov 16th at 12:46 PM | healthbar_1.2.0.zip | 1-click install | ||
|
Add option to show all LOS healthbars instead of just target | |||||||
| 1.1.3 | healthbar | 87 | Nov 16th at 1:11 AM | healthbar_1.1.3.zip | 1-click install | ||
|
Add missing side: client modinfo | |||||||
| 1.1.2 | healthbar | 1771 | Oct 12th at 11:27 PM | healthbar_1.1.2.zip | 1-click install | ||
|
BUMB Game version | |||||||
| 1.1.1 | healthbar | 1961 | Sep 16th at 11:33 AM | healthbar_1.1.1.zip | 1-click install | ||
|
Bump version of mod and fix the release. | |||||||
| 1.1.0 | healthbar | 170 | Sep 15th at 9:26 PM | healthbar_1.1.0.zip | 1-click install | ||
|
Net8, configlib | |||||||
| 1.0.7 | healthbar | 4618 | May 4th at 9:22 AM | HealthBar.v1.0.7.zip | 1-click install | ||
3. Added new settings, enable/disable healthbar, show on player can now be disable, added posibility to hide HP value. | |||||||
| 1.0.6 | healthbar | 569 | Apr 30th at 10:11 PM | HealthBar.v1.0.6.zip | 1-click install | ||
|
Fix issue with missing translation. | |||||||
| 1.0.5 | healthbar | 69 | Apr 30th at 9:31 PM | HealthBar.v1.0.5.zip | 1-click install | ||
|
Add first version of settings GUI with save, reset, and config management. This update introduces a GUI for managing health bar settings, with features like saving, resetting to defaults, and live updates to settings. It includes color pickers, sliders, and number inputs, enhancing user customization and usability. Language support for English and Polish is also implemented. | |||||||
| 1.0.4 | healthbar | 265 | Apr 29th at 5:08 PM | HealthBar.v1.0.4.zip | 1-click install | ||
|
1. Consolidated variable names, removed redundant code, and streamlined logic to improve readability and efficiency. | |||||||
| 1.0.3 | healthbar | 128 | Apr 29th at 11:30 AM | HealthBar.v1.0.3.zip | 1-click install | ||
| |||||||
| 1.0.2 | healthbar | 223 | Apr 28th at 7:24 PM | HealthBar.v1.0.2.zip | 1-click install | ||
| |||||||
| 1.0.1 | healthbar | 223 | Apr 28th at 12:01 PM | HealthBar.zip | 1-click install | ||
|
Release the mod v.1.0.1 | |||||||
Added offset scaling
Made bar rendering only happen for entities in view distance and reduces expensive ray tracing calls only to those entities
Reduced amount of bars that are shown at a single time
Should reduce fps drop but i didn't experience much before, so ymmv
Lakul, Oweyan try to check changes
Fenvar if i'm not pinged, i don't see any notifications.
This mod now causes massive frame drops when more than 10 animals are around just FYI
Is there a fix for the massive frame drop when viewing the health bars?
Mogadis
Well shit sorry :D Mentioned the wrong. My apologies :(
Dunno what exactly happend but well :D
Teax I'm not the mod author, StachoPL, and KnewOne is.
But based on what I know, not directly but you can do something very close to it. Vintage Story API i think doesn't expose nameplate positioning but the current implementation can be improved i think:
The Problem
The mod currently uses:
entity.Pos.Y + entity.CollisionBox.Y2(top of collision box)VerticalOffsetof 22 pixelsThe Solution
The mod should use better anchor points that likely match what the nameplate system uses:
1. Better anchor point:
2. Scale the offset:
This is just an idea. After all, there is always more than 1 solution when it comes to coding. :)
Additional Examples: Entity.EyeHeight Property instead of CollisionBox.Y2 or do a dynamic offset based on the Selection Box, or instead maybe make the vertical offset scale with distance -- similar to the bar itself which would mean it becomes Scale-Aware with a vertical offset.
Just wanted to spur some ideas and show there are many ways to trying to do this.
Mogadis
Greetings, love this mod. Would it be possible to attach the healthbar somehow to the nameplate anchor? Regardless the vertical offset, the health bar overlaps on players / named creatures always with the name. Either at close range or at distance.
I like the vanilla nameplate scaling even at range its readable.
Best regards
Awesome StachoPL hope it's a great success~
I look forward to using it. :D
Mogadis I working on new renderer where I use textures :)
Really wish the bar was like your image:

I am going to be completely honest, I was upset with the fact it was completely different than the pic. Yes, the mod is great but man that image would have fit so well into Vintage Story instead of a flat bar that fills.
the range update is working perfectly.
1.2.0 attempts to add more general HP bar for all the nearby mobs, mainly those that are in LOS in certain range. Range is configurable. You can still use the old view style with the "target only display". That option doesn't have range options. New display has some scaling stuff going on, so check out new scale toggles.Use Configlib to have descriptions for settings
Kolljak the way mod finds the target to draw the healthbar is by what is selected in your tooltip mostly. So it's limited by game's recognition of entities
downloaded most recent version
doesnt have "side" : "client" in the modinfo
where do I add it, I wanna use it while on my friends server ;-;
edit: got it to work, my friend poked around on it XD
Is there a way to customize the distance in which the health bar becomes visible or am i blind.
Greetings, i would really like this mod but i cant get it to work. In singleplayer its working but on every server i was testing this, it did not work.
Edit: Found the problem. >> "side" : "client", << is missing in the modinfo.json
best regards
This is my go to HP bar mod. Great mod!
StachoPL
thank you!! you rock!!
DrgnDspchr update now. I sav thats the prev version has a multiple .dll files.
Greetings..
running game version 1.21.1 (stable) .. just added your mod and started a new world and im getting this on loadin and i dont think i have seen a health bar yet?? could very well be user error on my part since im new to the game (not even 1 month playing) .....
Thanks in advance
15.9.2025 20:48:16 [Error] [healthbar] An exception was thrown when trying to load assembly:
15.9.2025 20:48:16 [Error] [healthbar] Exception: Found multiple .dll files with ModSystems and/or ModInfo attributes
at Vintagestory.Common.ModContainer.LoadAssembly(ModCompilationContext compilationContext, ModAssemblyLoader loader) in VintagestoryLib\Common\API\ModContainer.cs:line 553
Why adding whole new gui dialog and a hotkey, instead of using Config lib with it centralized access to mod settings? Also ImGui have color pickers, so you dont need to edit colors blindly.
Also with config lib generated configs you can have settings explained in config file itself, without need to describe it on modpage and require players to return to the page if they want to change a setting.
All this is quite inconvenient.
Not working to 1.21
Will you be updating to the new version of the game?
Mistrzu mod nie działa na wersji 1.21 pc 1 - gorąca prośba o możliwie przyjrzenie się problemowi
Temporary before I not fix the issue with text rendering, disable show hp value in settings tab.
I also use this mod in a multiplayer game on the TOPS server and in a single game, frames are dropping on the server, when hosting a personal server such problems were not observed, there are assumptions that this mod should be present on the server so as not to cause delays in frames, but it must be installed manually by the player, it is not installed from the server to the client by itself.
Kerr I'm having the same issue, my frames drop from 160 to the single digits.
Massive frame loss when targeting mobs and other players. idk whats causing it to do this but its really really bad.
Tried this mod on the TOPS server and experienced the same lag as Grand_Paladin and fps drop from 100 to 20 fps, however no lag in singeplayer was witnessed
It is a definete problem with the mod
I guess some logic in getting health is not fast or any optimised for server use
Really hope it will get fixed as I really like it
Russian translation.
It's very good that you added color settings - the default colors are too poisonous-bright. If make them darker, muffled, then this is more consistent with the style of the game.
Aimli_ Thx, in next update it should be added :)
@Grand_Paladin new version should work better.
@Grand_Paladin do you have other mods? I didnt notice thats on my PC.
Tried this mod on the TOPS server and anytime I approach a mob the game stutters and FPS drops dramatically.
Disbaled the mod and problem went away.
I'm rocking a powerful CPU and RTX3090, so its not on my end.
Scorives I will work on it in next update, something is not yes here xD
AcidNight I was forgot to add side to modinfo. It's should work now. I tested it on own server.
Hi, is there any way to set it to always on as when i leave range of mob a few feet away the bar disapeears i tried setting fade out to zero which works when im in range of mob but a few feet away it disappears.
does not work in multi
Hello, I'm going to test that ^^ said, you should do like the other mods, add the version to the zip name in case of an update we know directly if we already have it or not
Good Soup