Vintage Story Mod DB · Vintage Story mod
HealthBar
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 backg
Quick answer
Which HealthBar release matches 1.22.2?
HealthBar 1.4.2 targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.
Where it goes
Is HealthBar required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This Vintage Story file is marked client-only.
What else does HealthBar 1.4.2 need?
1.4.2 on 1.22.2. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add HealthBar without breaking your instance.
Built for HealthBar 1.4.2 on 1.22.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.4.2. It targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.4.2. It opens that exact file at the source.
About this project
What does HealthBar add?
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 file VintagestoryData/ModConfig/HealthBar.json.
Every entry is optional – delete a line to restore its default value.
| Key | Default | Description |
|---|---|---|
Enabled |
true | Enable or disable the health bar display. |
TargetOnlyHealthBar |
false | Show healthbar only for the current target. Limited range and not affected by DisplayRange. |
DisplayRange |
20 | Max distance to show health bars. High values may cause performance issues. |
ShowOnPlayer |
true | Display health bars on players. |
ShowHpText |
true | Show numeric HP text inside the bar. |
HorizontalFOV |
60 | Horizontal field of view angle in degrees for frustum culling. Only entities within this angle from camera direction will show health bars. |
MaxBarsDisplayed |
7 | Maximum number of bars shown at once (useful if you experience slowdowns). |
MaxTargetBarsDisplayed |
1 | Maximum number of bars shown in target-only mode (1 = only the selected entity). |
AlwaysShowTargetInAround |
true | Always show the current target in around mode and do not count it towards the limit. |
Theme |
Basic | Select theme: Basic or Pixel. (ConfigLib stores the selected label.) |
BarWidth |
66 | Total width of the bar (pixels on your screen). |
BarHeight |
7 | Total height of the bar (pixels). |
MinScale |
0.75 | Minimum size multiplier for distant entities. |
MaxScale |
8 | Maximum size multiplier when very close. |
VerticalOffset |
22 | Vertical offset (pixels) above the entity’s head. Increase for tall entities. |
MinOffsetScale |
1.0 | Minimum vertical offset multiplier for distant entities (helps prevent overlap). |
MaxOffsetScale |
2.0 | Maximum vertical offset multiplier for close entities (helps prevent overlap). |
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. |
MidHealthThreshold |
60 | Below this percentage HP, the bar uses MidHealthColor. |
LowHealthThreshold |
25 | Below this percentage HP, the bar uses LowHealthColor. |
FullHealthColor |
"#44FF44" | Bar color at full health. |
MidHealthColor |
"#FFCC00" | Bar color when HP is between low and mid thresholds. |
LowHealthColor |
"#FF4444" | Bar color when HP is below the low threshold. |
FrameColor |
"#cccccc" | Frame/border color of the health bar. |
Project description from Vintage Story Mod DB.
Pick your setup
HealthBar releases for each Vintage Story version.
Choose the version and loader you play, then open the matching release.
1.22.1
1 loader build1.22.0-rc.10
1 loader build1.22.0-rc.9
1 loader build1.22.0-rc.8
1 loader build1.22.0-rc.7
1 loader build1.22.0-rc.6
1 loader build1.22.0-rc.5
1 loader build1.22.0-rc.4
1 loader build1.22.0-rc.3
1 loader build1.22.0-rc.2
1 loader build1.22.0-rc.1
1 loader buildShowing the newest 12 of 45 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
HealthBar versions and loaders
1.4.2
healthbar_1.4.2.zip
15 May 2026
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.