Browse docs

Protective Gear and Air

Firefighter clothing validation, heat protection, smoke exposure, and breathing air systems.

Protective gear

Sky Fire Job can validate firefighter PPE through Config.FireSystem.protectiveGear. The default configuration separates:

  • Breathing-related components
  • Heat-protection components
  • Required helmet prop

If a player's outfit does not match the configured components, the intended protection is reduced or unavailable.

Smoke and breathing air

The breathing system supports:

  • Smoke exposure scaling
  • Toxic smoke exposure scaling
  • SCBA air capacity
  • Pressure bar display
  • Optional inventory-backed air bottle items
  • Optional refill station support
  • A separate wildfire protective mask without cylinder air
  • Independent normal and toxic smoke protection for the wildfire mask

When inventory metadata support is available, air bottle state can be saved and restored through the breathing-air item flow.

The fire_protective_mask item uses its own clothing rules and smoke multipliers. By default it blocks most normal smoke while allowing most toxic exposure through, so SCBA remains the appropriate protection for vehicle, structure, and hazardous-material fires. SCBA and the protective mask are mutually exclusive.

Refill stations

When refill support is enabled, firefighters can use SCBA refill stations placed through the fire creator flow. Foam refills are configured separately under Config.Hose.foamRefill.

Mask overlay

Optional mask overlays can be configured independently for SCBA and the wildfire protective mask. Both stay disabled by default and can force first-person view when enabled. The wildfire mask never displays the SCBA pressure gauge.

Heat protection

Heat protection reduces incoming heat and burn severity according to the configured multipliers. The default setup can also prevent automatic ignition while the correct equipment is worn.

NPC reactions

The fire system also includes configurable NPC reactions near active incidents, including:

  • Panic behavior
  • Filming behavior
  • Reaction radius and duration
  • Maximum tracked nearby peds

Testing checklist

  • Confirm the configured firefighter uniform matches the required component IDs.
  • Test smoke exposure with and without full breathing gear.
  • Test normal and toxic smoke with the wildfire protective mask.
  • Confirm air drains while SCBA is active.
  • Test air refill at a refill station when enabled.
  • Confirm the helmet prop and all required components are applied correctly.