An experimental set of TAS creation tools for SuperTuxKart. This was made as part of a class project with a limited timeframe, and as such has some limitations.
This is designed very specifically for the v1.3 official Windows release of the game. This will not work for any other version.
(Keep the Injector.exe and Payload.dll in the same directory as parser.py.)
-
Download the zip from the releases page and unzip it.
-
Open up the game.
-
Execute TAS scripts from command line:
3.1) Get python (at least version 3.8) and make sure it's in your PATH.
3.2) Open up a e.g. powershell window in the same directory as parser.py by shift+right clicking in that folder.
3.3) Run TAS scripts from the command line like so:
parser.py -p "scripts\sample_script.peng".
Check out the TAS syntax doc, see the README in the download for any clarifications on stuff that might not work.
You can unload the dll from the game by running unload.py.
This project uses visual studio 2022 and python v3.8. Open up the project and set the default startup project as 'Injector'. The injector will inject payload.dll into the game. If you would like to debug anything that happens in the payload then launch the game, run the injector (not necessarily from vs), and attach vs to supertuxkart.exe. This allows you to set breakpoints and stuff like that.
The parser communicates with the payload via IPC, here are the docs for the specifics of the message format.
If you run the injector, then you'll have to unload it from the game before rebuilding the project. This can be done with unload.py.
This project was heavily inspired by the TAS tools made for Portal 1. It also uses MinHook and a very similar TAS scripting syntax.