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

# Exploitation et dépannage

> Vérifiez l'état de l'exécution et résolvez les problèmes courants d'installation, de PNJ, de voix et de fournisseurs.

Commencez par les commandes d'état. Elles exposent l'état opérationnel pris en
charge sans nécessiter de journaux détaillés.

## Commandes d'état

Exécutez dans la console du serveur :

```text theme={null}
humalike_status
humalikenpc:status
```

`humalike_status` rapporte l'amorçage des identifiants et les domaines de
fournisseurs `player`, `inventory`, `dispatch` et `actions`. `humalikenpc:status`
rapporte le fournisseur joueur sélectionné, la taille du registre et la dernière
synchronisation du registre.

Exécutez `humalike_status` dans la console F8 du client pour inspecter le
fournisseur d'interaction ; la commande affiche aussi d'où vient le paramètre
d'interaction : `server` (défini dans server.cfg et reçu), `default` (les
paramètres du serveur sont arrivés et le laissent sur `auto`) ou `local` (pas
encore reçu). Exécutez `/voice` pour inspecter la connexion vocale locale.

`humalikenpc:reload` demande un rafraîchissement immédiat du registre. Les
commandes serveur et client sont restreintes par ACE là où les permissions de
commandes FiveM s'appliquent.

## États des fournisseurs

| État          | Signification                                                | Action                                               |
| ------------- | ------------------------------------------------------------ | ---------------------------------------------------- |
| `selected`    | Un fournisseur disponible est actif.                         | Aucune.                                              |
| `disabled`    | Le domaine est configuré sur `none`.                         | Ne l'activez que si la fonctionnalité est requise.   |
| `unavailable` | Aucun fournisseur ne correspond au paramètre.                | Démarrez sa dépendance ou corrigez le nom configuré. |
| `ambiguous`   | Les meilleurs fournisseurs disponibles ont la même priorité. | Sélectionnez-en un explicitement.                    |
| `degraded`    | Un callback du fournisseur sélectionné a échoué.             | Inspectez ce pont ou cette dépendance.               |

## Journalisation de débogage temporaire

```cfg theme={null}
set humalike_debug 1
```

Redémarrez la ressource, reproduisez un seul problème, collectez les lignes
pertinentes, puis remettez la valeur à `0`. Le mode débogage est volontairement
verbeux et ne doit pas rester activé sur un serveur de production chargé.

Retirez les identifiants et les URL de connexion signées avant de partager des
journaux.

## La ressource ne devient pas prête

Vérifiez, dans l'ordre :

1. `humalike_license_key` utilise `set`, contient la licence serveur actuelle et
   apparaît avant `ensure humalike`.
2. L'URL de callback enregistrée contient l'adresse IPv4 publique littérale
   globalement routable de ce FXServer.
3. Le trafic TCP entrant atteint ce port.
4. L'enregistrement du serveur est activé.
5. La build FXServer est récente et OneSync est activé.

Ne renouvelez la licence que si elle est perdue ou exposée ; le renouvellement
invalide immédiatement l'ancienne valeur.

## Un PNJ est manquant

* Confirmez que l'état du serveur est prêt et que le nombre d'entrées du registre n'est pas nul.
* Confirmez que le PNJ et le serveur sont activés dans le tableau de bord.
* Pour les PNJ statiques, vérifiez le modèle, les coordonnées, l'orientation, le
  routing bucket et la géométrie de la carte.
* Pour les PNJ ambiants, vérifiez que la politique ambiante est activée et que
  les joueurs se trouvent dans une zone avec de la fréquentation piétonne (une
  chaîne de montagnes ou la haute mer n'a personne).
* Exécutez `humalikenpc:reload` une fois au lieu de redémarrer le serveur à répétition.

## Le PNJ ne répond pas

* Vérifiez le microphone du joueur et la touche PTT Humalike.
* Utilisez `/voice` et vérifiez que le PNJ visé n'est pas en sourdine pour ce joueur.
* Approchez-vous et faites face au PNJ pour une conversation directe.
* Vérifiez les [tours de PNJ](/fr/npc-turns) disponibles du serveur.
* Confirmez que le PNJ a une voix et qu'il est activé.

Un PNJ peut aussi choisir de ne pas parler selon son personnage et la
conversation en cours. Testez plusieurs énoncés clairs avant de traiter le
silence comme une panne de connexion.

## `/me` ou `/do` est ignoré

L'intégration intégrée dépend de l'événement de roleplay pris en charge par le
framework. Une ressource de chat personnalisée peut afficher la commande sans
publier cet événement. Dans ce cas, appelez `ReportPlayerEvent` depuis le
gestionnaire serveur de la ressource de chat. Voir
[Signaler des événements joueur](/fr/ai-npc/integrations/world-events).

## L'action d'inventaire est indisponible

Exécutez `humalike_status` et vérifiez le domaine `inventory`. `give_item` n'est
annoncée que tant qu'un fournisseur d'inventaire est sélectionné. Résolvez un
fournisseur indisponible ou ambigu, puis laissez Humalike rafraîchir ses
capacités.

## Erreurs de callback NUI ou d'assets après une mise à jour

Les releases mélangées en sont la cause habituelle. Arrêtez Humalike, remplacez
l'intégralité du répertoire de la ressource par le contenu d'un seul
`humalike.zip`, puis redémarrez-la. Ne superposez pas les releases et ne copiez
pas uniquement les fichiers web compilés.

## Signaler un bug

Indiquez la version de la release Humalike, la version de l'artefact FXServer,
l'état du framework et des fournisseurs, les étapes de reproduction exactes et
des journaux nettoyés. Signalez les problèmes de sécurité via le
[signalement privé de vulnérabilités](https://github.com/Humalike/humalike-fivem-npc/security/advisories/new).

## Suite

* [Consulter les commandes et exports publics](/fr/ai-npc/reference).
* [Passer en revue les recommandations de sécurité](/fr/ai-npc/security).
* [Ouvrir le tableau de bord PNJ IA](https://humalike.ai/ai-npc).