Dépannage - F.A.Q
Ce guide de dépannage couvre la majorité des problèmes techniques rencontrés lors de l'installation ou de l'utilisation quotidienne du script.
6.1 Installation & Démarrage
Q : Erreur Script error ... @MasterStretcher/server/main.lua dans la console.
Cause : Votre version de serveur (Artifacts) est trop ancienne et ne supporte pas la syntaxe Lua 5.4 (ex: const, local function).
Solution :
server.cfg contient bien set mysql_ui true si vous utilisez oxmysql récent.
Q : Le script démarre mais rien ne se passe (pas d'items, pas de commande).
Cause : La liaison avec la MasterKey a échoué ou la clé est absente.
Solution :
Config.MasterModsKey dans config.lua. Elle ne doit pas être vide.
Vérifiez que votre serveur a accès à internet (le script doit valider la configuration au démarrage).
Vérifiez la console serveur (F8 ou TXAdmin), un message explicite doit apparaître : [MasterStretcher] Authentification réussie.
Q : Erreur No such export ... (ox_target ou qb-target).
Cause : MasterStretcher démarre avant votre script de target, ou le nom de la ressource est incorrect.
Solution :
server.cfg, assurez-vous que ensure ox_target (ou qb-target) est placé AVANT ensure MasterStretcher.
Vérifiez la valeur de Config.TargetSystem dans le config.lua.
6.2 Problèmes Visuels & Physique
Q : Les brancards sont invisibles ou clignotent pour certains joueurs.
Cause : Problème de synchronisation des entités (Entity Lockdown) ou OneSync.
Solution :
server.cfg : set onesync on.
Si vous utilisez un script type "Anti-Entity-Spam", ajoutez les modèles ferno-f2, fernof3 et stryker à la liste blanche (whitelist).
Q : Le brancard s'envole ou vibre violemment quand je le pousse.
Cause : Conflit de physique entre le joueur et le brancard.
Solution :
Config.EnableSlopePhysics dans le config.lua pour voir si cela stabilise la situation.
Vérifiez que vous n'avez pas modifié les fichiers .meta des véhicules qui pourraient changer la collision.
Q : Le brancard ne roule pas dans les pentes.
Cause : Les freins sont actifs ou la fonctionnalité est désactivée.
Solution :
Config.EnableSlopePhysics = true.
En jeu, ciblez le brancard et vérifiez si l'option "Débloquer Freins" est disponible. Par défaut, lâcher un brancard active ses freins (Config.AutoBrakeOnRelease).
6.3 Interactions & Target
Q : Je ne vois pas l'œil (Target) sur le brancard.
Cause : Problème de distance ou de modèle.
Solution :
restart), les targets peuvent disparaître. Relancez votre client FiveM.
Q : L'option "Pousser" est grisée ou ne marche pas.
Cause : Restriction métier ou état bloqué.
Solution :
Config.JobRestriction = true, vérifiez que votre job est bien dans Config.AuthorizedJobs et que vous avez le grade requis.
Un autre joueur "contrôle" peut-être déjà le brancard (problème de synchro réseau). Supprimez le brancard et refaites-le spawn.
Q : Je ne peux pas installer de PNJ (Civil) sur le brancard.
Cause : Le PNJ est mort ou est considéré comme un objet statique.
Solution :
6.4 Véhicules & Ambulances
Q : Je n'ai pas l'option "Rentrer le brancard" sur mon ambulance.
Cause : La condition de sécurité n'est pas remplie.
Solution : vérifiez les points suivants DANS L'ORDRE.
requiredDoors dans la config).
Modèle : Le véhicule est-il configuré dans Config.AmbulanceConfig ? Vérifiez le nom de spawn (Hash).
Occupation : L'ambulance pense-t-elle qu'elle a déjà un brancard ? (Voir point suivant).
Orientation : Vos pieds (et ceux du brancard) doivent être proches de l'arrière du véhicule.
Q : L'ambulance me dit "Place occupée" alors qu'elle est vide.
Cause : Désynchronisation de l'état du véhicule (StateBag). Cela arrive si un brancard a été supprimé via un script de nettoyage (ClearArea) sans être sorti proprement.
Solution :
attachedStretcher du véhicule à nil.
Q : Le brancard traverse le sol ou flotte dans l'ambulance.
Cause : Les coordonnées hauteur (Z) sont mal réglées dans Config.AmbulanceConfig.
Solution :
config.lua.
Modifiez la valeur hauteur pour ce modèle :
* Si il flotte : Diminuez la valeur (ex: passez de -0.25 à -0.35).
* Si il est dans le sol : Augmentez la valeur.
Redémarrez le script pour tester.
Q : Le brancard explose ou le véhicule s'envole quand je le rentre.
Cause : Collision physique violente. Le brancard touche la hitbox du véhicule.
Solution :
profondeur trop élevée (le brancard rentre trop loin et touche les sièges avant).
Réduisez la profondeur (rapprochez-le des portes arrières).
6.5 Audio & Items
Q : Aucun son de roues quand je pousse.
Cause : Fichier manquant ou volume trop bas.
Solution :
html/sounds/wheels.mp3 est bien présent sur votre serveur.
Vérifiez Config.WheelSoundVolume (augmentez à 0.5 ou 1.0 pour tester).
Vérifiez que vous n'avez pas désactivé les sons NUI dans vos paramètres GTA.
Q : L'item s'utilise mais le brancard n'apparaît pas.
Cause : Erreur SQL ou nom d'item incorrect.
Solution :
items ou shared) correspond EXACTEMENT à celui dans Config.ItemsVeh (colonne item).
Vérifiez si vous avez l'erreur model not found dans la console F8 (le modèle 3D ferno-f2 n'est pas streamé).