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

FAQ & Troubleshooting

Common questions, known issues, and solutions for BS Patrol Helicopter.


General Questions

Where is the config file?

$profile:BS_PatrolEvent/BS_HeliConfig.json

On most servers this translates to something like:

/path/to/your/server/profile/BS_PatrolEvent/BS_HeliConfig.json

The file is generated automatically on first server boot with the mod loaded.

How do I reset the config to default?

Delete BS_HeliConfig.json and restart the server. A fresh config with default values will be generated.

What does ConfigVersion do?

The mod uses ConfigVersion to track config migrations. When a new mod version adds new config sections (like WreckSettings or MarkerSettings), it checks the version number and automatically adds missing sections if AutoUpdateConfig is 1. Do not manually change this value.

What does AutoUpdateConfig do?

When set to 1 (default), the mod will automatically add new config sections to your JSON when you update the mod. The existing values you've customized are never overwritten — only new, previously-missing sections are added with their defaults.

Set to 0 if you want full manual control over the JSON file. New sections will still be loaded with defaults in memory, but the JSON file won't be modified.


Common Issues

"Spawn position is 0 0 0. Check BS_HeliConfig.json."

Cause: The PatrolRoutes array is empty, or the spawn position coordinates are invalid.

Solution: Make sure you have at least one route with a valid SpawnPosition:

"PatrolRoutes": [
    {
        "RouteName": "My Route",
        "SpawnPosition": "5213.19 390.0 9080.21",
        "Waypoints": [
            "4205.63 390.2 10859.44"
        ]
    }
]

⚠️ Common mistake: Using commas in coordinates. The format must be "X Y Z" with spaces, not "X, Y, Z".

The helicopter doesn't spawn

Check these in order:

  1. Is the event enabled? "EnableEvent": 1
  2. Are there enough players? Check MinPlayersToStart. The mod logs "Insufficient players (X/Y)" if the count is too low.
  3. Is a previous helicopter still active? The mod won't spawn a new one if the previous helicopter hasn't crashed yet. Check logs for "Previous helicopter is still active".
  4. Check your spawn position. If it's "0 0 0" or invalid, the helicopter can't be created.
  5. Check the server log for errors from [BSPatrolModule].

The helicopter spawns but doesn't move

  • Make sure PatrolRoutes has at least one route with valid Waypoints.
  • Check that the waypoint coordinates are valid positions on your map.
  • If using a custom map, make sure the coordinates are within the map boundaries.

The helicopter flies underground or into mountains

The flight controller uses terrain detection and altitude smoothing to avoid this. However, if your waypoints are in extremely mountainous areas with steep elevation changes:

  • Increase PatrolAltitude in the Difficulty section (try 100–150 for mountainous terrain).
  • Space your waypoints further apart so the helicopter has time to adjust altitude.

Crates spawn but have no loot

  • Make sure LootCrates has at least as many entries as CrateCount.
  • Check that Presets in each crate entry match the names of categories defined in LootCategories (case-sensitive).
  • If using LBMaster, verify the LBPresetName matches an existing preset. Check logs for "LB Preset 'X' NOT found".

Expansion AI bots don't spawn

  • Verify that Expansion AI (EXPANSIONMODAI) is installed and loaded on the server.
  • Check that IsExpansionBot is set to 1 for bot entries.
  • Check logs for "EXPANSIONMODAI not active. Ignoring bot".
  • Make sure the ClassName is a valid survivor class (e.g., "SurvivorM_Hassan").

Defenders spawn inside buildings

The mod uses raycasting to avoid this, but it can occasionally happen in dense areas. You can:

  • Reduce SpawnRadius to keep defenders closer to the wreck (usually in open ground).
  • Accept that ~5% of spawns near buildings might clip slightly — they'll pathfind out.

Map markers don't appear

  • Markers require Expansion Navigation or LBMaster Groups to be installed.
  • Check MarkerSettings — make sure the relevant toggles are 1.
  • Verify the integration mod is loaded (check for their entries in server logs).

The wreck persists after server restart

It shouldn't — the wreck's OnStoreLoad method auto-deletes it on load. If you're seeing a persistent wreck:

  • It may be a different object or mod creating it.
  • Check if something else is re-saving the wreck to the storage file.

Log Locations

The mod logs to the standard DayZ server log (*.RPT file). Look for entries prefixed with:

Prefix Source
[BSPatrolModule] Module lifecycle (spawn, retry, config loading)
[BS_FlightController] Combat state changes, patrol transitions
[BS_Wreck] Crate spawning, loot population
Defenders spawned: Defender spawn summary
CrashedEvent: LBMaster loot preset results

Can I use this alongside other helicopter mods?

Yes — BS Patrol Helicopter is a self-contained event. It doesn't modify any vanilla helicopter classes. It can coexist with vehicle mods, other helicopter events, or AI mods.

Does this work on custom maps?

Yes, but you must configure your own PatrolRoutes with coordinates that are valid for your map. The default routes are for Chernarus.

Does this require a client-side mod?

Yes — the mod must be loaded on both server and client (it includes particle effects, sounds, models, and animations that are needed client-side).


Performance Tips

  1. Use DespawnRadius in CrashDefenders to clean up zombies/bots when players leave the area.
  2. Set WreckDespawnTime to auto-remove old crash sites. Without this, wreck effects (fire, smoke, lights) run until server restart.
  3. Don't go overboard with defenders. 15–20 total is reasonable. 50+ zombies can cause server lag.
  4. Increase DespawnCheckInterval if you have many active crash sites. The check is lightweight but runs on a timer.
  5. Use RespawnTime to control event frequency. Overlapping events (helicopter alive while wreck exists) are handled gracefully, but more events = more server load.