The goal of this repository is to document and re-implement functions of the original game for modding purposes. The project is heavily influenced by the OpenJKDF2 project
This makes use of DLL injection through a simple loader located at ./loader/loader.cpp
The code for the DLL to inject is at ./swr_reimpl
As of the 25 October 2023, progress is at 30.54% (656 / 2148) of functions which have been analysed (not necessarily re-implemented).
- git
- Ghidra 10.2.2 (important for the ret-sync plugin)
- x32dbg
blocks are still TODO
MAT file: https://www.massassi.net/ See also for COG and MOTS
This repository is still in early developement. Usage is not yet possible other than for decompilation purposes.
If you want to contribute, you'll need python, a windows C compiler and Ghidra.
Symbols can be imported using scripts in the scripts/Ghidra
directory. You should "Parse C source" on the src/types.h
file
before using the scripts to import functions prototypes via headers. Global variables can be imported from the
data_symbols.syms file using another script
Update all submodules (for developpement purposes only):
git submodule update --init --recursive
Run compile.bat
script. The loader and the replacement dll should be generated in the ./build
directory. Copy these two files WITHOUT renaming them into the same directory as SWEP1RCR.EXE
. Run the loader.
TODO Install python, gcc, g++ with MSYS2, git bash
This is based on the repository located here, included as a submodule
The freshly installed GOG version of the game (SWEP1RCR.EXE
) has the following md5: e1fcf50c8de2dbef70e6ad8e09371322
Other versions are not yet tested
Wine will be used to run Visual C++ 5.0, the original compiler for the project. Through WSL, file transfer is much easier in both directions and Wine is much faster than a VM like Qemu or VirtualBox (and much simpler to setup as well)
Download the vcpp5 iso for initial compiler configuration here: https://winworldpc.com/product/visual-c/5x
See NOTES.md for more infos
Special thanks goes to
- George Lucas
- the LucasArt team that made all these years of fun possible,
- JayFoxRox for the original work on the decompilation back in 2018,
- LightningPirate and Galeforce from the SWEP1RCR discord community for their work on asset packing and decomp,
- Aphex from the SWEP1RCR discord for his work on asset export to modern file formats and decompilation symbols.
- Urgon from the Indiana Jones and the Infernal Machine decomp project, for his bindiff with swe1r
The original game (Star Wars Episode 1 Racer) is a property of the LucasArts Entertainment Company LLC.
The content provided on this repository is for informational and educational purposes only. It is not intended to infringe upon any copyrighted material.
If you believe that any content on this repository violates your copyright or intellectual property rights, please contact us immediately to seek resolution.
I am not liable for any loss or damage, including but not limited to indirect or consequential loss or damage, arising from the use of or reliance on any content found on this repository.