AI Development Guide and M27AI v74 Devlog

@splitice
1 - Re % of an AI's time taken on different areas, It will vary depending on the AI and the approach taken, although at a high level I'd expect pathfinding to take up a lot of time at the start of game, and build conditions to take up minimal time throughout the game.

For example with pathfinding, for a while my AI would calculate if it could path somewhere as and when it needed to (and then record the result so it could refer to later), but more recently it will do the calculations up-front, which is consistent with the approach of the other AI I'm aware. Times taken can vary dramatically - e.g. when Balthazar was testing their pathfinding logic, I think the slowest time they came across was on Alaska (which I'm guessing was an 81km map) where it took more than 5m. Softles mentioned their pathfinding after optimisation is down to 0.4s on smallest maps. Map size has a big impact though, since an 81x81km map is 262 times the size of a 5km map, so if you do things to the same level of accuracy the time taken will skyrocket.

Therefore pathfinding is largely a 1-off cost at the start of the game (where it's more acceptable to have a slight delay before the game actually starts), although there'll still be some overhead later on (e.g. if trying to calculate a safe path to use - I dont use this logic at the moment so can't comment on how much time it takes).

The most useful function for working out the CPU performance impact is GetSystemTimeSecondsOnlyForProfileUse()
If you compare the result before and after a 'heavy duty' function you can get an indication of how long that function takes (although the figure isn't that reliable).

In the latest version I'm working on I'll be including lots of comments and profiler outputs from some profiling I did of my own AI in an effort to improve its CPU performance, and the code for this as well as code Softles recently helpfully shared on the AI discord for profiling will be included as part of the AI.

As a very rough guide though, anything that is running >10k times in a single tick needs to be streamlined to avoid a performance impact. Simple checks like if a variable is true or false take up no noticeable time (you'd need to be checking millions of times in a tick I'd have thought to impact things), while more involved checks such as getting all units of a particular category within a certain distance of a point on the map will take far longer.

Examples of things that can end up overloading a tick could be carrying out logic on every part of the map (e.g. calculating reclaim), or recursive logic (e.g. in v14 and earlier I'd recursively look for units around an existing unit, and then units around those, and so on, in order to group them into an 'army' to be dealt with).

To give a rough idea of the relative weightings for M27 (other AI will be different) for different aspects of the AI, the following benchmarks are for the total time taken in the first 10m of a 3v3 M27AI game on a 10km map (WIP v15):

  • Determining pathing at the start of the game c.4.5s
  • telling platoons what to do 8.5s
  • threat detection logic (identify enemy threats, selecting units to deal with the threat) 3.7s
  • checking reclaim on the map 3.3s
  • managing air units 2.6s
  • managing engineers (build conditions and orders including reclaim) 1.7s
  • Deciding what to build for factories 0.1s.
    As part of this, I have a function called 200k times that took 0.000s in total, and another function called 165 times that took 0.36s.

The times are a relative guide, not absolute, as the GetSystemTimeSecondsOnlyForProfileUse() isn't that accurate, and depending on how its used it won't factor in time taken by the wider game engine as a consequence of the AI's code.

2 - Not in the immediate future, but probably once I've achieved some other goals. I think Softles may be planning an AI tournament with norush at some point so that might prompt me to have a look at it!

v15 Update:
Focus of this release was (CPU) optimisation, so the major changes are 'behind the scenes'. It also means in some areas (primarily threat detection) my ACU unfortunately is a bit more stupid than before, as I didn't feel I could justify the increased CPU load caused by a more accurate method.

  • Implemented new profilers (both my own, and one Softles kindly provided) to help identify high usage functions
  • Rewrote most of the reclaim logic to improve performance (significant reduction in game stuttering, although still worse than I'd like)
  • Optimisation of a number of other functions to significantly reduce time taken
  • Improved SMD logic (including fixing a bug that meant SMD was never built) - AI is now much more likely to have a loaded SMD ready before a nuke hits.
  • Tweaks to how much power and energy storage is built to reduce tendency to over-build power and to ensure the ACU can deal 15k damage with overcharge late-game
  • Various bugfixes (notable ones being a bug with ACU escorts that would result in lots of errors appearing in the log, and an issue that caused escorts/assisting platoons to sometimes go to the wrong location)

@maudlin27 said in AI Development Guide and M27AI v15 Devlog:

Rewrote most of the reclaim logic to improve performance (significant reduction in game stuttering, although still worse than I'd like)

I'm not sure if it will help but I recently re-wrote AutoReclaim (dwm) as "AutoReclaim (splitice)" for more performant reclaims (for T!-3 engineering type towers).

--

I also tried a 2v2 (far slots) on Burial Mounds and noted many issues (including a general lack of awareness of the no unit paths and lack of serious economic growth). This was on v14. I think I'll re-asses though when this gets more mature.

I also gave v15 a try but failed on start with:


info: playable area coordinates are { 0, 0, 1024, 1024 }
info: Offmapareas are {
info:   { x0=-100, x1=1124, y0=-100, y1=0 },
info:   { x0=-100, x1=1124, y0=1024, y1=1124 },
info:   { x0=-100, x1=0, y0=0, y1=1024 },
info:   { x0=1024, x1=1124, y0=0, y1=1024 }
info: }
warning: false\000M27ERROR GameTime 1: Exceeded max loop count; iCurIntelLine=6
warning: stack traceback:
warning:         [C]: in function `assert'
warning:         [C]: in function `pcall'
warning:         ...nder forged alliance\mods\m27ai\lua\m27utilities.lua(45): in function `ErrorHandler'
warning:         ...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua(387): in function `RecordIntelPaths'
warning:         ...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua(4108): in function <...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua:4042>
warning: false\000M27ERROR GameTime 1: Exceeded max loop count; iCurIntelLine=7
warning: stack traceback:
warning:         [C]: in function `assert'
warning:         [C]: in function `pcall'
warning:         ...nder forged alliance\mods\m27ai\lua\m27utilities.lua(45): in function `ErrorHandler'
warning:         ...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua(387): in function `RecordIntelPaths'
warning:         ...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua(4108): in function <...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua:4042>
warning: false\000M27ERROR GameTime 1: Exceeded max loop count; iCurIntelLine=8
warning: stack traceback:
warning:         [C]: in function `assert'
warning:         [C]: in function `pcall'
warning:         ...nder forged alliance\mods\m27ai\lua\m27utilities.lua(45): in function `ErrorHandler'
warning:         ...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua(387): in function `RecordIntelPaths'
warning:         ...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua(4108): in function <...er forged alliance\mods\m27ai\lua\ai\m27overseer.lua:4042>
warning: false\000M27ERROR GameTime 1: Exceeded max loop count; iCurIntelLine=9

Map: Liberiam Battles

@splitice said in AI Development Guide and M27AI v15 Devlog:

Liberiam Battles

What were the game settings, in particular what player slots were in use by what teams and/or do you have a replay ID? I tried it just now in slots 1+2 and didnt get an error but from the log extracts and look of the map it might depend on what the player and team setup is.

@maudlin27 said in AI Development Guide and M27AI v15 Devlog:

What were the game settings, in particular what player slots were in use by what teams and/or do you have a replay ID? I tried it just now in slots 1+2 and didnt get an error but from the log extracts and look of the map it might depend on what the player and team setup is.

From memory was a mix of Sorian and your 2x m27 aix v 2x sorian aix v 2x sorian aix v1(player)

Just added m27 on a whim so didnt record game settings. Replay is https://replay.faforever.com/16044970

@splitice Thanks, found and fixed the issue in the latest version (will upload in a moment). Re Burial Mounds, having a look at the map it's not one that my AI will fare very well on at the moment (confirmed by it losing vs Sorian Adaptive when I tested just now). The biggest issue being the heavily fortified civilian base which will stop some of the ACU rushes that M27 relies on to gain an early game advantage (and which probably is also why it's not ecoing quickly), as well as making its current reliance on land for victory late-game flawed since amphibious tanks dont fare well against significant PD fortifications.

v16 - Hotfix:

  • Rewrote my land scout pathing logic to fix a bug that caused a crash on Liberiam Battles (thanks @splitice for flagging)
  • Minor tweaks to overcharge logic to increase the units that will be considered
  • Low health enemy ACUs are more likely to be targeted for an all-in attack even if M27's ACU isn't nearby
  • Bugfix to air threat logic so that air units near the ACU are correctly prioritised; also tweaks to the logic for building air factories when outnumbered in air

@maudlin27 Re; Burial Mounds if I was to describe the problems with the strategy they would be (in no particular order) - sorry was late.

  1. Over reliance on light artilery. I (a human player) would see this and respond with a small air fleet and this unit is not particularly useful on a water map. The AIs pumping these out were largely limited to defensive operations.
  2. After the early rush fails (or if AI suspects it will fail) the AI really needs to switch to economy building first. A player who has a well optimized build queue can easily push many orders of magnitude ahead of this AI
  3. One of the AIs didnt build any mass extractors, just a single land factory and pumped out units. Given the extremely low cost and quick pay back time of a T1 mass extractor I struggle to see why they should b skipped (of course they could be delayed, but I stopped the game after ~15m and it was still just pumping out units). Perhaps if a early rush tactic is chosen a max game time before mass extractor build within at-least the players own area continues should be implemented?

I havent played against the AI as a human yet so this is theoretical.

@maudlin27 said in AI Development Guide and M27AI v15 Devlog:

To give a rough idea of the relative weightings for M27

Thank you for the time you spent gathering this.

That's quite a low % of total time, I assume this is pegged at 100% (i.e max sim speed until saturation)?

In retrospect I wonder what % of time goes to AI vs lua game logic vs engine. I'd always assumed the AI code (being there is multiple instances of it running and they typically can be quite intensive) would be a good (50+%) of the total sim time.

@splitice Thanks for the feedback!

  • Re 1 - Likely a flaw due to the civilian point defences - the AI treats civilian units as enemies, considers the total weighting of enemy units, thinks its up against an enemy who favours PD far above mobile units, and so builds lots of arti in response. No easy short term solution where the civilian base cant be pathed to (I'd probably need to come up with map specific logic which will be a long way away, or special rules for civilians which would similarly be very low down on my list as this is the largest civilian base I've come across on a map to date)
  • 2 - Unfortunately it's not straightforward to come up with an approach/set of rules that would handle this well, and the current approach assumes it should be able to gain map control if it spends more than the enemy on units.
    Longer term I'm planning on introducing turtle logic to the AI which I'd probably look to use on a map like this which would make it eco a bit better, but that's at least a few versions away.
  • 3 - Sounds like a bug - doing a quick test with 8 M27AI, within the first 5m all mexes on each side were either claimed or queued up to be claimed, so I'd need a replay to investigate further. When checking back on the 4v4 test I ran though I noticed some other bugs which led to a massive slowdown/broken AI after certain players died which I'll be looking into for another hotfix!

Re the low profiling, I think the low % of total time is due to the limitations of the method I'm using - while getting the difference in system time seconds gives a good guide of how long a function takes relative to other functions, I think there're other things that happen in the background as a result of the code which don't get picked up (e.g. Sprouto's mentioned there's a garbage collector that can require resources to deal with clearing redundant variables) - these could be linked to the AI, or the normal game engine/operations, and I'm not sure of a reliable way to quantify. However I'd also assume the AI will take a majority of the total sim time, especially where multiple AI are used.

V17 Hotfix (Hotfix to the previous hotfix)
My previous hotfix fixed an issue with the AI not working on some maps, but caused it to crash on some teamgame maps. This is now fixed so hopefully it works on almost all maps.
Other minor changes made:

  • Bombers will try and defend the base if enemies get near
  • ACU will overcharge when retreating
  • Air factories should be built in priority to land factories if there's a significant air unit shortfall
  • Various minor bugfixes (mostly aimed at reducing the error messages appearing in the log when an ACU dies)

Edit: v18 Hotfix - AI should now work when DilliDalli AI is also playing; also fixed issue for maps with >=10 players.

v19 Update:
The focus of this release was implementing a new 'air dominance' strategy intended to punish players who don't get AA, and to make better use of rally points.

  • New air dominance strategy - if the enemy fails to get AA quickly enough the AI will aim to focus all its resources on building bombers to overwhelm them. Related to this I've reworked some of the logic for choice of bomber targets
  • Better use of rally points - units will look to gather at a rally point between our base and the enemy, so they are less likely to cause pathfinding issues at base and can respond quicker to threats
  • Improved logic for ACU upgrades - fixed some bugs and added new checks so ACU should be less likely to upgrade when near the enemy base, while upgrading sooner if its able to, and attacking the enemy sooner once upgraded
  • Various other bugfixes and minor tweaks

The air dominance strategy is mostly a 'win more' strategy, but I've seen a few games my AI has played (both against humans and AI) where it has an initial bomber that does a lot of damage before being shot down, yet eventually the enemy is able to recover from the damage and wins the game. The hope with the air domination strategy is that such games turn into a quick win instead of just a moderate advantage. However it has its risks, since it's incredibly mass efficient to counter air units that are attacking your base, and if you kill them you then benefit from all their wrecks.

v20 Update:
This version improves some of the AI's late game ability, both fixing an issue that led to severe under-utilisation of T3 mobile artillery in some cases, and having it build experimental units.

  • Experimental units will now sometimes be built late game
  • Improved use of T3 mobile artillery (they're less likely to gather in huge numbers doing nothing...)
  • Better use of heavily upgraded ACUs (including bugfix that caused Cybran ACUs to do nothing after getting laser)
  • Tweaks to Engineer management
  • Other minor bugfixes

v21 Update
This version focused mostly on smaller eco gains so when my AI is trying to eco it should do it a bit better. Main changes are:

  • Power stall manager to pause construction etc. to avoid or minimise power stalls
  • New dedicated ACU protection strategy to provide quicker help to our ACU when its in trouble
  • Increased focus on marginal mass gains when ecoing (e.g. not getting as much power so more mass can be spent on mexes; Reducing the combat units built so it can be spent on mexes, etc.)
  • Various bugfixes, including one that stopped a fully upgraded Sera com from doing anything, and issues with ACU logic for cancelling its upgrade and running away

Since my ACU self-destruct logic hardly ever triggers (I've only had it work in sandbox when testing it), I also decided to expand the behaviour - now my engineers and mexes should also exhibit self-destructive behaviour.

@jip FYI re your query a few versions ago when I introduced it, my ACU should only self-destruct in the niche scenario where it is about to die anyway and the enemy ACU is within range of the explosion and low enough health to die to it. I didn't want to risk a more general 'I give up' type logic both for fear of hit going horribly wrong, and since even in games where my AI's base has been destroyed it's sometimes managed a win with its ACU.

v22-v23 Update
There was no particular theme to these changes, other than that most of them arose from watching mistakes my AI made on a 1v1 against another AI on Burial Mounds

  • Tanks can now suicide (sometimes)
  • Fixed bug with power stall manager that made it far less effective; minor tweaks to this to prioritise HQ updates and initial engineer production (to allow more efficient power)
  • Minor logic improvements to experimentals (stopping them from trying to kite, making monkeylord move instead of attack-moving)
  • Ignoring PD that cant be pathed by land (so MMLs etc. arent overbuilt trying to counter it - relevant in particular for Burial Mounds)
  • Various tweaks to air logic (more likely to refuel, target transports with AA, make use of stealth)
  • More accurate logic for whether reclaim is within range (thanks to Marlo and Jip who helped me figure out how to determine the size of a reclaim object)
  • Another rework of my land scout 'intel path' logic - it should now form a path along the shoreline on island maps
  • Bugfix that caused my threat response logic to view each unit individually instead of grouping threats together
  • Various other bugfixes and tweaks

Although there was no big area of focus with this release, I did manage to achieve one of my long term goals with it, beating gunner1069 (the human sparring partner who usually plays a match against each version of the AI; they're a 1.1k global from playing astro exclusively, with their preferred tactic being to turtle - originally they played M27AI on Theta Passage, until around v10 when M27AI would fare well against their turtling on conventional maps, at which point they switched to Astro Craters).

Winning against a turtle on Astro Craters is harder than a normal map, since the normal advice against a turtle is to avoid attacking them, out-eco them with your map control (since T1 mexes are far cheaper per mass generated than T2 mexes), and then attack with an overwhelming force. Obviously this doesn't work so well if gaining map control just means you have 21 mexes to their 19. There are still plenty of flaws with my AI that a good astro player could exploit to win, but it can now at least offer a challenge on the map against weaker players.

V23 hotfix - Thanks to relent0r for flagging - there was a bug in v22 which caused my T1 platoon formers to not work, which should be fixed now.

v24 Update
The main focus of this update was having the AI rush bombers more often and various other changes to the air logic:

  • T3 bombers will sometimes be rushed depending on the map and game state (e.g. on 'island' maps)
  • Improved targeting for bombers, in particular when targeting enemy structures and considering whether to attack a shielded target (particularly relevant for strategic bombers who previously would ignore any shielded target)
  • Various tweaks to build orders and whether to upgrade an air factory in preference to a land factory
  • Various bugfixes

Latest changes (v25 summary)
v25 - Misc
There was no particular theme to this update or any one big change, just lots of small tweaks and bugfixes (many of which I'd been putting off for a while due to not being major issues). Some of the more noticeable changes were:

  • Building sonar on island maps
  • Guncom ACU considers targeting high value locations instead of just going for the enemy base
  • More factories and engineers are likely to be built earlier on
  • Minor adjustments to bomber targeting logic

In terms of the number of changes, ignoring hotfixes my main releases have typically averaged around 8 bugfixes and 16 misc/minor changes in addition to 1-2 significant changes/features. This version has 22 bugfixes and 64 misc changes, and was primarily aimed at clearing a backlog of small issues I'd noted to look at 'soon' from versions going back to v14.

V26 - Nukes, shields and novax
This update was aimed at increasing variety in the late-game (I'm basically working through the late game units I want my AI to try and build one by one).

  • Nuke launchers will be built late-game if the enemy doesnt have SMD, and aborted if the enemy gets SMD in time
  • Shield generators will be built to protect high value structures (although the Cybran's mostly for show since it builds the T2 rather than T3 shield most of the time)
  • UEF will build and use a novax centre in some cases
  • Various misc changes and bug fixes (12 bug fixes, 24 misc changes), including things like having factories self-destruct, multiple mass storage queued at a time, and better logic at avoiding trying to queue multiple buildings in the same place.

M27 turns 27!

Main change in v27: T3 arti introduced
Other changes: 23 bugfixes, 38 misc changes.

I was expecting the T3 arti to be relatively straightforward since I already had logic for choosing a nuke target that I could adapt, but getting the power adjacency to work became a real headache and also led me to a separate bug where structures could be built ontop of each other (thanks to Jip for confirming it's an engine bug).

The other bugfixes and misc changes included various updates relating to replays people helpfully provided:

  • Improved AI's ability to fight ghetto gunships (thanks to Babel for the replays highlighting this weakness)
  • Reworked overcharge logic (I'd originally written it when M27 could only build T1 units so there were a few flaws with it when fighting T2+ units)
  • Introduced a unit cap for ASFs (thanks to Azraeel for the replay highlighting 2 M27 AIs building c.900 asfs! and Fearghal for confirming a similar issue on the Air Wars map)
  • Fixed a hard crash that sometimes could happen at the start of the game. Also removed an amusing bug/feature where the Ythotha deathball would be controlled by the AI making it far deadlier (thanks to Relent0r for highlighting both of these)

Edit: Also managed to introduced a painful new bug - the ACU will now suicide into enemy PD (due to the new overcharge logic) - this will be fixed in the next version.