Dépannage - F.A.Q

CeAvant guidetout de: dépannagepassez couvreConfig.Debug = true, redémarrez la majoritéressource, desreproduisez problèmesle techniquesproblème rencontréset lorslisez dela l'installationconsole ouserveur deet l'utilisationla quotidienneconsole F8 du joueur. Les messages [MasterStretcher] donnent presque toujours la cause.

1. Installation et démarrage

Erreur au démarrage dans un fichier .lua du script.

6.1 Installation & Démarrage

Q : Erreur Script error ... @MasterStretcher/server/main.lua dans la console.

Cause : Votre version de serveur (Artifacts) estArtifacts trop ancienneanciens et ne supporte pas la syntaxe (Lua 5.4 (ex:requis) ou constox_lib, localabsent function).
/ Solutiondémarré :

après.

Mettez à jour vos artifacts FiveMet versplacez laensure versionox_lib avant ensure MasterStretcher.

5848« DÉMARRAGE BLOQUÉ : fichier(s) manquant(s) ou supérieurevide(s) ». Un fichier du script a été supprimé ou vidé. Réinstallez le dossier depuis l'archive d'origine (Windows/Linux).

en Assurez-vous quegardant votre server.cfgconfig/). contient bien set mysql_ui true si vous utilisez oxmysql récent.

Q :

Le script démarre mais rienaucune neoption se passe (pas d'items, pas de commande).

Cause :n'apparaît. La liaisonlicence avecn'est lapas MasterKey

validée. aLa échouéconsole doit afficher [MASTERMODS] Licence validée pour : …. Sinon :

« Aucune clé de licence configurée » : ajoutez set mastermods_key "MM-XXXXX" dans server.cfg (ou Config.MasterModsKey). « Licence invalide ou désactivée » : vérifiez la clé estsur absente.
Solution :

Vérifiez Config.MasterModsKey dans config.lua. Elle ne doit pas être vide.https://ressources.mastermods.dev. Vérifiez« queAPI votreinjoignable » : le serveur an'accède accèspas à internet (; le script doittolère validerenviron la1 configurationh au30 démarrage).de coupure avant de se désactiver. 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 ouox_target, qb-target)target, ox_inventory).

Cause : MasterStretcher démarre avant votre script de target, ou le nom de laLa ressource estcitée incorrect.
doit Solutiondémarrer :

avant

MasterStretcher, Dans votre server.cfg, assurez-vous que ensure ox_target (ou qb-target) est placé AVANT ensure MasterStretcher. Vérifiez la valeur deet Config.TargetSystem dans/ Config.InventorySystem doivent correspondre à ce que vous utilisez.

Les textes affichent des noms de clés ou sont en français malgré Config.Locale. Codes valides : fr, en, de, es. Une langue introuvable retombe sur le config.luafrançais (un message l'indique en console).

---

6.22. ProblèmesVisuel Visuelset & Physiquephysique

Q

Brancard : Les brancards sont invisiblesinvisible ou clignotentqui clignote pour certains joueurs.

Cause : Problème de synchronisation des entités (Entity Lockdown) ou OneSync.
Solution :

Ce script nécessite OneSync Infinitydoit pourêtre fonctionneractivé. correctement. Activez-le dans votre server.cfg : set onesync on. Si vous utilisezavez un scriptanti-spam typed'entités, "Anti-Entity-Spam", ajoutezautorisez les modèles ferno-f2,de fernof3brancards et strykerd'ambulances. à la liste blanche (whitelist).

Q :

Le brancard est vu « en main » par un joueur mais au sol par les autres. Corrigé en 3.4.1 : la prise en main exige le contrôle réseau. Le joueur voit alors « Connexion réseau instable, réessayez » : il suffit de recommencer.

Le brancard vibre ou s'envole ou vibre violemment quand jeen le pousse.

Cause :poussant. Conflit de physique entre le joueur et le brancard.
Solution :

C'est souvent dû à une latence réseau (Lag) ou à un script de "Pousser véhicules" qui interfère. Désactivez temporairement Config.EnableSlopePhysics danspour letester. Vérifiez aussi config.luaattach.pos pourdu voirmodèle si(/configStretcher, celalicence stabilisePremium). 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 dansen les pentes.

Cause :pente. Les freins sont actifs ou la fonctionnalité est désactivée.
Solutionserrés :

sur Vérifiezun brancard couché, Alt → Bloquer/Débloquer Freins. Ou Config.EnableSlopePhysics = truefalse. En

Avertissement jeu,F8 ciblezGetNetworkObject: leno brancardobject etby vérifiez si l'option "Débloquer Freins"ID. estCorrigé disponible.en Par défaut, lâcher un brancard active ses freins (Config.AutoBrakeOnRelease).

---

6.3 Interactions & Target

Q3.4.1 : mettez à jour.

3. Interactions

Je ne vois pas l'œil (Target) sur le brancard.

Cause : Problème de distance ou de modèle.
Solution :

Rapprochez-Approchez-vous (laenviron distance2,5 estm), réglée à ~2.5m). Vérifiez que le script n'est pas en erreur dansregardez la console F8F8. (Client). Si vousla avezressource redémarréa leété scriptredémarrée 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 :

Si Config.JobRestriction = true, vérifiez que votre job est bien dans Config.AuthorizedJobs etpendant que vous avezétiez leconnecté, gradereconnectez-vous. requis.

« UnPousser/Lâcher » absent. Permission push insuffisante (Config.JobRestriction), ou vous êtes allongé / assis. Si un autre joueur "contrôle" peut-êtrepousse déjà lece brancardbrancard, (problèmepassez de synchro réseau). Supprimezpar le brancard et refaites-le spawn.

Q : Je ne peux pas installer de PNJ (Civil) sur le brancard.

relais.

Cause : Le PNJ est mort ou est considéré comme un objet statique.
Solution :

Le script empêcheImpossible d'installer desun PNJPNJ. qui sont dans des véhicules. Le PNJ doit être envivant, étatà pied, et un brancard libre doit être à moins de "ragdoll" ou vivant.

---

6.4 Véhiculesm &de Ambulances

lui.

Q

Impossible d'inviter un joueur. Brancard libre à moins de 4 m du blessé, blessé à pied et conscient : Jeil n'aidoit pas l'option "Rentrer le brancard"cliquer sur monAccepter ambulance.dans les 10 secondes.

4. Véhicules

Cause« :Rentrer dans l'ambulance » absent. LaL'option conditionn'apparaît qu'en poussant un brancard, à moins de sécurité n'est pas remplie.
Solution : vérifiez les points suivants DANS L'ORDRE.

Portes : Les portes arrières sont-elles GRANDES OUVERTES ?Config.MaxInteractionDistance (Vérifiez6 requiredDoorsm) dansdu lacentre config). Modèle : Led'un véhicule est-il configurédéclaré dans Config.AmbulanceConfig ?. Vérifiez le hash (nom de spawn (Hash)exact). Occupation : L'ambulance pense-t-elle qu'elle a déjàPour un brancardvéhicule ?très (Voirlong, pointaugmentez suivant)Config.MaxInteractionDistance.

OrientationAu clic : Vos« piedsOuvrez (etd'abord ceuxles du brancard) doivent être prochesportes de l'arrièreambulance du! véhicule.

» alors

Qqu'elles sont ouvertes. La numérotation des portes de ce véhicule est différente. Avec Config.Debug = true, /brancardDoors indique l'index de chaque porte ouverte : L'ambulancecorrigez merequiredDoors. dit

Au "Placeclic occupée": « Ambulance pleine » alors qu'elle estparaît vide.

Cause : DésynchronisationDepuis dela l'état3.4.1, duun véhiculelien (StateBag). Cela arrive sivers un brancard aqui étén'est supprimépas viaréellement fixé dans le véhicule est vérifié puis nettoyé automatiquement en quelques secondes. Réessayez après 5 secondes. Si le message persiste, un scriptbrancard deest nettoyagebien (ClearArea) sans être sorti proprement.
Solutionrangé :

Faites apparaître une nouvelle ambulance. (Avancé) Un admin peut utiliser un script pour resetSortir le StateBagbrancard. attachedStretcher

Le durangement véhiculemarche à nildeux mais pas à plusieurs. Corrigé en 3.4.1 (brancard auto-armé fixé par le mauvais joueur, sortie impossible quand quelqu'un est assis dans le véhicule). Mettez

Qà :jour.

Le brancard traverse le solplancher ou flotte dans l'ambulance.le

Cause :véhicule. Les coordonnéesAjustez hauteur (Z) sont mal réglées dans Config.AmbulanceConfig.
Solution :

Ouvrezl'entrée config.lua. Modifiez la valeur hauteuroffsetsByModel pourde ce modèle :    * Si il flotte : Diminuez la valeur (ex: passez de -0.25brancard. à -0.35).    * Si il est dans le sol : Augmentez la valeur. Redémarrez le script pour tester.

Q :

Le brancard exploserentre oudans les sièges avant / le véhicule s'envole quand je le rentre.

Cause :envole. Collision physique violente. Le brancard touche la hitbox du véhicule.
Solution :

C'est souvent dû à une valeur profondeur trop élevée (le brancard rentre trop loin et touche les sièges avant). Réduisez la profondeur (rapprochez-leY) destrop portes arrières).

---

6.5 Audio & Items

Qgrande : Aucunréduisez-la pour reculer le brancard.

5. Son et items

Pas de son de roues quand je pousse.

Cause :roues. Fichier manquant ou volume trop bas.
Solution :

Vérifiez que le fichier html/sounds/wheels.mp3, est bien présent sur votre serveur. VérifiezConfig.EnableWheelSound, Config.WheelSoundVolume, (augmentez à 0.5 ou 1.0 pour tester). Vérifiezet que vousle joueur n'aveza pas désactivécoupé lesle sonsvolume NUIdes interfaces (NUI) dans vosGTA. paramètres GTA.

Q :

L'item s'utiliseest utilisé mais leaucun brancard n'apparaît pas.

Cause : Erreur SQL ou nom d'item incorrect.
Solution :apparaît.

1. • Vérifiez que leLe nom de l'item dansdoit votreêtre base de données (items ou shared) correspond EXACTEMENT à celuiidentique dans Config.ItemsVeh (colonneet item).dans votre inventaire.
   • VérifiezLe simodèle vousdoit avezêtre l'streamé (erreur model not found dansen F8).

Message « Vous avez déjà trop de brancards en service » : limite Config.MaxStretchersPerPlayer atteinte. ox_inventory : vérifiez l'export de l'item (nom du dossier) et la version d'ox_inventory (message « mode dégradé » en console).

L'item a disparu sans brancard. Depuis la 3.4.1, l'item n'est retiré qu'après l'apparition réussie. Avec ox_inventory, le retrait dépend de consume et l'usage est annulé si le joueur n'a pas la permission.

Toujours bloqué ? Ouvrez un ticket sur le Discord MasterMods avec la console serveur et F8 (le modèle 3Den ferno-f2Config.Debug = true.

n'est pas streamé).