Combat Intelligence AI

The smartest NPC AI system ever created in Garry's Mod

**Our project is volunteer only, we are sustaining the development thanks entirely to community support. Please continue supporting us on Patreon to keep the project alive. **

Check out the nightly version for latest unstable updates.

---

v1.5.5 (8/17/2026)

Added

• Debug Overlay UI Redesign: Completely overhauled the debug overlay interface for improved readability, clearer visualization of NPC decision-making data, and better usability during development and testing.

• New flashlight: flashlight is now a proper mounted weapon light cone.

• Heat Map System: Implemented a spatial heat map system to evaluate area safety. This system now informs patrol route generation and cover selection logic.

• Collective Patrol Planning: NPC squads are now capable of executing coordinated group patrol plans.

• Danger Hotspot Avoidance: NPCs exhibit a behavioral bias toward avoiding high-threat zones. This facilitates emergent tactical behaviors, such as circumventing locations where allied units were neutralized or navigating around high-risk corners.

• Tactical & Empty Reload System: Introduced a brand-new reloading mechanism that distinguishes between tactical reloads (retaining the chambered round) and empty reloads (full cycle). This replaces the previous monolithic reload routine.

Changed

• Line-of-Sight (LOS) Detection: Enhanced LOS detection algorithms for NPCs to improve target acquisition accuracy.

• Cover-Finding Mechanism: Refactored cover evaluation into a fixed-interval squad-level detection job. Cover spots are now cached based on spatial grid cells, replacing the previous per-frame calculation method.

• Bullseye Directional System: Migrated the bullseye directional shooting system to the Fireaim helper module to consolidate related logic.

Performance

• OODA Manager Optimization: Overhauled the underlying manager system for the OODA architecture. Implemented a round-robin scheduling approach for NPC decision cycles, resulting in improved overall system performance and smoother "thinking" updates across large NPC populations.

• Spatial Caching: Optimized cover-finding routines through grid-based caching, yielding a notable performance improvement during squad-level operations.

Fixed

• Memory Leak Resolution: Addressed a persistent npc_bulleye memory leak by relocating the directional shooting logic to the Fireaim helper, ensuring proper resource management when the helper is utilized.

• Endless Reload Loop: Resolved a critical issue where NPCs would get stuck in an infinite reload cycle due to mid-reload interruptions. The new tactical/empty reload system now correctly handles state transitions during the reload process.

• State Thrash Reduction: Significantly reduced NPC state thrashing, eliminating the frequent "seizure-like" jitters previously observed during rapid decision-making transitions.

• Aggression Response: Fixed an overarching aggression logic flaw that prevented NPCs from properly returning fire when engaged by hostile targets.

• Shoot-and-Move Handling: Fixed poor state management that previously prevented NPCs from reliably shooting while moving. Both actions can now be performed simultaneously without interrupting one another.

HAVING ISSUES? UNSUBSCRIBE AND RESUBSCRIBE

---

Features

• Smart cover - Spots are scored on distance, enemy sightlines, danger zones, flank exposure and squad history. Compromised cover gets abandoned and remembered as bad. Covered routes, commit to attacking on arrival, squad pins while one flanks, judged on escape routes and high ground, varied peek angles, hold fire when you're exposed

• Memory - NPCs remember where they last saw you, they sweep nearby rooms (including other floors), and at some point eventually give up.

• Spatial Mapping - NPCs learn chokepoints, high ground, and flank routes to fight smarter

• Squads - They share knowledge with each other on the battlefield, they communicate through radio comms, and they have dynamic roles (Leader, Suppressor, Flanker, and Breacher) with instant leader succession. Squad adopts a range of tactic: fire and maneuver, staggered fire, adaptive formations, reload cover

• Morale - deaths, explosions and close calls shake them; pinned NPCs go to ground, broken ones run.

• Weapon recognition - They rush your pistol, spread out from your rocket launcher, and refuse to hold sightlines against your sniper.

• Personalities - every NPC rolls traits so they all fight differently.

• Voice lines - They actually give communications to each other.

• Battle Awareness - They can hear footsteps, doors, glass, reloads. But Suppressed weapons carry far less. Pinned NPCs call for help, allies respond to nearby gunfire and regroup with their squad

• Engagement & Range - weapon-appropriate engagement distances, no suicidal charges, shoot on sight

• Melee Defense - backpedal while firing when swarmed, bail out when overwhelmed or dry

• Adaptive CQB - real doorway slicing, short rushes, shoot-move-reposition

• Self-Preservation - avoid kill zones, hold angles on unknowns, guaranteed suppression, realistic corner pushes

• Search Improvements - favor chokepoints and high ground, fresh sounds redirect the hunt

• Friendly Fire - won't shoot through squadmates (if toggled to avoid), blocked shooter calls it and teammate steps aside

• Suppression - stay grouped, go hunting if target is lost too long, suppressors hold position

• Smarter Patrol - sweep the map, avoid recent ground, favor map features, never freeze

• Performance - This can work with 100+ NPCs no issues

Console

cai_debug 1 - See every NPC state to see what they are thinking and doing. cai_difficulty 0.5–2 - Reaction speed and accuracy cai_dump - Stats

Settings

If you don't want to head to console just go to options and change the settings there!

V1.6.0 Releasing 8/30/2026 - My birthday!

** If you like the NPC in the images download it here **

Contributors

• Kenni

• Fortunate Rat

Interested in contribute to the project? Check out our github.