Configuration Détaillée

Ce chapitre détaille les options disponibles dans le fichier config.lua pour adapter le script à votre serveur. Ce fichier est le cœur de la personnalisation du gameplay.

3.1 Framework & Permissions

Cette section permet de définir comment le script s'intègre à votre économie et à vos systèmes de métiers.

• Config.FrameworkMetier : Définit le framework utilisé par votre serveur.

  • "esx" : Pour les serveurs ESX Legacy ou v1.
  • "qb" : Pour les serveurs QBCore.
  • "standalone" : Aucune dépendance métier (tout le monde peut tout faire).

• Config.TargetSystem : Définit le système de visée (Third-eye).

  • "ox" : Recommandé (ox_target).
  • "qb" : Pour qb-target.

• Config.JobRestriction :

  • true : Active la restriction par métier. Seuls les métiers listés ci-dessous pourront utiliser les brancards.
  • false : Désactive les restrictions. Tout le monde peut utiliser le matériel.

• Config.AuthorizedJobs : Configuration fine des grades (si JobRestriction est activé). Le chiffre correspond au grade minimum requis.

  • push : Autorisation de pousser le brancard.
  • patient : Autorisation de manipuler le patient (installer/sortir).
  • stow : Autorisation de charger/décharger de l'ambulance.
  • spawn : Autorisation de faire apparaître un brancard via un item.
  • extras : Autorisation de modifier les accessoires (sac, oxygène...).
  • delete : Autorisation de supprimer le brancard (Admin/Boss).

3.2 Gameplay & Physique

Ces options modifient le ressenti et le comportement du brancard en jeu.

• Config.DefaultKey ('E') : La touche clavier par défaut pour interagir (lâcher le brancard) si le Target n'est pas utilisé.
• Config.EnableSlopePhysics : Si true, le brancard soumis à la gravité roulera tout seul dans les pentes s'il n'est pas tenu ou freiné.
• Config.SlowDownWhenPushing : Si true, force le joueur à marcher (empêche le sprint) lorsqu'il pousse un brancard.
• Config.HolsterWeaponBeforePush : Si true, range automatiquement l'arme du joueur avant qu'il ne saisisse les poignées (évite les bugs visuels).
• Config.AutoBrakeOnRelease : Si true, les freins s'activent automatiquement dès que vous lâchez le brancard.

3.3 Audio et Immersion

• Config.EnableWheelSound : Active le bruitage réaliste de roulement.
• Config.WheelSoundVolume : Volume du son (0.0 à 1.0).
• Config.WheelSoundDistance : Distance à laquelle les autres joueurs entendent le brancard (défaut : 15 mètres).

📘 Chapitre 4 : Configuration des Véhicules (Ambulances)

Ce chapitre est le plus technique mais le plus important. Il permet de définir quels véhicules peuvent interagir avec le brancard (chargement/déchargement) et comment le brancard se positionne physiquement à l'intérieur.

Toute la configuration se fait dans la table Config.AmbulanceConfig de votre fichier config.lua.

3.4 Structure d'un véhicule

Pour ajouter un nouveau véhicule, copiez un bloc existant et modifiez les valeurs. Voici l'explication ligne par ligne :

{
    model = "Master III VSAV",          -- Nom indicatif (pour vous repérer)
    hash = `rmaster317_vsav-bspp`,      -- Le nom de spawn du véhicule (nom du YFT)
    auteur = "Anto",                    -- Auteur du véhicule (ne pas laisser vide)
    AutoBrancardName = "ferno-f2",      -- Le modèle de brancard qui spawn avec (si Auto-Armement actif)
    requiredDoors = {2, 3},             -- Les portes qui doivent être ouvertes pour ranger le brancard ou le sortir
    
    -- RÉGLAGES DE POSITION (OFFSET)
    detection = 2.4,                    -- Rayon de détection (en mètres) autour du véhicule
    alignementLateral = -0.25,          -- Position Gauche/Droite (X)
    profondeur = -1.25,                 -- Position Avant/Arrière (Y)
    hauteur = -0.25,                    -- Position Haut/Bas (Z)
    rotation = 0.0                      -- Rotation du brancard (0.0 = Pieds vers l'avant)
},

## 3.5 Objets & Items
Vous pouvez définir quels items de votre inventaire font apparaître quel modèle de brancard.
**
Exemple de configuration :**
```lua
Config.ItemsVeh = {
    {hash = `ferno-f2`, item = 'stretcher',  label = 'Ferno F2'},
    {hash = `stryker`,  item = 'stretcher3', label = 'Stryker M1'},
}


hash : Le modèle 3D du brancard (doit exister dans le jeu).
item : Le nom technique de l'item dans votre base de données (DB).
label : Le nom affiché lors du spawn.