Skip to content

Notifications & markers

cjcarw edited this page Feb 27, 2026 · 2 revisions

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.


Notifications

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.

Full Reference

"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"
}

Option Details


NotificationIcon

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 .paa file (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.


NotificationTitleKey

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"

EnableSpawnNotification

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.

SpawnNotificationKey

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!"

EnableCrashNotification

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.

CrashNotificationKey

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!"

EnableDespawnNotification

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.

DespawnNotificationKey

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!"

Notification Examples

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": ""
}

Marker Settings

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.

Full Reference

"MarkerSettings": {
    "EnableHeliMarker": 1,
    "EnableWreckMarker": 1,
    "Enable3DMarker": 1,
    "Enable2DMarker": 1
}

Option Details


EnableHeliMarker

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_INTERVAL in 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).


EnableWreckMarker

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.

Enable3DMarker

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.


Enable2DMarker

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.


How Markers Work with Different Mods

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.

Marker Examples

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: 0 with EnableSpawnNotification: 0 makes 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.


SearchLight Settings

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.

Full Reference

"SearchLightSettings": {
    "Brightness": 35.0,
    "Radius": 500.0,
    "ConeAngle": 45.0
}

Option Details


Brightness

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) and 200.0 (critical damage). The default searchlight at 35.0 is noticeably visible at night without being blinding.


Radius

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.

ConeAngle

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: 30 you get a tight spotlight effect like a police helicopter. At ConeAngle: 90 you get a wide floodlight that illuminates a large area below.


SearchLight Examples

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.