Injury Display

Know which limb is about to fail you — and how badly — without typing health between every swing.

What it’s for

HEALTH tells you everything, once, in a block of text that scrolls away. Mid-fight you don’t want everything. You want to know whether it’s your right arm or your left leg, and whether it’s the scratch you took two rooms ago or the thing that’s about to cost you the fight.

The injury display is a body, drawn once and updated as the game reports damage. Each part carries its own severity, so a glance answers “where” and “how bad” at the same time. Wounds and scars are shown apart, which matters because a scar is permanent and a wound is the one you can still do something about.

It is also the widget that changes the most between frontends, and deliberately so. In the desktop GUI it can be real artwork — a painted body that swaps to a different pose when you go down, with hand-drawn wounds that stack in place. In the terminal it’s a compact figure of characters that colors by severity. Both read the same game data; only the drawing differs.

Set it up

Common setups

A painted body that lies down when you do

This is the feature that makes the widget more than a picture, and it needs a skin with doll art. In your active skin’s skin.toml, the [injury_doll] table is the default body. Add a [[injury_doll.variants]] entry with a name, a when condition, and its own complete skin table:

[[injury_doll.variants]]
name = "downed"
when = { type = "indicator", id = "prone", active = true }

[injury_doll.variants.skin]
base = "doll/downed.png"

Then right-click the injuries window ▸ Injury doll ▸ Calibrate doll…, switch the Doll set drop-down from Default to downed, and click each body part on the prone art to place its dot. Click Save to skin.

You’ll see: your doll standing while you’re upright, and the whole body swapping to the prone painting the instant you’re knocked down — with every wound dot landing in the right place on the new pose, because you calibrated that set separately.

Dots that read at a glance instead of a squint

Open Calibrate doll… on the default set. The bottom rows style the generated dots: a Wound color, a Scar color, a dot size slider as a percentage of the doll’s height, and an opacity slider. Flip Preview: between wounds and scars and drag the rank slider from 1 to 3 to see each severity live on the art before you commit.

Push dot size up until the dots are unmistakable at your normal window size, then click Save to skin.

You’ll see: wounds as solid circles with their rank numeral inside and scars as rings, big enough to read from your seat — and the change takes effect on the very next frame rather than waiting for a skin reload.

A hand that disappears with the arm above it

For dolls with hand-drawn art, a part can suppress itself. Give the part a hidden_when condition in the manifest:

[injury_doll.leftHand]
hidden_when = { type = "injury", area = "leftArm", cmp = ">=", level = 3 }
healthy = "doll/hand_ok.png"

You’ll see: the left hand stop drawing entirely once the left arm hits severity 3 — no orphaned hand floating below a missing arm. The hand’s own wound still appears in the hover tooltip, so you don’t lose the information, only the drawing.

Tips & gotchas

⚠️ Scar 1 is level 4, not level 1. The scale runs 0 through 6: 0 is healthy, 1–3 are wounds, and 4–6 are scars. So a condition of Injury >= 4 means “any scar at all”, and Injury >= 1 means “anything wrong”. The editor labels (Scar1), the TOML color keys (scar1_color), and the skin art keys (scar1) all use the short name while the underlying level is 4. Counting scars from 1 in a condition is the most common way to write a rule that never fires.

⚠️ A variant replaces the doll wholesale — it does not layer on top. A matched variant brings its own base image, its own anchors, its own part art, and its own dot styling. That is the point: a prone body repositions every limb, so nothing from the standing set would land correctly. It also means a variant inherits nothing — a hidden_when you wrote on the default set does not apply while a variant is active. Author each set completely.

⚠️ The calibrator’s Doll set drop-down discards unsaved work when you switch. Changing from Default to a variant reseeds every anchor and dot value from the manifest. Click Save to skin before you switch sets, every time.

The window may appear on its own. The injuries window is bound to the game’s own injuries dialog, and windows bound that way are created for you the first time the game opens their dialog — that is how the GemStone IV experience window arrives. If a doll turns up unbidden, this is why, and .hidewindow injuries puts it away. It won’t duplicate: if you already have one, the existing window takes the feed.

A pool doll and a skin doll are not the same thing. A doll picked from Doll image is a single flat image with a sidecar file beside it holding its anchors and dot styling — that’s all. Pool dolls carry no pose variants and no hidden parts, because those live in a skin’s manifest. Choose Skin default if you want variants. Calibrating a pool doll writes to its sidecar, so the calibration travels with the artwork and a shared doll can arrive already calibrated.

A part with hand-drawn art never gets a dot, and that’s a feature. Once any severity key is authored for a part, that part is fully hand-drawn: at a level with no art the base shows through. Skins that paint the worst case into the base rely on this — “no overlay” is a deliberate reveal, like the hole where a severed limb was. Parts with no art at all keep their generated dots, so one doll can mix both approaches freely.

The nervous system draws underneath everything else. It’s a full-body underlay rather than a badge, so limb wounds and dots paint over it instead of being covered by it.

The tooltip only appears when something is wrong. Hovering a healthy GUI doll says nothing at all — an “uninjured” tooltip read as a stray badge, so it was removed. If you get no tooltip, you have no wounds.

Grayscale is built on demand. Ticking Grayscale doll art generates desaturated copies of the art at that moment and drops them when you untick it. Skins can’t ship pre-made grayscale files; the client makes its own.

Clicking another player can open their doll in a popup. The game sends a separate per-player injuries dialog, and both desktop frontends draw it as a floating window titled with that player’s name — the terminal closes it with Esc, the GUI with its window close button. That popup always uses the default doll set and the default palette: variants and hidden parts read your state, so your own prone flag must never reshape someone else’s body.

Your severity colors don’t reach the phone. The phone ships the same seven default colors, so an unmodified setup matches everywhere — but per-window injury*_color overrides are not forwarded, so a recolored desktop doll and the phone’s doll will differ.

See also

• Indicators — the same Injury condition, driving a status light; a bleeding indicator says “somewhere”, this says where
• Dashboard — those statuses in one grid
• Mini Vitals — how much health is left, next to which parts took it
• Make your health bar shout when you’re hurt — turning a wound into a sound, a light, and a buzz
• Skins (GUI Graphics) — authoring doll art, overlays, and variants in a skin manifest
• Compass — the other art-driven widget with its own picker

[injury_doll]
base = "doll/body.png"

[injury_doll.dots]
wound_color = "#e02020"
scar_color = "#b8b8b8"
diameter = 0.07

[injury_doll.leftArm]
healthy = "doll/arm_ok.png"
injury1 = "doll/arm_i1.png"
injury3 = "doll/arm_severed.png"

[injury_doll.leftHand]
hidden_when = { type = "injury", area = "leftArm", cmp = ">=", level = 3 }

[[injury_doll.variants]]
name = "downed"
when = { type = "indicator", id = "prone", active = true }

[injury_doll.variants.skin]
base = "doll/downed.png"

[[windows]]
name = "injuries"
widget_type = "injury_doll"
title = "Injuries"
row = 0
col = 0
rows = 8
cols = 10
show_border = true
border_style = "rounded"
content_align = "center"
injury1_color = "#aa5500"
injury2_color = "#ff8800"
injury3_color = "#ff0000"
scar1_color = "#999999"
scar2_color = "#777777"
scar3_color = "#555555"