> ## 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

> Configurez la sélection des fournisseurs, les libellés, les blessures et le comportement avancé du monde.

Humalike utilise des convars FXServer définies avec `set`. La ressource envoie
aux joueurs les valeurs dont leur jeu a besoin lorsqu'ils se connectent ; aucun
paramètre documenté ne nécessite donc `setr`, mais un `setr` existant continue
de fonctionner. Gardez la licence uniquement derrière `set`.

Les paramètres sont lus au démarrage de la ressource : après en avoir modifié
un, exécutez `restart humalike`. Les deux exceptions, `humalike_population_cops`
et `humalike_npc_vehicles`, sont relues toutes les quelques secondes.

## Configuration minimale

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

ensure humalike
```

La licence est le seul identifiant que vous configurez. Les identifiants
d'exécution et vocaux sont obtenus automatiquement.

## Sélection des intégrations

Les domaines de fournisseurs sont indépendants :

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

Chaque valeur accepte :

* `auto` — sélectionne l'unique fournisseur disponible de plus haute priorité.
* Un nom de fournisseur — exige ce fournisseur.
* `none` — désactive le domaine.

Si des fournisseurs de rang égal entrent en conflit, `auto` signale `ambiguous`
au lieu de deviner. Sélectionnez explicitement le fournisseur voulu.

## Langue de l'interface

```cfg theme={null}
set humalike_ui_language en
```

| Paramètre              | Défaut | Description                                                                                                             |
| ---------------------- | -----: | ----------------------------------------------------------------------------------------------------------------------- |
| `humalike_ui_language` |   `en` | Langue des textes que Humalike affiche lui-même aux joueurs : le panneau `/voice` et ses propres invites. `en` ou `pl`. |

Les libellés de réanimation, de morgue et de blessure se traduisent un par un via
leurs propres convars ci-dessous.

## Libellés des PNJ

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

| Paramètre                                   |  Défaut | Description                                                                                                                          |
| ------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------ |
| `humalike_npc_labels_enabled`               |  `true` | Afficher le libellé canvas au-dessus des PNJ IA.                                                                                     |
| `humalike_npc_labels_distance`              |  `14.0` | Distance de rendu maximale en mètres.                                                                                                |
| `humalike_npc_labels_height`                |  `0.98` | Placement vertical par rapport au ped.                                                                                               |
| `humalike_npc_labels_scale`                 |   `1.0` | Multiplicateur d'échelle du libellé.                                                                                                 |
| `humalike_npc_labels_default_language`      |    `en` | La langue que parlent la plupart des PNJ. Un PNJ parlant une autre langue reçoit un drapeau (ou son code de langue) sur son libellé. |
| `humalike_npc_labels_show_default_language` | `false` | Inclure le marqueur de langue pour la langue par défaut.                                                                             |

## Population ambiante

```cfg theme={null}
set humalike_population_cops false
set humalike_npc_vehicles true
```

| Paramètre                  |  Défaut | Description                                                                                                                                                                                                                                                                                          |
| -------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `humalike_population_cops` | `false` | Garder la police aléatoire de GTA active pendant que Humalike possède la population de rue (voir [PNJ ambiants](/fr/ai-npc/ambient-npcs)) ; relue toutes les quelques secondes, elle peut donc être basculée à chaud. Tout le reste — limites, rayons, figurants — se règle dans le tableau de bord. |
| `humalike_npc_vehicles`    |  `true` | Permettre aux personnages dynamiques d'apparaître au volant d'une voiture ou sur une moto et de circuler comme le trafic (voir [Conducteurs](/fr/ai-npc/ambient-npcs#conducteurs)). Relue toutes les quelques secondes ; `false` fait apparaître chaque personnage à pied et jamais de véhicule.     |

## Gameplay des blessés et médical

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

| Paramètre                           |          Défaut | Description                                                                      |
| ----------------------------------- | --------------: | -------------------------------------------------------------------------------- |
| `humalike_npc_wounded_enabled`      |          `true` | Activer le flux blessé/mort.                                                     |
| `humalike_npc_wounded_duration`     |        `300000` | Fenêtre de l'état blessé en millisecondes.                                       |
| `humalike_npc_death_chance`         |             `5` | Pourcentage de chance qu'une blessure soit fatale.                               |
| `humalike_npc_revive_linger`        |         `30000` | Durée pendant laquelle le PNJ réanimé reste protégé du nettoyage.                |
| `humalike_npc_revive_linger_radius` |            `20` | Rayon de maintien en mètres.                                                     |
| `humalike_npc_medic_jobs`           | `ambulance,ems` | Métiers autorisés à soigner les PNJ, séparés par des virgules.                   |
| `humalike_npc_police_jobs`          |        `police` | Métiers autorisés à prendre en charge les PNJ décédés, séparés par des virgules. |
| `humalike_npc_wounded_require_duty` |          `true` | Exiger que le métier correspondant soit en service.                              |
| `humalike_npc_revive_duration`      |         `10000` | Durée de la progression du traitement en millisecondes.                          |
| `humalike_npc_mortuary_duration`    |          `5000` | Durée de l'interaction morgue en millisecondes.                                  |
| `humalike_npc_treatment_distance`   |           `6.0` | Distance de validation côté serveur en mètres.                                   |
| `humalike_npc_deceased_retention`   |        `900000` | Durée de conservation d'un PNJ décédé en millisecondes.                          |

Les interactions de traitement affichent ces textes :

| Paramètre                        | Défaut              |
| -------------------------------- | ------------------- |
| `humalike_npc_revive_label`      | `Revive`            |
| `humalike_npc_revive_progress`   | `Treating patient`  |
| `humalike_npc_mortuary_label`    | `Send to mortuary`  |
| `humalike_npc_mortuary_progress` | `Securing the body` |

### Métiers sans framework

ESX, QBCore et Qbox répondent aux vérifications de métier depuis le framework,
et un fournisseur joueur personnalisé y répond avec son propre `HasJob`. Seul le
fournisseur joueur `standalone` lit les ACE : un métier est alors une
autorisation accordée au joueur ou à son groupe, et une autorisation compte
comme en service :

```cfg theme={null}
add_ace group.ems humalike.job.ambulance allow
add_ace group.police humalike.job.police allow
add_principal identifier.license:0123456789abcdef group.ems
```

Définissez `humalike_npc_medic_jobs` sur une chaîne vide pour laisser chaque
joueur soigner les PNJ blessés.

## Dispatch médical

| Paramètre                                |  Défaut | Description                                               |
| ---------------------------------------- | ------: | --------------------------------------------------------- |
| `humalike_npc_medical_dispatch`          |  `true` | Autoriser les signalements au dispatch médical.           |
| `humalike_npc_medical_dispatch_chance`   |   `100` | Pourcentage de chance de signaler un incident éligible.   |
| `humalike_npc_medical_dispatch_delay`    | `10000` | Délai avant signalement, en millisecondes.                |
| `humalike_npc_medical_dispatch_throttle` |    `30` | Intervalle minimal entre deux signalements, en secondes.  |
| `humalike_npc_mortuary_dispatch`         |  `true` | Notifier le dispatch de la prise en charge par la morgue. |

Les paramètres de dispatch n'ont d'effet externe que lorsqu'un fournisseur de
dispatch est sélectionné.

## Affichage des blessures

| Paramètre                             |  Défaut | Description                                                             |
| ------------------------------------- | ------: | ----------------------------------------------------------------------- |
| `humalike_npc_wounds_enabled`         |  `true` | Suivre les blessures structurées.                                       |
| `humalike_npc_wound_display`          |  `true` | Autoriser l'affichage de la fiche de blessures.                         |
| `humalike_npc_wound_display_distance` |   `3.0` | Distance d'inspection maximale.                                         |
| `humalike_npc_wound_display_height`   |   `0.0` | Décalage vertical de la fiche de blessures au-dessus du ped, en mètres. |
| `humalike_npc_wound_screen_offset`    | `0.075` | Décalage à l'écran de la fiche de blessures.                            |
| `humalike_npc_max_wounds`             |     `6` | Nombre maximal d'entrées de blessures affichées.                        |
| `humalike_npc_wound_min_damage`       |     `5` | Dégâts minimaux pris en compte pour un signalement de blessure.         |

Les textes de la fiche de blessures, chacun avec son propre paramètre :

| Paramètre                              | Défaut                |
| -------------------------------------- | --------------------- |
| `humalike_npc_wound_title`             | `Injuries`            |
| `humalike_npc_wound_none`              | `No visible injuries` |
| `humalike_npc_wound_deceased`          | `Deceased`            |
| `humalike_npc_wound_region_head`       | `Head`                |
| `humalike_npc_wound_region_torso`      | `Torso`               |
| `humalike_npc_wound_region_left_arm`   | `Left arm`            |
| `humalike_npc_wound_region_right_arm`  | `Right arm`           |
| `humalike_npc_wound_region_left_leg`   | `Left leg`            |
| `humalike_npc_wound_region_right_leg`  | `Right leg`           |
| `humalike_npc_wound_kind_gunshot`      | `Gunshot wound`       |
| `humalike_npc_wound_kind_stab`         | `Stab wound`          |
| `humalike_npc_wound_kind_blunt`        | `Blunt trauma`        |
| `humalike_npc_wound_kind_burn`         | `Burn`                |
| `humalike_npc_wound_kind_explosion`    | `Blast injury`        |
| `humalike_npc_wound_kind_fall`         | `Fall injury`         |
| `humalike_npc_wound_kind_vehicle`      | `Vehicle impact`      |
| `humalike_npc_wound_severity_minor`    | `minor`               |
| `humalike_npc_wound_severity_serious`  | `serious`             |
| `humalike_npc_wound_severity_critical` | `critical`            |

## Comportement des poses

| Paramètre                           |   Défaut | Description                                                         |
| ----------------------------------- | -------: | ------------------------------------------------------------------- |
| `humalike_npc_pose_abandon_ms`      | `120000` | Relâcher une pose maintenue après ce délai sans joueur à proximité. |
| `humalike_npc_pose_abandon_radius`  |     `60` | Rayon de proximité des joueurs utilisé par le nettoyage des poses.  |
| `humalike_npc_pose_threat_watch`    |   `true` | Laisser les menaces interrompre les poses prolongées.               |
| `humalike_npc_pose_threat_radius`   |     `30` | Rayon d'observation des menaces en mètres.                          |
| `humalike_npc_pose_threat_clear_ms` |  `10000` | Délai avant qu'un état de menace se dissipe.                        |

## Réglage avancé du monde

Les convars `humalike_world_*` contrôlent la collecte, le regroupement, les
instantanés et le signalement des PNJ. Leurs valeurs par défaut sont conçues
pour des serveurs normaux. Ne les modifiez que pour diagnostiquer un problème
mesuré ; des intervalles plus courts augmentent la charge client, serveur et
réseau.

| Paramètre                                   |  Défaut | Description                                                              |
| ------------------------------------------- | ------: | ------------------------------------------------------------------------ |
| `humalike_world_tick_ms`                    |    `20` | Tick de planification du collecteur.                                     |
| `humalike_world_moving_interval_ms`         |   `100` | Intervalle de mise à jour du joueur en mouvement.                        |
| `humalike_world_idle_interval_ms`           |  `1000` | Intervalle de mise à jour du joueur à l'arrêt.                           |
| `humalike_world_listener_interval_ms`       |    `33` | Intervalle de mise à jour de l'auditeur local.                           |
| `humalike_world_npc_edge_enabled`           |     `1` | Activer le streaming du monde des PNJ.                                   |
| `humalike_world_npc_edge_interval_ms`       |   `200` | Intervalle des trames PNJ.                                               |
| `humalike_world_npc_edge_ticket_retry_ms`   |  `3000` | Intervalle de nouvelle tentative après l'échec d'un ticket edge PNJ.     |
| `humalike_world_npc_edge_ticket_refresh_ms` | `12000` | Intervalle de rafraîchissement du ticket edge PNJ.                       |
| `humalike_world_npc_report_radius`          |   `150` | Rayon de signalement des PNJ en mètres.                                  |
| `humalike_world_npc_max_per_frame`          |    `32` | PNJ par trame, borné à `1`–`32`.                                         |
| `humalike_world_voice_enabled`              |     `1` | Activer les mises à jour vocales du monde.                               |
| `humalike_world_voice_delta_batch_ms`       |   `100` | Intervalle de regroupement des deltas vocaux.                            |
| `humalike_world_voice_snapshot_ms`          | `60000` | Intervalle des instantanés vocaux complets.                              |
| `humalike_world_cabin_voice_enabled`        |     `1` | Activer le routage de l'habitacle des véhicules.                         |
| `humalike_world_cabin_start_delay_ms`       |  `1000` | Délai avant le démarrage du routage d'habitacle, au moins `0`.           |
| `humalike_world_cabin_retry_ms`             |  `2000` | Intervalle de nouvelle tentative du routage d'habitacle, au moins `500`. |
| `humalike_world_cabin_snapshot_ms`          | `30000` | Intervalle des instantanés complets d'habitacle, au moins `5000`.        |
| `humalike_world_snapshot_interval_ms`       | `60000` | Intervalle des instantanés d'autorité du serveur.                        |

<Warning>
  Ne configurez pas de convars non documentées d'endpoint, d'autorité ou de
  secret vocal. Elles sont gérées par l'exécution publiée et ne font pas partie
  de la surface de configuration client prise en charge.
</Warning>

## Suite

* [Sélectionner un framework](/fr/ai-npc/frameworks).
* [Configurer les systèmes de gameplay](/fr/ai-npc/gameplay).
* [Consulter toutes les interfaces publiques](/fr/ai-npc/reference).
