Skip to content
AdvancedIAAnimated guide
Beta 2.0.4GitHub

Discovering AdvancedIA

2:04 · 7 scenes

What the app does, how to install it, launch it and keep it up to date.

More human AI drivers

AdvancedIA · HumanAI engine

  • A Lua app for Assetto Corsa, run by Custom Shaders Patch (CSP).
  • Its HumanAI engine sits on top of the game’s own AI and drives up to 60 AI cars.
  • Offline only: online, the app stands aside and sends no command.
  • It never drives your car: steering, throttle and brakes stay yours.

Requirements

Before installing

  • Assetto Corsa for PC and Custom Shaders Patch installed, with Lua apps working.
  • The app was developed and checked against CSP 0.3.0-preview675; a missing CSP function is simply left unused.
  • Content Manager is recommended: the app reads the session type it writes into race.ini.
  • Offline sessions only, up to 60 AI cars driven.
App folder
assettocorsa/apps/lua/AdvancedIA
Language
English by default, French in one click

Installing with Content Manager

Installation

  • Close Assetto Corsa.
  • Download AdvancedIA-Beta-<version>.zip from the latest GitHub release.
  • Drag the zip onto the Content Manager window and confirm.
  • Check the path: assettocorsa/apps/lua/AdvancedIA/manifest.ini.
Without Content Manager
extract the zip into the assettocorsa root folder
Check
.sha256 file published next to the zip

First launch

Esc · setup/pits screen

  • Start an offline session: practice, track day, race weekend, race or hotlap.
  • Open the pause menu (Esc) or the setup screen: the AdvancedIA window opens by itself.
  • While you drive it stays closed: open it from AC’s apps bar if you need it.
  • The interface starts in English; FR | EN at the top right switches language and the choice is saved.
Window
900 × 700, no title bar: drag an empty area
Fallback
icon among the setup screen apps

The header: the app’s state

Header (on every tab)

  • The state chip says what the app is doing: ACTIVE, PAUSED, SUSPENDED, ONLINE, NATIVE AI…
  • The APP switch turns the whole app off: the AI become fully native again.
  • PANIC stops every command at once, until RESUME.
  • Next to it: the track, the profile in use, how many AI are driven and the installed version.

One-click updates

Header · UPDATE · DIAGNOSTICS › UPDATES

  • One request to GitHub, about ten seconds after launch; nothing about you is sent.
  • When a newer version exists, UPDATE · <version> appears in the header.
  • One click, while stopped: SHA-256 digest and package downloaded, checked and unpacked outside the app folder.
  • Installed on the first stop, the previous version kept for rolling back, then the app restarts.
Turn off
untick "Check for updates at launch"
Settings
kept (CSP storage)

What the app never does

Safety guards

  • It never drives your car and never changes a track, car or surfaces.ini.
  • It contacts no server but GitHub, and only for updates.
  • It only changes two CSP display options and the [AI_FLOOD] section, after saving your original values.
  • It never executes stored text: preset names, class patterns and zones are read as data.

New in 2.0.1In-game update fixed

  • The Update button works again: going from 1.62 to 2.0.0 failed (« Cannot write to the app folder: current version kept »), because the game keeps the font files open. The previous version was kept intact.
  • The fonts now live in a new fonts2/ folder; the old fonts/ folder can stay, it is no longer used.
  • A font, sound or image that cannot be replaced is kept (one warning line in the log) and the update carries on; the Lua files still update all together or not at all.
  • Stuck on 1.62: press Update in game, or drop the zip on Content Manager with the game closed.

New in 2.0.0The window in game

  • The AdvancedIA window can now be opened while you drive, from AC’s apps bar. It is closed by default and costs nothing while it is closed.
  • In the pause menu and on the setup screen, it still opens by itself, as before.
  • In game, it opens on a compact view: PANIC, the APP switch, profile and preset, AI state, current flag and the overlay switch.
  • The compact view also sets the overlay of the current desktop: « Overlay on this desktop », « Move the overlay » / « Lock the overlay » and « Put back on this desktop ».
  • “Full view” gives access to everything else (home, settings, rules, diagnostics); the compact view comes back the next time you open it in game.
  • Settings read at the start of a session (AI distribution, start, start strategy) are greyed in game: “Greyed settings: applied from the next session.”

Good to knowManual installation (without Content Manager)

  • On the GitHub page, Code › Download ZIP, then extract the archive: it contains a folder named AdvancedIA-main.
  • Copy that folder into assettocorsa/apps/lua/ and rename it exactly AdvancedIA (CSP stores the settings under that name).
  • Typical final path with Steam: C:\Program Files (x86)\Steam\steamapps\common\assettocorsa\apps\lua\AdvancedIA\manifest.ini.
  • The repository’s tests/ and docs/ folders are never loaded by the game: they can stay.

Good to knowWhat is active on a first installation

  • With "Automatic profile" and "Built-in preset for the session detected" (both on by default), each session gets its preset as soon as it is detected.
  • Hotlap gets no preset: only the racing rules are on (flag overlay, DRS beep).
  • The overlay appears centred at the top of the screen; it hides AC’s flags and message banner while the app is active.
  • Track day on a long track (7 km and more) with many AI: the first session is still CSP’s (AI flood), the full-track distribution applies from the next launch.
  • Race: the Safety Car is on by default; add its model (ferrari_458_s3) to the grid.

Good to knowMoving from ACAdvancedIA (Beta 1.48 and older)

  • Install Beta 1.49 or later once by hand: delete (after a backup) assettocorsa/apps/lua/ACAdvancedIA, the two apps must never run together.
  • To keep your settings: before the first launch, rename Documents/Assetto Corsa/cfg/extension/state/lua/app/ACAdvancedIA.ini to AdvancedIA.ini.
  • The CSP state file ACAdvancedIA-cspgui.ini and the ACAdvancedIA.Bridge.* bridge keys keep their old name on purpose.

Good to knowUpdating: safety and rolling back

  • The download and check steps can be cancelled and never touch the app folder.
  • Each file is copied under a temporary name then renamed: a crash never leaves a half-written file.
  • A version that fails to start properly twice in a row is rolled back automatically at the next launch.
  • "Roll back to Beta X" puts the previous version back; "Check now" is limited to once a minute.
  • Manually: close the game, install the package over the old one (Content Manager) or replace the AdvancedIA folder. Back up your tracks/*.lua zone files first.

Good to knowUninstalling

  • If you used track days with a distribution other than Native: set "AI distribution at session start" back to Native, tick General, drive a track day with AI, then restart the game, so the app writes back your AI flood values.
  • Untick the two CSP display options (or switch the app off) while the game runs: your gui.ini values come back at once.
  • Close the game and delete assettocorsa/apps/lua/AdvancedIA; optionally delete AdvancedIA.ini, the AdvancedIA*.log logs and Documents/Assetto Corsa/AdvancedIA.

The window, profiles and presets

2:04 · 7 scenes

Four tabs, five automatically detected profiles, sections to tick and one-click presets.

Four tabs

HOME · SETTINGS · RACING RULES · DIAGNOSTICS

  • HOME: detected session, built-in presets, racing rules, the TO CHECK list, custom presets.
  • SETTINGS: a sidebar in four groups, DRIVING, TRAFFIC, RACE & SAFETY, ADVANCED.
  • RACING RULES: switches, mandatory stop, Safety Car and championship rule sets.
  • DIAGNOSTICS: updates, calibration, headlight flashes, zones, CSP capabilities, AI table, log.

Five profiles, detected automatically

HOME › SESSION · Automatic profile

  • Five independent profiles: Track day, Practice, Qualifying, Race and Hotlap.
  • With "Automatic profile", the profile follows the session Content Manager declares in race.ini.
  • In a race weekend: practice, then qualifying, then race: the profile changes at each session.
  • Clicking a profile only shows it so you can edit it; without "Automatic profile", the click chooses it.
Without race.ini
CSP session type; practice counts as a track day

Sections to tick

SETTINGS › sidebar

  • Each profile has 16 sections (Global options included), plus the racing rules in their own tab.
  • An unticked section keeps its values but stops applying; its settings stay visible, dimmed.
  • No section ticked: the app sends no command ("native AI").
  • The counter shows changed settings; a right click puts a setting back to its default.

The built-in presets

HOME › BUILT-IN PRESETS

  • One click sets the profile concerned and ticks every section that acts in that session.
  • Nordschleife Touristenfahrten and Track day: yielding and spacing for the track day.
  • Free practice and Flying-lap qualifying: yielding, sanctions, flying laps first.
  • Realistic race and Multi-class endurance: blue flags, start, strategy, sanctions, classes.

The preset for the detected session

HOME › Built-in preset for the session detected

  • On by default: at each new session, its built-in preset is applied and lit.
  • Track day → Nordschleife Touristenfahrten on its own track, Track day elsewhere; Practice → Free practice; Qualifying → Flying-lap qualifying; Race → Realistic race.
  • Your championship rules, preferences and class patterns are kept.
  • Your presets win: a profile loaded from a custom preset (Custom) is never replaced.

Custom presets, export, import

HOME › CUSTOM PRESETS

  • Type a name then SAVE: the profile shown and the global options are saved.
  • Up to 16 presets, names of 64 bytes at most; they survive updates.
  • EXPORT writes your presets and your five profiles to Documents\Assetto Corsa\AdvancedIA\AdvancedIA-presets.ini.
  • IMPORT reads that file back; nothing changes before CONFIRM, every value is checked.
Never exported
personality seed, detailed log, language, positions

Resetting cleanly

Right click · RESET SECTION · RESTORE DEFAULTS

  • One setting: right click, back to the profile default.
  • One section: RESET SECTION, at the top of the section.
  • A whole profile: HOME › RESTORE DEFAULTS: <profile>.
  • Everything: first set the distribution back to Native and untick the two CSP options, then, with the game closed, delete Documents/Assetto Corsa/cfg/extension/state/lua/app/AdvancedIA.ini.

Good to knowWhat each profile does

  • Track day: track-day traffic, standard yielding, spacing; never any penalties or championship rules.
  • Practice: the AI yield to faster cars and drive at practice pace.
  • Qualifying: slow AI move clearly out of the way of a flying lap.
  • Race: no standard yielding; blue flags, overtaking and defending, standing start, racing rules.
  • Hotlap: sessions without AI; only the racing rules (overlay, DRS beep and badge).

Good to knowBuilt-in presets: details

  • Sections ticked by all: General, Headlights (AI-to-AI flashes included), Overtaking, Lines, Personality, Accidents, Racing rules, Classes / Endurance, Weather, Track light panels.
  • Nordschleife Touristenfahrten: keep right, pass on the left, progressive warm-up lap.
  • Track day: yield side "Keep line", overtaking side Automatic, fewer headlight flashes (150 m, 15 km/h).
  • Free practice: level 97%, aggression 40%, level spread 6%, lapses in focus, chained overtakes, real runs.
  • Realistic race: blue flags, start, strategy, sanctions, passing aid, realistic starts, advanced strategy; standing start kept.
  • Multi-class endurance: Endurance layer, multi-class, "Lapped cars and classes: nuanced behaviour"; on the Race profile, Endurance rules for the whole weekend.
  • A Practice, Qualifying or Race preset also sets the weekend’s championship rules; a Track day preset leaves them alone.

Good to knowWindow: tips

  • Choices with up to three values are segments; longer ones a ‹ value › button.
  • A wider window widens the columns; a narrower one scales the whole window down. Lists scroll with the wheel.
  • Changing a setting in the garage brings the AI’s ongoing manoeuvres back to their base line, with an occupancy check.
  • Settings are saved at once, without having to drive.

Driving and personality

1:47 · 6 scenes

Level, aggression, caution, spread between drivers, mistakes and lateral moves.

Level, aggression, caution

SETTINGS › DRIVING › General

  • Level: 100% matches level 100 in Content Manager; up to 110% in Automatic mode.
  • Aggression: later braking and more determined attacks; 100% = 95% of the native maximum.
  • Caution: the safety margin behind another car (1 = native), adjusted to the situation.
  • Level, aggression and caution spreads: each AI gets a fixed, random offset.
Level
95% track day · 100% practice, quali, race
Aggression
55% · 45% · 80% (race)
Caution
1,6 · 2,2 · 1,2

Every driver is different

SETTINGS › DRIVING › Personality · ADVANCED › Global options

  • The personality seed (Global options) gives each driver its delays, courtesy, patience and braking.
  • Same seed, same drivers; "Regenerate personalities" draws new ones (if "Global options" is ticked).
  • Reaction delay before yielding: 0.25 to 0.9 s on a track day, 0.2 to 0.6 s elsewhere.
  • Every car learns its usual pace at 400 points of the lap, lap after lap.

Lapses in focus and mistakes

SETTINGS › DRIVING › Personality

  • Lapses in focus (on by default on track days): now and then, a few per cent of pace lost for one to three seconds.
  • Never in a corner, under braking, side by side, nor with a car on a flying lap behind.
  • Driving mistakes: wheel lock-up under braking or wheelspin out of corners, triggered through CSP’s native functions.
  • A mistake may end in an off, a spin or a crash, and so in a yellow flag or a Safety Car.
Mistakes
1 per hour per AI on a track day, 0.5 elsewhere
Minimum gap
3 min per AI, 60 s in the field

Dynamic personalities, finer driving

Personality › Dynamic personalities · Finer driving (options)

  • Each AI has a mood: pressure, a contact, a mistake or a lost place raise its stress.
  • An assertive driver attacks more, a timid one becomes careful; all of them then make more mistakes.
  • Fatigue grows over a stint; a pit stop gives some rest.
  • Finer driving: progressive throttle out of corners, slower for an amateur or in the rain.

Lateral moves without weaving

SETTINGS › DRIVING › Lines

  • Every lateral move (yield, overtake, defend, avoid) follows a bounded lateral speed and acceleration.
  • An occupied side always comes first: the AI returns to its line twice as fast.
  • Anti-weaving: six side changes a minute at most, then 20 s without manoeuvres.
  • No change of direction under braking beyond 20% pedal, except to avoid.

Rear awareness and real track width

Lines › Rear awareness (option)

  • An AI never moves towards the side where a faster car will be alongside within one to two seconds.
  • The set side is a preference: with less than a metre of room, the AI yields on the other side.
  • Offsets follow the real track width, up to 4 m off the racing line.
  • Left and right are always the driver’s, whatever sign the calibration measures.

Good to knowLevel above 100%

  • Requested level mode (Global options): Automatic, Native if confirmed, Grip bonus allowed or Cap at 100%.
  • Automatic writes the native level up to 110% and checks a trial value of 1.05 read back a moment later (log and DIAGNOSTICS).
  • The grip bonus (off by default) replaces the native level only if the read-back proves a cap; it changes the AI cars’ grip.

Good to knowSettings per profile (General)

SettingTrack dayPractice / QualiRace
Level (%)95100100
Aggression (%)554580
Caution1,62,21.2
Emulated braking zone (%)100100100
Level spread (%)832
Aggression spread (%)12810
Caution spread (%)1288

Good to knowDriving mistakes: safety guards

  • Never under flags nor within three minutes after a neutralisation, nor in the first minute of a race, on pit exit, side by side or within 40 m of you.
  • More frequent for a weaker, tired (Endurance layer) or distracted driver, or in the rain.
  • Each mistake is written to the log: "erreur de pilotage: …".
  • No sudden braking with a car close behind: the radar lifts before it brakes, and a lapse in focus or a lock-up does not start.

Good to knowLeft / right calibration

  • In Assetto Corsa, DIAGNOSTICS normally reads "Offset / side sign: -1 / -1": that is expected.
  • The calibration waits for two isolated AI lined up on a wide enough straight, makes a native +0.5 offset for 3 s, then returns to centre.
  • No offset is sent until the sign is confirmed; if it fails, it retries every 60 s, or use "Rerun sign calibration".

Track day: yielding and flowing traffic

2:38 · 9 scenes

Yielding, headlight flashes, traffic spacing and AI distribution around the track.

Yielding

SETTINGS › TRAFFIC › Yielding

  • The AI watches behind it: a car at least 6 km/h faster that will catch it within 10 s.
  • The situation must hold first, then the AI moves to the set side (right by default) and lifts off.
  • It holds its position at least 1 s and stays aside after the pass, while the other car moves back across.
  • After 25 s without a pass, it returns to its line and ignores that car for 10 s.
Rear detection
100 m (practice, quali: 200 m)
Follower speed advantage
6 km/h · horizon 10 s
Offset
0.65 of the half-width · −6%

Keep line

Yield side: Keep line (Track day preset)

  • The Track day preset chooses "Keep line": the slower car stays on its line.
  • It lifts off on the straight.
  • The faster car moves aside to the side with room and passes.
  • A damaged or very slow car still moves off the line.

Traffic that flows

Yielding · track day, practice, qualifying

  • A yielding AI really lifts: 15 km/h under the speed of the car it lets by.
  • The drop is gentle (6 km/h per second), never a brake check.
  • On a track day, in a queue (less than 60 m from the car ahead), the AI no longer yields to a car only slightly faster.
  • It yields as soon as the track ahead is clear, or to a car at least 15 km/h faster; your own headlight flash is always honoured.
Floor
30 km/h
Queue
< 60 m from the car ahead

Your headlight flashes

SETTINGS › TRAFFIC › Headlights · DIAGNOSTICS › Learn

  • Teach the app your flash signal once: DIAGNOSTICS › Learn headlight flashes (6 s).
  • Outside the race, an accepted flash makes the AI yield; in the race, it depends on the mode (Never, Lapped cars, Always).
  • Beyond 60 m you must be at least 12 km/h faster on a track day; stuck right behind, a flash means "let me by".
  • A second flash within 4 s makes the request urgent; up to three AI ahead react, from the nearest to the furthest.
Flash range
200 m (race: 150 m)
Request lifetime
8 s
Horn
can count as a flash (option)

Letting an AI past you

Every session, race included

  • Move at least 2 m off its line, on a straight, without overtaking yourself.
  • The AI following within 40 m pulls out on the side you free, even at equal speed.
  • It does not hand the place straight back.
  • Outside the race, slowing clearly below its pace works too: it passes you even at a crawl.

No fighting outside the race

Headlights · track day, practice, qualifying

  • When you pass an AI, it does not try to pass you back for 20 s.
  • Unless you slow down sharply (25 km/h slower).
  • Right behind you, alongside, or just after the pass, it eases its aggression.
  • In the race, the AI fights as usual and may defend.

Traffic spacing

SETTINGS › TRAFFIC › Spacing (track day)

  • The target gap combines pace (2.5 s at the car’s speed, plus 15 m), the number of AI and a per-car variation.
  • An AI too close gets a gentle speed cap, 4 km/h per second at most, down to −14%.
  • Corrections in 6 s episodes, staggered between cars, followed by 12 s free; nothing below 60 km/h.
  • Never a teleport or a forced brake; a fast AI is never held back behind a slow one.
Distance per AI
2.8 m
Variation
± 45 %

Session-start distribution and AI flood

SETTINGS › DRIVING › General

  • "On the whole track" (track day): each AI is placed on its line, with random gaps.
  • Never less than 15 m between two cars, and 300 m free on each side of you.
  • 25% of the AI stay in the pits and leave on their own, as on a real track day.
  • On tracks of 7 km and more, CSP’s AI flood is switched off: effective at the next game launch.
From
10 AI
Practice and quali
staggered pit exits, 10 s per AI

Pit exit

Every session

  • For 15 s after the pit lane, an AI only closes in slowly on the car ahead (you included).
  • It makes no manoeuvre for the first seconds; inside the pit lane, the native limiter applies.
  • Track day, practice, quali: it waits at the end of the lane (10 s at most) while a car on track reaches the merge.
  • In practice and qualifying, only a car on a flying lap is waited for.

New in 2.0.1Yielding without getting in the way

  • An AI moving aside for you no longer slows down at a corner exit in front of you: it only accelerates less.
  • An AI only moves aside when the car behind is really closing in, and stops as soon as it no longer is.
  • On an out lap or cool-down lap, an AI drives at normal pace through the corners when a fast car comes up behind, and keeps its slow pace on the straights only, off the racing line.

New in 2.0.0AI turn signals

  • An AI moving aside to let a car through signals on the side it moves to; a slow car held at the edge turns on its hazard lights.
  • On track days, in practice and in qualifying; in a race, only for blue flags or a faster class.
  • Never while attacking or defending, never on your car.
  • “AI turn signals” setting: SETTINGS › DRIVING › Lines, Turn signals sub-group. It is ticked in every preset and only works when the Lines section is ticked.
  • Some car models have no turn signals, or have them swapped in their model: the app cannot do anything about it.

Good to knowRules for each kind of session

  • Track day: passes and invitations on straights only; a car that cannot pass keeps about a second behind; after an off, the AI waits up to 30 s for a clear track before rejoining.
  • Practice and qualifying: a yielding car only lifts on a straight outside braking; in a corner it keeps its speed and only moves aside.
  • Every "straight" rule also looks at the lateral acceleration: a fast sweeper is not a straight.
  • Pressure: a car sitting within 15 m at a similar speed is let through after 4 s (3 s in practice and quali).
  • Invitation: if the car behind stays within 25 m for more than 12 s, the AI slows a further 10% to invite it past.

Good to knowAI-to-AI headlight flashes

  • An AI held up behind a slower one gives it a visible double flash; that car yields as it would to yours.
  • In the race, only to lap a car or for a faster class, never between cars fighting for position.
  • Outside the race: after two yields without a pass, the AI stops flashing that car for 2 minutes.

Good to knowSpacing: settings

SettingDefault value
Base gap (s)2.5 s at the car’s speed + 15 m
Distance added per AI (m)2,8
Gap variation (%)± 45
Maximum speed reduction (%)14
Cap slope4 km/h per second at most

Good to knowCSP AI flood

  • The app manages the [AI_FLOOD] section of Documents/Assetto Corsa/cfg/extension/new_behaviour.ini; only its own keys change.
  • With at least "Spread from (AI)" AI (10 by default), AI flood is switched off; below that, it is switched on with the chosen range (1 to 5 km).
  • In Native mode, the original values saved before the first change are written back.
  • CSP only reads this setting at launch: it takes effect at the next launch, announced by the overlay (AI flood (CSP)).

Practice and qualifying

1:30 · 5 scenes

The flying lap comes first: warm-up laps, cool-down laps and real AI runs.

The flying lap comes first

Yielding › Practice and qualifying: flying laps first

  • As in F1, every car (you included) is on a flying lap… or not: out-lap, cool-down, in-lap, damaged car.
  • An AI not on a flying lap moves aside for the closest flying car within 6 s, as under a blue flag.
  • It never attacks a flying car ahead of it, unless invited or that car is abnormally slow.
  • An AI leaving the pits waits at the end of the lane while a flying car reaches the merge.
On by default
practice and qualifying
Never
in the race or on a track day

Warm-up and cool-down laps

Yielding › Qualifying: AI cool-down laps

  • Out-lap: level lowered by 12%, reached in 3 s and given back after the line.
  • Qualifying: after one or two flying laps, an AI drives a cool-down lap at −18%, then goes again.
  • During that lap it is not on a flying lap and lets flying cars by.
  • Never with less than 2.5 laps of session left, so the last attempt counts.
Needs
the General section ticked (acts through the level)

Real AI runs

Yielding › Practice and qualifying: real AI runs (option)

  • Qualifying: out-lap, one flying lap, in-lap, a wait in the box (60 to 150 s), then a new run.
  • In qualifying, each run starts on the softest dry compound, with just enough fuel.
  • Practice: for each AI and each run, a programme drawn at random.
  • A run that could no longer be finished before the flag is not started: the AI stays in its box.
Box wait
60–150 s (quali) · 90–300 s (practice)
Calls at once
3 cars at most

Staggered pit exits

SETTINGS › DRIVING › General · AI distribution at session start

  • In practice and qualifying, the AI leave the pits one after the other, in a random order.
  • Ten seconds between two AI by default; with many cars the gap shrinks, never below 2 s.
  • All are out within 3 minutes at most, or within the first quarter of a short session.
  • Only AC’s native wait is used: no car is parked.

A message for you: flying lap

In-game overlay

  • On your out-lap or cool-down lap, the overlay warns you when a flying AI is coming.
  • The gap is a time gap, measured at the same point of the track: not metres, not km/h.
  • The AI must really be catching you (at least 0.1 s per second) and be within 3 s.
  • A car at your pace is never announced; a given AI at most every 30 s.

New in 2.0.1Flying lap at the corner exit

  • A car on a flying lap can pass a car that is not on one at the corner exit.

New in 2.0.0Turn signal for a flying lap

  • An AI letting a car on a flying lap through also signals, on the side it moves to (“AI turn signals” setting).

Good to knowHow a car counts as "flying" or not

  • Out-lap: from the pit exit to the line (one more lap if the line comes less than 30 s after the exit).
  • Cool-down or aborted lap: below 75% of the field’s pace at that point for 4 s, until the line.
  • A car on its in-lap or a damaged car never counts as flying.
  • Qualifying: a flying lap spoilt by track limits or a yellow flag is redone instead of the cool-down (its time stays in AC’s classification).
  • Qualifying: on its out-lap, an AI keeps at least 2 s to the car ahead by easing off early in the lap.

Good to knowReal runs: how it works

  • The softest compound is found from the names (SS, S, M, H, Hyper/Ultra/Extra/Super Soft, Soft, Medium, Hard, Pirelli C1–C6).
  • Fuel set in the box with physics.setCarFuel, only when the car’s consumption is known.
  • The in-lap goes through the usual pit request, three cars called at most; never under a red flag or a neutralisation.
  • Log: "passage en piste: <name>, <programme>, N tour(s) prevu(s), pneu X, carburant N L, attente N s".

The race start

1:47 · 6 scenes

Standing start, careful first lap, formation lap, rolling start and realistic starts.

Standing start

SETTINGS › DRIVING › Start (race)

  • For 2 s after the start, no offset, yield or overtake is commanded: the AI follow their native line.
  • Full throttle to the first corner: no following caution on the straight, the AI stay close.
  • Under braking and in corners, caution ×1.3 and aggression ×0.8, relaxed over 25 s.
  • The front radar stays very gentle at the start: it only brakes under 0.8 s to contact.

Careful first lap

Start › Careful first lap (start and restarts)

  • At the start and at every restart, each AI drives a careful first lap, with gaps counted in time.
  • Every braking zone is anticipated: points learnt from the leading cars, braking of the car ahead.
  • No defence, no tow-breaking; overtakes only on a real straight with a real advantage.
  • Ends at the first crossing of the line, when the pack has spread, or after 3 minutes.

Formation lap

Start › Race start: Formation, standing

  • At AC’s lights the field sets off for a formation lap in single file, in grid order, at about 100 km/h.
  • At the end of the lap every car takes its grid slot again and the race starts at the app’s lights.
  • You: keep your place, do not overtake, follow the panel (your slot, then the lights).
  • AC counts the formation lap as lap 1: add one lap to the race.
Default
Standing (a rolling start is never chosen for you)
Not available
online, in a replay, track > 7.5 km

Rolling start

Start › Formation, rolling

  • The same formation lap, then a rolling start: the green flag falls as the leader comes up to the line.
  • Nobody may overtake before crossing the line.
  • With "Realistic starts", the pack forms two files and the pole car picks its moment between 300 and 100 m.
  • If a car is stopped just after the line, the green is postponed by one lap.

Realistic starts

Start › Realistic starts (reactions, formation lap, graded jump starts)

  • Each AI has its own reaction time; a few cars (three at most) make a poor getaway: wheelspin or bogging down.
  • More frequent in the rain; no car is ever left standing on the grid.
  • With a formation lap, the AI weave on the straights to warm their tyres.
  • On the app’s grid: small movement = warning, jump start = penalty, flagrant jump start = doubled penalty.

Holding the grid lane

Start › Hold the grid lane at the start (option)

  • Each AI records its position on the grid.
  • After the green light, while a car runs alongside it, it keeps its lane instead of cutting towards the racing line.
  • It then joins the racing line gradually, never towards an occupied side.
  • The log measures each start: average field speed and radar brake applications.

New in 2.0.4Sturdier two-file starts

  • Fresh install: the two files hold from the very first start. The app did not know yet which side is left (it only learns it from a car alone at speed), so no file was held and every AI headed for the racing line, with spins and pile-ups on big grids. It now starts from AC’s usual convention and keeps measuring to confirm it.
  • Standing start: the files no longer split after one second. The brake pedal still pressed on the grid at the green was taken as the first braking; only a real braking now ends the files.
  • Rolling start: each car’s file is taken again at the green flag (and when the lights go out on the grid after a formation lap), instead of every car aiming at the racing line at the same moment.

New in 2.0.4A more realistic formation lap

  • Strict single file: during the formation lap an AI never gets closer than 6 m to the car ahead, wherever it is across the track; the grid order is kept all lap. A weaving car freezes its lateral position while another car is level with it.
  • A car that has lost the pack at the end of the formation lap (after an off, for instance) lines up behind the last slot, and the lights do not wait for it.
  • A stop or spin near the pit entry, or a car going into the pit lane, no longer cancels the standing start or adds a formation lap; only an incident elsewhere cancels it, as before.
  • Wider, sharper weaves: over about 90% of the track width, centred on the middle, to one side then the other, without small corrections. The AI still straighten up in corners and at the pit entry.
  • Before a standing start, near the end of the formation lap, each AI slows down, launches flat out and brakes hard, one to three times, to warm its tyres.
  • On the grid, the AI line up with their slot earlier and no longer stop at an angle.
  • Everyone gets their own slot back, exactly, read on the grid at the start. The slot of a car in the pit lane stays empty (before, every AI behind it moved up one slot, into the other column). Once stopped, each AI is set to the exact position and heading the game gave it, wheels straight, then checked.
  • On the way to the grid: the AI move to their column gently without ever aiming outside it, and no longer overtake, defend or yield until lights out.
  • Rolling start: the two files form during the regroup at the end of the formation lap; the cars run in tight pairs, side by side with a slight stagger, and the pack closes up before the green flag.

New in 2.0.2Two abreast at the start

  • After the lights, every AI keeps the side of its grid slot down the first straight and only merges onto the racing line, in order, near the first braking zone: the back of the field no longer runs in single file on one side.
  • A standing start after a formation lap is kept on a fresh install (it could turn into a rolling start).

New in 2.0.0Aborted start and grid

  • With a formation lap, or a standing restart after a red flag: an incident on the grid or during the lights no longer sends the race off under yellow.
  • The whole field does one more lap in single file, without overtaking (“Start delayed”), then forms a new grid with new lights.
  • The car at the origin is held in place until the field has passed, never teleported, and starts from the back of the new grid.
  • At the 3rd aborted start, the extra lap ends with a rolling start. A race too short for one more lap starts as before.
  • A car hit while waiting in its place is not treated as the cause.
  • AI jump starts on an app grid are taken at lights out: an aborted start forgets them, as it does for you.
  • Formation lap: only a delayed car (spin, stop) loses its place; a car simply passed keeps its own, and the car that passed it goes back to its own.
  • A lively formation lap: bursts of throttle, braking and wide weaving to warm the tyres.
  • On the grid, the AI are protected from being sent back to the pits by AC.

Good to knowFormation lap: good to know

  • AC counts the formation lap as lap 1 and starts its race clock at its own lights: add one lap to the race.
  • AC’s jump-start rule applies at its lights; the app’s at the standing start after the formation lap.
  • An incident that neutralises the race during the formation lap ends it: start under FCY, then a rolling start at the green flag.
  • If the grid cannot be formed, the formation lap ends with a rolling start.
  • With SpotterEngineer (formerly SpotterEnginer), Beta 2.1.1 or later is needed to call these starts correctly.

Good to knowCareful first lap: details

  • On a straight (driver not braking, outside a braking point’s anticipation window), the AI keeps its foot down in the tow.
  • The radar only lifts with contact less than 0.6 s away and no free lane alongside, never when the car behind is closer to hitting it.
  • Extra caution is capped at 1.6 times the usual; an AI already below 70% of its learnt pace is not slowed any further: the back of the field flows through the first corners.
  • In a braking zone, an AI already braking with a car less than 6 m ahead gets a dosed brake (0.3 at most); a much faster car arriving behind reacts earlier.
  • Released over 3 s; each radar lift or brake at the start is explained in the log.

Race battles

2:21 · 8 scenes

Overtaking, defending, the slipstream, corner priority, blue flags and classes.

Overtaking

SETTINGS › TRAFFIC › Overtaking

  • A slower car within 50 m, caught within 6 s with at least 3 km/h of advantage (in the race).
  • Or the AI is held up: below 93–95% of its usual pace at that point.
  • It prepares, pulls out, runs side by side, then moves back across with a margin: two car lengths plus 10 m.
  • An occupied side is always respected; the attack is dropped if the side closes or a yellow flag comes out.
Forward detection
60 m track day · 50 m elsewhere
Speed advantage
8 · 10 · 3 km/h
Clearance after overtaking
18 · 20 · 10 m

Side, abort and wait

Overtaking · Overtaking side

  • Side: Opposite to yield side, Automatic, Left or Right; the free side always has priority.
  • In the race, Automatic chooses from the position of the car ahead and the next corner.
  • Faster target (outside races also: no progress, attempt too long): the AI leaves that car alone for 45 s, then 3 min, then 10 min.
  • In the race, the wait is 180 s at most and the pair is judged again if the gap closes at 25 km/h or more.

Defending

Overtaking › Defending (race only)

  • Against an attacker within 12 m, an AI may cover its line once per attacker and per lap.
  • A single move, of at most 0.35 of the half-width, at least 8 s between two defences.
  • Never against a car lapping it or a faster class, never under braking.
  • The defence ends as soon as the cars overlap; never a move towards a car alongside.

The slipstream, and breaking it

Overtaking › Slipstream and dirty air

  • Above 150 km/h behind a car, the AI lowers its caution after 1 s to use the tow.
  • Slipstream seeking: it moves in behind, stays in the tow and pulls out late enough to get alongside before braking.
  • Breaking the tow (race): the car ahead makes one move away from a direct rival, and returns before braking.
  • Dirty air: in a corner, in the wake, the AI lifts slightly and its line turns into small corrections.

Corner-entry priority

Every profile, race included

  • Two cars side by side at a corner entry: the one whose nose is ahead by more than 2.2 m has priority.
  • The AI whose nose is behind leaves its attack or defence and lifts off gently.
  • It never moves towards the other car and does not attack again for 1.5 s.
  • The decision is made in the first second of the corner: a pass already alongside is not cut.

Passing aid, last laps

Overtaking › Passing aid (the defender holds its line), Last-laps urgency

  • Passing aid: when the attacker is alongside with room, the defender holds its line.
  • Attack push: within 1 s, the AI pushes on the straight and under braking (+3%, 10 s at most).
  • No hesitation: a car within 1 s with room beside it is attacked after 0.2 s.
  • Last-laps urgency: against a direct rival, aggression rises step by step in the last 3 laps.

Blue flags

SETTINGS › TRAFFIC › Blue flags (race)

  • An AI about to be lapped moves aside to let the lapping car (you or an AI) through.
  • Limited loss of pace: a fixed 8%; side Automatic, Left or Right.
  • When you sit within 40 m behind, the blue flag stays waved even if you are not faster: it keeps its line through the corner and moves over at the exit.
  • A blue flag only concerns a car a lap down; a slower car on the same lap is simply overtaken.
Flash range
150 m (×1.5 when two or more laps down, or for a faster class)
Option
Lapped cars and classes: nuanced behaviour

Multi-class

SETTINGS › RACE & SAFETY › Classes / Endurance

  • The AI are split into classes by pace: a new class opens at an 8% gap, four at most.
  • A slower class yields to a faster one, which overtakes it more easily and gets a longer blue-flag range.
  • Class patterns (for example lmp1:1,lmp3:2,gt3:3) take priority over the automatic split.
  • Endurance rules: the slower class holds a predictable line; it is up to the faster car to overtake cleanly.

New in 2.0.4A faster class glued behind

  • With multi-class on, a car of a faster class sitting right behind a slower one at the same pace (15 m or less) is let through, in every session; a car on a flying lap still never yields to one on its out-lap. The log notes the classes the app recognised.

New in 2.0.2Overtaking and slipstream

  • Real pace differences in races: tyre wear, compound and fuel weigh more on each AI’s pace, and start strategies are offset, so a car on fresher tyres really catches a car on worn ones. Bounded; practice, qualifying and track days are unchanged.
  • A real tow between AI: AC’s slipstream setting only affects your own car. An AI sitting in the tow on a straight gets a small, bounded pace gain (straights only, ending well before braking, never under yellow). The log notes AC’s slipstream setting at the start of the session.
  • Pull-out at the right moment: the AI lines up right behind and pulls out at the slingshot point, late enough to keep the tow and early enough to get alongside before braking, no longer in the middle of the straight.
  • Attacks that don’t give up too early: the attacker no longer drops back as soon as the car ahead is briefly faster.
  • No more hesitating behind a slow car: any clearly slow car ahead, or a car that moved aside, is passed on the free side at the first safe chance, never at a braking point and never squeezing it. A car a lap ahead is never targeted.
  • The anticipated defence really triggers now: the distance to the braking point comes from the learned braking points.

New in 2.0.1Slow car ahead

  • A clearly slow car ahead gets passed, including your own car when you slow down or move aside, also on the first lap.
  • The AI behind pulls out to the side you leave free at the first safe chance, never at a braking point and never squeezing you.

New in 2.0.0Corner priority, slipstream, blue flag

  • Corner priority, with F1 reference points for every category: on the inside, a car keeps its right if its front axle is level with the other car’s mirror; on the outside, if it is ahead of the other car’s front axle.
  • In chicanes and slow corners, the car without the right gives way cleanly: it brakes a little earlier, leaves a car’s width and tucks in behind. The car with the right never squeezes the other.
  • After losing a duel, a car does not dive straight back in at the next part of the corner.
  • Anticipated defence: the car ahead covers the inside of the next corner before the attacker gets alongside, with a single move before the braking zone. Never in the braking zone, never once the attacker is alongside, never against a car lapping it, never on the first lap. It also covers a car sitting in its tow at the same speed, a bit further from the braking point.
  • Slipstream: the attacker lines up right behind the car ahead on the straight (within about 30 cm), stays in the tow and pulls out a few metres behind, or at the « slingshot » point where it can still get alongside before braking. Its attack stays alive while it waits.
  • Passing at the corner exit: an AI right behind that gets a better exit (close and clearly faster) pulls out at once to the free side instead of lifting.
  • A mistake ahead: when the car ahead runs wide, slides or loses speed after a mistake, the AI behind no longer slows down with it; it passes on the other side and leaves room to a car rejoining the track.
  • Grip guard in corners: the app never pushes an AI’s level above 103% or its caution below 0.8 in a corner; attack pushes stay on the straights.
  • Attack push between AI (race): less than about 1 s from the car ahead, the attacker gains +3% level on the straight, 10 s at most per attempt, not again on the same car for 20 s; never on the first lap, under a flag, on a wet track or against you.
  • An attempt that does not get alongside within 30 s ends and the pair is put on hold.
  • On a straight, a car overlapped by half lifts a little to let the other through.
  • Blue flag: the backmarker moves to the edge and lifts; the fast car goes by without slowing. In corners, while the fast car is alongside or just ahead, it keeps lifting, brakes earlier and keeps its side, then does not attack the car that just passed it for a few seconds.

Good to knowWhy an attack does not start

  • No room beside the car ahead (less than 1.2 m), straight too short before the next braking point.
  • Pair suspended after failures, first lap, no-manoeuvre zone, flag, start, corner or braking.
  • Direction budget used up, side or corridor taken, not closing, not enough advantage.
  • The log’s minute summary counts these refusals, once per target.

Good to knowBreaking the tow and dirty air

  • Long straights are relearnt each session from the AI’s own laps, braking zones excluded.
  • Never when the follower is more than 12 km/h faster, already overtaking or is you; never near the pit exit.
  • Breaking the tow and a defence never both happen on the same straight.
  • Dirty air: off by default on a track day.

Good to knowLapped cars and classes: nuanced behaviour (option)

  • The backmarker moves over when the lapping car is really arriving (about 5 s), never just before a braking point.
  • Two backmarkers fighting each other call a truce until the lapping car has passed both.
  • A slower class holds its line once the faster car has chosen a side; a group of the faster class passes as one.
  • Your own blue flag has two stages (advise, then order) and is not shown in the 30 s after a start.

Incidents and yellow flags

2:04 · 7 scenes

Detection, avoidance, yellow zones, delta time, danger zones and recovering cars.

Detecting an incident

SETTINGS › RACE & SAFETY › Accidents

  • A car counts as stopped below 10 km/h for more than 2 s; you included.
  • A spin is confirmed over 0.6 s, only with a real loss of speed.
  • Wrong-way driving is confirmed after 2 s; a stationary grid is never an incident.
  • An incident ends after 2 s of normal driving: a slide that settles stays a single incident.

Avoiding a stopped car

Accidents › Avoid stopped or crashed cars

  • An AI approaching a stopped, very slow, spinning or crashed car slows down and goes round it on the free side.
  • With no clear lane, it brakes hard behind it.
  • A slow car (below 25 km/h) is only avoided if the AI arrives 15 km/h faster; in a traffic jam it simply follows.
  • Avoidance is never limited by the anti-weaving rule.
Detection
150 m
Level
−25 %
Caution
×1,5
Offset
0,6

The yellow-flag zone

Accidents › Yellow flags (incident zone)

  • The zone runs from 300 m before to 50 m after the incident, and is held 10 s after it clears.
  • No overtaking from 150 m before the zone, for the AI and for you.
  • Double waved yellow (car stopped on the track): reference 15% slower than the usual pace, judged on the delta.
  • In the zone: no overtaking, yielding, blue flag or defending; the AI brake at 5 m/s² and queue.
Endurance
Slow Zone at a fixed 80 km/h
Unknown pace
50 km/h or 35% of top speed

The delta time

Delta under VSC, FCY, Safety Car, red flag, double yellow

  • The delta compares your time with a reference: your usual pace, slowed according to the situation.
  • It starts at +1 s and never exceeds +3 s: no credit to take by flooring it afterwards.
  • Normal braking is always allowed: from your speed at the signal, after a 2.5 s reaction.
  • Judged at each mini-sector (about 250 m): it is not an 80 km/h limiter.

Difficult spot, danger zone

Accidents

  • Three different cars with an incident within 100 m in five minutes: the place becomes a difficult spot.
  • The AI drive there with 15% more caution and start no overtake there.
  • Danger zone: speed there is also capped 4% under the learnt pace (7% after two more incidents).
  • The difficult spot is forgotten after 10 minutes without an incident in a race, 30 minutes elsewhere; never your car.

After a crash

Accidents

  • Off the track, the crashed AI stays still 3 to 8 s, then waits until no car at speed could reach it.
  • If engine, suspension and gearbox work, it is asked to restart: three attempts at most within 40 s.
  • It is towed to its box only if it cannot go on; in a race, it then retires (except under a red flag).
  • Off the track without moving: returned after 30 s; an AI still making progress, even at walking pace, is never recovered.

Pit stop for damage

Accidents › Pit stop for damage (option)

  • In practice, qualifying and race, the app reads AI damage while they drive.
  • An AI is called in when its damage stays over a threshold for 3 s.
  • Never under a red flag, nor under yellow or a neutralisation unless the car is unsafe, nor, in a race, in the last 2 laps.
  • At its box it is repaired; gearbox damage cannot be repaired in the pits.

New in 2.0.4AI parked off track are towed

  • An AI stopped off track, away from the racing line, closes its yellow zone after 15 s but was then forgotten: it is now towed to its pit box after 30 s without moving away (also when it only spins its wheels on the spot), repaired and back in the race.

New in 2.0.2Yellows, crashed AI and retirements

  • Under a local yellow, an AI may pass the car that caused it (off track, spun or rejoining) on the far side, as in real racing. Never under the Safety Car, VSC, FCY or red flag; a car driving normally under someone else’s yellow is still not passed.
  • A car that rejoins and drives cleanly is no longer avoided at reduced speed after 1.6 s.
  • A crashed AI waits for the cars stopped or crawling just behind it before rejoining: no more low-speed bumping in a queue under yellow.
  • No more retirements of undamaged AI: only a really broken car (engine, suspension or gearbox) retires; an undamaged car is repaired and rejoins. No progressive failure before two laps are completed.

New in 2.0.1Progressive slowing under yellow

  • The car in front eases off gently when a faster car is close behind, and the car behind starts braking earlier: no more rear-end chains when a double yellow comes out.

New in 2.0.0Slow cars, retirements and danger zones

  • A slow or damaged car drives at the edge, off the racing line, and is called into the pits earlier.
  • Warning yellow “Slow car on the edge … m ahead · overtaking allowed”: no speed limit, no ban on overtaking.
  • In a race, an AI recovered to its pit box (broken, stuck or stationary) retires and stays parked until the end. Exception: the red flag.
  • A crashed AI that can still drive (engine, suspension and gearbox intact) is restarted: 3 attempts at most, every 6 s, within 40 s. Meanwhile AC no longer sends it back to its pit box.
  • It does not move off while a car at speed could reach it; on the first lap, until the field has passed. It is also restarted under a VSC, an FCY or the Safety Car, never under a red flag.
  • Damage pit stop: a light touch no longer calls the car in (higher bodywork threshold).
  • Danger zone: when three cars go off at the same place within five minutes, the AI speed there is capped 4% under the learnt pace, from 150 m before to 100 m after; 7% after two more incidents. Never your car.
  • Learnt danger zones are kept per track, even with track memory off: they slow the AI from the first lap of the next launch, on the way in and just after the spot, never all along the exit, and fade after calm launches.
  • Track light panels: when your car is in the pits, they follow the car the camera is on and turn yellow as it nears a yellow zone (CSP has a single flag for the whole track).

Good to knowRecovering stopped cars

  • Alone on the track under a local yellow: a broken car is taken back to its pit box after 3 s; a car that does not move off after its attempts, after 8 s.
  • While race control decides (neutralisation chosen, several cars, neutralisation running): a car that does not move off stays 20 s, or the major-incident delay plus 5 s.
  • A recovery does not count as a stop, except under a red flag; AC resets the car when it returns to the pits.
  • One service per pass through the pit lane: a car back in its box without leaving the lane gets no extra tyres or repairs.

Good to knowFor you

  • Your car is never speed-limited: the delta time judges your pace.
  • The overlay warns you once per group of incidents; AC’s small native yellow flag on the HUD is optional.
  • On an equipped track, the light panels turn yellow too.
  • A car in trouble (already slow, or running for 3 s below half the pace it could hold there) may be passed under yellow without a sanction.

Neutralisations and red flag

2:04 · 7 scenes

FCY, VSC, Safety Car, unlapping, finish under SC, red flag and restart.

Major incident: the response

Race · Neutralisation after a major incident

  • A car stopped on the track for more than 15 s is a major incident.
  • It triggers the rule set’s neutralisation: local yellow zone, FCY, VSC or Safety Car.
  • If the incident escalates (2 cars stopped, or 30 s longer), the Safety Car replaces the neutralisation.
  • The red flag (3 cars, track blocked) keeps priority; a neutralisation lasts at least 30 s.

FCY and VSC

Overlay · neutralisation delta

  • FCY: the whole track runs to the FCY delta, with no overtaking.
  • VSC: the whole track runs to the VSC delta; the end is announced 12 s before the green (VSC ENDING).
  • After an FCY or a VSC, racing resumes at once, with no DRS wait.
  • The band and the messages announce each phase.

The Safety Car comes out

RACING RULES › Safety Car

  • Call: the field goes to the FCY delta (never above 90 km/h) while the car stays 10 s in its box.
  • Released in its box, it drives down the pit lane and joins the track by itself, just ahead of the leader.
  • Otherwise it is placed on the track through CSP, 200 m ahead of the leader, always out of your sight.
  • It must be on the grid: add its model (ferrari_458_s3 by default) in Content Manager.
Default model
ferrari_458_s3
Without it
the VSC or FCY carries on

Behind the Safety Car

Safety Car · on track

  • It drives at its own pace, with no cap, and waits for the queue to form.
  • Nobody passes it: an AI that does must give the place back and is sanctioned.
  • Cars join the queue at their pace −10%, then run in single file without overtaking.
  • Incident cleared, out for 60 s and field bunched up: "In this lap · stay in line".

Unlapping and finishing under SC

Safety Car

  • Queue formed, at least 3 laps to go: lapped cars may unlap themselves, one at a time, by name.
  • The Safety Car then comes in at the end of the following lap; never in a multi-class race.
  • Last lap under the Safety Car: it comes in at the end of the lap, no green flag, finish in queue order.
  • At the green: no overtaking before the line for the queue; a car elsewhere on the track may attack at once.

Red flag

RACING RULES › Racing rules on › Red flag on a serious accident

  • Race: at least 3 cars stopped for 10 s because of an incident, leaving no 2.5 m passage; or a pile-up: 5 cars stationary for at least 10 s within the same 200 m.
  • All AI return to their pit box at the red-flag delta (+60%), without overtaking; you too.
  • The order is frozen at the red flag, you included.
  • Stopped cars are recovered, then the restart comes once the track is clear; otherwise it comes anyway and a standing restart becomes a rolling start.

The restart

RACING RULES › Racing rules on › Restart after a red flag

  • The Safety Car leaves first; the cars follow it one by one, in the frozen order.
  • Rolling start (RS) behind the Safety Car: base, GT and Endurance rules.
  • Standing start (SS) from the grid: F1 2025 and F1 2026; each car goes to its slot, five lights, then lights out.
  • Retaking your classified place is not an overtake; DRS stays disabled for a lap.

New in 2.0.0Safety Car, red flag and restarts

  • After a red flag, the Safety Car leaves first; the AI stay in their pit boxes until it is on track, then follow it one by one, in the red-flag order.
  • The Safety Car drives at its own pace, with no fixed cap, never faster than the car right behind can follow; it waits for the queue to form.
  • Red flag on a pile-up: 5 cars must still be stopped for at least 10 s within the same 200 m; spins that drive away do not count.
  • The restart no longer comes on a plain delay: at the maximum delay, AI still stopped are recovered and the restart waits for a clear track (15 s at most).
  • If a car cannot be cleared, the restart comes anyway (behind the Safety Car, or under VSC or FCY), with a log line; a standing restart becomes a rolling start if it is still on the track at the end of the lap.
  • Unlapping, as in F1: in a single-class race with at least three laps to go, the lapped cars in the queue are allowed one at a time, by name, to overtake the queue and the Safety Car, which comes in at the end of the following lap. No unlapping in multi-class races.
  • A car unlapping itself is not under the Safety Car rules and drives at most 30 km/h faster than the car it passes; the procedure stops on a new incident, a red flag or a switch to FCY.
  • Neutralised finish: if the last lap starts under the Safety Car, it comes in without a restart and the cars take the chequered flag in queue order, without overtaking. Called during the last lap, it stays in the pits.
  • Behind the Safety Car, the AI weave only while their tyres are cold.
  • End of a VSC or FCY: a 3, 2, 1, GO countdown, exactly as the green flag returns.

Good to knowThe Safety Car in detail

  • Choosing the model: RACING RULES › Safety Car, filter and pick from the car database, or type its folder.
  • Several cars of that model: the one whose livery contains "safety" is the Safety Car; with the default model, the others race as competitors.
  • It is held in its box by AC’s own pit wait in every session, ready to drive out by itself.
  • Pace: its own, with no cap.
  • Bunching: it waits for the queue to form, up to 3 laps.
  • A car ahead of it without having passed it lifts until it is back behind.
  • If it stays stopped in its pit box after a red flag, it is placed near the pit exit after 4 s; that position is kept for the track.
  • If it stops on the track during its intervention, it is returned to its box and the neutralisation carries on as an FCY.
  • Limitation: the Safety Car never leads the field through the pit lane.

Good to knowRed flag: details

  • Each AI uses its own pit box: no queue in the fast lane (a simplification of the real procedure).
  • The restart waits for you, at most until the maximum delay; restarting outside the pits is penalised.
  • At the latest: one and a quarter laps at the return speed plus the pit lane (5 to 30 minutes depending on the track).
  • F1 rules: tyres changed under the red flag and the stop counts; GT and Endurance rules: no work on the cars.
  • Practice and qualifying: the session is suspended the same way, then resumes at the green, with no restart lap; never on a track day.
  • Limitation: AC cannot suspend a race, its clock keeps running during the suspension.

Rules, penalties and sanctions

2:04 · 7 scenes

Five championship rule sets, your penalties under flags and the AI sanctions.

Five rule sets

RACING RULES › CHAMPIONSHIP RULES

  • Base rules, F1 2025, F1 2026, GT and Endurance, applied together to Practice, Qualifying and Race.
  • Track day and Hotlap are never changed by a rule set.
  • Two independent switches: mandatory stop in the race and Safety Car.
  • The same choice is one click away on HOME; it is locked while a race is running.

What changes with each rule set

Checked against the F1 2025/2026, WEC 2026 and GT World Challenge 2026 regulations

  • Everywhere: no change of direction under braking, one defence per straight, repairs at every stop.
  • F1: mandatory stop with two different dry compounds (between 20 and 95% of the race), race fuel from the start.
  • GT: FCY, pits open, a stop between 25 and 35 min of a one-hour race, emulated BoP and Pro-Am grades.
  • Endurance: Slow Zone at 80 km/h, stints of 50 min at most, slower class on a predictable line.

Your penalties under flags

Accidents › Player penalties under flags

  • Negative delta: a mini-sector crossed below −0.50 s.
  • Overtaking under flags: in a yellow zone or the 150 m before it, under a neutralisation or a red flag.
  • An overtake made within 10 s of the flag is forgiven if you give the place back.
  • Sanction: AC’s native throttle cut (5 s); beyond 5 offences, black flag in a race.
Never
on a track day or in hotlap

The AI sanctions

SETTINGS › RACE & SAFETY › Sanctions

  • AC cannot sanction an AI: everything is applied by the app, and time penalties go to the corrected classification.
  • Track limits: three wheels off for 0.3 s; warnings then a time penalty in the race, lap invalidated in practice and quali.
  • Procedural offences: jump start, pit-lane speeding, crossing the pit-exit line: drive-through (default), stop-and-go or time penalty.
  • Black flag: wrong way, ignored penalty or too many penalties; the AI is brought back and parked at its box.

Collisions: who is to blame?

Sanctions › Collisions and blue flags: AI sanctions (option)

  • In a corner, the car whose nose is behind is at fault.
  • On a straight: the car that hits from behind, or the one that moves across.
  • When unclear (start, pile-up, light rub, noses level, neutralisation): racing incident, nobody is penalised.
  • Judged 6 s after the contact: serious when the other car spins, goes off or loses two places.

Your track limits handled by the app

Sanctions › Your track limits handled by the app (option)

  • For players who find AC’s track-limit penalties too harsh: first switch AC’s penalties off in Content Manager.
  • Same rules as the AI: at least three wheels off for 0.3 s, at 40 km/h or more.
  • Practice and quali: lap invalidated in the app, or a warning only.
  • Race: 3 warnings, then a time penalty (corrected classification) or AC’s throttle cut.

CSV race report

Sanctions › Race report (CSV file) (option)

  • Once per race, when everyone has finished, or 90 s after you finish.
  • Written to Documents/Assetto Corsa/logs/AdvancedIA-race.csv; the five latest reports are kept.
  • One row per car, in corrected order: warnings, penalties, drive-throughs, contacts at fault…
  • An interrupted race writes a partial report (complete=0).

New in 2.0.4Give the place back first

  • In a local yellow zone, an overtake always leaves at least 5 s to give the place back before any penalty, and the panel shows it inside the zone. The single-yellow message now says « no overtaking ». Nothing changes under a neutralisation or a red flag.

New in 2.0.0Big grids: fairer judging

  • Under a VSC, the Safety Car or an FCY, an AI that passes another car is first told to give the place back; it is sanctioned only if it keeps it beyond the give-back time.
  • In a local yellow zone, a pass made on the careful first lap, or on a car that is avoiding or braking hard, is also a place to give back first.
  • Contacts: a nudge without loss of control (under 8 km/h of speed difference), or a first-lap contact under 30 km/h, is nobody’s fault; a contact that sends the other car off is still judged.
  • AI track limits: an exit with another car right beside, just ahead or just behind (pushed wide), or on the careful first lap, is excused.
  • Cool-down lap after the chequered flag: an AI that has finished no longer does its in-lap flat out. It drives at 70% of its learnt pace, never braking hard, and moves gently aside if a car still racing comes up behind. Your car is never touched.

Good to knowRules that always apply (racing rules on)

  • One defence per straight, never a move towards a car alongside (one car width), the defence ends as soon as the cars overlap.
  • Neutralisations, mandatory stops and Overtake Mode only apply in the race; the other rules in every profile where the rules are on.
  • Emulated BoP: within each class, the AI level slowly converges towards the median pace (± 2% at most); weight and power are never changed.
  • Pro-Am driver ratings (Bronze to Platinum): each AI gets a rating (Platinum, Gold, Silver or Bronze) for the whole weekend; lower ones up to 4% slower and slightly more careful.
  • F1 2026: Overtake Mode emulated for the AI only (+2% level on the next lap’s straights when within 1 s at the detection point).

Good to knowEscalating penalties and notices

  • Option "Escalating penalties for repeat offences": 5, 10, 15 s… up to 30 s, for track limits only.
  • Each sanction has its own overlay panel: badge (DT, SG, +N, CUT, POS, black flag), driver’s name, sanction and reason.
  • Unticking the section or the switch of a penalty’s source during a session cancels what is under way.
  • Serving: the AI is called in after 30 s of racing, pits open, no red flag or neutralisation; not served within the set laps: black flag.

Pits, strategy and weather

2:04 · 7 scenes

Mandatory stop, tyres, fuel, repairs, every AI’s strategy, rain and endurance.

The mandatory stop

RACING RULES › Mandatory stop in the race

  • A stop is required within a window (off by default; on with F1 and GT): from 25% to 75% of the race by default (in leader laps, or in time).
  • Each AI stops at its own moment in the window, three called in at once at most.
  • You: the overlay warns you when the window opens, then at most once a lap, just before the pit entry.
  • Stop missing when the window closes: penalty. A configured stop is never lifted because of the race length.

Tyres, fuel, repairs

Mandatory stop in the race

  • New tyres at every visit once a stop rule is active: wets if the weather requires them, otherwise another compound (F1) or a fresh set.
  • Repairs at every stop: 3 s plus a damage-based time, 60 s at most.
  • Fuel: refuel at the stop, race fuel from the start, or left to AC.
  • Consumption measured lap by lap and remembered per car and track; an AI never runs dry.

Every AI is its own strategist

SETTINGS › RACE & SAFETY › AI strategy (race)

  • Cautious or bold, each strategist plans its stops from its tyre wear, its fuel and the laps left.
  • Undercut: a bold strategist a few laps from its stop pits before the rival just ahead.
  • Cover: a cautious one answers the rival behind that pits; overcut: an AI on good tyres stays out two laps when the rival ahead pits.
  • Advanced strategy (option): pit-lane loss learnt, cheap stop under the Safety Car.

Varied starts, wear, failures

AI strategy · Weather

  • Varied starting strategies (option): part of the AI swap compound on the grid; the back leans harder, the front softer.
  • Wear: the app waits until it has seen a fresh tyre and the wear rising before using it.
  • Pace from tyre wear, compound and fuel load (option): worn tyres cost more and more.
  • Rare progressive failures: leak, battery drain, overheating, slow puncture; the AI pits, is repaired in 8 to 20 s and goes again.

Rain and tyres

SETTINGS › RACE & SAFETY › Weather

  • The app watches rain, track wetness and standing water, with 15 s of confirmation.
  • Wet track: level down by up to 10%, aggression lower, caution higher, rear detection range +30%.
  • Rain: intermediates, or wets in heavy rain, fitted at the stop; back to dry tyres when the track dries.
  • On the grid, the right compound is fitted at once rather than making a stop on lap 1.
Without wet tyres
grip compensation 15% (0–30%)

Live weather

Weather › Live weather (progressive pace, anticipated tyres)

  • The AI follow the grip as it changes instead of switching at one instant.
  • Each driver has its own crossover point: a bold one stays on dry tyres a little longer.
  • Stops are spread: three cars called at a time, the worst-shod first.
  • The weather controller’s forecast is used when CSP provides it.

Endurance

SETTINGS › RACE & SAFETY › Classes / Endurance

  • Pace varies from one stint to the next (3%), drawn at each stop.
  • It drops slightly over a stint (1%, reached after 40 min, reset in the pits).
  • Extra caution for 8 s on pit exit.
  • Lapses in focus become more frequent after 1 h 30 without an incident; TO CHECK suggests the Endurance layer beyond one hour.

New in 2.0.4Mandatory stop and closed pits

  • If the mandatory-stop window closes while the pits are closed (neutralisation), the missed stop is no longer penalised: you could not stop any more.
  • When the game ignores the pit calls (some setups: the AI never enters), the app writes it in the log after 5 laps without entering, shows it in HOME › TO CHECK and stops calling that AI, with no penalty. First thing to try: a newer CSP version.

New in 2.0.3Mandatory stop by race distance

  • By default, a race of 100 km or less has no mandatory stop and a longer race has one, as long as you don’t touch the « Mandatory stop in the race » switch.
  • Once you set it, your choice is kept whatever the distance; picking a championship rule set goes back to the default. The window status line and the session log say which applies.
  • The stop window opens even when the game does not report the leader’s lap count (it stayed at 0 on some setups, and no AI pitted): the app then takes the cars’ own laps, with one warning line in the log.

New in 2.0.0Mandatory stop and short races

  • Short race: the pit window closes before the last lap, with at least one lap open; the AI are called in at least one lap before.
  • A configured mandatory stop is never lifted because of the race length.
  • Only a race too short for the stop lifts it, with the message « Race too short: no mandatory stop. » It is never announced as a sprint race.
  • F1 rules with a compound change: as in real F1, a stop made under a VSC, the Safety Car or an FCY counts as the mandatory stop, even before the window opens. The AI strategists no longer hold that stop back.
  • A green-flag stop before the window still does not count; other rule sets keep their window.

Good to knowSafety of the stop plan

  • Whether a stop is needed is decided on the raw fuel and tyre capacity; margins only place it.
  • Critical fuel (under 1.5 laps, cannot finish): called even with the pits closed or the call limit reached.
  • A stop that changed nothing is not asked again; one call limit is shared with the stop rules and penalties.
  • A neutralised lap does not teach fuel use.

Good to knowWet tyres: how CSP behaves

  • Compounds come from each car’s CSP catalogue (dry, intermediate, wet); the log lists them once per session.
  • Off the grid, the app requests a stop and only changes the compound at the stop; the request stays active in the lane until the change.
  • On a dry track, if an AI’s CSP rain-tyre flag turns back on, the dry-tyre request is given again (every 10 s at most).
  • Without a wet compound, a bounded grip assist (15%) compensates; Rain FX stays active.

Good to knowEndurance and classes

  • Endurance layer: Track day and Race profiles; on a track day, without a classification.
  • Multi-class: without a large enough gap the grid stays one class; an AI still learning its pace is compared with no class.
  • Class patterns: literal substrings of the car folder name (32 characters at most), class 1 = the fastest.

Overlay, light panels and diagnostics

2:38 · 9 scenes

Reading the band, setting the overlay, DRS and beeps, light panels, diagnostics and troubleshooting.

Reading the band

In-game overlay

  • On the left, the flag and its code: SC, VSC, FCY, ! for a yellow, !! for a double yellow, P for a mandatory stop.
  • In the middle, the title then a short one-line instruction.
  • On the right, the delta time, large: green when positive, flashing red when negative.
  • Below, pills when they apply: penalty, place to give back, pit lane closed, no overtaking.

FIA signals and information

In-game overlay

  • SLOW VEHICLE (white): a car ahead, within 300 m, is going below half its usual pace; overtaking is allowed.
  • WARNING (black and white): a place still to give back, or your last tolerated offence.
  • CAR DAMAGED (black with an orange disc): shown for 20 s when your car gets notable mechanical damage.
  • Session line, lap-line message (LAP 4/8) and end-of-race summary: place, gains, best lap, overtakes.

Setting up the overlay

SETTINGS › ADVANCED › In-game overlay

  • UNLOCK · MOVE · SIZE: drag it, pull the corner, right-click to lock it again.
  • Size from 0.50x to 2.50x; background opaque, dimmed or transparent; display only with information, or always.
  • It can replace AC’s session box and take over AC’s messages.
  • It hides AC’s flags and messages through two CSP options, given back to your values as soon as the app stops hiding them.

DRS and beeps

Racing rules · Overlay

  • A beep when your DRS becomes available, in hotlap too; a DRS badge until you open it. The app never opens your DRS.
  • DRS rules: disabled in the rain and under flags, and for one leader lap after the start, a Safety Car or a red flag.
  • The AI open their DRS in the zones, on a straight, when CSP reports it available.
  • F1-style delta beeps, closer and closer together; volume from 25 to 400%.

Track light panels

SETTINGS › RACE & SAFETY › Track light panels

  • On a track whose CSP configuration lights its panels from the player’s flag, the app lights them with its own flags.
  • Yellow: yellow zone ahead of you, SC, VSC, FCY; white: slow vehicle; orange: slippery track; blue: your blue flag.
  • Red only when CSP hides AC’s own flags; green at the end of a neutralisation (5 s) or of a zone (3 s).
  • The app reads the track configuration and never writes it; offline only.

The DIAGNOSTICS tab

DIAGNOSTICS

  • Updates, sign calibration ("-1 / -1" is normal in AC), headlight flashes, track zones.
  • CSP capabilities: every function used, available, call succeeded, missing or disabled after three failures.
  • AI CARS DRIVEN: state, offset, level, aggression, caution and gap of each AI; hover for the reason.
  • Circular log of the last 200 events, with a filter (ALL, ERROR, WARN, INFO, DEBUG).

The session log

DIAGNOSTICS › SESSION LOG

  • The session log is written to Documents/Assetto Corsa/logs/AdvancedIA.log; the three previous ones are kept.
  • The file stays in French; the DIAGNOSTICS window shows it in the interface language.
  • Every important decision has its line: yields, overtakes, flags, sanctions, strategy, weather.
  • A minute summary counts yields, overtakes, refusals and their reasons.

Zones and track memory

DIAGNOSTICS › Track zones · Global options › Track memory

  • Zones: mark a start and an end for a no-manoeuvre, caution or attack section, then SAVE.
  • Files read as data, never executed: tracks/<track>.lua and Documents\Assetto Corsa\AdvancedIA\tracks.
  • Track memory (option): each car model’s pace at every point of the lap, your pace, the time lost in the pits.
  • Used only where the session knows nothing yet; never in a wet, online or replay session.

Quick troubleshooting

If something is wrong

  • The window does not appear: while driving, open it from AC’s apps bar; otherwise open the pause menu or the setup screen, or click its icon among the setup apps.
  • "Native AI": no section ticked in this profile; load a preset or tick a section.
  • AI appearing around you on a long track: AI flood is switched off, relaunch the game from Content Manager.
  • No Safety Car: add its model to the grid; otherwise VSC or FCY take over.

New in 2.0.4The overlay hides with AC’s apps

  • Hiding the apps with Ctrl+H hides the overlay too; it comes back with them.

New in 2.0.2Window, sounds and companion apps

  • « Window text size » (100 to 150%) in SETTINGS › ADVANCED › Overlay › Interface; the window grows with the text.
  • « App sounds (beeps) »: a single switch in the same place turns every app beep off (DRS and delta).
  • The tooltip of the built-in preset for the detected session explains how to keep your own settings.
  • SpotterEngineer (formerly SpotterEnginer) is recognised under both names: folder, pit plan, strategy and update state. The bridge format does not change.
  • New in 2.0.3: a small read-only key tells companion apps whether the two-dry-compounds rule applies to you and which dry compounds you have used. The bridge does not change.

New in 2.0.0Overlay per desktop, diagnostics, companion apps

  • The overlay is set desktop by desktop: SETTINGS › ADVANCED › In-game overlay › App desktops, four switches Desktop 1 to 4 (the current desktop is marked).
  • On a desktop where it is off, nothing is drawn, but the app keeps managing everything.
  • Elements on this desktop: session line, flag panel, explanation and recap, instruction pills are shown or hidden separately, desktop by desktop.
  • To place an element apart: « Move the overlay », then drag it out of the panel (it becomes its own window on this desktop); right-click to lock. « Reset » puts it back under the panel.
  • Watching a replay in the middle of a race no longer ends the race in the app: nothing is read during the replay, and on return the app settles for 2 s before detecting a finish.
  • DIAGNOSTICS shows a line for the AI turn signals, in the CSP capabilities.
  • Companion apps: the data bridge moves to version 2 (retirements, the reason for each AI’s last sanction, track-limit and penalty thresholds). SpotterEngineer (formerly SpotterEnginer) Beta 2.1.1 or later is needed; AdvancedIA never depends on them.

Good to knowCSP display options

  • File: Documents/Assetto Corsa/cfg/extension/gui.ini, section [HIDE]; only HIDE_SYSTEM_MESSAGES and HIDE_RACE_FLAGS change.
  • An option you had ticked yourself is never touched; your original values are saved before the first write.
  • They stay ticked when the game closes; the app gives your values back when you switch off the option, the app, or the flag panel.
  • At most 8 writes of gui.ini per session; AC’s red cut and penalty banners cannot be hidden through CSP.

Good to knowBridge with companion apps

  • SpotterEngineer (voice spotter and race engineer) is a separate, optional app that reads AdvancedIA’s state.
  • SpotterEngineer, the voice engineer and spotter, is available on GitHub: github.com/VincentChevalier44/SpotterEngineer
  • The bridge only opens when SpotterEngineer (or SetupLab) is installed; it never writes into the engine or the settings.
  • Its updates are announced under TO CHECK; its pit plan is followed for your reminders.
  • SetupLab: a read-only key AdvancedIA.session gives it the session, the rules, the state of your lap (clean or not), whether DRS is allowed and the compound change still owed. Nothing is shown and nothing changes for the AI.

Good to knowBeep preferences

  • Sounds: sounds/delta-beep.wav and sounds/drs-available-beep.wav.
  • Volume from 25 to 400% (200% by default), on top of the master volume; the same in cockpit and exterior views.

Good to knowWhat suspends the commands

Status shownMeaning
Online session: commands suspendedReal online session
CSP alt-online modeFake online race run by a CSP New Modes script
Cannot read the game state: commands suspendedCSP did not answer the read of the game state
Replay: commands suspendedAC does not simulate the cars
PausedReal pause; the setup menu keeps the engine running
Session overThe session has ended
No AI spline: commands suspendedNo usable AI line on this track
Panic: commands stoppedPANIC button
Disabled: native AIAPP switch off
Abnormal time stepA frame took abnormally long
CSP physics access unavailablephysics.allowed() is false; the app never bypasses CSP
No section enabled: native AINothing ticked in this profile

Good to knowDetailed troubleshooting

  • The AI never move aside: check DIAGNOSTICS › Sign calibration (-1 / -1) and that Yielding, Overtaking, Accidents and Lines are ticked.
  • On a track day, the AI hold each other up in queues: tick Spacing (or load Nordschleife Touristenfahrten).
  • An AI you are lapping will not let you by: blue flags only act in a race, section ticked; sit within 40 m.
  • Your headlight flashes are ignored: learn them first, or use the horn; check the mode (Lapped cars in the race by default).
  • The overlay is off screen: SETTINGS › ADVANCED › In-game overlay › PUT BACK ON SCREEN.
  • I am never penalised: never on a track day or in hotlap; check "Player penalties under flags" and AC’s race settings.
  • The AI do not change tyres in the rain: tick Weather and "Manage dry and wet tyres".
  • I want the original AI back right now: PANIC, or switch the APP off.
No topic matches. Try another word: "blue", "delta", "rain", "pits"…

Animated guide to AdvancedIA Beta 2.0.4, written from the app’s code and documentation. The videos are explanatory diagrams in condensed time, not game captures; setting values are the defaults of the profile or preset named, examples aside, and stay adjustable.

AdvancedIA © Vincent Chevalier / LHK Informatique · MIT licence · GitHub repository

Barlow and JetBrains Mono fonts (SIL OFL licence). Updated: 18/11/2026.