Skip to main content
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 :
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

​
Journalisation de débogage temporaire

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

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

​
Suite