Skip to main content

Installation

Bienvenue dans la documentation de MasterStretcher. Ce script apporte une dimension réaliste aux interventions médicales sur votre serveur FiveM grâce à une physique avancée, une synchronisation précise et une intégration complète avec les véhicules d'urgence.

1.1 Pré-requisPrérequis

Avant

decommencer,assurez-vousÉlément queDétail votre serveur disposede:
    Compte Cfx.re :Pour Nécessaire pour téléchargerrécupérer la ressource viadans Keymaster Artifacts FiveM Version récente (la dernière version recommandée) ; Lua 5.4 requis OneSync Obligatoire (les brancards sont créés et synchronisés par le systèmeserveur) d'assets officiel(Escrow).ox_lib FiveMObligatoire, Artifactsdémarré :avant VersionMasterStretcher 4752 ox_target ou supérieureqb-target recommandée.Recommandé (sinon : interactions au clavier, Config.TargetSystem = "none") ox_inventory Facultatif ; version récente si vous l'utilisez (voir Configuration Détaillée)

    1.2 Procédure d'Installation

    L'installation se fait en 3 étapes via le système officiel Tebex et Keymaster.

    Étape 1 : Récupérer la ressource

    1. Rendez-vous surSur la boutique officielleTebex :MasterMods, https://raph.tebex.io/
    Sélectionnezajoutez le packagepaquet gratuit MasterStretcher (Gratuit).et Procédez au "paiement" (0.00€) pour liervalidez la ressourcecommande à 0,00 €. Elle est liée à votre compte Cfx.re. Sur

    ÉtapeKeymaster, 2 : Télécharger les fichiers

      Connectez-vous sur votreonglet Keymaster : https://portal.cfx.re/ Dans la liste "Granted Assets"Assets, cherchez MasterStretcher. Cliquez sur Download pour obtenirtéléchargez l'archive .zipMasterStretcher.

      Étape

      L'archive 3contient :

        le dossier MasterStretcher/ : Installationla ressource ; Formation-Brancard-MasterStretcher.pdf : le guide joueurs, à partager à vos secouristes (il ne va pas dans resources).

        2. Installer sur le serveur

        1. Copiez

          Ouvrez l'archive téléchargée. Lele dossier extrait porte un nom qui change à chaque version (par exemple MasterStretcher_MasterMods_v17) — renommez-le en MasterStretcher avant de le glisser dans leresources/. répertoireGardez exactement ce nom : il sert à l'export ox_inventory (resourcesMasterStretcher.stretchermod_use_item).

        de votre serveur. Ça vous évite de devoir modifier votreDans server.cfg, àdémarrez-le chaqueaprès miseses à jour du script.

        Ajoutez la ligne suivante à votre fichier server.cfgdépendances : ensure MasterStretcher

        ⚠️ Si vous préférez garder le nom du dossier tel quel (avec son suffixe de version), remplacez MasterStretcher par le nom exact du dossier dans la ligne ensure — mais pensez alors à la mettre à jour vous-même à chaque nouvelle version téléchargée.

        ensure ox_lib
        ensure ox_target        # ou qb-target
        ensure ox_inventory     # si utilisé
        ensure MasterStretcher
        

        1.33. Configuration deConfigurer la Licencelicence (Obligatoire)obligatoire)

        Pour que le script fonctionne correctement, vous devez générer une clé unique (gratuite également).

        1. Rendez-vousCréez survotre leMasterKey générateur officielgratuite : https://ressources.mastermods.dev/CreerMasterKey.php
        2. GénérezRecommandé : ajoutez-la dans server.cfg :
        set mastermods_key "MM-XXXXX"
        

        Utilisez bien set (et non setr) : la clé reste côté serveur. Elle est prioritaire sur la config.

        Autre possibilité : Config.MasterModsKey = "MM-XXXXX" dans config/config.lua. Ce fichier est téléchargé par les joueurs ; server.cfg est donc préférable.

        Au démarrage, la console doit afficher : [MASTERMODS] Licence validée pour : <nom du serveur>. Si elle affiche « Aucune clé de licence configurée », la clé n'est pas lue (voir Dépannage - F.A.Q).

        4. Adapter la configuration

        Les fichiers de config/ restent modifiables (ils ne sont pas chiffrés) :

        Fichier Contenu Page config/config.lua Licence, langue, framework, permissions, gameplay, son, items, sécurité Configuration Détaillée config/stretchers.lua Modèles de brancards, items, accessoires, positions du patient Configuration Détaillée config/vehicles.lua Ambulances et nacelles Configuration des Véhicules

        Mettre à jour

          Sauvegardez votre MasterKeydossier config/. Ouvrez le fichier config.lua situé dansRemplacez le dossier duMasterStretcher script.par celui de la nouvelle archive. CollezRemettez votre config/ et comparez-le avec la nouvelle version : les nouvelles options sont listées dans les Journaux des changements. Une option absente de votre ancienne config prend sa valeur par défaut. Redémarrez le serveur (ou ensure MasterStretcher).

          Mise à jour depuis la 3.4.0 : rien n'est obligatoire. Pensez à déplacer votre clé dans laserver.cfg variableet correspondanteregardez les deux nouveaux réglages Config.MaxStretchersPerPlayer et Config.AbandonedStretcherMinutes.

          Ne pas modifier

          Le script vérifie au démarrage que tous ses fichiers sont présents. S'il en manque un, il refuse de démarrer et l'indique en console :

          Config.MasterModsKeyréinstallez =alors "VOTRE_CLE_ICI"la 
          ressource depuis une archive propre.