PS2 recomp: PS2Recomp and the games built with it
By AnyPS5 Progress Tracker · Updated
PS2Recomp is an experimental tool that statically recompiles PS2 game executables into C++; it is not a player-ready emulator, and its README warns that "Hardware emulation is partial and many paths are stubbed."
At a glance
| Project | Status (README) | Latest release | Last commit | License |
|---|---|---|---|---|
| PS2RecompPS2 recompilation toolkit · PS2 · Toolchain | Tool for building ports | v0.4 (pre-release) · Apr 5, 2026 | Oct 23, 2026 | GPL-3.0 |
| PS2 Web RecompGran Turismo 4, God of War II (in the browser, built locally) · PS2 · Static recompilation | README: work in progress | No releases | Nov 12, 2026 | MIT |
| God of War PS2 Static RecompilationGod of War · PS2 · Static recompilation | README: work in progress | No releases | Nov 6, 2026 | GPL-3.0 |
| BT3-RecompDragon Ball Z: Budokai Tenkaichi 3 · PS2 · Static recompilation | README: playable | No releases | Oct 1, 2026 | GPL-3.0 |
Source: GitHub API for each repository, read Nov 21, 2026
What is PS2Recomp?
PS2Recomp is a developer tool. Its README says it "statically recompiles PS2 ELF binaries into C++ and provides a runtime to execute the generated code." It is inspired by N64Recomp, the tool behind Zelda 64: Recompiled.
You do not load games into it the way you do with PCSX2. Each game needs its own project: function maps, stubs, patches and per-game runtime work. The playable results are those per-game projects.
How far do PS2 recomp ports run?
Status as stated in each official README:
- PS2Recomp (tool): "Performance is very bad for VU and GS" and "Hardware emulation is partial and many paths are stubbed."
- god-of-war-recomp (God of War, PS2): boot, menus, new game and the ship fight with HUD work; "Full playthrough" is listed as pending.
- BT3-Recomp (Dragon Ball Z: Budokai Tenkaichi 3): "Playable: boots through logos and title, menus work, and fights render in the GPU path at close to the engine's 30 fps cap." FMVs are skipped.
- ps2-web-recomp (browser): Gran Turismo 4 and God of War II; "two games have been brought up so far."
ps2-web-recomp: recompiled CPU, emulated hardware
ps2-web-recomp is a separate project with its own recompiler. It translates the Emotion Engine code to C++ and WebAssembly, "so the main CPU is never interpreted; the rest of the console, its operating system and hardware, is emulated by a runtime that draws with WebGPU."
Its README states that the I/O processor runs the game's own modules "on an interpreter of its R3000 CPU", and the Graphics Synthesizer is modelled with WebGPU compute shaders. It is a hybrid: static recompilation for the main CPU, emulation for the rest.
Recomp vs decomp: OpenGOAL as a comparison
Recompilation translates machine code automatically. Decompilation rebuilds readable source code. OpenGOAL takes the decomp route for the Jak trilogy: it decompiles the original GOAL code and recompiles it for x86-64 with its own compiler.
Its README says "Jak 1 has been considered in a polished, complete state for years", Jak 2 "is considered in beta", and "Jak 3 has a good amount of work left to do." Decomp ports take longer but produce editable source. Recomp ports start faster but still need hardware work in the runtime.
How to try a PS2 recomp port (overview)
Pick a per-game project, not the tool. Download its official release if it has one, or build it from its repository. You need your own legally obtained copy of the game; the exact requirements are in the official README. Most of these projects support only one region of the game.
When a port stops, the README usually explains the log. ps2-web-recomp, for example, says an unsupported game will most likely stop at "[sys] unhandled syscall" or "[iop] missing <library> #<n>".
Requirements (from the official README)
| Build tools | CMake 3.20+ and a C++20 compiler (tested mainly with MSVC) |
|---|---|
| CPU | SSE4/AVX host support for some vector paths |
PS2 recomp vs PCSX2
PCSX2 is a general emulator for the PS2 library. A recomp port runs one game, one build, as a native program, and can add per-game fixes such as widescreen or higher frame rates. For most games PCSX2 is the practical choice today; recomp is early. Compare approaches in our emulator overview.
Is it legal?
The repositories contain no game code or data. ps2-web-recomp adds that the generated C++ and WebAssembly "belong to the game's owners: keep them on your own machine and do not publish them." Laws differ by country and rights holders can request takedowns. See our legal overview. This is not legal advice.
More native ports and recompiled games: the full PC ports list.
PS2Recomp FAQ
Can PS2Recomp play any PS2 game?
No. It is a tool that each game project must configure. Its README says hardware emulation is partial and many paths are stubbed.
Which PS2 games have recomp ports?
Projects include God of War (KIexster/god-of-war-recomp) and Dragon Ball Z: Budokai Tenkaichi 3 (z3xox/BT3-Recomp), both built on PS2Recomp, plus Gran Turismo 4 and God of War II in the separate ps2-web-recomp browser project.
Is ps2-web-recomp pure recompilation?
No. Only the main Emotion Engine CPU is recompiled. Its README says the rest of the console is emulated by a runtime, and the I/O processor runs on an interpreter.
What is the difference between PS2 recomp and OpenGOAL?
PS2 recomp translates machine code automatically. OpenGOAL decompiles the Jak games' code into readable GOAL source and recompiles it with its own compiler.
Do PS2 recomp projects include the game?
No. You need your own legally obtained copy of the game; the exact requirements are in the official README.