Skip to content
cjcarw edited this page Feb 27, 2026 · 4 revisions

Welcome to the BS Patrol Helicopter Wiki! 🚁

BS Patrol Helicopter is an advanced, highly customizable, and dynamic server-side event mod for DayZ. It introduces a fully autonomous AH-64D Apache helicopter that patrols your map, intelligently engages threats, and generates high-value, dynamic crash sites when shot down.


🌟 Core Features

  • Dynamic Waypoint Patrols: The helicopter smoothly navigates through custom routes defined by server admins.
  • Advanced AI Flight Controller: Features terrain clearance detection to avoid mountains and a dynamic combat state machine (Orbit, Pull Back, U-Turn, Attack Run).
  • Lethal Weapon Systems: Equipped with machine guns and unguided missiles. Includes a "Suppression Mode" that unleashes an area-of-effect missile barrage if the heli takes damage but loses line of sight to the attackers.
  • Realistic Crash Physics: Upon reaching 0 HP, the heli experiences critical failures (tail rotor loss, engine fires) and falls using actual physics (gravity, drag, momentum, bouncing) before exploding.
  • Locked Burning Loot: Drops burning crates that cannot be opened until the fire naturally dies out, forcing players to defend the crash site.
  • Crash Defenders: Spawns Vanilla Zombies or Expansion AI Bots to guard the crash site.
  • Native Integrations: Out-of-the-box support for Expansion (Markers, Notifications, AI) and LBMaster (Groups/Markers, Preset Loot).

πŸ“‚ Getting Started

Run your server once with the mod installed to generate the configuration directory. The main configuration file will be located at:

$profile:BS_PatrolEvent/BS_HeliConfig.json

Note: In DayZ JSON configs, booleans are represented as 1 for true and 0 for false.

Tip: The mod has AutoUpdateConfig enabled by default. When a new version adds config sections, they will be added to your existing JSON automatically on next server boot. Set "AutoUpdateConfig": 0 if you prefer to manage updates manually.


πŸ“– Wiki Pages

Page Description
Event Settings Master event toggle, timers, player requirements, wreck despawn
Helicopter Settings Helicopter class, health, patrol routes, aggression behavior
Difficulty & Combat Turret, missiles, flares, combat states, suppression mode, crash damage
Wreck & Loot System Wreck settings, crate types, loot categories, LBMaster integration
Crash Defenders Vanilla zombies, Expansion AI bots, night scaling, despawn logic
Notifications & Markers Server-wide alerts, Expansion map markers, LBMaster markers, searchlight
FAQ & Troubleshooting Common issues, log locations, coordinate format, compatibility

πŸ“ Config File Structure Overview

Your BS_HeliConfig.json is divided into the following top-level blocks:

{
    "ConfigVersion": 3,
    "AutoUpdateConfig": 1,
    "EventSettings": { ... },
    "HelicopterSettings": { ... },
    "Notifications": { ... },
    "WreckSettings": { ... },
    "SearchLightSettings": { ... },
    "MarkerSettings": { ... },
    "Difficulty": { ... },
    "CrashDefenders": { ... },
    "LootCategories": { ... },
    "LootCrates": [ ... ]
}

Each block is documented in detail on its respective wiki page.

# Welcome to the BS Patrol Helicopter Wiki! 🚁

BS Patrol Helicopter is an advanced, highly customizable, and dynamic server-side event mod for DayZ. It introduces a fully autonomous AH-64D Apache helicopter that patrols your map, intelligently engages threats, and generates high-value, dynamic crash sites when shot down.


🌟 Core Features

  • Dynamic Waypoint Patrols: The helicopter smoothly navigates through custom routes defined by server admins.
  • Advanced AI Flight Controller: Features terrain clearance detection to avoid mountains and a dynamic combat state machine (Orbit, Pull Back, U-Turn, Attack Run).
  • Lethal Weapon Systems: Equipped with machine guns and unguided missiles. Includes a "Suppression Mode" that unleashes an area-of-effect missile barrage if the heli takes damage but loses line of sight to the attackers.
  • Realistic Crash Physics: Upon reaching 0 HP, the heli experiences critical failures (tail rotor loss, engine fires) and falls using actual physics (gravity, drag, momentum, bouncing) before exploding.
  • Locked Burning Loot: Drops burning crates that cannot be opened until the fire naturally dies out, forcing players to defend the crash site.
  • Crash Defenders: Spawns Vanilla Zombies or Expansion AI Bots to guard the crash site.
  • Native Integrations: Out-of-the-box support for Expansion (Markers, Notifications, AI) and LBMaster (Groups/Markers, Preset Loot).

πŸ“‚ Getting Started

Run your server once with the mod installed to generate the configuration directory. The main configuration file will be located at:

$profile:BS_PatrolEvent/BS_HeliConfig.json

Note: In DayZ JSON configs, booleans are represented as 1 for true and 0 for false.

Tip: The mod has AutoUpdateConfig enabled by default. When a new version adds config sections, they will be added to your existing JSON automatically on next server boot. Set "AutoUpdateConfig": 0 if you prefer to manage updates manually.


πŸ“– Wiki Pages

Page Description
[Event Settings](Event-Settings) Master event toggle, timers, player requirements, wreck despawn
[Helicopter Settings](Helicopter-Settings) Helicopter class, health, patrol routes, aggression behavior
[Difficulty & Combat](Difficulty-&-Combat) Turret, missiles, flares, combat states, suppression mode, crash damage
[Wreck & Loot System](Wreck-&-Loot-System) Wreck settings, crate types, loot categories, LBMaster integration
[Crash Defenders](Crash-Defenders) Vanilla zombies, Expansion AI bots, night scaling, despawn logic
[Notifications & Markers](Notifications-&-Markers) Server-wide alerts, Expansion map markers, LBMaster markers, searchlight
[FAQ & Troubleshooting](FAQ-&-Troubleshooting) Common issues, log locations, coordinate format, compatibility

πŸ”— Mod Integrations

BS Patrol Helicopter detects and integrates with the following mods automatically at compile time. No extra configuration is needed β€” if the mod is loaded, the features activate:

Mod Features Unlocked
Expansion AI (EXPANSIONMODAI) Armed AI bots as crash defenders with factions, loadouts, and loot
Expansion Navigation (EXPANSIONMODNAVIGATION) 3D world markers for the helicopter in-flight and the crash site
LBMaster Groups (LBmaster_Groups) 2D/3D map markers via LBMaster's static marker system
LBMaster Rework (LBmaster_Rework) Use LBMaster loot presets inside crash crates instead of built-in loot

πŸ“ Config File Structure Overview

Your BS_HeliConfig.json is divided into the following top-level blocks:

{
    "ConfigVersion": 3,
    "AutoUpdateConfig": 1,
    "EventSettings": { ... },
    "HelicopterSettings": { ... },
    "Notifications": { ... },
    "WreckSettings": { ... },
    "SearchLightSettings": { ... },
    "MarkerSettings": { ... },
    "Difficulty": { ... },
    "CrashDefenders": { ... },
    "LootCategories": { ... },
    "LootCrates": [ ... ]
}

Each block is documented in detail on its respective wiki page.

Clone this wiki locally