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

# Référence publique

> Index des convars, commandes, exports, événements, fournisseurs et actions stables.

Cette page est un index compact. Suivez les guides liés pour les contrats de
callback, les exemples et les recommandations d'exploitation.

## Convars

| Domaine             | Paramètres publics                                                                                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Requis              | `humalike_license_key`                                                                                                                                                          |
| Diagnostics         | `humalike_debug`                                                                                                                                                                |
| Fournisseurs        | `humalike_player`, `humalike_inventory`, `humalike_dispatch`, `humalike_actions`, `humalike_interaction`                                                                        |
| Interface           | `humalike_ui_language`                                                                                                                                                          |
| Libellés            | `humalike_npc_labels_*`                                                                                                                                                         |
| Gameplay médical    | `humalike_npc_wounded_*`, `humalike_npc_death_chance`, `humalike_npc_revive_*`, `humalike_npc_mortuary_*`, `humalike_npc_treatment_distance`, `humalike_npc_deceased_retention` |
| Métiers et dispatch | `humalike_npc_medic_jobs`, `humalike_npc_police_jobs`, `humalike_npc_medical_dispatch*`                                                                                         |
| Blessures           | `humalike_npc_wounds_enabled`, `humalike_npc_wound_*`, `humalike_npc_max_wounds`                                                                                                |
| Poses               | `humalike_npc_pose_abandon_*`, `humalike_npc_pose_threat_*`                                                                                                                     |
| Réglage du monde    | `humalike_world_*` listées dans [Configuration](/fr/ai-npc/configuration#réglage-avancé-du-monde)                                                                               |

Les convars non documentées d'endpoint, de secret d'exécution et d'autorité ne
constituent pas une interface client prise en charge.

## Commandes

| Côté           | Commande             | Rôle                                                                             |
| -------------- | -------------------- | -------------------------------------------------------------------------------- |
| Serveur        | `humalike_status`    | État de l'exécution et des fournisseurs.                                         |
| Client         | `humalike_status`    | État du fournisseur d'interaction et réception ou non des paramètres du serveur. |
| Serveur/joueur | `humalikenpc:status` | État du registre de PNJ.                                                         |
| Serveur/joueur | `humalikenpc:reload` | Demander un rafraîchissement immédiat du registre.                               |
| Client         | `/voice`             | État de la connexion vocale locale.                                              |

Les outils d'apparition ambiante réservés aux développeurs sont désactivés par
défaut. Pour les utiliser sur un serveur de test hors production, définissez
`humalike_developer_tools 1` et accordez l'ACE `humalike.developer_tools`. La
commande est :

```text theme={null}
/humalike_dev ambient <spawn|goto|remove|list> [npc_uuid]
/humalike_dev observe <npc_uuid> <key> [field=value ...]
```

Les apparitions de débogage sont temporaires et ne remplacent pas le placement
des PNJ géré par le tableau de bord.

## Exports serveur

```lua theme={null}
exports.humalike:RegisterProvider(domain, descriptor)
exports.humalike:UnregisterProvider(domain, name)
exports.humalike:GetProviderStatus()
exports.humalike:ReportPlayerEvent(playerId, event)
exports.humalike:ReportObservation(npcId, playerId, key, fields, options)
exports.humalike:SetNpcStock(npcId, stock)
exports.humalike:PlaceOrder(npcId, playerId, lines)
exports.humalike:BindNpcEntity(npcId, networkId, options)
exports.humalike:UnbindNpcEntity(bindingId)
exports.humalike:DespawnNpc(npcId)
exports.humalike:RespawnNpc(npcId)
exports.humalike:AcquireNpcControl(npcId, options)
exports.humalike:RenewNpcControl(leaseId, ttlMs)
exports.humalike:ReleaseNpcControl(leaseId)
exports.humalike:GetNpcRuntimeState(npcId)
exports.humalike:ListNpcRuntimeStates()
```

Voir [API des fournisseurs](/fr/ai-npc/integrations/provider-api),
[Signaler des événements joueur](/fr/ai-npc/integrations/world-events),
[Actions définies par le serveur](/fr/ai-npc/integrations/custom-actions) et
[PNJ externes](/fr/ai-npc/integrations/external-npcs) et
[Contrôle d'exécution](/fr/ai-npc/integrations/runtime-control).

## Exports client

```lua theme={null}
exports.humalike:RegisterInteractionProvider(descriptor)
exports.humalike:UnregisterInteractionProvider(name)
exports.humalike:GetInteractionProviderStatus()
exports.humalike:SetVoiceBusy(reason, active)
```

## Événements

| Côté              | Événement                            | Charge utile                   |
| ----------------- | ------------------------------------ | ------------------------------ |
| Serveur et client | `humalike:integration:ready`         | `{ apiVersion, runtimeEpoch }` |
| Serveur           | `humalike:npc:ready`                 | `{ apiVersion, generation }`   |
| Client            | `humalike:voice:transmittingChanged` | `active: boolean`              |

## Noms des fournisseurs intégrés

* Joueur : `standalone`, `esx`, `qbcore`, `qbox`.
* Inventaire : `esx`, `ox_inventory`, `qb_inventory`.
* Interaction : `builtin`, `ox_target`, `qb_target`.

## Clés d'action intégrées

`wave`, `start_dancing`, `interrupt_animation`, `kneel`, `hands_up`, `punch`,
`stand_up`, `follow_player`, `stop_following`, `hold_position`,
`release_movement`, `enter_vehicle`, `enter_own_vehicle`, `exit_vehicle`, `walk_away`
et `run_away`.

`give_item` est ajoutée lorsqu'un fournisseur d'inventaire est disponible. Le
fournisseur d'actions personnalisé sélectionné peut annoncer des clés
supplémentaires.

## Types d'événements joueur neutres

`rp_action`, `identity_document_shown`, `item_dropped`, `item_picked_up`,
`police_badge_shown`, `ems_badge_shown`, `doj_badge_shown`, `hands_raised` et
`hands_lowered`.

## Suite

* [Lire les contrats complets des fournisseurs](/fr/ai-npc/integrations/provider-api).
* [Voir des exemples de charges utiles d'événements](/fr/ai-npc/integrations/world-events).
* [Diagnostiquer un serveur en cours d'exécution](/fr/ai-npc/operations).