WhiskyTangoFoxtgrot_3 EWRS Script v15.9(Stable) - README
==============================

DESCRIPTION
-----------
This script provides Early Warning Radar System (EWRS) functionality for DCS missions. It detects airborne enemy aircraft within radar range and issues formatted BRAA callouts (Bearing, Range, Altitude, Aspect), with additional support for friendly picture and enemy helicopter picture on request.

FEATURES
--------
- Works for either Blue or Red coalition (coalition-agnostic)
- Detects enemy aircraft using all active radar units with "EWR_" prefix
- BRAA callouts every 25 seconds (normal), or every 3 seconds if enemy is within 10nm
- Displays detailed callouts: aircraft type, heading, range, altitude, aspect
- Adds clock direction + altitude cue when enemy is within 5nm
- Filters out units that are destroyed (dead or exploded)
- Callouts are automatically sorted by ascending distance
- Standalone script (does NOT require MIST or other frameworks)
- Optional F10 Radio Commands for:
  - Toggling automatic EWRS reports
  - Requesting friendly picture
  - Requesting enemy helicopter picture

RADAR UNIT SETUP
----------------
To be used as a radar, a group must have a name starting with "EWR_". The script automatically scans for all active radar units (AWACS or ground-based) with this prefix.

Examples:
- EWR_AWACS1
- EWR_RadarSiteEast

CALL OUT FORMAT
---------------
Standard format:
[Type]    BRAA [Bearing]° / [Range]nm  ALT [Angels/Cherubs X]  ASPECT [Hot/Cold/etc]

If enemy is within 5nm, a clock cue and relative altitude cue is appended:
[Type]    BRAA [Bearing]° / [Range]nm  ALT [Angels X]  ASPECT [Hot]  [3 o'clock High]

Examples:
F-4E-45MC BRAA 138° / 10nm  ALT Angels 12  ASPECT Cold  6 o'clock Level
Mig-21bis BRAA 342° / 25nm  ALT Angels 15  ASPECT Flanking Left

Altitude Cue:
- "Angels" = altitude in thousands of feet (e.g. Angels 15 = ~15,000 ft)
- "Cherubs" = altitude under 10,000 ft (e.g. Cherubs 3 = ~3,000 ft)

Distance Cue:
- Distance is rounded to nearest whole number of nautical miles

ALTITUDE FLOOR
--------------
Units must be airborne above 50 feet AGL to be detected by radar. This prevents parked or taxiing aircraft from being reported.

F10 RADIO COMMANDS
------------------
Under F10 > Other:
- Toggle EWRS Callouts       → Enables or disables automatic enemy reporting
- Request Friendly Picture   → Returns list of detected friendly air units
- Request Enemy Helicopter Picture → Reports airborne enemy helicopters


NOTES
-----
- EWRS callouts only display when enemy aircraft are within radar range and above the minimum altitude
- Destroyed units are excluded from further reports
- Friendly and Helo picture reports are available on request, not automatic
- Works with dynamically activated and late-spawned aircraft

--------------------------------------
End of README - WhiskyTangoFoxtgrot_3 EWRS Script v15.9
--------------------------------------
