wounded

wounded captures a stalker when health or psy-health reaches configured breakpoints. The NPC falls into a wounded state, calls for help, can be helped by another stalker, and can auto-heal after a timeout.

Parameters

The active logic section can point to a wounded configuration section:

wounded

Location: active section or [logic] fallback. Type: section name. Optional.

Section used to configure wounded behavior. nil uses community defaults.

The wounded configuration section supports:

hp_state

Type: wounded data. Optional. Default: community default.

State/sound descriptor for HP wounds when the actor is not seen.

hp_state_see

Type: wounded data. Optional. Default: community default.

State/sound descriptor for HP wounds when the actor is seen.

psy_state

Type: wounded data. Optional. Default: community default.

State/sound descriptor for psy-health wounds.

hp_victim

Type: wounded data. Optional. Default: community default.

Victim descriptor stored in portable state.

hp_cover

Type: wounded data. Optional. Default: community default.

Parsed into state. The inspected manager does not currently store its processed result.

hp_fight

Type: wounded data. Optional. Default: community default.

Controls whether the NPC can keep fighting while wounded.

help_dialog

Type: string. Optional. Default: community default.

Dialog used for wounded help interaction.

help_start_dialog

Type: string. Optional. Default: null.

Start dialog set when the NPC becomes wounded.

use_medkit

Type: boolean. Optional. Default: community default.

Allows medkit use after help or auto-heal unlocks it.

autoheal

Type: boolean. Optional. Default: true.

Allows automatic medkit unlock after wounded timeout.

enable_talk

Type: boolean. Optional. Default: true.

Stores whether talking is enabled while wounded.

not_for_help

Type: boolean. Optional. Default: community default.

Marks the wounded object as not suitable for helper NPCs.

Wounded Data Syntax

Wounded data is parsed as repeated descriptors:

hp|state_condlist@sound_condlist|hp|state_condlist@sound_condlist

Examples:

hp_state = 20|wounded_heavy_2@help_heavy
hp_fight = 20|false
psy_state = 20|{=best_pistol}psy_armed,psy_pain@wounded_psy

Each descriptor has:

hp

Breakpoint compared with current HP or psy-health in the 0..100 range.

state_condlist

Condlist resolved to the stalker state or special value.

sound_condlist

Optional condlist after @, resolved to the sound name.

The parser selects the last descriptor whose breakpoint is greater than or equal to the current value before a higher unmatched breakpoint stops the scan.

Runtime behavior

On reset, the scheme resolves the wounded config section and parses the descriptor fields. Defaults differ for normal, monolith, and zombied communities. Normal stalkers default to a wounded-heavy state with help sounds and medkit use. Monolith and zombied defaults disable outside help.

The wound manager recalculates state on update and hit. Psy wounds are checked first. If no psy wound applies, HP wound state and sound are selected from hp_state or hp_state_see depending on whether the NPC sees the actor. Fight and victim results are stored in portable state.

When the wounded action starts, the NPC stops moving, disables trade, sets wounded state, registers as a wounded object, and begins calling for help after the configured delay. If auto-heal is enabled and no helper unlocks medkit use, the manager unlocks medkit use after the wounded timeout.

Example

[logic]
active = walker@guard

[walker@guard]
path_walk = guard_walk
path_look = guard_look
wounded = wounded@guard

[wounded@guard]
hp_state = 25|wounded_heavy_2@help_heavy
hp_state_see = 25|wounded_heavy_3@help_heavy
hp_fight = 25|false
hp_victim = 25|nil
help_dialog = dm_help_wounded_medkit_dialog
use_medkit = true
autoheal = true
not_for_help = false

Notes

• Wounded timing defaults are loaded from schemes\wounded.ltx: call delay 5000, call period 5000, wounded timeout 60000 if the config file does not override them.
• If the resolved wounded state is nil while the action is executing, the implementation aborts with a wrong wounded animation error.