Config

File	Side	Purpose
mobhealth-common.toml	server / singleplayer	What is shown, to whom, and how - all the server-side logic.
mobhealth-client.toml	client	The appearance of your own graphical bars and damage numbers.

mobhealth-common.toml

Server / common config.

`[display]` - the master switch for each mode

Key	Default	Description
chat	true	Send a chat message to the viewer with damage dealt and health left.
actionBar	true	Show the readout on the action bar.
toast	false	Pop an achievement-style toast. Requires the mod on the client.
nameplate	false	Put a health bar on the mob's name tag.
bossBar	false	Show the top-of-screen boss-bar widget.
graphical	true	Allow modded clients to draw graphical floating bars.
damageIndicators	true	Send floating damage numbers to modded clients. Requires the mod on the client.

Key	Default	Values	Description
audience	ATTACKER	ATTACKER, NEARBY	ATTACKER = only the player who hit the mob; NEARBY = everyone within nearbyRadius.
nearbyRadius	32	4-128	Radius (blocks) for audience = NEARBY.

[audience] - applies to chat, action bar, boss bar, toast, damage indicators and graphical. The nameplate is always visible to everyone nearby.

`[targets]` - which mobs trigger a display

Key	Default	Description
hostile	true	Hostile monsters (zombies, skeletons, creepers, …).
neutral	true	Neutral mobs - passive until provoked (endermen, wolves, bees, …).
passive	true	Passive animals (cows, sheep, chickens, …).
players	false	Other players (PvP).
bosses	true	Boss entities (Ender Dragon, Wither).
hideUntilDamaged	true	Only show once a mob is below full health.
overrides	["minecraft:armor_stand=false"]	Force specific entities on/off, beating their group. Format "namespace:id=true\|false".

Example overrides:

overrides = ["minecraft:villager=false", "minecraft:ender_dragon=true", "somemod:custom_boss=true"]

`[damageindicators]`, `[chat]`, `[actionbar]`

Key	Default	Values	Description
damageindicators.minDamage	0.0	0.0-100.0	Don't send a number for hits below this much damage (2 = one heart). Raise it to keep poison/thorns off the screen.
damageindicators.markKillingBlow	true	bool	Flag the blow that kills, drawn bold, larger and in fatalColor.
chat.chatContent	BOTH	BAR, NUMBERS, BOTH	What the chat message includes.
actionbar.actionBarContent	BOTH	BAR, NUMBERS, BOTH	What the action bar shows.

`[nameplate]`, `[bossbar]`, `[toast]`

Key	Default	Values	Description
nameplate.mode	ON_DAMAGE	ON_DAMAGE, NAMED_ONLY, ALWAYS	ON_DAMAGE: brief bar after a hit, then reverts. NAMED_ONLY: only mobs that already have a name tag. ALWAYS: shown after a hit and kept.
nameplate.content	BOTH	BAR, NUMBERS, BOTH	What the nameplate shows.
bossbar.color	RED	PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE	Boss-bar colour.
toast.projectileIcon	PROJECTILE	PROJECTILE, WEAPON	For ranged hits, show the projectile or the firing weapon.

`[bar]` - text bar appearance (chat / action bar / nameplate)

Key	Default	Values	Description
segments	20	1-100	Number of segments in the bar.
filledChar	"\|"	string	Glyph for a filled segment.
emptyChar	"\|"	string	Glyph for a depleted segment. Keep it the same as filledChar for a constant-width bar - a different glyph like " " changes width as health changes, since the font is proportional.
valueStyle	CURRENT_MAX	NONE, CURRENT_MAX, PERCENT	Numeric readout: none, 14/20, or 70%.

`[timing]` - how long bars linger, in ticks (20 = 1 second)

Key	Default	Range	Description
displayTicks	100	20-1200	Default lifetime after the last hit (100 = 5s).
displayTicksHostile	-1	-1-1200	Per-group override; -1 = use default.
displayTicksNeutral	-1	-1-1200	Per-group override.
displayTicksPassive	-1	-1-1200	Per-group override.
deathTicks	20	0-600	How long a bar lingers after the mob dies, kept short so an empty bar doesn't hang around.

mobhealth-client.toml

Client config.

Controls the appearance of your own graphical bars and damage numbers. A server can override the [graphical] options; when it doesn't, these values apply. [damageIndicators] is yours alone - the server's only say is whether it sends the numbers at all.

`[graphical]`

Key	Default	Values	Description
enabled	true	bool	Master switch for graphical bars on your client.
verticalOffset	0.5	-2.0-6.0	Extra height (blocks) above the mob's head.
maxDistance	24.0	4.0-96.0	Only draw bars for mobs within this many blocks.
barWidth	40	8-200	Bar width in pixels (at scale 1.0).
barHeight	4	1-24	Bar height in pixels (at scale 1.0).
barStyle	SOLID	SOLID, ROUNDED, SEGMENTED, TAPERED	Bar shape. SEGMENTED = notched chunks; TAPERED = lens/leaf.
segments	10	2-50	Number of chunks for the SEGMENTED style.
scale	1.0	0.25-4.0	Overall size multiplier for the bar and its outline.
scaleWithDistance	false	bool	Shrink bars as the mob gets further away.
fadeWithDistance	false	bool	Fade bars out as the mob approaches maxDistance.
showBackground	true	bool	Draw a dark outline behind the bar.
showText	true	bool	Draw the numeric health above the bar.
showPlayers	false	bool	Also draw bars above other players.
onlyWhenDamaged	true	bool	Only draw a bar once the mob is hurt.
requireLineOfSight	true	bool	Only draw bars for mobs you can actually see, not through terrain.

`[damageIndicators]`

Key	Default	Values	Description
enabled	true	bool	Master switch for floating damage numbers on your client.
scale	1.0	0.25-4.0	Size multiplier. 1.0 = normal font size.
durationMs	1200	200-5000	How long each number lives, in milliseconds.
drift	16.0	0.0-96.0	How far the number rises over its life, in screen pixels.
verticalOffset	0.0	-2.0-4.0	Extra height (blocks) above the hit, so numbers rise through empty air rather than through the health bar.
spread	0.6	0.0-3.0	Random scatter (blocks) per number, so a burst of hits reads as several numbers instead of one flickering in place.
maxDistance	32.0	4.0-96.0	Only draw numbers within this many blocks of you.
minDamage	0.0	0.0-100.0	Ignore hits below this much damage. Filters further than the server's own minDamage.
maxOnScreen	40	4-200	Cap on numbers alive at once; the oldest are dropped first.
hearts	false	bool	Show damage in hearts rather than raw health points (2 points = 1 heart).
numberColor	FF5555	RRGGBB	Colour of an ordinary damage number.
fatalColor	FFAA00	RRGGBB	Colour of the killing blow.

numberColor rather than color, because the in-game config screen looks options up by their last path element alone and [bossbar] already owns color.

[graphicalEnforce]

Server-enforced graphical options.

Graphical bars are drawn by the client, but a server can enforce any of the client's graphical settings - useful for fairness (force line-of-sight so nobody sees mobs through walls) or a consistent look. Boolean options use a three-way value: CLIENT lets each client decide (default), ON / OFF force it for everyone. Numeric options use an enforce<X> toggle plus the value to force.

Key	Default	Values	Enforces (client option)
lineOfSight	CLIENT	CLIENT/ON/OFF	requireLineOfSight
numbers	CLIENT	CLIENT/ON/OFF	showText
background	CLIENT	CLIENT/ON/OFF	showBackground
showPlayers	CLIENT	CLIENT/ON/OFF	showPlayers
onlyWhenDamaged	CLIENT	CLIENT/ON/OFF	onlyWhenDamaged
enforceVerticalOffset / verticalOffsetValue	false / 0.5	bool / -2.0-6.0	verticalOffset
enforceMaxDistance / maxDistanceValue	false / 24.0	bool / 4.0-96.0	maxDistance
enforceBarWidth / barWidthValue	false / 40	bool / 8-200	barWidth
enforceBarHeight / barHeightValue	false / 4	bool / 1-24	barHeight
enforceScale / scaleValue	false / 1.0	bool / 0.25-4.0	scale
scaleWithDistance	CLIENT	CLIENT/ON/OFF	scaleWithDistance
fadeWithDistance	CLIENT	CLIENT/ON/OFF	fadeWithDistance
enforceBarStyle / barStyleValue	false / SOLID	bool / style	barStyle
enforceSegments / segmentsValue	false / 10	bool / 2-50	segments

Example - enforce line-of-sight, hide numbers, cap the draw distance, but let players pick their own bar size:

[graphicalEnforce]
    lineOfSight = "ON"
    numbers = "OFF"
    enforceMaxDistance = true
    maxDistanceValue = 16.0

To disable graphical bars entirely from the server, set [display] graphical = false instead - that turns them off for all modded clients. After editing, run /mobhealth reload (or have players reconnect) to push the changes.

Recipes

Common setups.

Vanilla-friendly server

No client mods needed - everyone sees nameplate bars and chat, no graphical bars.

[display]
    chat = true
    nameplate = true
    bossBar = false
    graphical = false

Boss-bar HUD instead of nameplates

A single green bar at the top of the screen, nothing else.

[display]
    chat = false
    nameplate = false
    bossBar = true
[bossbar]
    color = "GREEN"

"MMO" always-visible bars

Persistent nameplate and graphical bars for modded clients, even on undamaged mobs.

[display]
    nameplate = true
    graphical = true
[targets]
    hideUntilDamaged = false
[nameplate]
    mode = "ALWAYS"

Immersive, graphical-only

No chat spam, no boss bar - just the floating pixel bars, enforced consistent for everyone.

[display]
    chat = false
    actionBar = false
    bossBar = false
    graphical = true
[graphicalEnforce]
    lineOfSight = "ON"

Config

Server logic, client appearance.

Server / common config.

[display] - the master switch for each mode

[targets] - which mobs trigger a display

[damageindicators], [chat], [actionbar]

[nameplate], [bossbar], [toast]

[bar] - text bar appearance (chat / action bar / nameplate)

[timing] - how long bars linger, in ticks (20 = 1 second)