Ambiance - Random RHS Flybys

==============================================================================
AMBIANCE - RANDOM RHS FLYBYS
==============================================================================

DESCRIPTION:
This addon adds random RHS flyby spawning to any gamemode. Flybys will occur at random intervals, locations, and directions across the map.

Works out of the box, but it's configurable.

==============================================================================
CONFIGURATION:
==============================================================================

The mod uses JSON config by default.

External JSON Config File (Default, Recommended)
1. Start the server/mission once - a default config will be created at:
   $profile:RandomRHSFlybys/config.json
2. Edit config.json with any text editor
3. Restart server to apply changes

CONFIGURABLE SETTINGS DEFAULTS:

Minimum Interval:
  Default: 240 seconds (4 minutes)
  The shortest time between flybys

Maximum Interval:
  Default: 600 seconds (10 minutes)
  The longest time between flybys

Spawn Height Offset:
  Default: -10 meters
  Offset from the world bounding box top (can be negative)
  NOTE: This is NOT the highest terrain point, but the world's upper limit
  Example: If world bbox top is 1000m and offset is -10, planes spawn at 990m
           If offset is -200, planes spawn at 800m

Duration Before Flyby Is Deleted:
  Default: 23 seconds
  Should match the length of the RHS flyby animation

Enable Formations:
  Default: Checked
  Randomly spawns 1, 2, or 3 aircraft flying together in formation
  All aircraft in a formation are the same type (all F-22 or all SU-57)

Formation Spacing:
  Default: 50 meters
  Lateral distance between aircraft in formation

Formation Depth Variation:
  Default: 20 meters
  Max forward/backward offset for visual variety in formation

Enable Random Flybys:
  Default: Checked
  Toggle to enable/disable the system

==============================================================================
EXAMPLE: JSON CONFIG FILE
==============================================================================

The JSON config file is automatically created at:
$profile:RandomRHSFlybys/config.json

Example config.json content:
{
  "minInterval": "240",
  "maxInterval": "600",
  "spawnHeightOffset": "-10",
  "flybyDuration": "30",
  "enableFormations": "1",
  "formationSpacing": "50",
  "formationDepthVariation": "20",
  "enabled": "1"
}

Notes:
- minInterval/maxInterval: Time between flybys in seconds (240-600 = 4-10 minutes)
- spawnHeightOffset: Offset from world bounding box top in meters
  Can be negative (e.g., "-10" spawns 10m below world bbox top)
- flybyDuration: How long before the flyby entity is deleted
- enableFormations: "1" = formations enabled, "0" = always single aircraft
- formationSpacing: Lateral distance between aircraft in meters
- formationDepthVariation: Max forward/backward offset in meters
- enabled: "1" = enabled, "0" = disabled

Simply edit the values and restart your server to apply changes.

IMPORTANT: Spawn height is based on the world's bounding box top, NOT the
highest terrain point. This means all flybys spawn at the same altitude. They won't ever collide with any mountain or object unless the offset is negative.
Adjust spawnHeightOffset as needed for your map.

-- -- -- -- --

This mod adheres to RHS EULA: https://docs.rhsmods.org/rhs-status-quo-user-documentation/arma-reforger/rhs-status-quo/eula