Repository navigation
Home
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.
- 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).
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
1fortrueand0forfalse.
Tip: The mod has
AutoUpdateConfigenabled by default. When a new version adds config sections, they will be added to your existing JSON automatically on next server boot. Set"AutoUpdateConfig": 0if you prefer to manage updates manually.
| 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 |
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.
- 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).
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
1fortrueand0forfalse.
Tip: The mod has
AutoUpdateConfigenabled by default. When a new version adds config sections, they will be added to your existing JSON automatically on next server boot. Set"AutoUpdateConfig": 0if you prefer to manage updates manually.
| 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 |
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 |
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.