FAQ and Troubleshooting

❓ FAQ and Troubleshooting

The BTR never spawns.

• Check there are at least MinPlayersToSpawn players online.
• Check your first waypoint is inside the map (off-map coordinates fail silently — see Patrol Routes).
• Make sure each preset listed in BTR82_Global.json actually exists in presets/. The log warns about missing ones.

It only spawns in one place.

It spawns at the first waypoint of a route. If a route's first waypoint is off-map, that route silently fails and you only ever see the valid ones. See Patrol Routes.

Bullets don't hurt it.

By design. BulletDamageMultiplier defaults to 0.0. Set it to 1.0 to let bullets through (see Recipes).

I get explosions even with the grenade disabled.

Those are the cannon, not the grenade. Set Turret.ExplosiveCannon: 0 to remove the cannon's splash.

All player actions freeze on my server.

The mod doesn't touch the player action/interaction system. This is almost always a conflict with another mod. Test with only -mod=@CF;@BS Patrol Tank and check your .RPT/script log for a script error naming the culprit (often another mod that also modifies the action system).

My config changes don't apply.

Make sure you're editing the file the active preset points to (check BTR82_Global.json → Presets), and that the server fully restarted. The log prints which presets loaded.

It targets me even when I'm fully behind cover at point-blank.

Check Combat.CloseRangeAutoLOS. If it's >0, the BTR sees through cover within that distance (and will fire through walls). Set it to 0 to disable.

My two BTRs won't fight each other.

Almost always faction config. Check, in both presets:

• Their Faction.Name values are different (two "Hostile" BTRs are the same faction and ignore each other).
• Faction.AttackOtherBTRs is 1 (it can self-heal to 0 when first added — see How the Config Works).
• Neither lists the other in Faction.Allies.

Full guide: Faction System.

My BTRs shoot each other but deal no damage.

Normal for the coaxial MG — BTRs are bullet-immune (Health.BulletDamageMultiplier: 0). Only the cannon hurts them, via its explosion, so make sure Turret.ExplosiveCannon is 1. If duels drag on forever, lower Health.MaxHealth. See Health and Damage.

The engine/RPM sound keeps playing after the BTR is destroyed.

Fixed — the engine sound is now force-stopped on death (it previously could linger if the BTR died while moving). Make sure you're on the latest build. A heavily damaged but still alive BTR keeping its engine running is correct; the sound only stops when it's actually destroyed.

---

Tip

Still stuck? See Support and License and bring your log file (see Performance and Logs).