Repository navigation
Combat
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.
[
{"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 | 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.
Configuration reference for the customized TACZ NPCs Alive build, baseline 2.2.1-hiki.c2me.1. Home · Troubleshooting
- TACZ NPCs Alive : Configuration Wiki
- Getting started
- Configuration map and inheritance
- Configuration recipes
- Behavior and perception
- Offline loot by biome
- Resting, campfires and social space
- Combat: reaction, accuracy and firing patterns
- Administrator commands
- Recruitment and companion orders
- Dialogue profiles and selection rules
- Factions, relations and player reputation
- Friendly-fire prevention and damage protection
- Greetings and contextual replies
- Inventory, interests and item replacement
- Levels, health and accuracy progression
- Loadouts and equipment
- Offline activity and the time wallet
- Autonomous NPC quests
- Player supply requests
- Spawning and structure replacement
- Trading, prices and currency denominations
- Experimental offline travel
- Troubleshooting and migration
- Weapon-specific percentage modifiers