This is a native script compiler/decompiler for the so called GTA3script language, used to design the mission scripts of the 3D Universe of the series.
Due to its design, it can also be used as a framework for working with SCM data. See the README.md in the src directory for a technical overview. There's also a experimental Dynamic Recompiler in the dynarec-x86 branch.
Windows (MSVC) and Linux (GCC/Clang) are currently supported, but you need the latest compiler toolchain of your platform due to the use of C++17.
Just follow the standard CMake procedure for generating projects or makefiles.
mkdir build
cd build
cmake ..
Then make or use the generated project files.
The compiler/decompiler is invoked by the file extension of the input file, or from the action compile or decompile.
Compilation example:
gta3sc main.sc --config=gta3
gta3sc compile main.sc --config=gta3 # does the same thing as above
Decompilation example:
gta3sc main.scm --config=gta3
gta3sc decompile main.scm --config=gta3 # does the same thing as above
The decompiler is still very early and produces very low-levelish code, so low that it cannot be recompiled back. High-level decompilation is supposed to be implemented later.
Help:
To get further instructions, try getting help from the utility.
gta3sc --help
Ensuring a compiler is working correctly is a must. To help us on this task we use llvm-lit. While on the root of this tree, use the following command to run all the tests.
lit test --verbose
For further details, please refer to the README.md on the test directory.