FAQ

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 :

  1. Mettez à jour vos artifacts FiveM vers la version 5848 ou supérieure (Windows/Linux).
  2. Assurez-vous que votre 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 :

  1. Vérifiez Config.MasterModsKey dans config.lua. Elle ne doit pas être vide.
  2. Vérifiez que votre serveur a accès à internet (le script doit valider la configuration au démarrage).
  3. 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 :

  1. Dans votre server.cfg, assurez-vous que ensure ox_target (ou qb-target) est placé AVANT ensure MasterStretcher.
  2. 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 :

  1. Ce script nécessite OneSync Infinity pour fonctionner correctement. Activez-le dans votre server.cfg : set onesync on.
  2. 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 :

  1. C'est souvent dû à une latence réseau (Lag) ou à un script de "Pousser véhicules" qui interfère.
  2. Désactivez temporairement Config.EnableSlopePhysics dans le config.lua pour voir si cela stabilise la situation.
  3. 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 :

  1. Vérifiez Config.EnableSlopePhysics = true.
  2. 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 :

  1. Rapprochez-vous (la distance est réglée à ~2.5m).
  2. Vérifiez que le script n'est pas en erreur dans la console F8 (Client).
  3. Si vous avez redémarré le script en jeu (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 :

  1. Si Config.JobRestriction = true, vérifiez que votre job est bien dans Config.AuthorizedJobs et que vous avez le grade requis.
  2. 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 :

  1. Le script empêche d'installer des PNJ qui sont dans des véhicules.
  2. Le PNJ doit être en état de "ragdoll" ou vivant.

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.

  1. Portes : Les portes arrières sont-elles GRANDES OUVERTES ? (Vérifiez requiredDoors dans la config).
  2. Modèle : Le véhicule est-il configuré dans Config.AmbulanceConfig ? Vérifiez le nom de spawn (Hash).
  3. Occupation : L'ambulance pense-t-elle qu'elle a déjà un brancard ? (Voir point suivant).
  4. 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 :

  1. Faites apparaître une nouvelle ambulance.
  2. (Avancé) Un admin peut utiliser un script pour reset le StateBag 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 :

  1. Ouvrez config.lua.
  2. 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.
  3. 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 :

  1. C'est souvent dû à une valeur profondeur trop élevée (le brancard rentre trop loin et touche les sièges avant).
  2. 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 :

  1. Vérifiez que le fichier html/sounds/wheels.mp3 est bien présent sur votre serveur.
  2. Vérifiez Config.WheelSoundVolume (augmentez à 0.5 ou 1.0 pour tester).
  3. 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 :

  1. Vérifiez que le nom de l'item dans votre base de données (items ou shared) correspond EXACTEMENT à celui dans Config.ItemsVeh (colonne item).
  2. Vérifiez si vous avez l'erreur model not found dans la console F8 (le modèle 3D ferno-f2 n'est pas streamé).

Support Administrateur/Tech

Cette section traite des problèmes de configuration et d'installation technique.

Q : Le brancard apparaît, mais l'option pour le ranger dans l'ambulance ne s'affiche pas.

R : Cela peut venir de deux points dans votre Config.AmbulanceConfig :

  1. Le modèle du véhicule : Vérifiez que le hash correspond exactement au nom de spawn de votre véhicule.

  2. La distance de détection : Augmentez la valeur de detection (ex: passez de 2.4 à 4.0) si l'arrière de votre véhicule est particulièrement long.

  3. Les portes : L'interaction ambulance_stow nécessite que les portes arrière du véhicule soient physiquement ouvertes.

Q : Le patient est mal positionné (trop haut, trop bas ou décalé).

R : Vous devez ajuster les offsets dans la table Config.Brancards ou Config.Lits.

Q : Je ne vois pas les options pour monter ou baisser les pieds.

R : Assurez-vous d'avoir correctement renseigné les variables extraPiedsHaut et extraPiedsBas avec les IDs d'extras correspondants à votre modèle 3D. Si ces variables sont absentes ou erronées, l'interaction stretcher_pieds ne s'affichera pas.

Q : Le son des roues (wheels.mp3) ne se déclenche pas.

R : 1. Vérifiez que le dossier html contient bien le sous-dossier sounds avec le fichier wheels.mp3. 2. Assurez-vous que les utilisateurs n'ont pas coupé le volume "NUI" dans leurs paramètres GTA.

Support Utilisateur / Joueur

Cette section aide les joueurs à utiliser le script correctement en jeu.

Q : Pourquoi je n'arrive pas à pousser le brancard ?

R : Vérifiez si le frein de sécurité est activé. Si le message "Frein activé" a été déclenché, vous ne pourrez pas utiliser l'option de poussée (stretcher_push). Utilisez l'interaction pour "Enlever le frein" avant de réessayer. Vérifiez également que vous avez le autorisations requises surtout si votre serveur utilise un système de métiers.

Q : J'ai rangé le brancard dans l'ambulance, comment le ressortir ?

R : Ouvrez les portes arrière de l'ambulance, visez le brancard avec votre système d'interaction et sélectionnez simplement "Pousser". Le brancard se détachera automatiquement du véhicule pour revenir dans vos mains.

Q : Est-ce que je peux mettre plusieurs patients sur le même brancard ?

R : Non. Le système utilise un marqueur de sécurité qui verrouille le brancard dès qu'une personne est installée. Cela évite les collisions physiques et les bugs de synchronisation.

Q : Le brancard est bloqué dans un mur ou dans le sol, que faire ?

R : Utilisez l'option "Supprimer" (stretcher_delete) via votre menu d'interaction. Cela nettoiera l'entité proprement. Si vous étiez installé dessus, vous serez déposé à côté en toute sécurité.