Extend command line single player launch capabilities
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
/gameoptionsargument to define lobby options. - Add support for (a new)
/gamebotsargument to define AI army configurations. - Add support for (a new)
/gamemodsargument to define what (sim) mods to load. - Add support for (a new)
/runWithTheWindargument to run the simulation as fast as possible. - Fix an issue with the scoreboard for missing the
FullShareoption.
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
- [x] Changes are annotated, including comments where useful
- [x] Changes are documented in a changelog snippet according to the guidelines.
- [ ] Request 2-3 reviewers from the list of reviewers and their areas of knowledge.
Some of these changes are inspired by the work of @HardlySoftly , see also attached his scripts for the automated AI tournaments.