fa icon indicating copy to clipboard operation
fa copied to clipboard

Extend command line single player launch capabilities

Open Garanas opened this issue 5 months ago • 10 comments

Description of the proposed changes

Fixes various things:

  • Documents and annotate the majority of the launching a skirmish via the command line interface.
  • Assign the default value of all lobby options by default.
  • Add support for /gameoptions argument to define lobby options.
  • Add support for (a new) /gamebots argument to define AI army configurations.
  • Add support for (a new) /gamemods argument to define what (sim) mods to load.
  • Add support for (a new) /runWithTheWind argument to run the simulation as fast as possible.
  • Fix an issue with the scoreboard for missing the FullShare option.

And introduces a new powershell script as inspired by the script made by @lL1l1. It serves as an example on how to launch a bot session.

Testing done on the proposed changes

It enables a setup such as this:

https://github.com/user-attachments/assets/7ca47d64-c390-4bd7-ac1b-176c048325ad

The AI is running, but the AI itself is not functional yet. The procedure is described at:

  • https://github.com/Garanas/fa-average-joe-ai?tab=readme-ov-file#launch-the-game

Where you can launch the game from Visual Studio Code using command line arguments.

Additional context

I am not aware of this functionality being used anywhere except for the AI tournament functionality of Softles. That setup overrides this file however. The existing launch script uses the autolobby functionality. Therefore I'm not that afraid of backwards compatibility issues.

Checklist

Some of these changes are inspired by the work of @HardlySoftly , see also attached his scripts for the automated AI tournaments.

FAF-AI-Autorun-main.zip

Garanas avatar Jul 17 '25 14:07 Garanas