Back to mods
HealthBar  project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which HealthBar release matches 1.22.2?

Updated 2 months ago
Best match for your filters 1.4.2
Game version 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3
Loader Built-in Vintage Story mod system

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.

Client Required
Dedicated server Not supported
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 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.

 


Features

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.

45 available setups

Showing 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 of 17 releases match
Clear filters

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.