Skip to content
HIKI edited this page Oct 26, 2026 · 2 revisions

Combat: reaction, accuracy and firing patterns

File: tacznpc_behavior.json → combat, with partial overrides in loadouts.<id>.combat.

Field Built-in Bounds / purpose
reactionTimeTicks {"min":10,"max":24} First-shot delay after acquiring/reacquiring a target; 0–1200
targetMemoryTicks 40 Target memory used by the reaction gate; 0–1200
aimDistance 10 Distance threshold for ADS; 0–256; not maximum range
baseAimErrorDegrees 0.6 NPC angular aiming error; 0–5
accuracyByDistance See below Piecewise-linear distance/spread curve
shotIntervalTicks {"min":2,"max":4} Extra delay between successful shots; 0–1200
burstShots {"min":1,"max":2} Successful shots per burst; 1–128
burstPauseTicks {"min":18,"max":36} Pause between bursts; 0–72000
weapons Category overrides pistol, rifle, sniper, shotgun, smg, mg, rpg, default
weaponModifiers GunId percentages Weapon modifiers
friendlyFire Safety policy Friendly fire

Ranges are inclusive integers with min ≤ max. A partial range inherits its missing endpoint, which can produce an invalid range if the new minimum exceeds the inherited maximum.

Default distance curve

[
  {"distance":0,"spreadMultiplier":1},
  {"distance":15,"spreadMultiplier":1.4},
  {"distance":35,"spreadMultiplier":2.5},
  {"distance":60,"spreadMultiplier":4}
]

Place this array in accuracyByDistance. It requires 1–32 points, starts at distance 0 and increases strictly. Distances are 0–4096, multipliers 0–20. The parser also rejects base-error × point values above 45 degrees.

Values interpolate between points and keep the last multiplier past the final point. Larger spread means less accurate. This curve is NPC aim error, not the native gun's projectile spread.

Final NPC aim error combines the base value, interpolated curve, level aim multiplier and gun-specific percentages, capped at 45°. Native TaCZ spread separately receives the progression spread multiplier.

Category defaults

Category Shot interval Burst shots Burst pause
default / rifle 2–4 1–2 18–36
pistol 4–8 1–2 16–32
smg 2–4 1–3 20–36
mg 2–4 1–3 24–44
sniper 0 1 40–70
shotgun 2–4 1 28–48
rpg 2–4 1 50–90

Example partial loadout override:

{"loadouts":
  {
    "guard": {
      "combat": {
        "reactionTimeTicks": {
          "min":16,
          "max":28
        },
        "burstShots": {
          "min":2,
          "max":3
        },
        "weapons": {
          "mg": {
              "burstShots": {
                "min":4,
                "max":6
              }
            }
        }
      }
    }
  }
}

A common firing field supplied at the loadout level replaces the inherited value for every category. Then a category entry in that same loadout overrides it. Thus this guard uses 2–3 shots generally and 4–6 for mg, before GunId percentages.

TaCZ still controls ammunition, reload, bolting, spin-up and native cooldown. Reducing extra AI delay cannot promise a fire rate above those limits. First-shot reaction is not reset merely by interrupting a movement goal.


Home · Configuration map · Troubleshooting

Clone this wiki locally