# Journaux des changements

#### 📋 Changelog (Mise à jour du 30/12 - 31/12) - 3.1.0

##### **Nouvelles Fonctionnalités**

<div class="preview" id="bkmrk-syst%C3%A8me-pnj-complet%C2%A0"><div class="preview__inner-1"><div class="preview__inner-2"><div class="cl-preview-section">

- **Système PNJ Complet** : Placement de PNJ vivants sur le brancard avec un menu de position dédié pour modifier l’animation après l’installation.
- **Support Nacelle** : Support de l’EPAN d’Anto avec détection automatique et masquage visuel des roues.
- **Alignement Dynamique (Pitch &amp; Roll)** : Le brancard s’incline automatiquement selon l’inclinaison du terrain (avant/arrière et latéral).

</div></div></div></div>##### **Correctifs &amp; Patches**

<div class="preview" id="bkmrk-remaniement%C2%A0%3A-simpli"><div class="preview__inner-1"><div class="preview__inner-2"><div class="cl-preview-section">

- **Remaniement** : Simplification du fichier de configuration
- **Système de Relais** : Transfert de contrôle fluide entre deux collègues via une demande et une confirmation synchronisées.
- **Persistance d’Animation** : Système de vérification pour empêcher que l’animation du patient ne soit coupée par des scripts tiers.
- **Optimisation des Collisions** : Désactivation des collisions entre le patient et le brancard pendant le transport pour supprimer les mouvements erratiques.
- **Patch Technique** : Correction de la fonction native de débarquement, correction d’un bug où les joueurs-non-métier ne pouvaient pas se coucher sur le brancard.
- **Changement de système** : Plus besoin d’être sur Discord SAUF pour garder les fonctions ‘Premium’ : Support Nacelle, alignement dynamique, restriction métier
- **Optimisation des Extras** : Regroupement des dossiers et garde-corps en interrupteurs uniques (ON/OFF) avec logique d’exclusion mutuelle pour une gestion simplifiée.

</div></div></div></div>#### 📑 Changelog - MasterStretcher (Mise à jour du 01/01) - 3.1.1

<p class="callout warning">Attention : changement du fichier config.lua nécessaire !</p>

<div class="preview" id="bkmrk-correction-du-bug-de"><div class="preview__inner-1"><div class="preview__inner-2"><div class="cl-preview-section">

- **Correction du bug des nacelles** : Le brancard ne *devrait* plus léviter et ne plus boguer lorsqu’il est attaché à une échelle ou un panier. Il reste désormais parfaitement fixé pour tout le monde, même lors des mouvements.
- **Alerte de mise à jour** : Si une nouvelle version du script est disponible, un gros message d’alerte très visible (en rouge et jaune) s’affichera directement dans la console de votre serveur au démarrage.
- **Affichage des véhicules amélioré** : Les véhicules s’affichent désormais par leur **nom** et leur **auteur** (ex: *Master III \[Anto\]*), au lieu de simples numéros techniques pour une compréhension plus simple de la config.
- **Meilleure stabilité** : Le système de vérification est plus robuste et ne risque plus de bloquer le démarrage, même si vous avez une liste de véhicules configurés extrêmement longue.
- **Gestion des pieds** : Modification afin de pouvoir intégrer plus facilement d’autres brancards.

</div></div></div></div>#### 📑 Changelog - MasterStretcher (Mise à jour du 02/01) - 3.1.4

<p class="callout warning">Attention : changement du fichier config.lua nécessaire !</p>

##### 🚑 Configuration &amp; Identification des Véhicules

<div class="preview" id="bkmrk-labels-des-ambulance"><div class="preview__inner-1"><div class="preview__inner-2"><div class="cl-preview-section">

- **Labels des Ambulances** : Les véhicules sont désormais identifiés par leurs noms configurés (ex: “Master III 2012”) au lieu de simples identifiants techniques.
- **Affichage des Auteurs** : L’auteur du modèle (si renseigné dans la configuration) apparaît désormais entre crochets à côté du nom du véhicule (ex: \[Anto\]).
- **AutoBrancardName (Liaison automatique)** :
- Ce paramètre définit le modèle de brancard nativement associé à une ambulance.
- Le rapport automatique traduit désormais l’ID technique en label lisible, vous permettant de valider instantanément que la liaison entre votre ambulance et son brancard est opérationnelle.
- **requiredDoors (Gestion des accès)** :
- Ce paramètre liste les indices des portes (ex: 2, 3) qui doivent être impérativement ouvertes pour charger ou décharger un brancard.
- Le rapport technique répertorie ces portes pour chaque véhicule, garantissant un contrôle précis de vos réglages de réalisme.

</div></div></div></div>#### 📑 Changelog - MasterStretcher (Mise à jour du 02/01) - 3.1.5

<div class="preview" id="bkmrk-test%C2%A0%3A-essais-nacell"><div class="preview__inner-1"><div class="preview__inner-2"><div class="cl-preview-section">

- **Test** : essais nacelle
- **Rotation** : possibilité de tourner le brancard pour l’attachement dans le véhicule

</div></div></div></div>#### 📑 Changelog - MasterStretcher (Mise à jour du 03/01) - 3.1.6

- Correction d'un bug sur les portes des hélicoptères mal détectées

#### 📑 Changelog - MasterStretcher (Mise à jour du 25/01) - 3.1.7

<div class="preview" id="bkmrk-correction-d%27un-bug--1"><div class="preview__inner-1"><div class="gutter">

- Correction d'un bug sur le fait que l'index métier (grade) n'était pas vérifié. Changement de sa logique générale.

</div></div></div>#### 📑 Changelog - MasterStretcher (Mise à jour du 25/01) - 3.1.8

- Allègement de code
- Ajout de trois fichiers de langage pour un changement rapide

#### 📑 Changelog - MasterStretcher (Mise à jour du 15/02) - 3.2.0

<p class="callout warning">Attention : changement du fichier config.lua nécessaire !</p>

- Uniformisation du matériel : Lors de la sortie automatique de l'ambulance, le brancard apparaît avec un équipement propre et défini (via la configuration), supprimant l'apparition d'accessoires aléatoires.
- Nouvelle option de configuration : Ajout d'un paramètre permettant de régler finement la réactivité de la physique selon les besoins du serveur.
- Refonte de l'optimisation : La consommation du script (Resmon) a été drastiquement réduite. Il est désormais ultra-léger (autour de 0.03ms) tout en conservant une physique de pente et d'inclinaison en temps réel.

#### 📑 Changelog - MasterStretcher (Mise à jour du 17/02) - 3.2.1

<div class="preview" id="bkmrk-ajout-de-la-langue-e"><div class="preview__inner-1"><div class="gutter">

- Ajout de la langue Espagnole.
- Correction d'un bug où le son de roulement ne pouvait pas être désactivé.

</div></div></div>#### 📑 Changelog - MasterStretcher (Mise à jour du 18/03) - 3.2.2

- **Nouvelle API Complète (Exports) :** Intégration totale avec vos menus personnalisés (Context Menu, Radial, etc.) via une nouvelle liste d'exports (pousser, ranger, ouvrir les menus, lire les états).
- **Support "No-Target" :** Possibilité de définir `Config.TargetSystem = "none"` pour désactiver totalement les cibles (ox/qb) sans générer d'erreurs dans la console.
- **Nouveaux Événements (Hooks) :** Ajout d'événements clients et serveurs exploitables pour déclencher vos propres scripts (ex: allumer les gyrophares au déploiement du brancard).
- **Mémorisation du Dossier :** Correction d'un problème agaçant où le dossier du brancard se recouchait tout seul lorsqu'on le posait au sol.
- **Accessoires au Spawn :** Les brancards (qu'ils soient sortis manuellement ou via l'auto-arm de l'ambulance) apparaissent désormais bien avec les accessoires par défaut définis dans votre configuration.
- **Lâcher Réaliste (Ragdoll) :** Si un joueur trébuche, tombe d'un toit ou se fait renverser, il lâche désormais instantanément le brancard, évitant les bugs de collision destructeurs.
- **Blindage des Actions Externes :** Les actions déclenchées via l'API (menus custom) vérifient désormais rigoureusement les permissions des métiers et l'ouverture des portes des ambulances. Fini les vols de brancards par les civils !
- **Alerte de Désynchronisation :** Ajout d'une notification visible pour le joueur s'il tente d'interagir avec un brancard qui ne répond pas au réseau (prévention des bugs de clics dans le vide).

#### 📑 Changelog - MasterStretcher (Mise à jour du 01/04) - 3.2.3

<p class="callout warning">Attention : changement du fichier config.lua nécessaire !</p>

- **Système UI Caméléon :** Les notifications et textes à l'écran s'adaptent désormais 100% automatiquement à votre serveur (ox, qb, esx, okok ou natif).
- **Synchronisation &amp; Stabilité :** Résolution des animations "dans le vide" après un redémarrage, du spam lors du rangement, et des conflits réseaux sur la gestion des accessoires.

#### 📑 Changelog - MasterStretcher (Mise à jour du 02/04) - 3.2.4

<p class="callout warning">Attention : changement du fichier config.lua nécessaire !</p>

- **Physique des sols réaliste :** Le script détecte désormais la matière sous vos pieds (sable, boue, neige) et ralentit drastiquement la poussée. Désactivable dans la config.
- **Outil Dev `/configBrancard` :** Un assistant visuel 3D directement en jeu pour aligner les brancards dans vos véhicules moddés et copier la configuration générée en un clic.

#### 📑 Changelog - MasterStretcher (Mise à jour du 03/04) - 3.2.5

- **Bouclier Anti-Crash :** Si une erreur ou un oubli se glisse dans le config.lua, le script ne crashera plus en jeu. Il ignore le véhicule défectueux en silence pour les joueurs, et affiche une alerte claire et précise uniquement dans la console du serveur.
- **Sélection des Portes :** L'assistant /configBrancard s'enrichit d'un menu à cases à cocher (multi-select) pour paramétrer les portes requises. Il suffit de cocher "Coffre" ou "Passager" et l'outil génère le code parfait.
- Dépréciation des versions antérieures à 3.2.0 - Mise à jour vers 3.2.5 conseillée

#### 📑 Changelog - MasterStretcher (Mise à jour du 13/05) - 3.2.6

- **Essais :** tentative de correction de désynchronisations.

#### 📑 Changelog - MasterStretcher (Mise à jour du 31/08) - 3.3.4

<p class="callout warning">Attention : changement du fichier config.lua nécessaire !</p>

- **Framework :** Prise en charge de QBox
- **Compatibilité `ox_inventory`** ajoutée pour l'item brancard, en plus des inventaires natifs

#### 📑 Changelog - MasterStretcher (Mise à jour du 31/08) - 3.3.5 - 3.3.10

- **Le brancard ne spawnait pas avec `ox_inventory`** malgré aucune erreur visible — corrigé
- **Les accessoires du brancard (dossier, garde-corps, options) restaient bloqués** — corrigé.
- **Sur certains serveurs, les accessoires ne pouvaient jamais être changés du tout**, peu importe la situation — corrigé
- Correction d'un cas où la position de spawn du brancard pouvait être rejetée à tort par le serveur.
- Renforcement général de la fiabilité réseau : plusieurs actions (spawn, rangement, freins, patient sur brancard) passent désormais systématiquement par une validation serveur
- **Extras configurables au spawn** : possibilité de définir quels accessoires (dossier, garde-corps, équipements) apparaissent par défaut quand un brancard est créé, via la configuration
- Nombreux messages de diagnostic ajoutés en mode debug pour un support plus rapide en cas de souci.

#### 📋 Changelog - MasterStretcher (Mise à jour du 07/09) 3.3.12

- **Brancard mal positionné après rangement** : dans de rares cas, un brancard rangé dans un véhicule pouvait apparaître visuellement décalé/flottant, alors que le rangement semblait pourtant réussi. Une vérification supplémentaire est désormais faite après chaque rangement, avec une nouvelle tentative automatique si un problème est détecté.
- Renforcement de la fiabilité réseau lors du rangement, pour éviter les cas où l'opération semble aboutir sans l'être réellement.
- Corrections mineures de robustesse interne.

#### 📋 Changelog - MasterStretcher (Mise à jour du 11/09) 3.3.13 - 3.4.0

- **Décalages de véhicules incohérents selon le modèle de brancard** : les offsets de rangement (position dans l'ambulance) étaient calibrés pour un seul modèle de référence et ne convenaient pas forcément aux autres. Chaque véhicule accepte désormais un réglage dédié par modèle de brancard, appliqué aussi bien au rangement manuel qu'à l'auto-armement.
- **`permission_denied` remonté en boucle dans le dashboard** (action=patient) : les options du menu patient (s'installer, changer la position, placer/retirer un PNJ) n'étaient pas filtrées selon la permission du joueur avant affichage — le bouton apparaissait puis se faisait rejeter côté serveur.
- **`distance_too_far` remonté dans le dashboard** (action=stow, jusqu'à 49m constatés) : les options de rangement restaient sélectionnables bien au-delà de la portée autorisée. Un contrôle de distance côté client fait maintenant disparaître le bouton dès que le joueur s'éloigne.
- **Brancard bloqué "occupé" après déconnexion du patient** : si un joueur se déconnectait en étant allongé sur un brancard, celui-ci restait marqué occupé indéfiniment, empêchant quiconque de s'y installer ou de le libérer. Nettoyage automatique ajouté à la déconnexion.
- **Commande `/configStretcher <modèle>`** : calibration complète d'un modèle de brancard en jeu (position portée, position haute et basse au sol), avec animation de poussée réelle jouée pendant le réglage. Génère directement le bloc de configuration à coller.
- **Invitation à s'allonger avec consentement** : un secouriste peut désormais viser un autre joueur et lui proposer de s'allonger sur un brancard à proximité. Le joueur ciblé dispose de 10 secondes pour accepter ou refuser — plus aucun placement forcé d'un vrai joueur sur un brancard.
- **Permissions du menu patient revues** : s'installer soi-même, changer sa propre position et se relever sont désormais libres pour tout le monde. Agir sur un autre joueur ou un PNJ reste réservé aux secouristes.
- Réorganisation de `config.lua` pour plus de clarté (sections Audio et Objets &amp; Inventaire séparées, réglages mal classés remis à leur place).
- Ajout de la configuration pour le stryker [en vente ici](https://discord.gg/WRtcQ8NWkH)
- **Nouvelle version du Ferno F2 incluse** : changement de quelques textures (Textures du matelas, Textures du M.I.D. et de la couverture de survie retravaillées pour un meilleur rendu en jeu).

#### 📑 Changelog - MasterStretcher (Mise à jour du 21/10) - 3.4.1

⚠️ Aucune modification de config obligatoire. Deux nouveaux réglages facultatifs dans `config/config.lua` (voir plus bas), et la clé peut passer dans `server.cfg`.

##### **Nouveautés**

- **Clé dans server.cfg :** `set mastermods_key "MM-XXXXX"` est prioritaire sur `Config.MasterModsKey` et n'est jamais envoyée aux joueurs.
- **Guide de formation joueurs :** `Formation-Brancard-MasterStretcher.pdf` fourni dans l'archive (13 pages, fiche réflexe incluse).
- **Messages clairs :** l'option « Rentrer dans l'ambulance » reste affichée et explique au clic pourquoi c'est impossible (ambulance pleine, portes fermées).
- **Traductions complètes :** tous les textes du script sont traduits en français, anglais, allemand et espagnol ; une langue mal écrite (`en-us`…) ne casse plus rien.
- **Nouveaux réglages :** `Config.MaxStretchersPerPlayer = 2` (brancards en service par joueur) et `Config.AbandonedStretcherMinutes = 30` (nettoyage des brancards oubliés).

##### **Correctifs**

- **Rangement à plusieurs joueurs :** l'ambulance n'est plus bloquée « pleine » une fois sur trois. Le brancard auto-armé est fixé par le bon joueur et vérifié par le serveur.
- **Sortir le brancard d'une ambulance occupée :** fonctionne même si quelqu'un est resté assis dedans.
- **Brancard visible chez un seul joueur :** la prise en main exige désormais le contrôle réseau du brancard.
- **Avertissement F8 `GetNetworkObject: no object by ID` :** corrigé.
- **PNJ sur brancard :** installer et retirer un PNJ fonctionne de nouveau.
- **Brancard figé en l'air** après un rangement refusé : corrigé.
- **Recherche du brancard le plus proche :** ne vise plus une voiture.
- **Son des roues** qui se coupait en pleine poussée : corrigé.
- **Item perdu :** il n'est retiré qu'après l'apparition réussie du brancard, et le grade est vérifié.
- **Deux joueurs sur la même place :** impossible désormais.
- **Brancards orphelins :** supprimés avec leur ambulance ou après 30 minutes d'abandon.

##### **Sécurité**

- Le serveur valide toutes les actions sensibles : apparition des brancards (autorisation, distance, limite), relais, invitations, positions du patient, auto-armement (plus de duplication).
- Un joueur malveillant ne peut plus supprimer une entité arbitraire, voler un brancard ou imposer une animation à un autre joueur.
- La désactivation de licence est appliquée côté serveur.

#### 📑 Changelog - MasterStretcher (Mise à jour du 22/10) - 3.4.2

⚠️ Aucune modification de config nécessaire.

- **Ambulance qui part dans tous les sens avec un patient à bord :** corrigé. Le brancard rangé et son patient n'entrent plus en collision avec le véhicule.
- **Position du patient vue par les autres joueurs :** plus d'attache approximative en double, seule la position choisie par le patient est utilisée.

#### 📑 Changelog - MasterStretcher (Mise à jour du 22/10) - 3.4.3

⚠️ Aucune modification de config nécessaire.

- **Impossible de sortir le brancard après avoir roulé** (ou d'ouvrir le *Menu Intérieur*) : corrigé. Le serveur mesure maintenant la distance jusqu'à l'ambulance qui porte le brancard.

#### 📑 Changelog - MasterStretcher (Mise à jour du 24/10) - 3.5.0

⚠️ Aucune modification de config obligatoire. Nouvelle section facultative `Config.NPC` dans `config/config.lua` (zones hôpital à adapter à vos MLO).

##### **Nouveautés**

- **PNJ morts et blessés au sol :** ils s'installent sur le brancard (positions allongées). Pendant le transport, le PNJ reste immobile et invulnérable, et n'est plus supprimé par le jeu. Ramassé mort, il redevient un cadavre quand on le sort.
- **Confier le patient à l'hôpital :** dans les zones hôpital, le PNJ est pris en charge et le brancard libéré.
- **Serveurs 100 % PNJ :** exports et événements pour piloter les patients PNJ depuis vos scripts de missions (voir *Exports et événements*).

##### **Correctifs**

- **PNJ qui se relève ou tombe du brancard** quand un autre joueur en prend le contrôle réseau : corrigé.
- **qb-target :** l'option « Mettre sur le brancard » sur un PNJ fonctionne.
- **Brancard bloqué « occupé »** par un PNJ supprimé par un autre script : corrigé.
- **« Ouvrez d'abord les portes » alors qu'elles ont été arrachées :** corrigé, une porte arrachée compte comme ouverte.
- **PNJ sur brancard qui réagit aux explosions et coups de feu :** corrigé, il reste dans sa position.
- **Ambulance explosée :** le brancard rangé dedans a brûlé avec elle. Il apparaît calciné et n'est plus utilisable. Un brancard détruit peut toujours être supprimé.

#### 📑 Changelog - MasterStretcher (Mise à jour du 24/10) - 3.5.1

⚠️ Aucune modification de config nécessaire.

- **Brancard rangé supprimé par un autre script** (`/dv`, nettoyage des véhicules de txAdmin, garage) : l'ambulance est libérée tout de suite et peut être réarmée, au lieu de rester « pleine » jusqu'à une vérification.

#### 📑 Changelog - MasterStretcher (Mise à jour du 27/10) - 3.5.2

⚠️ Aucune modification de config nécessaire.

- **Options du brancard invisibles jusqu'à 30 min après une connexion ou un redémarrage :** corrigé.
- **Ambulance parfois sans brancard après l'auto-armement** (erreur `autoarm_attach_failed`) : le serveur n'attendait pas assez longtemps la confirmation d'un joueur à la connexion lente. Corrigé, avec un essai d'attache de plus.
- **Joueur bloqué en mode « pousser »** quand le brancard est supprimé pendant qu'il le tient : corrigé.
- **Mort ou mis dans un véhicule en poussant :** le brancard est reposé au sol et freiné.
- **Arme rangée avant l'animation de poussée** (bras mal placés) et **nom du collègue** affiché dans la demande de relais.

#### 📑 Changelog - MasterStretcher (Mise à jour du 30/10) - 3.6.0

⚠️ Aucune modification de config nécessaire.

- **MasterKey facultative :** le script fonctionne sans clé, le serveur est reconnu automatiquement par son adresse cfx.re. La clé reste utile pour rattacher le serveur à votre compte MasterMods (portail, support, outils Premium).
- **Console plus claire :** l'identité du serveur est affichée au démarrage, avec le lien cfx.re/join.

#### 📑 Changelog - MasterStretcher (Mise à jour du 01/11) - 3.6.1

⚠️ Aucune modification de config nécessaire.

- **Ambulance soudain sans brancard après une sortie ratée :** le brancard restait coincé, invisible, dans le véhicule. Il est maintenant remis en place automatiquement.
- **Diagnostic :** les erreurs du script et des joueurs sont remontées à MasterMods même sans le mode debug, pour corriger plus vite les problèmes rencontrés sur vos serveurs.

#### 📑 Changelog - MasterStretcher (Mise à jour du 01/11) - 3.6.2

⚠️ Aucune modification de config nécessaire.

- **Suivi des prises en charge :** le portail MasterMods affiche, pour chaque brancard occupé, s'il s'agit d'un joueur ou d'un PNJ, son état, sa position et depuis combien de temps il est installé. Aucune donnée personnelle n'est transmise.

#### 📑 Changelog - MasterStretcher (Mise à jour du 01/11) - 3.6.3

⚠️ Aucune modification de config nécessaire.

- **Brancard invisible après une invitation :** inviter un joueur à s'allonger pendant qu'on pousse le brancard le rendait invisible pour ce joueur, et impossible à reprendre. Le brancard est maintenant posé automatiquement (freins serrés) avant l'installation du patient, puis peut être repris normalement.
- **Brancard brûlé avec un patient dessus :** le patient peut maintenant en descendre (et un PNJ peut être retiré), le brancard restant inutilisable pour le reste.
- **Patient allongé :** il ne peut plus prendre le relais ni recevoir d'invitation tant qu'il est sur un brancard.

#### 📑 Changelog - MasterStretcher (Mise à jour du 01/11) - 3.6.4

⚠️ Nouvelle option facultative : `Config.RequireOnDuty` (voir [Configuration détaillée](https://docs.raph-dev.fr/books/generalites-important/page/configuration-detaillee)). Sans elle, rien ne change.

- **Ambulance sans brancard à l'apparition :** sur les machines de joueurs peu puissantes, le brancard automatique pouvait ne jamais apparaître. Corrigé.
- **Service :** avec la restriction métier, le script peut exiger d'être en service (QB, QBX, ESX récent).
- **Redémarrage du script en cours de partie :** les options du brancard ne disparaissent plus pour les métiers autorisés.
- **Fluidité :** les vérifications de permission sont mises en cache.

#### 📑 Changelog - MasterStretcher (Mise à jour du 19/11) - 3.6.5

⚠️ Aucune modification de config nécessaire.

- **Brancard automatique pas fixé dans l'ambulance :** quand le serveur confiait le brancard à un autre joueur que celui assis dans l'ambulance, la fixation pouvait échouer. Corrigé.
- **Sortie du brancard :** l'ambulance n'est plus considérée à tort comme vide pendant qu'un joueur sort le brancard.
- **Brancard en double :** une ambulance dont le brancard avait été sorti pouvait en recevoir un second. Corrigé.
- **Prendre un brancard posé :** échouait parfois avec « Connexion réseau instable » quand un autre joueur était plus près. Corrigé.
- **Menu Extras :** n'apparaît plus pour les joueurs dont le grade ne l'autorise pas.