Script MasterFire

MasterFire : simulation d'incendies pour FiveM (MasterMods).

Présentation

MasterFire est le script d'incendies de MasterMods pour FiveM. Il fait apparaître des feux qui se propagent, évoluent et se combattent de façon réaliste, avec une gestion complète des interventions pour les serveurs pompiers.

Ce que fait le script

Compatibilité

Licence

MasterFire est gratuit. Il nécessite une MasterKey, gratuite elle aussi, la même que pour les autres scripts MasterMods : voir Installation.

Support : discord.mastermods.dev

Installation

1. MasterKey

MasterFire est gratuit mais nécessite une MasterKey. Si vous en avez déjà une pour MasterStretcher ou MasterLadder, c'est la même.

Sinon, créez-la sur ressources.mastermods.dev/CreerMasterKey.php.

2. Ressource

  1. Décompressez l'archive et placez le dossier MasterFire dans resources/. Ne le renommez pas : les autres scripts l'appellent par exports.MasterFire.
  2. Dans server.cfg, après votre framework :
set mastermods_key "MM-XXXXX"
ensure MasterFire

# Administrateurs : tous les droits (menu /mfire, /fire…)
add_ace group.admin masterfire.admin allow

# Facultatif : rapports d'intervention sur votre Discord
set masterfire_webhook "https://discord.com/api/webhooks/..."

  1. Ouvrez config/config.lua et réglez au minimum :

    • Config.FrameworkMetier : esx, qb, qbx, ox ou standalone ;
    • Config.NotifySystem : votre système de notifications ;
    • les droits : voir Permissions & administration.

  2. Redémarrez le serveur. La console doit afficher :

[MasterFire] Licence MasterMods validée pour : <nom de votre serveur>

3. Premier test

En jeu, en administrateur : /mfire, choisissez « Incendie d'habitation », puis « Allumer devant moi ». Éteignez-le à l'extincteur (arme WEAPON_FIREEXTINGUISHER).

Mise à jour

Remplacez le dossier en conservant vos fichiers config/*.lua et data/scenarios.json (vos scénarios enregistrés). Comparez vos fichiers de config avec ceux de la nouvelle version : les nouvelles options sont listées dans les Journaux des changements.

Guide d'utilisation

Pour les pompiers

Recevoir l'appel

Avec le dispatch intégré, les pompiers en service reçoivent une notification (type de feu, adresse, nombre de foyers) et un blip clignotant. /firegps pose l'itinéraire vers le dernier appel, /firegps 2 vers l'avant-dernier.

Éteindre

Moyen Agent Portée
Extincteur du jeu (viser, tirer) Poudre 10 m
Canon à eau d'un engin (firetruk par défaut) Lance canon 75 m
Lance canon de MasterLadder Lance canon portée de l'échelle
Script de lance compatible Eau 30 m

Se protéger

Fin d'intervention

Quand le dernier foyer est éteint, tous les pompiers et tous ceux qui ont arrosé reçoivent « Fin d'intervention », et le blip disparaît.

Pour l'administration : menu /mfire

Onglet Feux

Mode placement

« 📍 Placer les foyers » ferme le menu et passe en visée :

Le cercle au sol montre la surface que le feu occupera environ. Tous les foyers forment une seule intervention.

Onglet Scénarios

Commandes

Commande Effet
/mfire Menu de gestion
/fire start [type|préréglage] [taille] [dispatch] Allume un feu 3 m devant soi
/fire stop [n°] Annule l'intervention indiquée, ou la plus proche (60 m)
/fire stopall · /fire list Annule toutes les interventions · les liste
/fire scenario add <type|préréglage> <taille> <nom> Enregistre un scénario à sa position
/fire scenario del|list|start <n°> Gère les scénarios
/fire scenario random <n°> on|off Ajoute / retire du générateur
/fire spawner on|off Active / désactive le générateur
/firegps [n] Itinéraire vers le n-ième appel reçu (tous les joueurs)
/mfsurface Surface visée (diagnostic, Config.Debug = true)
mfireHeartbeat Console serveur, Config.Debug = true : force licence, télémétrie et carte

Types : solid, liquid, electrical, vehicle. Préréglages : trash, car, house, warehouse, tanker, transformer, brush.

Configuration générale

Fichier config/config.lua. Il reste lisible après l'escrow.

Licence et langue

Framework et permissions

Gameplay

Option Défaut Rôle
MaxFires 20 Foyers actifs simultanés sur le serveur
MaxFlamesPerFire 60 Plafond de flammes par foyer
DefaultSize 15 Flammes visées si la taille n'est pas précisée
SpreadInterval 4000 ms entre deux tentatives de propagation
SpreadChance 35 % de chance de propagation à chaque tentative (avant phase, surface et météo)
SpreadMinDistance / SpreadMaxDistance 1,5 / 3,5 Distance (m) entre une flamme et la suivante
SpreadMaxHeightGap 3,0 Dénivelé maximal accepté
SpreadInitialBurst 0,4 Part de la taille créée dès le départ
RegenPerSecond 1,5 Points de vie regagnés par une flamme non arrosée

Fumée

Option Défaut Rôle
EnableSmokeDamage true Dégâts de fumée sans ARI
SmokeRadius / SmokeDamage / SmokeTick 5 m / 2 / 2000 ms Zone, dégâts et fréquence
SmokeMinFlames 4 Taille de foyer à partir de laquelle la fumée blesse
SmokeVision true Visibilité réduite dans la fumée
SmokeVisionRadius / SmokeVisionStrength 9 m / 0,85 Distance et intensité du voile
SmokeVisionModifier BarryFadeOut Timecycle GTA utilisé

Dispatch

Générateur aléatoire

SpawnerOnStart, SpawnerInterval (minutes), SpawnerChance (%), SpawnerMinFirefighters.

Sécurité réseau

Rendu

StreamInDistance / StreamOutDistance (160 / 190 m), RenderTick, NativeFire (feux natifs GTA sous les effets : ils brûlent les joueurs et réagissent à l'eau du jeu), FireSound.

Commandes et placement

Command (fire), GpsCommand (firegps), MenuCommand (mfire), PlacementRange (120 m), MaxOriginsPerIncident (8 foyers).

Debug

Feux, apparence et préréglages

Fichier config/fire.lua.

Types de feu

Type Feu PV d'une flamme Remarque
solid Sec (bois, papier, mobilier) 100 L'eau est l'agent idéal
liquid Liquide (carburant, huile) 130 L'eau l'aggrave : mousse, poudre ou lance
electrical Électrique 80 L'eau est sans effet et électrise : poudre ou CO₂
vehicle Véhicule 120 Mousse recommandée

effectiveness donne le multiplicateur de chaque agent : 0 sans effet, valeur négative = aggrave. waterShockDamage : dégâts infligés à qui arrose un feu électrique. spreadMultiplier : vitesse de propagation propre au type.

Agents

Agent Portée Remarque
water 30 m Scripts de lance, eau du jeu
cannon 75 m Joueur dans un véhicule (Config.CannonVehicles) ; MasterLadder
foam 30 m Réservée à l'action extinguish (pompiers)
powder 10 m Extincteur du jeu (arme vérifiée par le serveur)
co2 7 m Scripts d'extincteur CO₂

maxReach est vérifié par le serveur : un impact plus loin que la portée est refusé et signalé dans les logs.

Particules

Config.Particles liste les effets proposés dans le menu, par type : flame, smoke, extra. Ajoutez n'importe quel effet natif de GTA :

mon_effet = { kind = "smoke", label = "Ma fumée", asset = "core", name = "nom_de_l_effet", offset = 1.0 },

Un effet introuvable n'empêche rien : la console affiche « Effet introuvable : Config.Particles.mon_effet ».

Préréglages

Config.Presets : feux prêts à l'emploi, proposés dans le menu et utilisables par /fire start house ou CreateFire(coords, nil, { preset = 'house' }).

Préréglage Type Flammes Particularité
trash (poubelle) solid 2 Ne se propage pas
car (voiture) vehicle 6 Foyer principal plus gros, fumée noire
house (habitation) solid 30 Fumée noire épaisse
warehouse (entrepôt) solid 55 Grands panaches
tanker (citerne) liquid 20 bleve = true : peut exploser
transformer electrical 4 Étincelles
brush (broussailles) solid 45 Propagation rapide, fumée blanche

Réglages visuels d'un préréglage (visual) : flame, flameScale, mainBoost (taille du foyer d'origine), smoke, smokeScale, smokeEvery (1 = fumée sur chaque flamme, 6 = légère), smokeAlpha, extra, extraScale, extraEvery. Tous sont aussi réglables dans le menu, feu par feu.

Réalisme

Fichier config/realism.lua. Chaque section a un enabled pour la désactiver.

Phases du feu

Chaque foyer a une chaleur de 0 à 100. Elle monte tant qu'il brûle (plus vite s'il est grand) et baisse quand on l'arrose : l'eau et la lance refroidissent bien, la poudre et le CO₂ peu.

Phase Quand Effet
Éclosion chaleur < 25 Petites flammes, propagation ×0,5
Développement chaleur < 70 Comportement normal
Embrasement chaleur ≥ 70 Grandes flammes, fumée épaisse, propagation ×1,8
Couvant intérieur embrasé et fermé Flammes basses, fumée dense, ne se propage plus (voir backdraft)
Déclin combustible épuisé Le feu s'éteint de lui-même

Combustible (fuelMinutes) : durée de vie d'un feu laissé seul, par type (sec 25 min, liquide 15, électrique et véhicule 10), plus longue pour un grand feu. 0 = illimité. Un feu éteint ainsi apparaît comme « éteint faute de combustible ».

Surfaces

La propagation dépend de la surface sous la flamme :

Surface Coefficient
Végétation ×1,7
Bois ×1,3
Intérieur ×1,1
Terre ×0,8
Béton, pierre ×0,45
Métal ×0,4
Route ×0,3
Sable ×0,2
Eau 0 (jamais)

Un départ de feu sur une route reste donc petit, un feu de broussailles part vite.

Les surfaces sont reconnues par leur hash de matériau (Config.Surfaces.materials). Pour compléter la table : Config.Debug = true, visez le sol et tapez /mfsurface, qui affiche le hash et la catégorie retenue. Un hash inconnu compte comme « autre » (×1), et les routes sont reconnues même sans hash.

Vent et météo

Feux en intérieur

Détectés automatiquement dans les intérieurs du jeu et les MLO. Un bâtiment sans intérieur (façade seule) est traité comme un feu extérieur.

Phénomènes dangereux

L'ARI ne protège pas de leurs dégâts. Les joueurs à moins de 60 m reçoivent les signes précurseurs.

Flashover (embrasement généralisé éclair)

Un intérieur dont la chaleur atteint 90 s'embrase d'un coup : +10 flammes, dégâts dans un rayon de 9 m. À 75, l'avertissement « fumées chaudes sous plafond » invite à refroidir.

Backdraft (explosion de fumées)

Un intérieur embrasé que personne n'ouvre manque d'air au bout de 2 min et devient couvant. Entrer alors qu'il est encore chaud (≥ 65) provoque l'explosion : +8 flammes, dégâts dans 7 m. Refroidir depuis l'entrée avant d'entrer l'évite, et le feu repart normalement.

BLEVE (explosion de citerne)

Une citerne (préréglage tanker, ou bleve = true) monte en pression tant qu'elle chauffe. À mi-parcours, la soupape siffle, une alerte part et un compte à rebours s'affiche à l'écran. Au bout (4 min sans refroidissement), elle explose : rayon de 35 m, +20 flammes. Arroser le foyer fait redescendre la pression.

nativeExplosion ajoute l'explosion native de GTA (dégâts aux véhicules). Désactivée par défaut : beaucoup d'anticheats bloquent les explosions.

Permissions & administration

Les 6 actions

Action Donne accès à
extinguish Agents réservés (mousse)
dispatch Recevoir les appels incendie ; compte comme pompier pour le générateur
stop /fire stop, /fire stopall, /fire list, liste des interventions dans le menu
start Allumer un feu (commande, menu, placement)
scenario Créer, lancer, supprimer des scénarios
spawner Activer / désactiver le générateur aléatoire

Le menu /mfire n'affiche que ce que le joueur a le droit de faire, et chaque clic est revérifié par le serveur.

ACE (tous les modes)

add_ace group.admin masterfire.admin allow             # toutes les actions
add_ace group.pompiers masterfire.firefighter allow    # extinguish + dispatch
add_principal identifier.license:xxxx group.pompiers

Sans restriction métier

Config.JobRestriction = false (ou framework standalone) : tout le monde peut éteindre, les appels et l'administration passent uniquement par les ACE ci-dessus.

Avec restriction métier

Config.JobRestriction = true : chaque action exige le grade minimum indiqué par métier.

Config.AuthorizedJobs = {
    ['pompier']   = { extinguish = 0, dispatch = 0, stop = 3, start = 4, scenario = 4, spawner = 4 },
    ['ambulance'] = { dispatch = 2 },
}
Config.RequireOnDuty = true -- QBCore / QBox : il faut être en service

Une action absente pour un métier lui est interdite. Les ACE restent prioritaires.

Mode développement

Config.BypassPermissions = true donne tous les droits à tous les joueurs, pour tester sans rien configurer. Un bandeau rouge s'affiche dans le menu et un avertissement dans la console. À remettre à false avant d'ouvrir le serveur.

Journaux

Intégrations

MasterLadder

La lance canon de la nacelle éteint les feux MasterFire : chaque impact compte comme agent cannon, avec son efficacité selon le type de feu, et le porteur de la lance est crédité dans le rapport d'intervention.

Côté MasterLadder (config/config.lua) :

Config.WaterMonitor = {
    -- …
    masterFire = { enabled = true, resource = "MasterFire", radius = 3.0, multiplier = 1.0 },
}

Scripts de lance à incendie

Deux possibilités :

Appareil respiratoire (ARI)

L'ARI protège des dégâts de fumée (pas de la perte de visibilité). Un script d'ARI le déclare côté client :

exports.MasterFire:SetBreathingApparatus(true)   -- ou false à la dépose
-- ou :
LocalPlayer.state:set('masterfire:scba', true, true)

Dispatch

AddEventHandler('masterfire:server:dispatch', function(data)
    -- data.incidentId, data.label, data.typeLabel, data.foyers, data.coords, data.jobs
end)

Autres scripts (braquages, accidents…)

-- feu de véhicule après un accident, avec appel des pompiers
exports.MasterFire:CreateFire(coords, nil, { preset = 'car', dispatch = true })

Voir Exports et événements.

Exports et événements

Exports serveur

-- Un foyer → fireId, incidentId (ou nil, erreur)
local fireId, incId = exports.MasterFire:CreateFire(coords, 'liquid', {
    size = 20, preset = nil, label = 'Station-service', dispatch = true,
    difficulty = 1.0, spreadChance = 35, bleve = false, visual = nil,
})

-- Plusieurs foyers = une intervention (un appel, un rapport) → incidentId, fireIds
local incId, fireIds = exports.MasterFire:CreateIncident({ c1, c2, c3 }, nil, { preset = 'house', dispatch = true })

exports.MasterFire:RemoveIncident(incId)
exports.MasterFire:RemoveFire(fireId)
exports.MasterFire:RemoveAllFires()

exports.MasterFire:GetIncidents()               -- interventions en cours (résumé)
exports.MasterFire:GetFire(fireId)              -- foyer : flammes, phase, chaleur, intérieur, BLEVE…
exports.MasterFire:GetFires()
exports.MasterFire:GetNearestFire(coords, radius) -- → foyer, distance
exports.MasterFire:IsOnFire(coords, radius)
exports.MasterFire:IsLicensed()

-- Appel de confiance (canon, échelle, bras élévateur) : pas de contrôle de portée
local flammes = exports.MasterFire:ApplyAgent('cannon', impact, 2.5, 1.0, sourceJoueur)

exports.MasterFire:StartScenario(scenarioId, dispatch) -- → incidentId
exports.MasterFire:SetSpawner(true)

Erreurs possibles : license (licence non validée), limit (trop de feux), origins (foyers invalides), type, coords.

Exports client

exports.MasterFire:SprayAt('water', impact, 1.5)          -- validé par le serveur
exports.MasterFire:SetBreathingApparatus(true [, silencieux])
exports.MasterFire:HasBreathingApparatus()
exports.MasterFire:GetNearestFlame(coords, radius)        -- → fireId, flameId, distance
exports.MasterFire:IsNearFire(coords, radius)
exports.MasterFire:GetFires()

Événements serveur (AddEventHandler)

Événement Paramètres
masterfire:server:incidentStarted incidentId, { label, type, coords, fires, scenarioId }
masterfire:server:incidentClosed incidentId, résumé (outcome extinguished / burned_out / cancelled, durée, intervenants, agents, phénomènes…)
masterfire:server:fireCreated fireId, { type, coords, size, scenarioId, incidentId }
masterfire:server:fireRemoved fireId, raison, { scenarioId, incidentId }
masterfire:server:phaseChanged fireId, nouvellePhase, anciennePhase
masterfire:server:phenomenon fireId, 'flashover' | 'backdraft' | 'bleve'
masterfire:server:dispatch { incidentId, label, typeLabel, foyers, coords, jobs }
masterfire:server:licenseChanged valide

En cas d'erreur

Activez d'abord Config.Debug = true : la console détaille ce que fait le script.

« Licence MasterMods refusée »

La console explique la raison. À vérifier :

Tant que la licence n'est pas validée, aucun feu ne peut être créé (l'extinction reste possible).

« API MasterMods injoignable (code 0) »

Le serveur ne peut pas sortir sur Internet (pare-feu, DNS, hébergeur). Le script tolère environ 1 h 30 de coupure avant de bloquer la création de feux.

« DÉMARRAGE BLOQUÉ : fichier(s) manquant(s) »

Un fichier de la ressource a été supprimé ou vidé. Réinstallez depuis l'archive d'origine.

« Vous n'avez pas la permission »

Voir Permissions & administration. Pour tester rapidement : Config.BypassPermissions = true (puis remettez false).

Un feu existe (/fire list) mais rien ne s'affiche

Le feu ne se propage pas

Le feu ne s'éteint pas

Les appels n'arrivent pas

Support

discord.mastermods.dev : joignez la console serveur et la console F8 avec Config.Debug = true.

Journaux des changements

1.0.0 - 2026-10-24

Première version publique.

Ajouté