Dépannage

L'outil ne s'ouvre pas

L'ouverture exécute un pipeline de vérification complet. Si un contrôle échoue, vous recevez une notification expliquant pourquoi. Résolvez les points suivants :

• Permission — si Config.Permission.Enabled = true, confirmez que le joueur y a accès. Pour Type = 'ace', assurez-vous que l'ACE (animpos.use) est accordé avec add_ace. Pour Type = 'job', assurez-vous que le métier du joueur se trouve dans Config.Permission.Jobs.
• Restriction d'état — vous êtes bloqué si vous êtes dans un véhicule, en train de tomber/en parachute, en train de nager (si activé), mort, dans le dernier sursaut ou menotté. La notification vous indique quel état pose problème. Ajustez le drapeau Config.Restrictions correspondant si ce blocage n'est pas souhaité.
• Délai de récupération — après chaque utilisation, il y a un temps d'attente Config.Cooldown (par défaut 15 s). "Trop rapide ! Veuillez patienter un moment." signifie que le délai est toujours actif.
• Hook CanUse — un Config.CanUse personnalisé renvoyant false bloquera l'ouverture. Vérifiez la logique personnalisée à cet endroit.

Aucune notification n'apparaît

C'est presque toujours une incompatibilité de backend. Config.Notify doit correspondre à un système de notification qui est réellement en cours d'exécution :

• ox_lib — nécessite qu'ox_lib soit démarré (la console avertit s'il est défini sur ox_lib mais qu'ox_lib ne tourne pas).
• qbcore — nécessite QB-Core et son événement QBCore:Notify.
• esx — nécessite ESX et son événement esx:showNotification.
• custom — nécessite un gestionnaire fonctionnel dans Config.CustomNotify.

Une valeur invalide bascule par défaut sur ox_lib et enregistre un avertissement dans la console.

Le raccourci clavier ne fait rien

• Confirmez que Config.Keybind.Enabled = true et que Config.Keybind.Default n'est pas vide — l'association de touches n'est enregistrée que lorsque les deux sont définis.
• L'association de touches est enregistrée au démarrage de la ressource ; si vous avez modifié la configuration, redémarrez la ressource.
• Vérifiez que le joueur n'a pas réattribué (ou effacé) la touche dans Paramètres → Raccourcis clavier → FiveM. La commande /animpos fonctionne toujours, peu importe le raccourci clavier.

Le texte est dans la mauvaise langue / en anglais

• Définissez setr ox:locale "<code>" dans server.cfg (utilisez setr pour que cela se réplique sur les clients).
• Utilisez un code pris en charge : en, tr, de, fr, es, pt, ru.
• Une clé de traduction manquante bascule par défaut sur l'anglais — vérifiez que votre fichier de langue contient cette clé avec exactement le même nom que dans en.json.

Les fonctionnalités du framework ne fonctionnent pas / ne sont pas détectées

• Définissez Config.Framework pour qu'il corresponde exactement à votre serveur (qbox, qbcore, esx ou standalone). Une valeur invalide enregistre un avertissement dans la console.
• Les restrictions de mort / dernier sursaut / menottes ne fonctionnent que sur qbox et qbcore. Sur esx et standalone, ces vérifications de métadonnées sont ignorées par conception — seules les restrictions de véhicule / chute / natation s'appliquent.
• Si les restrictions de métadonnées ne se déclenchent toujours pas sur QBox/QB-Core, votre framework stocke peut-être ces champs sous des clés différentes — ajustez Config.Restrictions.MetaKeys.

Personne bloquée figée ou transparente

Le script réinitialise l'alpha, libère le ped et rétablit le ragdoll à l'arrêt de la ressource, donc redémarrer bupa-animpos résout un état bloqué. Si une intégration a laissé la mise à l'échelle du ped en pause, l'export de reprise est également appelé lors du nettoyage.