Recipes

🧩 Recipes — Common Setups

Copy-paste configurations for the questions that come up most.

Tip

Each snippet only shows the fields you change — paste them into the matching section of your preset. Full field list: Configuration Reference. Complete template: Example Preset.

🎯 Make every weapon damage the BTR

In the preset's Health:

"ArmorMultiplier": 1.0,
"BulletDamageMultiplier": 1.0

ArmorMultiplier: 1.0 = full damage; BulletDamageMultiplier: 1.0 = bullets count (default 0.0 makes it immune to bullets). Lower MaxHealth too if you want it to go down faster.

💥 Explosives-only tank

"ArmorMultiplier": 1.0,
"BulletDamageMultiplier": 0.0

Only rockets/grenades/explosives hurt it.

🚫 Turn off the cannon's explosion

In Turret:

"ExplosiveCannon": 0

Pure direct-hit cannon — no splash, no explosion visual/sound, and no tree felling from cannon impacts (hits show a bullet ricochet). (Changing CannonExplosionAmmo alone does not stop the blast.)

🕊️ Passive patrol (only fights when shot)

In Combat:

"AggroWhilePatrolling": 0

It patrols peacefully and only retaliates once attacked. It still defends itself — and it still always engages enemy BTRs (see Faction System).

⚔️ BTR-vs-BTR war

Give two different presets different faction names — that's all it takes:

// presets/patrol_east.json
"Faction": {
    "Name": "East",
    "AttackPlayers": 1,
    "AttackOtherBTRs": 1,
    "Enemies": ["ALL"],
    "Allies": []
}

// presets/patrol_west.json
"Faction": {
    "Name": "West",
    "AttackPlayers": 1,
    "AttackOtherBTRs": 1,
    "Enemies": ["ALL"],
    "Allies": []
}

Spawn one of each and they'll hunt each other on sight. For faster duels, lower Health.MaxHealth (e.g. 2500). Full guide with all scenarios: Faction System.

🤝 Allied convoy (two factions that don't fight each other)

// East preset
"Faction": {
    "Name": "East",
    "Allies": ["West"]
}

// West preset
"Faction": {
    "Name": "West",
    "Allies": ["East"]
}

They ignore each other but both still hunt players.

🔫 Machine-gun-only patrol (no cannon)

In Turret:

"CoaxOnly": 1

The cannon never fires — only the coaxial MG. Lighter, less lethal, great for low-pop or fresh-spawn areas. (Doesn't disable the grenade; keep Grenade.Enabled: 0 for that.)

💨 One desperate smoke screen near death

In SmokeScreen:

"Enabled": 1,
"TriggerAtHealth": 0.4,
"RepeatEvery": 0,
"MaxDeployments": 1

A single panic screen at 40% health. Set "Enabled": 0 to turn smoke off entirely. Details: Smoke Screen.

🩸 Show the BTR's health on the map

In Markers:

"ShowHealthOnMarker": 1

The marker label becomes e.g. Hostile BTR-82A [67%] — players can tell how worn-down it is and coordinate the kill.

🚥 Run several patrols at once

In BTR82_Global.json:

"MinEvents": 1,
"MaxEvents": 3

⏱️ Make it respawn faster / slower

In BTR82_Global.json, RespawnDelay (seconds). The timer starts when the wreck despawns, so also tune WreckLifetime in the preset's Event.

🔩 Change the cannon's ammo / hitting power

In Turret, swap AmmoClass for the direct-hit damage. Heavier caliber = more damage per hit:

"AmmoClass": "Bullet_762x54",
"DamageMultiplier": 2.0

Full ammo list: Ammunition and Class Names.

📦 Change the loot

Edit Loot.LootCategories (what can drop) and Loot.LootCrates (which crate gets what). Example item classes (weapons, mags, gear, medical) are in Ammunition and Class Names. A full filled-in loot block is in Example Preset.

🎨 Change the BTR's color

In Event:

"BTRClassName": "BS_BTR_Patrol_Urban"

All 12 skins: BTR Skins.

➕ Add a new difficulty/preset

1. Copy an existing file in presets/, e.g. presets/patrol_hard.json (a full template is on Example Preset).
2. Edit its values.
3. Add it to BTR82_Global.json:

   {
       "Preset": "patrol_hard",
       "Chance": 25.0
   }

4. Restart.

---

Full field list: Configuration Reference · Global Config · Example Preset · Ammunition and Class Names