Mods / HealthBar

Tags: #QoL
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.

 


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/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 IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.3.0 healthbar
1.21.0-pre.1 - 1.21.6
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
1.20.8 - 1.20.10
4618 May 4th at 9:22 AM HealthBar.v1.0.7.zip 1-click install
  1. Replaced individual GUI classes with a modular tab-based system to improve maintainability and scalability.
  2. Added separate tab implementations for general settings and thresholds, and introduced shared utility functions for reusable UI components.

3. Added new settings, enable/disable healthbar, show on player can now be disable, added posibility to hide HP value. 

1.0.6 healthbar
1.20.8 - 1.20.9
569 Apr 30th at 10:11 PM HealthBar.v1.0.6.zip 1-click install

Fix issue with missing translation. 

1.0.5 healthbar
1.20.8 - 1.20.9
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
1.20.8 - 1.20.9
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.
2. Refactored HealthBarBehavior to simplify update and disposal handling.

1.0.3 healthbar
1.20.8 - 1.20.9
128 Apr 29th at 11:30 AM HealthBar.v1.0.3.zip 1-click install
  1. Fix issue where the health bar immediately disappear after player stop targeting mobs.
1.0.2 healthbar
1.20.8 - 1.20.9
223 Apr 28th at 7:24 PM HealthBar.v1.0.2.zip 1-click install
  1. Fix issue where the mod is not loading when mod is not uploaded to the server.


1.0.1 healthbar
1.20.8 - 1.20.9
223 Apr 28th at 12:01 PM HealthBar.zip 1-click install

Release the mod v.1.0.1


40 Comments (oldest first | newest first)

KnewOne, 1 day ago

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.

 

Oweyan, Dec 7th at 6:34 AM

This mod now causes massive frame drops when more than 10 animals are around just FYI

Lakul, Dec 6th at 8:36 AM

Is there a fix for the massive frame drop when viewing the health bars?

Teax, Dec 3rd at 8:46 AM

Mogadis

Well shit sorry :D Mentioned the wrong. My apologies :(

Dunno what exactly happend but well :D

 

 

Fenvar, Dec 3rd at 8:16 AM (modified Dec 8th at 2:54 PM)

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:

Spoiler

The Problem

The mod currently uses:

  • entity.Pos.Y + entity.CollisionBox.Y2 (top of collision box)
  • A fixed VerticalOffset of 22 pixels
  • This causes overlap because it's completely independent of the nameplate system

The Solution

The mod should use better anchor points that likely match what the nameplate system uses:

  1. SelectionBox.Y2 instead of CollisionBox.Y2
  2. Scale the vertical offset with distance (like the bar itself)
  3. Make it configurable for fine-tuning

    Spoiler

    1. Better anchor point:

     
    // Use selection box height instead of collision box
    var heightRef = e.SelectionBox?.Y2 ?? e.CollisionBox.Y2;

    2. Scale the offset:

     
    // Make offset scale with distance
    var scaledOffset = Config.VerticalOffset * Math.Min(scale / Config.MinScale, 2.0f);

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.

Teax, Dec 2nd at 6:58 PM

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

Fenvar, Nov 28th at 2:20 PM

Awesome StachoPL hope it's a great success~ 
I look forward to using it. :D 

StachoPL , Nov 27th at 3:37 PM

Mogadis I working on new renderer where I use textures :) 

Fenvar, Nov 26th at 9:43 AM

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.

Kolljak, Nov 16th at 2:05 PM

the range update is working perfectly.

KnewOne, Nov 16th at 12:47 PM

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

KnewOne, Nov 16th at 1:03 AM

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

ComradeRatt, Nov 15th at 7:15 PM (modified Nov 15th at 7:39 PM)

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 

Kolljak, Nov 13th at 3:01 PM

Is there a way to customize the distance in which the health bar becomes visible or am i blind.

Teax, Oct 21st at 12:48 PM (modified Oct 21st at 12:52 PM)

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

Oweyan, Sep 24th at 11:41 PM

This is my go to HP bar mod. Great mod!

DrgnDspchr, Sep 16th at 11:49 PM

StachoPL   

thank you!! you rock!! 

StachoPL , Sep 16th at 11:34 AM

DrgnDspchr update now. I sav thats the prev version has a multiple .dll files. 

DrgnDspchr, Sep 16th at 3:36 AM

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

 

 

Maltiez, Sep 5th at 6:27 AM

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.

Redison, Aug 28th at 6:18 PM

Not working to 1.21

ChimMAG, Aug 28th at 8:52 AM

Will you be updating to the new version of the game?

IgnisPolonia, Jul 22nd at 8:29 PM

Mistrzu mod nie działa na wersji 1.21 pc 1 - gorąca prośba o możliwie przyjrzenie się problemowi

StachoPL , Jun 11th at 7:42 AM

Temporary before I not fix the issue with text rendering, disable show hp value in settings tab. 

Coucicouca, Jun 4th at 4:29 AM

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.

MaloryVeridia, May 26th at 4:53 PM

Kerr I'm having the same issue, my frames drop from 160 to the single digits. 

Bryorios, May 25th at 9:03 AM

Massive frame loss when targeting mobs and other players. idk whats causing it to do this but its really really bad.

Kerr, May 25th at 3:28 AM

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

ChimMAG, May 2nd at 10:44 AM

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.

StachoPL , May 1st at 9:50 AM

Aimli_ Thx, in next update it should be added :)

Aimli_, May 1st at 8:33 AM
Chinese localization:
 
{
  "settings.title": "血条-设置",
  "section.sizepos": "大小和位置",
  "section.animations": "动画",
  "section.thresholds": "HP阈值",
  "section.colors": "颜色",
  "label.barwidth": "条形宽度",
  "label.barheight": "条形高度",
  "label.verticaloffset": "垂直偏移",
  "label.fadein": "淡入速度(秒)",
  "label.fadeout": "淡出速度(秒)",
  "label.lowhp": "低HP阈值",
  "label.midhp": "中HP阈值",
  "label.colorlow": "低HP颜色",
  "label.colormid": "中HP颜色",
  "label.colorfull": "满HP颜色",
  "label.colorframe": "框颜色",
  "button.save": "保存",
  "button.reset": "重置",
  "button.close": "关闭",
  "message.saved": "设置已保存。",
  "message.reset": "设置已重置为默认值。"
}
StachoPL , Apr 29th at 5:10 PM

@Grand_Paladin new version should work better.

StachoPL , Apr 29th at 3:42 PM

@Grand_Paladin do you have other mods? I didnt notice thats on my PC.

Grand_Paladin, Apr 29th at 3:26 PM

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.

StachoPL , Apr 28th at 7:28 PM

Scorives I will work on it in next update, something is not yes here xD

StachoPL , Apr 28th at 7:25 PM

AcidNight I was forgot to add side to modinfo. It's should work now. I tested it on own server. 

Scorives, Apr 28th at 7:13 PM

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.

AcidNight, Apr 28th at 4:49 PM

does not work in multi

AcidNight, Apr 28th at 2:41 PM

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

SternFr, Apr 28th at 12:50 PM

Good Soup