Vintage Story Mod DB · Vintage Story mod

Extra Overlays-1.22+

Extra Overlays — Health bars for nearby creatures (VS 1.22+) Client-side mod that draws colored health bars above creatures near your player. Bars appear automatically for entities within range — you do not need to look directly at a mob for its bar to show.

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

Quick answer

Which Extra Overlays-1.22+ release matches 1.22.5?

Updated 6 days ago

Best match for your filters 1.8.1

Game version 1.22.5

Loader Built-in Vintage Story mod system

Extra Overlays-1.22+ 1.8.1 targets 1.22.5. 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 Extra Overlays-1.22+ 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.

Understand Vintage Story dependencies Read the Vintage Story installation guide

What else does Extra Overlays-1.22+ 1.8.1 need?

1.8.1 on 1.22.5. 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 Extra Overlays-1.22+ without breaking your instance.

Built for Extra Overlays-1.22+ 1.8.1 on 1.22.5. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use 1.8.1. It targets 1.22.5; 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.8.1. It opens that exact file at the source.

About this project

What does Extra Overlays-1.22+ add?

Extra Overlays — Health bars for nearby creatures (VS 1.22+)

Client-side mod that draws colored health bars above creatures near your player. Bars appear automatically for entities within range — you do not need to look directly at a mob for its bar to show.

Based on the original Extra Overlays by Mintir4, updated for Vintage Story 1.22+.

Features

Health bars above nearby creatures (up to 15 by default, within 10 blocks)
Color changes by remaining HP: green → yellow → red
Smooth fade in/out
Fully configurable via attr.json — no in-game menu

Installation

Client only — install on your game client; no server-side install required
Requires Vintage Story 1.22.3 or newer
Compatible with multiplayer (each player controls their own overlay)

Configuration

Settings are read from attr.json, located next to the mod DLL inside the mod folder/zip:

VintagestoryData/Mods/ExtraOverlays_VS1.22.2_net10_v1.7.5.zip ExtraOverlays.dll attr.json ← edit this file

How to edit:

Close the game (or leave your world)
Open the mod zip with any archive tool, or extract the mod to a folder
Edit attr.json with a text editor (Notepad, VS Code, etc.)
Save and restart the game / rejoin your world

Changes take effect the next time you enter a world.

Default settings (attr.json)

{

"FadeIn": 0.2,

"FadeOut": 0.4,

"Width": 100.0,

"Height": 10.0,

"YOffset": 10.0,

"HighHPColor": "#7FBF7F",

"MidHPColor": "#BFBF7F",

"LowHPColor": "#BF7F7F",

"LowHPThreshold": 0.25,

"MidHPThreshold": 0.5,

"VisibleBelowHealthThreshold": 0.99,

"MaxVisibleEntities": 15,

"MaxDistanceBlocks": 10.0

}

Option reference

Setting	Default	Description
FadeIn	0.2	Seconds for bars to fade in
FadeOut	0.4	Seconds for bars to fade out
Width	100	Bar width in pixels (scaled by distance)
Height	10	Bar height in pixels
YOffset	10	Vertical offset above the creature's head
HighHPColor	#7FBF7F	Color when HP is above MidHPThreshold (hex)
MidHPColor	#BFBF7F	Color when HP is between thresholds
LowHPColor	#BF7F7F	Color when HP is at or below LowHPThreshold
LowHPThreshold	0.25	HP ratio (0–1) below which the bar turns red
MidHPThreshold	0.5	HP ratio below which the bar turns yellow
VisibleBelowHealthThreshold	0.99	Only show bars for creatures at or below this HP ratio. Use 1.0 to show bars on all creatures, including full HP. Use 0.5 to only show injured ones.
MaxVisibleEntities	15	Maximum number of bars shown at once (closest first)
MaxDistanceBlocks	10	Range in blocks around the player

Common tweaks

Show bars on all creatures (even at full HP): set "VisibleBelowHealthThreshold": 1.0
Only show injured creatures: set "VisibleBelowHealthThreshold": 0.5 (or lower)
See bars from farther away: increase "MaxDistanceBlocks"
Reduce screen clutter: lower "MaxVisibleEntities"

Troubleshooting

No bars appear: check that VisibleBelowHealthThreshold is not too low, and that creatures are within MaxDistanceBlocks
Settings not applying: make sure you edited attr.json inside the mod folder/zip (not a copy elsewhere), saved the file, and rejoined your world
Invalid JSON: a syntax error will cause the mod to fall back to built-in defaults — check the client log for [extraoverlaysm4] messages