recvx-decomp

<img src="https://i.imgur.com/FreVpxO.png"/>

About

[!IMPORTANT] AI policy: LLMs produced negligible decompilation results in 2024 and also a good deal of 2025. Since we're trying our best not to mess up a 2-year-old project, we ask that any AI-generated submission is disclosed to us and handled responsibly.

recvx-decomp is a reverse-engineering project for Resident Evil: Code Veronica X which has the goal of reconstructing the source code of the game by decompiling the MIPS in the PS2 ELF back to C. The project currently only works with the US release (SLUS-20184), with plans to add support for more regions in the future.

Currently, the engine and gameplay systems are decompiled, as well as the GFX code and the CRI ADXT (Jan 26th, 2001) lib employed by the game. Enemy AI is still incomplete (EDIT: done now, the game is decompiled). Testing is done by repackaging the retail disc with our own compiled ELF using a script, and trying out the results on PCSX2.

Groundwork has been made for decompiling the Dreamcast and GameCube releases of Code Veronica; see the Resources section on this page for some links. Once the project is completed, there will be many potential uses of the code, including and beyond porting.

Building

[!IMPORTANT] You will have to provide your own files for the PS2 API, the project only works with the 2.0.0 and 3.0.3 versions of the SDK. compile_config.json outlines the paths where the build system expects the SCE stuff.

First clone the repository:

git clone --recursive https://github.com/AshfordFamily/recvx-decomp.git

Next, place your copy of the SLUS_201.84 file from inside the game disc into the config folder.

For this part of the setup, you can use a dev container (or not):

Dev Container route

If you're using an IDE that supports dev containers such as Visual Studio Code, you can simply open up the repo as a container (you'll need to have Docker or Podman installed on your machine to use this feature).

Manual route

Install splat with the following command:

pip install -r config/requirements.txt

---

Follow these instructions after performing the step of one of the two routes above:

Use this command to setup objdiff:

python compile.py --setup

Once done, you should see a newly-generated objdiff.json project file and a config/asm folder.

From now on, to build this project you just need to run the compile script each time:

python compile.py

Note: if you're using Linux, wibo is needed in order to run mwccps2.exe. A small prompt with install steps for it will appear if the script can't find wibo in your path.

You can repackage CVX's disc image with the compiled ELF to see the decompiled code in action. You need to put your ISO dump of the game's DVD on the iso folder, and extract its contents there:

python mkiso.py -m extract --iso iso/RE_CVX.iso

Then repackage the ISO:

python mkiso.py -m insert

If the process is successful, there should be a new file called RECVX_NEW.iso that you'll be able to use to test the project with a PS2 emulator or a modded console.

Resources

Related decomp projects:

• Resident Evil - Code: Veronica X (Nintendo GameCube)
• Resident Evil - Code: Veronica (Dreamcast)
• Dino Stalker
• Fahrenheit
• Fatal Frame
• Legacy of Kain: Soul Reaver

Also be sure to check out these neat patches for PCSX2. AshfordFamily's org avatar fan art was designed by fishiiarts_.

Disclaimer

recvx-decomp is licensed under MIT License, which allows for commercial use of the project's code. However, for commercializing ports of the game to modern platforms we still very much recommend contacting Capcom first for a proper publishing deal.