Dépannage - F.A.Q

Avant tout : passez Config.Debug = true, redémarrez la ressource, reproduisez le problème et lisez la console serveur et la console 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. Artifacts trop anciens (Lua 5.4 requis) ou ox_lib absent / démarré après. Mettez à jour vos artifacts et placez ensure ox_lib avant ensure MasterStretcher.

« DÉMARRAGE BLOQUÉ : fichier(s) manquant(s) ou vide(s) ». Un fichier du script a été supprimé ou vidé. Réinstallez le dossier depuis l'archive d'origine (en gardant votre config/).

Le script démarre mais aucune option n'apparaît. La licence n'est pas validée. La 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é sur https://ressources.mastermods.dev.
« API injoignable » : le serveur n'accède pas à internet ; le script tolère environ 1 h 30 de coupure avant de se désactiver.

Erreur No such export (ox_target, qb-target, ox_inventory). La ressource citée doit démarrer avant MasterStretcher, et Config.TargetSystem / 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 français (un message l'indique en console).

2. Visuel et physique

Brancard invisible ou qui clignote pour certains joueurs. OneSync doit être activé. Si vous avez un anti-spam d'entités, autorisez les modèles de brancards et d'ambulances.

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 en le poussant. Désactivez Config.EnableSlopePhysics pour tester. Vérifiez aussi attach.pos du modèle (/configStretcher, licence Premium).

Le brancard ne roule pas en pente. Les freins sont serrés : sur un brancard couché, Alt → Bloquer/Débloquer Freins. Ou Config.EnableSlopePhysics = false.

Avertissement F8 GetNetworkObject: no object by ID. Corrigé en 3.4.1 : mettez à jour.

3. Interactions

Je ne vois pas l'œil sur le brancard. Approchez-vous (environ 2,5 m), regardez la console F8. Si la ressource a été redémarrée pendant que vous étiez connecté, reconnectez-vous.

« Pousser/Lâcher » absent. Permission push insuffisante (Config.JobRestriction), ou vous êtes allongé / assis. Si un autre joueur pousse déjà ce brancard, passez par le relais.

Impossible d'installer un PNJ. Un brancard libre doit être à moins de 4 m du PNJ, et le PNJ à pied (pas dans un véhicule). Les PNJ morts ou blessés au sol sont acceptés depuis la 3.5.0 (Config.NPC.AllowDown). Avec qb-target, mettez à jour : l'option ne faisait rien avant la 3.5.0.

« Confier le patient à l'hôpital » n'apparaît pas. Le brancard doit être dans une zone de Config.NPC.HospitalZones. Les coordonnées fournies sont celles des hôpitaux d'origine : adaptez-les si vous utilisez un MLO.

Impossible d'inviter un joueur. Brancard libre à moins de 4 m du blessé, blessé à pied et conscient : il doit cliquer sur Accepter dans les 10 secondes.

4. Véhicules

« Rentrer dans l'ambulance » absent. L'option n'apparaît qu'en poussant un brancard, à moins de Config.MaxInteractionDistance (6 m) du centre d'un véhicule déclaré dans Config.AmbulanceConfig. Vérifiez le hash (nom de spawn exact). Pour un véhicule très long, augmentez Config.MaxInteractionDistance.

Au clic : « Ouvrez d'abord les portes de l'ambulance ! » alors qu'elles sont ouvertes. Si les portes ont été arrachées, mettez à jour : depuis la 3.5.0, une porte arrachée compte comme ouverte. Sinon, la numérotation des portes de ce véhicule est différente. Avec Config.Debug = true, /brancardDoors indique l'index de chaque porte ouverte : corrigez requiredDoors.

Au clic : « Ambulance pleine » alors qu'elle paraît vide. Depuis la 3.4.1, un lien vers un brancard qui n'est pas ré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 brancard est bien rangé : Sortir le brancard.

Le rangement marche à deux 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 à jour.

« Sortir le brancard » ou « Menu Intérieur » ne fait rien après avoir roulé. Corrigé en 3.4.3 (le serveur mesurait la distance jusqu'à l'ancienne position du brancard). En debug, la console affichait distance_too_far.

« Le véhicule est détruit : le brancard a brûlé avec lui ». Normal depuis la 3.5.0 : un brancard rangé dans un véhicule explosé n'est plus utilisable. Faites-en apparaître un autre.

L'ambulance se cabre ou part dans tous les sens quand un patient est à bord. Corrigé en 3.4.2 : mettez à jour. Si cela arrive aussi avec un brancard vide, vérifiez hauteur et profondeur de ce véhicule (brancard enfoncé dans le plancher ou les sièges).

Le brancard traverse le plancher ou flotte dans le véhicule. Ajustez hauteur (Z) dans l'entrée offsetsByModel de ce modèle de brancard.

Le brancard rentre dans les sièges avant / le véhicule s'envole. profondeur (Y) trop grande : réduisez-la pour reculer le brancard.

5. Son et items

Pas de son de roues. Vérifiez html/sounds/wheels.mp3, Config.EnableWheelSound, Config.WheelSoundVolume, et que le joueur n'a pas coupé le volume des interfaces (NUI) dans GTA.

L'item est utilisé mais aucun brancard n'apparaît.

Le nom de l'item doit être identique dans Config.ItemsVeh et dans votre inventaire.
Le modèle doit être streamé (erreur model not found en 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é ? Posez votre problème sur le Discord MasterMods avec la console serveur et F8 en Config.Debug = true.