Twisted Metal: Black Decompilation

About

A work-in-progress matching decompilation of the 2001 PlayStation 2 game Twisted Metal: Black. The README says it can be used to make certain changes, but the codebase is constantly evolving and could change drastically at any time. A digital copy of the NTSC version (SCUS-97101) is needed to build it.

Getting started

Use a Debian/Ubuntu-based Linux distribution, or WSL with Ubuntu on Windows. Install the system packages and run the Python setup script.

Known issues & limitations

• The project is a work in progress, and its codebase could change drastically at any time.
• The maintainer asks users not to port the code to other platforms until the project nears completion.

What you need to run it

Features

• The project can currently be used to make certain changes for modding.

Additional notes

Maintainer request

The maintainer asks that others do not port the code to other platforms until the project nears completion, and suggests a unified non-profit open-source engine replacement effort afterwards.

Sources

The project says it does not and will never reference or incorporate leaked Sony implementation source code.

FAQ

What is Twisted Metal: Black Decompilation?

Twisted Metal: Black Decompilation is an open-source decompilation of Twisted Metal: Black. Source code reconstructed from the original game's compiled binary, so the game can be understood, rebuilt and ported. The original game ran on PlayStation 2.

Do I need the original game files to run Twisted Metal: Black Decompilation?

Yes. The project does not include the original game's assets, so you need your own copy.