Mods / HealthBar

Tags: #QoL
Author: StachoPL
Side: Client
Created: Apr 28th at 12:00 PM
Last modified: May 4th at 9:22 AM
Downloads: 2443
Follow Unfollow 68

Recommended download (for Vintage Story v1.20.7 - v1.20.10):
HealthBar.v1.0.7.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.

 

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.
 

 

 

Installation

  1. Download HealthBar v1.0.1.zip from the Releases tab or the VS Mod DB.
  2. Drop the zip into your Mods/ folder (no need to unzip).
  3. Start the game – the mod loads automatically and is client-side only.

Multiplayer: Works on any server; other players need the mod installed to see bars on their own screen.

 

Configuration options

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.

Tip: Use any 6-digit hex (e.g. #AABBCC). The mod parses it automatically.

 

⚙️ New Settings Available

You can now customize the health bar in-game with a simple settings window:

  • 🔧 Change the size and position (width, height, offset)

  • 🎞️ Adjust fade-in and fade-out speed

  • 🚦 Set when colors change based on health

  • 🎨 Pick your own colors for low, mid, full health and the frame

Includes Save and Reset buttons.
Press Backslash ("\") to open the settings.

💾 Make sure to save your settings before you leave the game.

Version For Game version Downloads Release date Changelog Download 1-click mod install*
v1.0.7
v1.20.7 - v1.20.10*
1262 May 4th at 9:22 AM Show HealthBar.v1.0.7.zip 1-click install
v1.0.6
v1.20.7 - v1.20.9*
517 Apr 30th at 10:11 PM Show HealthBar.v1.0.6.zip 1-click install
v1.0.5
v1.20.7 - v1.20.9*
21 Apr 30th at 9:31 PM Show HealthBar.v1.0.5.zip 1-click install
v1.0.4
v1.20.7 - v1.20.9*
220 Apr 29th at 5:08 PM Show HealthBar.v1.0.4.zip 1-click install
v1.0.3
v1.20.7 - v1.20.9*
84 Apr 29th at 11:30 AM Show HealthBar.v1.0.3.zip 1-click install
v1.0.2
v1.20.7 - v1.20.9*
181 Apr 28th at 7:24 PM Show HealthBar.v1.0.2.zip 1-click install
v1.0.1
v1.20.7 - v1.20.9*
158 Apr 28th at 12:01 PM Show HealthBar.zip 1-click install

12 Comments (oldest first | newest first)

💬 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

💬 FrazierFr, Apr 28th at 12:50 PM

Good Soup

 (edit comment delete)