> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humalike.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Configure provider selection, labels, injuries, and advanced world behavior.

HumaLike uses FXServer convars. Put server-only values behind `set`; use `setr`
only for documented settings that must be visible to clients.

## Minimal configuration

```cfg theme={null}
set humalike_license_key "ak_secret_replace_me"
setr humalike_debug 0

ensure humalike
```

The license is the only credential you configure. Runtime and voice credentials
are obtained automatically.

## Integration selection

Provider domains are independent:

```cfg theme={null}
set humalike_player auto
set humalike_inventory auto
set humalike_dispatch auto
set humalike_actions auto
setr humalike_interaction auto
```

Each value accepts:

* `auto` — select the single highest-priority available provider.
* A provider name — require that provider.
* `none` — disable the domain.

If equally ranked providers conflict, `auto` reports `ambiguous` instead of
guessing. Explicitly select the intended provider.

## NPC labels

```cfg theme={null}
setr humalike_npc_labels_enabled true
setr humalike_npc_labels_distance 14.0
setr humalike_npc_labels_height 0.98
setr humalike_npc_labels_scale 1.0
setr humalike_npc_labels_default_language pl
setr humalike_npc_labels_show_default_language false
```

| Setting                                     | Default | Description                                           |
| ------------------------------------------- | ------: | ----------------------------------------------------- |
| `humalike_npc_labels_enabled`               |  `true` | Show the canvas label above AI NPCs.                  |
| `humalike_npc_labels_distance`              |  `14.0` | Maximum render distance in metres.                    |
| `humalike_npc_labels_height`                |  `0.98` | Vertical placement relative to the ped.               |
| `humalike_npc_labels_scale`                 |   `1.0` | Label scale multiplier.                               |
| `humalike_npc_labels_default_language`      |    `pl` | Language treated as the server default.               |
| `humalike_npc_labels_show_default_language` | `false` | Include the language marker for the default language. |

## Wounded and medical gameplay

```cfg theme={null}
setr humalike_npc_wounded_enabled true
setr humalike_npc_wounded_duration 300000
setr humalike_npc_death_chance 5
setr humalike_npc_medic_jobs "ambulance,ems"
setr humalike_npc_police_jobs "police"
setr humalike_npc_wounded_require_duty true
setr humalike_npc_medical_dispatch true
```

| Setting                             |         Default | Description                                           |
| ----------------------------------- | --------------: | ----------------------------------------------------- |
| `humalike_npc_wounded_enabled`      |          `true` | Enable the wounded/death flow.                        |
| `humalike_npc_wounded_duration`     |        `300000` | Wounded window in milliseconds.                       |
| `humalike_npc_death_chance`         |             `5` | Percent chance that a wound becomes fatal.            |
| `humalike_npc_revive_linger`        |         `30000` | Time the revived NPC remains protected from cleanup.  |
| `humalike_npc_revive_linger_radius` |            `20` | Linger radius in metres.                              |
| `humalike_npc_medic_jobs`           | `ambulance,ems` | Comma-separated jobs allowed to treat NPCs.           |
| `humalike_npc_police_jobs`          |        `police` | Comma-separated jobs allowed to handle deceased NPCs. |
| `humalike_npc_wounded_require_duty` |          `true` | Require the matching job to be on duty.               |
| `humalike_npc_revive_duration`      |         `10000` | Treatment progress duration in milliseconds.          |
| `humalike_npc_mortuary_duration`    |          `5000` | Mortuary interaction duration in milliseconds.        |
| `humalike_npc_treatment_distance`   |           `6.0` | Server validation distance in metres.                 |
| `humalike_npc_deceased_retention`   |        `900000` | Time to retain a deceased NPC in milliseconds.        |

Labels can be translated with `humalike_npc_revive_label`,
`humalike_npc_revive_progress`, `humalike_npc_mortuary_label`, and
`humalike_npc_mortuary_progress`.

## Medical dispatch

| Setting                                  | Default | Description                                    |
| ---------------------------------------- | ------: | ---------------------------------------------- |
| `humalike_npc_medical_dispatch`          |  `true` | Allow medical dispatch reports.                |
| `humalike_npc_medical_dispatch_chance`   |   `100` | Percent chance to report an eligible incident. |
| `humalike_npc_medical_dispatch_delay`    | `10000` | Delay before reporting, in milliseconds.       |
| `humalike_npc_medical_dispatch_throttle` |    `30` | Minimum interval between reports, in seconds.  |
| `humalike_npc_mortuary_dispatch`         |  `true` | Notify dispatch about mortuary handling.       |

Dispatch settings only have an external effect when a dispatch provider is
selected.

## Wound display

| Setting                               | Default | Description                             |
| ------------------------------------- | ------: | --------------------------------------- |
| `humalike_npc_wounds_enabled`         |  `true` | Track structured wounds.                |
| `humalike_npc_wound_display`          |  `true` | Allow the wound card to be shown.       |
| `humalike_npc_wound_display_distance` |   `3.0` | Maximum inspection distance.            |
| `humalike_npc_max_wounds`             |     `6` | Maximum displayed wound entries.        |
| `humalike_npc_wound_min_damage`       |     `5` | Minimum damage used for a wound report. |

The wound title, empty/deceased labels, body regions, injury kinds, and severity
labels also have `humalike_npc_wound_*` localization convars. Copy the defaults
from the release configuration before translating them.

## Pose behavior

| Setting                             |  Default | Description                                                 |
| ----------------------------------- | -------: | ----------------------------------------------------------- |
| `humalike_npc_pose_abandon_ms`      | `120000` | Release a held pose after this time without nearby players. |
| `humalike_npc_pose_abandon_radius`  |     `60` | Nearby-player radius used by pose cleanup.                  |
| `humalike_npc_pose_threat_watch`    |   `true` | Let threats interrupt sustained poses.                      |
| `humalike_npc_pose_threat_radius`   |     `30` | Threat observation radius in metres.                        |
| `humalike_npc_pose_threat_clear_ms` |  `60000` | Time before a threat state clears.                          |

## Advanced world tuning

The `humalike_world_*` convars control collection, batching, snapshots, and NPC
reporting. Their defaults are designed for normal servers. Change them only to
diagnose a measured issue; shorter intervals increase client, server, and
network work.

| Setting                               | Default | Description                          |
| ------------------------------------- | ------: | ------------------------------------ |
| `humalike_world_tick_ms`              |    `20` | Collector scheduling tick.           |
| `humalike_world_moving_interval_ms`   |   `100` | Player update interval while moving. |
| `humalike_world_idle_interval_ms`     |  `1000` | Player update interval while idle.   |
| `humalike_world_listener_interval_ms` |    `33` | Local listener update interval.      |
| `humalike_world_npc_edge_enabled`     |     `1` | Enable NPC world streaming.          |
| `humalike_world_npc_edge_interval_ms` |   `200` | NPC frame interval.                  |
| `humalike_world_npc_report_radius`    |   `150` | NPC report radius in metres.         |
| `humalike_world_npc_max_per_frame`    |    `32` | NPCs per frame, clamped to `1`–`32`. |
| `humalike_world_voice_enabled`        |     `1` | Enable voice world updates.          |
| `humalike_world_voice_delta_batch_ms` |   `100` | Voice delta batch interval.          |
| `humalike_world_voice_snapshot_ms`    | `60000` | Full voice snapshot interval.        |
| `humalike_world_cabin_voice_enabled`  |     `1` | Enable vehicle cabin routing.        |

<Warning>
  Do not configure undocumented endpoint, authority, or voice-secret convars.
  They are managed by the released runtime and are not part of the supported
  customer configuration surface.
</Warning>

## Next

* [Select a framework](/ai-npc/frameworks).
* [Configure gameplay systems](/ai-npc/gameplay).
* [Look up every public interface](/ai-npc/reference).