Configuration — Ungodly Robot AI v1.2.1

The panel

What each part does

Opening it: Press F7. Rebind with ToggleGuiKey in the Interface section. It will not open while OLMod's console is up — dismiss that with ` first.
Status strip: The khaki band across the top. Robots driven, how many are allowed to shoot, director stress and pressure, abilities defined and granted, actions running. It is the fastest way to understand what the mod is doing — open it during a firefight and watch the numbers move as the room reacts to you.
Search: Matches across every setting name, section and explanation at once. Faster than remembering which of the 19 tabs a setting lives on.
Explanations: Toggle the printed descriptions off for a denser list once you know your way around.
Reset buttons: One per row, plus Reset this tab and Reset ALL to defaults. A row button lights up only when that setting differs from its default, so a glance down the panel shows everything you have touched.
Save config file: Writes your current values back to the .cfg. Changes take effect immediately either way; this is for making them survive a restart.
While it is open: Your ship stops responding to your controls, so you cannot fly into a wall while reading, and the cursor becomes a normal pointer. The fight carries on unless you turn on GuiFreezesGameplay — so you can change a value and watch its effect live.

The file

UngodlyRobotAI.cfg

It sits beside the DLL in the olmod directory. Every setting is documented in place with its allowed range, its default and a plain-English explanation, which makes the file usable as documentation on its own.

A representative entry

# ----------------------------------------------------------------------------
[01 - General]
# ----------------------------------------------------------------------------

# Master switch for the whole mod. Turn this off and every robot instantly goes
# back to the stock Overload AI with nothing of this mod running. Useful for an
# A/B comparison mid-level: toggle it, fly the same corridor, and feel the
# difference.
#
#   Range:   true / false
#   Default: true
Enabled = true

It reloads live: The file is watched while the game runs. Save a change and it is picked up within a second or two — no restart, no returning to the menu.
Your values survive: The file is regenerated at startup, so comments you add are lost. Your values never are. A file from an older version gains the new settings automatically rather than being replaced.
Bad values are clamped: Anything outside a setting's stated range is pulled back into it and logged, rather than being accepted silently and causing something strange three rooms later.
It is plain text: Any editor will do. Keeping a copy of a tuning you like is copying the file somewhere.

The map

19 sections

Section	Settings	Covers
01 · General	5	Master switch; the global aggression, intelligence and skill dials
02 · Interface	6	Toggle key, panel scale, opacity, freeze-on-open
03 · Perception	8	Sight range, field of view, reaction times, hearing, cloak detection
04 · Memory & Searching	5	How long you are remembered, search aggression and spread
05 · Engagement	6	Preferred ranges, pressing a hurt player, group engage stagger
06 · Aiming & Accuracy	7	Spread, lead accuracy and error, warm-up, turn rate
07 · Fire Discipline	7	Fire rate, bursts, who shoots, friendly-fire avoidance
08 · Maneuvering	7	Speed, strafing, flanking, vertical attacks, weaving
09 · Evasion & Dodging	6	Dodge skill, reaction window, cooldown, splash scatter
10 · Squad Coordination	7	Contact sharing, distress calls, flank spacing, focus fire
11 · Morale	5	Retreat thresholds, rally points, reaction to allies dying
12 · Pressure Director	5	Strength, recovery window, max attackers, skill ramp
13 · Robot Roles	7	Frequency of each of the five jobs, and how long a job is held
14 · Scope & Compatibility	7	Bosses, Guide-Bot, turrets, level scripts, multiplayer
15 · Performance	6	Think rate, sight-check budget, brain cap, LOD distance
16 · Modular Abilities	38	Master switch, grant chance, cooldown/charge/power scales, per-ability tuning
17 · Modular Combat Actions	23	Master switch, grant chance, influence limits, per-action tuning
18 · Weapon Types	11	Two-weapon loadouts, secondary projectile, switch mode, distance, timing
19 · Debug	3	Verbose logging, on-screen overlay, timing readout

Where to start

Five dials that fix most complaints

Do not start by changing thirty settings. Almost every "it feels wrong" reaction traces back to one of these.

If it feels…	Change	Why that one
Too hard	Lower `GlobalSkill`, raise `AimSpreadScale`, or lower `MaxSimultaneousShooters`	Skill covers aim tightness, lead, reaction and dodge timing in one dial. Fewer simultaneous shooters lowers incoming volume without making anyone dumber.
Too easy	Raise `GlobalSkill` and `FlankTendency`	Flanking is what stops a room being solvable by holding one corner.
Unfair rather than hard	Lower `LeadAccuracy`, raise `LeadErrorScale`	Unfairness in a shooter almost always traces to prediction, not damage. A robot that always leads perfectly is not difficult, it just has no counterplay.
Hopeless in big rooms	Lower `MaxActiveAttackers` and `MaxSimultaneousShooters`	Caps how much of a large group can press at once, so the room stays a fight rather than a wall of fire.
Robots look indecisive	Raise `RoleCommitSeconds`	The single setting that most controls whether a robot commits to what it is doing. Set it to 0 and roles reshuffle constantly, which reads as approaching and standing off without ever completing either.

Defaults worth understanding

Three conservative choices

All three are switchable. All three are on by default for a reason.

Bosses get enhancement only

BossEnhancementsOnly is on and AffectBossRobots is off. Boss fights are hand-scripted set pieces with phases; replacing the brain can strand one between phases. The default leaves the phase script intact while still giving bosses the improved aiming and dodging. Turn it on for genuinely unscripted bosses, and accept that a phase may not play out as designed.

Level scripts win

RespectLevelScripts is on. The campaign drives specific robots at specific moments — stay asleep, attack on a trigger, hold a position. With this on, the mod steps aside whenever a script is driving a robot. Turning it off breaks authored moments, often in ways that do not show up until a level becomes unfinishable.

The Guide-Bot is untouched

It is a navigation companion whose entire job is following mission objectives. Giving it combat AI stops it doing that. Multiplayer is off by default for a related reason: Overload MP has no robots to improve, and other clients are not running your settings.

If the framerate drops

Performance settings

Turn on ShowPerformanceTimings first, so you can see the mod's actual per-frame cost rather than guessing at it. If it is the cause, three settings do the work:

MaxSightChecksPerFrame: Line of sight is the most expensive thing the AI does. Robots request a slot; if the frame's budget is spent they keep their previous answer and try again next frame. Lowering this degrades into slightly delayed reactions rather than a framerate collapse.
ThinkRateHz: How often the higher-level plan is re-evaluated. Movement always runs every physics frame so it stays smooth; only the thinking is throttled. The default is around 12 times a second, because re-deciding sixty times a second changes nothing except the CPU bill.
FullBrainDistance: Robots beyond this distance skip the expensive coordination work — the same principle as graphical LOD, and invisible for the same reason.