Flight Warning Systems

A complete cockpit warning suite that any aircraft mod can hang into itself.

Nothing here is tied to a specific airframe. The components read what they need out of the base game's flight simulation, so a vanilla helicopter and a third-party airliner get the same warnings with the same effort: drop the components on, done.


AEROPLANE WARNINGS

GPWS
- Mode 1 — excessive sink rate (SINKRATE, PULL UP)
- Mode 2 — excessive terrain closure (TERRAIN, PULL UP)
- Mode 3 — altitude loss after takeoff (DONT SINK)
- Mode 4 — unsafe configuration near the ground (TOO LOW GEAR, TOO LOW FLAPS)
- Mode 5 — below glideslope (GLIDESLOPE)
- Too Low Terrain, Bank Angle, Minimums and Approaching Minimums
- Altitude callouts from 2500 down to 10 feet
- EGPWS look-ahead that scans the terrain beside the flight path (CAUTION TERRAIN)

TCAS
- Traffic advisory (TRAFFIC TRAFFIC)
- Resolution advisory (CLIMB NOW, DESCEND NOW)

Stall protection
- Stall warning, stick shaker and camera shake

System tones
- V1, Rotate, Positive Rate, Gear Up
- Overspeed, fire bell, autopilot disconnect

Configuration warnings
- Takeoff configuration check — flaps, trim and parking brake on the takeoff roll
- Landing gear horn — throttle back, low, gear still up


HELICOPTER WARNINGS

- HTAWS terrain awareness that works in the hover, where a fixed-wing GPWS switches itself off
- Wire strike warning against powerlines
- Low rotor RPM, critical low RPM and rotor overspeed
- Vortex ring state
- Height-velocity avoid region


CONFIGURABLE, NOT OPINIONATED

Who hears the callouts is a setting too: pilots only, the whole flight crew, a radius around the
cockpit, everyone on board, or everyone in earshot. Aircraft with their own cockpit prefab and
aircraft without one are both supported.

Any sound event can be blanked out by clearing its name field, which lets a warning keep computing
while staying silent.


FOR AIRCRAFT MODDERS

Minimum install is two components and one entry in the sound component's file list. Put
FWS_AudioRouter and whichever warning components you want on the cockpit prefab (or on the aircraft
itself if there is no cockpit prefab), add the master switches to the aircraft, and register the
three .acp files.

Gear, flaps, throttle and rotor RPM come out of VehicleFixedWingSimulation and
VehicleHelicopterSimulation on their own. If your mod has its own flight model, feed the values in
through FWS_AircraftState — either by calling the setters or by deriving your own class and
overriding the getters. Anything you do not report counts as in order, so a partial integration
never produces false alarms.

TCAS detects the base game's aeroplane and helicopter simulations by default. Mods with their own
flight simulation add their component class name in one attribute field.

Callouts are not replicated — every machine decides locally whether it hears them, which costs zero
network traffic and is the right model for a cockpit speaker anyway.

The full integration guide ships with the mod as README_Integration.md.


NOTES

Two of the helicopter warnings do not exist as certified equipment in reality — vortex ring state
and the height-velocity avoid region. They are included because they are useful in game, and they
are switchable like everything else.

Some of the newer warnings currently borrow existing callouts because no dedicated recording exists
for them yet. Each one is a prefab attribute, so supplying your own recording is a matter of typing
in the event name.