AI Development Guide and M27AI v5 Devlog


Following the recent Supreme Computer Cup I was inspired to have a go at developing a basic AI for FAF. As I had zero experience of coding in Lua, I thought at the same time I would write down things as I learnt them to have both a guide for other people interested in getting started in developing an AI, and a dev log for the creation of my AI.

See below for a link to the current AI development guide and devlog:

The current AI has been uploaded as a mod, and the files can also be accessed from the below:

I've copied the current overview from the guide below:

This document is intended to do 3 things at once (meaning it does none of them very well!):
• Act as a guide to people new to FAF AI development, including collating any other useful resources out there on AI development
• Be a sort of dev log of my thought process and development steps for creating my first FAF AI, with extracts of code thrown in
• Form my main ‘todo’ list for further developments of my AI
If you see any errors, or have any comments or suggestions (in particular any AI developers who read this since you’ll probably know better/easier ways of doing things than the methods I’ve chosen) let me know and I can update the guide where relevant.

If you’re here for useful resources and/or details of how to write AI and don’t care about the dev log aspect then just skip to section 2) Setup and background and section 4) Index of useful functions, and/or browse the index for points that may be of interest.

In terms of the dev log section, if you start seeing lots of yellow highlighting/square brackets you’ve reached the end of the dev log part and the start of my todo list of things I’m planning on working on next.

Latest changes (v5) summary:

v5 changes - these were mostly about the ACU, making it more aggressive and less suicidal

  • Fixed various bugs and improved some error handling (see 3.18.4)
    ACU improvements (see 3.19):
  • ACU will try to expand to high reclaim or mex locations, while building on mexes it comes across and reclaiming
  • ACU will have scout and MAA support
  • ACU tries to kite enemies it comes across
  • ACU uses manual overcharge to overcharge optimal targets

v6 Hotfix (note - devlog not yet updated): Fixed errors so AI will now work following the recent FAF patch

  1. Overview 11
    1.1) AI goals 11
    1.2) Background 12
    1.3) Approach 12
  2. Setup and background 13
    2.1) Lua editors 13
    2.1.1) Intellij IDEA 13
    2.2) Other guides which include a section on AI: 13
    2.2.1) General information: 13
    2.2.2) How AI in FAF works 14
    2.2.3) AI markers and how AI uses them: 15
    2.2.4) Hooking (e.g. replacing/appending existing game code) 15
    2.2.5) Creating custom scripts for Sorian AI: 15
    2.2.6) Pathfinding 15
    2.2.7) How platoons work 15
    2.3) Lua coding 16
    2.3.1) How to code in Lua 16
    2.3.2) Stand alone Lua code testing 16
    2.3.3) Lua optimisation 16
    2.3.4) Common causes of errors for non-Lua coders 16
    2.4) Debugging in FAF 17
    2.4.1) Console 17
    2.4.2) Cheats 17
    2.4.3) Log window and error messages 17
    2.4.4) Debug window and shortcuts 17
    2.4.5) Platoon names for debugging 18
    2.4.6) Fast speed 18
    2.4.7) Other shortcuts and game startup options 18
    2.5) AI development discord 19
    2.6) Core FAF Lua files 19
    2.6.1) Accessing core Lua code 19
    2.6.2) Other built in functions 20
    2.6.3) Unit blueprints 20
    2.7) Testing AI against other AI 20
    2.7.1) Simple offline testing 20
    2.7.2) Mass offline AI testing 20
    2.8) Getting started – using a simple AI template as a starting point 21
    2.9) Downloading and setting up MicroAI 21
    2.10) Giving the AI mod your own name 21
    2.11) General - Hooks, and getting the code to recognise if it’s running your AI 22
    2.12) Github 22
    2.12.1) Linking Github with a local repo via creating your own init file 23
    2.12.2) Pro Git ebook 23
    2.12.3) Git commit messages 23
    2.13) Uploading your AI to FAF 23
    2.13.1) Pre-upload checklist 23
    2.13.2) FAF rules on uploading mods 23
    2.13.3) Uploading to FAF 23
  3. AI changes 24
    3.1) Build order - Changing the initial build order 24
    3.1.1) Adding/removing buildings 24
    3.1.2) Change build order based on map resource positions 24
    3.1.3) Build order conditions 25
    3.2) Build order – ACU builds without moving at start 25
    3.2.1) BaseTemplate 25
    3.3) Build factory and power to benefit from adjacency 26
    3.3.1) Record all mexes on the map, and reference this information 27
    3.3.2) Determine com start position 27
    3.3.3) Identify mexes near to start 28
    3.3.4) Hook onto the core code relating to building a structure at a location 29
    3.3.5) Call build order from custom aiBrain function, to edit how things are built 29
    3.3.6) Adjust build template based on mex location - conditions 30
    3.3.7) Adjust build template based on mex location – build location adjustment 31
    3.3.8) Build initial PGens by existing factory 31
    3.3.9) Adjacency bonus where ACU is away from start location 33
    3.3.10) Referencing unit blueprints for information such as unit size 35
    3.4) Platoons and sending engineers to reclaim 37
    3.4.1) How platoons work 37
    3.4.2) Send the first engineer on reclaim duty 42
    3.4.3) Determine where to send the engineer to reclaim 44
    3.4.4) Identifying reclaim mass value 44
    3.4.5) Find out if a location is accessible by ground: 44
    3.4.6) Mapping reclaim locations and assigning preferred location to an engineer 46
    3.4.7) Don’t send early reclaiming engi if there’s minimal starting reclaim 46
    3.4.8) Issue new reclaim command if engineer becomes idle 47
    3.4.9) Send more engineers to reclaim later (as lower priority) based on the reclaim currently on the map 47
    3.4.10) Send 5 engineers at the start to reclaim and build mexes 48
    3.4.11) Reclaiming trees when no main mass left 49
    3.5) Building and assisting hydro 49
    3.5.1) Check if hydro near start area and have engineer build hydro 49
    3.5.2) Have ACU assist engineer with hydro 50
    3.5.3) Get ACU to continue build order after hydro complete 51
    3.5.4) Subsequent build order changes 52
    3.6) Attack force composition changes and check of AI performance 52
    3.6.1) Build Moar Tanks 52
    3.7) Pre-v1: AI Progress check 52
    3.7.1) Land factory buildings and other build order refinements 53
    3.8) Raiding AI 55
    3.8.1) Raiding behaviour - overview 55
    3.8.2) Queue up move commands for mexes 55
    3.8.3) Identify mexes to target 56
    3.8.4) Locating mexes near to an existing pathing route 58
    3.8.5) Determine when raiders need new targets 59
    3.8.6) Handling complications (stuck units, move orders built on, platoon units dying) 59
    3.8.7) Change factory rally point so units are assigned orders sooner 61
    3.8.8) Making use of platoon names for debugging 63
    3.8.9) Ensure 1 land scout included in each platoon 64
    3.8.10) Use microbots before switching to tanks 64
    3.8.11) Have scouts stay with the platoon 66
    3.8.12) AI scouting, threat detection, and identifying nearby enemy units 67
    3.8.13) Attack engineers en-route: Overview 69
    3.8.14) Tracking when have reached movement points 69
    3.8.15) Determining the platoon minimum range 70
    3.8.16) Identifying nearby enemy units and assessing their threat 71
    3.8.17) Actions based on enemy threat 73
    3.8.18) Avoid attacking enemy mexes for small platoons 74
    3.8.19) Other issues – cheating, walls and min range 75
    3.8.20) Larger raiding platoons 76
    3.9) Large attack wave 77
    3.9.1) Checking when to form a large attack wave 77
    3.9.2) Generalising raider AI 77
    3.9.3) Creating separate platoon AI for the large attack force 78
    3.9.4) Run nearer to base when outnumbered 78
    3.9.5) Recalling nearby raiders to join attack force 79
    3.9.6) Updating threat assessment for ACU health and upgrades 80
    3.9.7) Don’t chase small numbers of faster units 82
    3.9.8) Switch to hunt and kill enemies once reached destination 83
    3.10) Pre-v1: AI Progress check 83
    3.10.1) Summer duel 84
    3.10.2) Theta passage 84
    3.10.3) New issues 84
    3.11) Platoon AI – Generalised approach and further enhancements 85
    3.11.1) Embracing the table 85
    3.11.2) Moving units when shots blocked by cliffs 88
    3.11.3) Anti-stuttering protection 88
    3.11.4) Large attack AI – Rally point for merged units 88
    3.11.5) Raiders assume small numbers of enemies are engis/scouts 89
    3.11.6) T1 Artillery specifically target structures, and spread-attack units 89
    3.11.7) Keep scouts at back of platoon 90
    3.11.8) Platoons with non-Seraphim T1 artillery and no tanks don’t run unless against slower enemy 91
    3.11.9) Factor in nearby platoons when faced with enemies 91
    3.11.10) More T1 arti in platoons once reached certain level of tanks 92
    3.11.11) Don’t treat AA as a direct fire unit when forming a platoon 92
    3.11.12) Build hydro where it’s far away from base 92
    3.12) Expansion bases 93
    3.12.1) Background – expansions and the main base 93
    3.12.2) Having all units treated as available for platoons 93
    3.13) Upgrade ACU with gun and attack 94
    3.13.1) How to upgrade an ACU 94
    3.13.2) Get enough energy to support guncom 94
    3.13.3) Upgrade ACU’s gun once have enough energy 95
    3.13.4) Attack with ACU once upgrade finished 96
    3.13.5) ACU overcharge 96
    3.14) V1-3 release incl AI progress check 97
    3.14.1) Performance – v1-3 of M27AI 97
    3.14.2) Issues and planned improvements from testing 97
    3.14.3) Debug issues and other bug fixes 98
    3.14.4) Attack lauched as soon as ACU gun ready 103
    3.14.5) Default attack-move direct fire units at enemy (attack-move if platoon scattered) 103
    3.14.6) Limit of 1 microbot per early raider platoon, and tank defenders 104
    3.14.7) Skip move location if are closer to the next move location than the first one 104
    3.14.8) Build more engineers if are close to overflowing mass 105
    3.14.9) Add energy storage requirements to ACU initial land factory build order 106
    3.14.10) ACU and Engineers will move near mex to build 106
    3.14.11) Other minor misc changes 108
    3.15) On demand basic pathfinding 108
    3.15.1) Revised approach 108
    3.15.2) Mex raiding path optimisations 110
    3.15.3) Useful maps for testing map based logic 110
    3.15.4) Move to build structure – check pathing 111
    3.15.5) Platoon Merge location – have it check no pathing issues in nearby segments 111
    3.16) AI Overseer - responding to enemy attacks 111
    3.16.1) Overview 111
    3.16.2) Planned initial logic 111
    3.16.3) Run overseer on AI creation 112
    3.16.4) Assigning units to defender platoons 113
    3.16.5) Recording enemy threats 114
    3.16.6) Sending units to deal with enemy threats 116
    3.16.7) Sorting a multi-dimensional table 116
    3.16.8) Disbanded units return to base 118
    3.16.9) Intercepting platoons should leave at least 1 scout when removing spare units 118
    3.16.10) Don’t remove units when in combat 119
    3.16.11) Platoon and other build conditions 119
    3.16.12) Limit number of mobile AA in an intercepting defending platoon 120
    3.16.13) Remove ACU from defender platoon once the threat is dealt with 120
    3.16.14) Don’t have ACU join a platoon if its upgrading 120
    3.16.15) Disabling sorian base manager distress logic 121
    3.17) AI Overseer – Intel and ACU managers 121
    3.17.1) Intel manager - overview 121
    3.17.2) Planned logic – 1-off 121
    3.17.3) Planned logic – recurring 122
    3.17.4) Scout localised platoon AI 123
    3.17.5) ACU manager 124
    3.18) V4 release (incl AI progress check) 125
    3.18.1) Pre-release testing checklist 126
    3.18.2) AI performance results 126
    3.18.3) Notable issues noted from performance 127
    3.18.4) Resolution of immediate issues/bugs post-release 128
    3.19) ACU –aggression, support and micro enhancements 133
    3.19.1) ACU custom platoon - overview 133
    3.19.2) ACU expansion – choice of location 134
    3.19.3) Platoon completion actions 136
    3.19.4) Expanding more than once 137
    3.19.5) Getting nearby reclaim and/or unclaimed mexes while moving 138
    3.19.6) Assisting hydro construction (reworked) 140
    3.19.7) ACU defender platoon refinements 141
    3.19.8) ACU Scout helper and general scout build order 141
    3.19.9) ACU MAA helper and general behaviour 144
    3.19.10) Air threat assessment and MAA to build (initial) 144
    3.19.11) Large platoon scout and MAA helpers 145
    3.19.12) ACU attacks independently to large attack platoon 145
    3.19.13) ACU Build order tweaks 145
    3.19.14) Aeon ACU gets both gun upgrades 146
    3.19.15) ACU retreat 146
    3.19.16) ACU kiting 146
    3.19.17) Have ACU attack-move if kiting doesn’t return any action 147
    3.19.18) Manual overcharge 147
    3.19.19) Other misc changes/refinements 151
    3.20) V5 release (incl AI progress check) 151
    3.20.1) Pre-release testing checklist 151
    3.20.2) AI performance results 151
  4. Future likely planned changes 152
    4.1) AI Overseer – Other changes 152
    4.1.1) Fix AI assisters when ACU goes into water 152
    4.1.2) ACU logic when underwater – reclaiming enemies; moving to nearby land 153
    4.1.3) Update intercept location for defenders 153
    4.1.4) Limit the range of the defender logic 153
    4.1.5) Determine when an enemy threat is killed 153
    4.1.6) T2 range adjustments 153
    4.1.7) Split up a large platoon to chase small units 153
    4.1.8) Attack with all land units once ACU near enemy main base 154
    4.1.9) Point defence included in ACU threat? 154
    4.1.10) Platoon composition manager 154
    4.1.11) Air threat MAA intercept 154
    4.1.12) Performance optimisations 155
    4.1.13) Anti-stuttering logic needed? 155
    4.1.14) Interupted buildings are compelted by assisting engineers 155
    4.1.15) Intel pathing – use land based pathing 155
    4.1.16) Intel pathing – have scouts advance independently if no threats 156
    4.1.17) Initial movement path for defenders based on intel 156
    4.1.18) Platoon completion – next action based on intel coverage 156
    4.1.19) Backup logic for unforeseen errors – idle ACU 156
    4.1.20) Backup logic for unforeseen errors – idle units 157
    4.1.21) Use OnKilled to reduce enemy threat and cancel defender intercepts 157
    4.1.22) Other (TBC) 157
    4.2) More micro improvements and other enhancements 157
    4.2.1) Assist building being constructed instead of building new one 157
    4.2.2) Engineer assist AI will assist factories 157
    4.2.3) ACU and small platoons move if under attack from artillery 157
    4.2.4) ACU/General platoon target prioritisation 158
    4.2.5) Initial raider build order tweaks 158
    4.2.6) Factory builder – instance count bug 158
    4.2.7) Indirect fire units near the ACU when its upgrading? 159
    4.2.8) Attack platoons merge with larger attack platoons they come near 159
    4.2.9) Support platoon units run away from enemies nearest them 159
    4.2.10) T1 Arti composition based on PD 159
    4.2.11) Platoon merge path when attacking? 159
    4.2.12) Aeon T1 tanks kiting 159
    4.2.13) Indirect fire structure targeting 159
    4.2.14) ACU new land factory/adjacency bonus – target nearest mexes first? 160
    4.2.15) Target low health units (small platoon sizes) 160
    4.2.16) Anti-capture protection 160
    4.2.17) Advanced reclaim prioritisation 160
    4.2.18) Air factory adjacency 160
    4.2.19) Engineer management – combine to construct a single building instead of 2 separate ones 160
    4.2.20) Engineers attack-move to nearby enemies 161
    4.2.21) Improved blip threat detection 161
    4.2.22) Protecting engineers 161
    4.2.23) Saving scouts when a platoon is dying 161
    4.2.24) Replace existing construction orders if closer 161
    4.2.25) Factory adjacency location - Build land factories nearer our base if not near base 161
    4.2.26) Integrate IsShotBlocked into wider unit stuck and targeting logic 161
    4.2.27) Advanced Kiting – Com vs Com 161
    4.2.28) Overcharge further refinements 161
    4.3) Resource stall and overflow 162
    4.3.1) Mass stall – pause non-mex production 162
    4.3.2) Energy stall – pause non-PGen production 162
    4.3.3) Mass overflow – upgrade a mex 162
    4.4) T2 upgrades and anti-turtle tactics 162
    4.5) Enhanced pathfinding information – how long to path 162
    4.6) AI scouting, threat detection, and safe paths 163
    4.6.1) General discussion on scouting and threat detection 163
    4.6.2) Naval pathfinding 165
    4.6.3) Determining a safe path for raiders 166
    4.6.4) Engineer mex selection – calculating safe paths 166
    4.6.5) Basic air scouting 166
    4.7) Other enhancements 166
    4.7.1) Fix guide hyperlinks 166
    4.7.2) What to do if early hydro is destroyed 166
    4.7.3) Transports 166
    4.8) Optimisations – base game AI removal 167
    4.8.1) Consumption values 167
    4.9) Lower priority enhancements to earlier code 168
    4.9.1) Enhancements flagged earlier 168
    4.9.2) Per-unit micro to win early exchanges 168
    4.9.3) If control >50% of mexes then consider upgrading to T2 mexes and land 168
    4.9.4) Overseer and full share 168
    4.9.5) Free for all and multiple opponents 168
    4.9.6) Enemy ACU upgrade 169
    4.9.7) Improve intel pathing choice based on enemy threats 169
  5. Index of useful functions 169
    5.1) Map, game setup and general aiBrain information 170
    5.1.1) aiBrain - general 170
    5.1.2) AI Brain – Economy 171
    5.1.3) Map Markers and start positions 172
    5.1.4) Map size 172
    5.1.5) Terrain info 173
    5.2) Getting a list of units by category, location, or other method 173
    5.2.1) All units that meet a particular category 173
    5.2.2) Units at/near a location 174
    5.3) Unit information 175
    5.3.1) Units on radar 175
    5.3.2) Blueprints 175
    5.3.3) Unit upgrades 176
    5.3.4) Unit’s ai Brain owner 176
    5.3.5) Whether a blueprint matches category conditions 176
    5.3.6) Location and pathfinding 176
    5.3.7) Unit’s current commands and whether it’s alive 177
    5.4) Unit and platoon commands 177
    5.4.1) Building 177
    5.4.2) Assisting 177
    5.4.3) Reclaim 177
    Note: The core AI functionality appears to run ProcessBuildCommand on a unit given an issuereclaim order (even if that unit is in a custom platoon) and will then disband that platoon (meaning less than 1 second after the reclaim order is given, the unit stops reclaim and is disbanded). 177
    One solution is to add extra code to ProcessBuildCommand to not disband the platoon is the unit is reclaiming. 178
    5.4.4) Factory specific commands 178
    5.4.5) Movement and attack-move 178
    5.4.6) Transport 178
    5.4.7) Combat related 178
    5.4.8) Stopping 179
    5.4.9) Upgrades 179
    5.4.10) Current commands and targets 179
    5.4.11) Unit status 179
    5.4.12) Change a unit’s name 181
    5.5) Platoon additional functions 181
    5.5.1) Units platoon handle 181
    5.5.2) Get AIBrain 181
    5.5.3) Get units in a platoon 181
    5.5.4) Disband 181
    5.5.5) Platoon exists 181
    5.5.6) Platoon position 181
    5.5.7) Get all platoons 181
    5.5.8) Platoon ai plan name 182
    5.5.9) Add units to a platoon 182
    5.5.10) Army pool and removing units from a platoon 182
    5.5.11) Create a platoon 182
    5.5.12) Change or reset an AI plan 182
    5.5.13) Platoon movement formation 182
    5.6) Time and thread related 182
    5.7) Other 183
    5.7.1) Visual changes – Draw Circles and Lines 183
    5.7.2) On Intel Change 184

Not exactly an AI comment, but you wanna have things right, right? 🙂

"Lua" (pronounced LOO-ah) means "Moon" in Portuguese. As such, it is neither an acronym nor an abbreviation, but a noun. More specifically, "Lua" is a name, the name of the Earth's moon and the name of the language. Like most names, it should be written in lower case with an initial capital, that is, "Lua". Please do not write it as "LUA", which is both ugly and confusing, because then it becomes an acronym with different meanings for different people. So, please, write "Lua" right!


Thanks, I'll reflect the correct case usage of Lua in the next version of the guide (I'll probably update it whenever I release an AI update so the two are in sync)


So I decided I might actually post something more relevant 🙂

Full stops vs colons – continuing the above example, oUnit.GetUnitId() will return an error, but oUnit:GetUnitId() won’t.

It's maybe worth mentioning why that happens. oUnit:GetUnitId() is syntactic sugar for oUnit.GetUnitId(self). So if you wanna you the version with . you have to pass self as first arg.

F9 opens up the debug window (you may want to change the game resolution to windowed to more easily access this).

That's a log window, not debug. You can open the debugger with Ctrl+F9 or /debug and that's way better for debugging then trying to print things into the log. Since it works as any debugger you are used to, pauses the execution on the line you seleceted and lets you see whats inside global and local variables.

The below link also appears to give a list of core/global functions that can be used (I’ve not tested these to see if they all work, or even if they’re for FAF rather than SupCom2):

It is for FA, some of these functions are documented here

I’m not using Github since I’m working on this on my own, and since I doubt I can get the same ease of use I currently have with changing something offline and instantly seeing the results in-game after a Ctrl+F10 restart. However, Github is used by a number of the AI developers so there’s likely some significant benefits to it.

Git is very useful even if you're working alone, as you have history of changes and you can easily switch to previous versions if something breaks. The game can use files from any location, so for my development, it uses files from my local git repo. It's just a matter of setting your own init file

To keep things simple (as I couldn’t get more complex builderconditions{} with multiple variables to work, despite seeing it being used in other AIs people have done)

So build conditions are defined in a table

BuildConditions = {
    {BMBC, 'BaseEngineersEnabled', {self.BaseName}},
    {BMBC, 'BaseBuildingEngineers', {self.BaseName}},
    {BMBC, 'HighestFactoryLevel', {i, self.BaseName}},
    {BMBC, 'FactoryCountAndNeed', {i, j, pType, self.BaseName}},
    {BMBC, 'BaseActive', {self.BaseName}},

so here, you have 5 build conditions, each in it's own table.

local BMBC = '/lua/editor/BaseManagerBuildConditions.lua'

first value ( BMBC) in the table is thr path the file you wanna use
second one ('BaseEngineersEnabled') is name of the function in that file to use
third ({self.BaseName}) is table of arguments to pass into that function
AI brain is always passed as first argument, and then all other that you specify in the table

So you could rewrite your example to this:

-- Inside the builder
BuilderConditions = {
    {MIBC, 'Is1NearbyMex', {11}}

-- Inside MiscBuildConditions.lua
function Is1NearbyMex(aiBrain, distance)
    local iNearbyMex = MapInfo.RecordMexNearStartPosition(Utilities.GetAIBrainArmyNumber(aiBrain), distance, true)
    if iNearbyMex == 1 then
        return true
    return false

This way you can already specify the distance for chehcking the nearby mexes.

Determine com start position

This function should do the trick 🙂

To help with this, I first wanted to understand what the various variables feeding into it were, so made use of the log function for each variable in turn; where it returned an error due to being a table value that I was trying to put into the log

Best would be to use the debugger to see whats what, as you can open the tables.
But if you really wanna dump the table into the log you have to use LOG(repr(table))


Thanks, in particular for the debug window - I expect using that would've drastically cut my debugging time! I'll update for your comments in the latest version.

Unfortunately I can't get the debug window to work for me (I just get an error message) and some other people have had the same problem. Asking in the AI discord Jip thought that you need to do an install from the cd version of the game not steam but that you may know the exact procedure?

Error message below in case it helps:


unpack this
into \THQ\Gas Powered Games\Supreme Commander - Forged Alliance\coderes\Engine


Don't think I've got that folder with the steam install, I've got the following:
C:\Program Files (x86)\Steam\steamapps\common\Supreme Commander Forged Alliance
(this doesn't have a coderecs folder, and adding one in doesnt resolve the issue)

I've also got the FAF location:
same issue as with the steamapps folder

(just in case I also tried the \Documents\My Games\Gas Powered Games\Supreme Commander Forged Alliance folder but no luck).

Is there anywhere else I may have missed for a steam version?

Although I'd hoped I'd got the CDs for both as well, checking I've only got the CD for the original supcom so cant try a fresh install via disc.


It belong to the game instalation folders, and fast few ppl having this issue resolved it by creating those folders



I am not finished reading your guide, but excellent work so far!


v4 changes (in reality v2, but when I uploaded the mod on its first release I had to rush out a couple of hotfixes where I'd forgotten to remove debug logic and accidently introduced a bug that affected all games!)

  • Fixed various bugs (see 3.14.3)
  • Slightly improved pathfinding performance (see 3.15)
  • New AI logic which will detect enemy threats and send units to deal with them (see 3.16)
  • New AI logic which attempts to maintain intel over the map to stop surprise attacks (see 3.17)

I've also updated the guide to reflect speed2's comments (as well as a couple of other minor points/sections, such as a bit on uploading a mod and some tests that I now run before uploading)


I am stunned.

Really good work, maudlin27!


v5 changes - these were mostly about the ACU, making it more aggressive and less suicidal

  • Fixed various bugs and improved some error handling (see 3.18.4)
    ACU improvements (see 3.19):
  • ACU will try to expand to high reclaim or mex locations, while building on mexes it comes across and reclaiming
  • ACU will have scout and MAA support
  • ACU tries to kite enemies it comes across
  • ACU uses manual overcharge to overcharge optimal targets

Also updated the guide slightly to add details of the AI development discord channel in FAF (separate to the main AI development discord), and a couple of common hard crash errors


v6 Hotfix - My AI broke with the recent FAF patch, so this is primarily to fix that. I was in the middle of more extensive changes so my AI is less stable than I'd like but I figured it's better than a broken one! I've also held off on updating the dev log for this release.

Main changes made:

  • ACU performs better underwater (reclaims units, tries to move to nearby land when it cant shoot)
  • Improvements to ACU overcharge behaviour (it should OC when retreating, and also positions better against enemy PD)
  • Switch to new error handling approach (orange messages now appear in the log with more detail; this also happens when any ACU dies)

Issues currently present I'm aware of (which shouldnt have a noticeably detrimental impact on performance, but will be noticeable to anyone looking at the log):

  • 'MergeLocations' error message on certain maps - should just mean larger platoons dont regroup at a midpoint before attacking
  • 'MexRaider' warning about the final waypoint - in most cases just affects which mexes are targetted (in rare cases might cause a delay in the platoon doing anything)
  • 'Stuttering'/delays in performance on certain maps (e.g. open palms)