> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/animation/animation-system-for-actor/animation-selection-setup/human-death-animation-selection.md).

# Human death animation selection

The logic for selecting death animations for a **human** unit is stored in `\properties\animation_selector\`**`human_death.inc`**

The selector processes requests whose names match the [kill flag](/animation/animation-system-for-actor/animation-selection-setup/human-specific-conditions.md#kill-flags-reference) names that describe the circumstances of death.

#### Death animation request types

* `stand_dying` — death while standing;
* `squat_dying` — death while sitting;
* `lie_dying` — death while lying;
* `swim_dying` — death while swimming;
* `corpse_drop` and `corpse_drag` — corpse drop and dragging during death;
* `default_dying` — a special request made once, with its result stored.\
  This request should return a death animation to be played if no other is found.\
  It ensures there are no standing dead soldiers after loading.

## Death animation selection

After a death animation request is chosen (from the list above), the `if`-block conditionals check different death circumstances.

#### Possible checks:

* Death circumstance flags — `human_kill_flags`
* Terrain type — `terrain_pp`
* Equipment at time of death — `human_stuff`

One of the **kill flag** checks is the direction check: `front` or `back`.\
If an obstacle prevents the animation from playing, selection proceeds as follows:

1. Use the correct direction specified in the `human_kill_flags` parameter.
2. Swap the direction flags (`front` ↔ `back`).
3. Use a variant without direction flags — intended for cases where the soldier falls in place and collides with the obstacle.

The main animation assignment method is [random selection](https://docs.bestway.com.ua/animation/animation-system-for-actor/animation-selection-setup/pages/Ap4atTpYWVJYwkRJyI8L#id-2.-random-animation-selection) by weight from the specified animation list.

<details>

<summary>Example: death animation selection by kill flags (no direction)</summary>

```
{stand_dying
    ...
    {if human_kill_flags "cover_in_trench"
        {random_select
            {weight 1 "stand_die_trench_1"}
            {weight 1 "stand_die_trench_2"}
            {weight 1 "stand_die_trench_3"}
        }
    }
    [...]
}
```

</details>

<details>

<summary>Example: death animation selection with kill flags (<code>front</code>/<code>back</code>)</summary>

```
{squat_dying 
    {if human_kill_flags "front" 
        {if human_kill_flags "blast" 
            {random_select 
                {weight 1 "death_from_explosion_front"} 
                {weight 1 "death_from_explosion_front02"}
                {weight 0.5 "stand_die_back_5_blast"} 
                {weight 1 "stand_die-force_back_1"} 
                {weight 1 "stand_die-force_back_2_far"} 
                {weight 1 "stand_die-force_back_3_far"} 
            } 
        } 
        {random_select 
            {weight 1 "squat_die"} 
            {weight 1 "squat_die_back_1"} 
            {weight 1 "squat_die_back_2"} 
            {weight 1 "squat_die_force-back"} 
        }
    } 
    {if human_kill_flags "back" 
        {if human_kill_flags "blast" 
            {random_select 
                {weight 1 "death_from_explosion_back"} 
                {weight 1 "death_from_explosion_back02"} 
                {weight 0.5 "stand_die_front_1_blast"} 
                {weight 1 "stand_die-force_front_1"} 
                {weight 1 "stand_die-force_front_2"} 
                {weight 1 "stand_die-force_front_3_far"} 
                {weight 1 "stand_die-force_front_4_far"} 
            } 
        }
    }
    [...]
}
```

</details>

## Post-death behavior of the human actor

After death, the engine places the corpse on the surface.\
To ensure that the body remains in the same position after the death animation finishes (e.g., death in a trench), the animation settings use the property:

```c
{props "dont_update_placement_after_death"}
```

This property can be defined in `properties\animation\human\`**`human_anm.ext`**

or in any animation settings list.

<details>

<summary>Example: death animation configuration in <code>human.ext</code></summary>

```
{sequence "stand_die_trench_1" 
    {speed 0.9} 
    {props "dont_update_placement_after_death"} 
    [...]
}
{sequence "stand_die_trench_2" {speed 0.9} {props "dont_update_placement_after_death"} [...]}
{sequence "stand_die_trench_3" {speed 1.2} {props "dont_update_placement_after_death"} [...]}
```

</details>