Repository navigation
Notifications & markers
This page covers the Notifications, MarkerSettings, and SearchLightSettings blocks. These control server-wide alerts, map markers (for Expansion Navigation and LBMaster Groups), and the helicopter's searchlight beam.
The mod can send server-wide UI notifications for three event phases: spawn, crash, and despawn. Each notification has an enable toggle and a customizable message.
"Notifications": {
"NotificationIcon": "BS_Event_Logo/Logo/BS_Patrol_Noti.paa",
"NotificationTitleKey": "#STR_BS_Heli_Title",
"EnableSpawnNotification": 1,
"SpawnNotificationKey": "#STR_BS_Heli_Spawn_Alert",
"EnableCrashNotification": 1,
"CrashNotificationKey": "#STR_BS_Heli_Crash_Alert",
"EnableDespawnNotification": 1,
"DespawnNotificationKey": "#STR_BS_Heli_Despawn_Alert"
}| Type | String (texture path) |
| Default | "BS_Event_Logo/Logo/BS_Patrol_Noti.paa" |
| Description | Path to the icon displayed in the notification popup. Uses DayZ's .paa texture format. The default icon is included with the mod. |
Custom icons: If you want a custom notification icon, create a
.paafile (DayZ's texture format) and place it in your mod's data folder. Then set the path here relative to your mod's prefix. Most server owners should leave this as default.
| Type | String |
| Default | "#STR_BS_Heli_Title" |
| Description | The title text shown at the top of every notification popup. Can be a localization string key (prefixed with #) or plain text. |
Localization keys vs plain text: Any value starting with
#is treated as a localization key — DayZ looks it up in the mod's stringtable.csv and displays the translated text for each player's language. If you write plain text instead (without#), that exact text is shown to all players regardless of language.
Example — Custom plain text title:
"NotificationTitleKey": "BS Patrol Event"Example — Using the default localization key:
"NotificationTitleKey": "#STR_BS_Heli_Title"| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | When enabled, broadcasts a notification to all online players the moment the helicopter spawns and begins its patrol. |
| Type | String |
| Default | "#STR_BS_Heli_Spawn_Alert" |
| Description | The message body of the spawn notification. Supports localization keys or plain text. |
Example — Custom spawn message:
"SpawnNotificationKey": "An Apache helicopter has been spotted! Track it down and take it out for loot!"| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | When enabled, broadcasts a notification to all online players when the helicopter crashes. This alerts everyone that a crash site with loot is now available. |
| Type | String |
| Default | "#STR_BS_Heli_Crash_Alert" |
| Description | The message body of the crash notification. Supports localization keys or plain text. |
Example — Custom crash message:
"CrashNotificationKey": "The Apache has been shot down! Rush to the crash site for high-tier military loot!"| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | When enabled, broadcasts a notification to all online players when the wreck despawns (either by WreckDespawnTime timer or manual cleanup). Lets players know the crash site is gone. |
| Type | String |
| Default | "#STR_BS_Heli_Despawn_Alert" |
| Description | The message body of the despawn notification. Supports localization keys or plain text. |
Example — Custom despawn message:
"DespawnNotificationKey": "The helicopter crash site has been cleaned up. Wait for the next patrol!"All notifications with custom plain text:
"Notifications": {
"NotificationIcon": "BS_Event_Logo/Logo/BS_Patrol_Noti.paa",
"NotificationTitleKey": "BS Patrol Helicopter",
"EnableSpawnNotification": 1,
"SpawnNotificationKey": "A military helicopter is patrolling the area! Gear up and hunt it down!",
"EnableCrashNotification": 1,
"CrashNotificationKey": "The helicopter has crashed! Head to the crash site for loot — but watch out for defenders!",
"EnableDespawnNotification": 1,
"DespawnNotificationKey": "The crash site has disappeared. A new helicopter will arrive soon."
}Only crash notification (stealth spawn, no despawn alert):
"Notifications": {
"NotificationIcon": "BS_Event_Logo/Logo/BS_Patrol_Noti.paa",
"NotificationTitleKey": "Helicopter Event",
"EnableSpawnNotification": 0,
"SpawnNotificationKey": "",
"EnableCrashNotification": 1,
"CrashNotificationKey": "A military helicopter has crashed nearby! Loot awaits the brave!",
"EnableDespawnNotification": 0,
"DespawnNotificationKey": ""
}Tip: Disabling the spawn notification makes the helicopter a surprise — players only find out about it when they hear it overhead or when it crashes. This adds a layer of discovery and immersion, especially on RP servers.
All notifications disabled:
"Notifications": {
"NotificationIcon": "BS_Event_Logo/Logo/BS_Patrol_Noti.paa",
"NotificationTitleKey": "",
"EnableSpawnNotification": 0,
"SpawnNotificationKey": "",
"EnableCrashNotification": 0,
"CrashNotificationKey": "",
"EnableDespawnNotification": 0,
"DespawnNotificationKey": ""
}The MarkerSettings block controls map markers that track the helicopter in-flight and the crash site after it goes down. Markers require either Expansion Navigation or LBMaster Groups to be installed — without either mod, these settings have no effect.
"MarkerSettings": {
"EnableHeliMarker": 1,
"EnableWreckMarker": 1,
"Enable3DMarker": 1,
"Enable2DMarker": 1
}| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | Master toggle for the in-flight helicopter marker. When enabled, a marker follows the helicopter as it patrols, updating its position in real-time. When the helicopter is destroyed, this marker is removed. Set to 0 to make the helicopter invisible on the map while flying. |
How the live tracking works: The helicopter's position is sent to the marker system every 4 seconds (defined by
MARKER_UPDATE_INTERVALin the code). The old marker is deleted and a new one is created at the current position each update cycle. This creates a smooth-tracking effect on the map. The marker is labeled"#STR_BS_Heli_Marker"(localized helicopter name).
| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | Master toggle for the crash site marker. When enabled, a static marker appears at the wreck location after the helicopter crashes. This marker persists until the wreck despawns. Set to 0 to make crash sites unmarked — players must find them by sound, smoke, or by following the helicopter's last known position. |
| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | Enable the 3D world marker — a floating icon visible in the game world when looking in the direction of the helicopter/wreck. This marker is visible through terrain and buildings at any distance. Requires Expansion Navigation to function. |
Note: The 3D marker renders as an icon floating in the sky above the helicopter/wreck position. Players can see it by looking in that direction without opening the map. This is the most visible marker type.
| Type | Boolean (1 / 0) |
| Default | 1 |
| Description | Enable the 2D map marker — an icon on the flat map/minimap. Players must open the map to see it. Requires LBMaster Groups to function. |
Note: The 2D marker appears on the in-game map when the player opens it. Unlike the 3D marker, it's not visible in the game world.
The marker system automatically detects which mods are installed and uses the appropriate API:
| Mod Installed | 3D Marker | 2D Marker | How It Works |
|---|---|---|---|
| Expansion Navigation only | ✅ Works | ❌ No effect | Uses ExpansionMarkerModule to create/remove server markers. Supports both helicopter tracking and wreck markers. |
| LBMaster Groups only | ✅ Works | ✅ Works | Uses LBStaticMarkerManager to create temporary server markers with 2D/3D options. |
| Both mods | ✅ Expansion | ✅ LBMaster | Expansion handles 3D markers, LBMaster handles 2D markers. Both systems run simultaneously. |
| Neither mod | ❌ No markers | ❌ No markers | All marker settings are ignored. No errors — the mod gracefully skips marker creation. |
Full tracking — all markers on (default):
"MarkerSettings": {
"EnableHeliMarker": 1,
"EnableWreckMarker": 1,
"Enable3DMarker": 1,
"Enable2DMarker": 1
}Only crash site marked (helicopter is a mystery):
"MarkerSettings": {
"EnableHeliMarker": 0,
"EnableWreckMarker": 1,
"Enable3DMarker": 1,
"Enable2DMarker": 1
}Tip: Combining
EnableHeliMarker: 0withEnableSpawnNotification: 0makes the helicopter completely stealthy — players only know about it when they hear it or see it crash.
Map marker only — no floating 3D icon:
"MarkerSettings": {
"EnableHeliMarker": 1,
"EnableWreckMarker": 1,
"Enable3DMarker": 0,
"Enable2DMarker": 1
}3D world marker only — must look around to find it:
"MarkerSettings": {
"EnableHeliMarker": 1,
"EnableWreckMarker": 1,
"Enable3DMarker": 1,
"Enable2DMarker": 0
}No markers at all (hardcore mode):
"MarkerSettings": {
"EnableHeliMarker": 0,
"EnableWreckMarker": 0,
"Enable3DMarker": 0,
"Enable2DMarker": 0
}Note: Even with all markers disabled, the helicopter is still visible and audible in the game world. Players can track it visually and by sound. The crash also produces smoke and fire particle effects that are visible from a distance.
The SearchLightSettings block controls the helicopter's searchlight — a directional beam of light that shines downward from the helicopter during flight. The searchlight is attached to the helicopter's spot_light memory point and follows it through all maneuvers.
"SearchLightSettings": {
"Brightness": 35.0,
"Radius": 500.0,
"ConeAngle": 45.0
}| Type | Float |
| Default | 35.0 |
| Description | The intensity of the searchlight beam. Higher values create a brighter, more visible light. The light is visible to all players within render distance. |
For reference: The helicopter's engine fire effects use brightness values of
100.0(engine damage) and200.0(critical damage). The default searchlight at35.0is noticeably visible at night without being blinding.
| Type | Float (meters) |
| Default | 500.0 |
| Description | The maximum render distance of the searchlight. Players beyond this distance will not see the light. This is not the size of the light cone on the ground — it's how far away the light source is visible. |
| Type | Float (degrees) |
| Default | 45.0 |
| Description | The angle of the light cone. Smaller values create a tighter, more focused beam. Larger values create a wider, more diffused light. 45.0 is a moderate spotlight cone. |
How it works visually: The searchlight shines downward from the helicopter's underbelly. At
ConeAngle: 30you get a tight spotlight effect like a police helicopter. AtConeAngle: 90you get a wide floodlight that illuminates a large area below.
Powerful focused spotlight (police/military feel):
"SearchLightSettings": {
"Brightness": 60.0,
"Radius": 800.0,
"ConeAngle": 30.0
}Subtle ambient glow (atmospheric):
"SearchLightSettings": {
"Brightness": 15.0,
"Radius": 200.0,
"ConeAngle": 60.0
}Ultra-bright wide floodlight (easy to spot at night):
"SearchLightSettings": {
"Brightness": 80.0,
"Radius": 1000.0,
"ConeAngle": 75.0
}Minimal searchlight (barely visible):
"SearchLightSettings": {
"Brightness": 5.0,
"Radius": 150.0,
"ConeAngle": 45.0
}Default balanced:
"SearchLightSettings": {
"Brightness": 35.0,
"Radius": 500.0,
"ConeAngle": 45.0
}Tip: The searchlight is one of the most immersive features at night. A bright, focused beam makes the helicopter terrifying to see overhead. Consider increasing brightness for servers that want a strong nighttime presence, or reducing it for servers where the helicopter should be harder to spot.
Note: The searchlight is automatically destroyed when the helicopter enters its crash sequence (tail rotor failure, engine fires). It does not persist on the wreck.