Jade Cocoon 2

Bring-up, not playable yet. On the full native path (no paraLLEl-GS, no IOP interpreter) the game boots through the intro movies, the title screen and the main menu, and New game plays the opening movie and the first in-game scenes with their dialogue, then free control from the Jade Throne Room out to the Wormhole Forest. Windows comes first, then Linux.

Native port (no PS2 hardware emulation left, not even a small part: the shared goal of the fork's ports). Native means the game's draws built straight from its own data (vertices, matrices, materials), with no GIF packet, no GS state machine and no copy of GS memory in between.

✅ works · 🔧 in progress · ⏳ not reached yet

docs/RECOMP_NOTES.md records how the port is brought up, every fix and how it was found, and what remains open.

The first in-game scenes on the full native path (native GS renderer, native IOP modules, recompiled overlays), up to the Wormhole Forest:

A fully playable Jade Cocoon 2 as a native executable on Windows and Linux, from the intro to the end of the story. Accuracy first; once it is playable, widescreen and higher internal resolution.

disc files (game/) ──► Ghidra (headless, EE extension) + ExportPS2Functions ──► tools/filter_ghidra_map.py
                   ──► recomp/ghidra/jc2_functions.csv ──► ps2_analyzer (SCE SDK signatures) ──► recomp/jc2_slus20309.toml
                                           │
                     ps2_recomp ──► C++ (one file per function, generated/) · ps2_vu_aot ──► VU1 microcode (generated/vu1/)
   CDDATA.000 overlays ──► tools/find_overlays.py ──► ps2_recomp in module mode ──► generated/overlays/ (1368 modules)
   the game's IRX (dumped by a first run) ──► the fork's tools/iop_recomp.py ──► generated/iop/ (13 modules)
                                           │
                 CMakeLists.txt ──► PS2Recomp runtime + generated code + runtime/jc2_overrides.cpp
                                           │
   PS2Recomp runtime: EE kernel HLE · DMAC · GIF · native GS renderer (OpenGL) · VIF/VU0/VU1 · IPU ─┼─► ps2EntryRunner
   PS2Recomp IOP:     the game's own IRX as native code · SPU2 and IOP on the PC clock · SIO2

• The retail executable is stripped, and its code and data share a single segment. Ghidra with the Emotion Engine extension maps the functions; tools/filter_ghidra_map.py drops the entries Ghidra put on data, and ps2_analyzer names the Sony SDK functions that have runtime handlers from the fork's signature database (244 at first pass).
• PS2Recomp turns every function into C++ (72,000 functions) and emits the address-indexed function table.
• The top-level CMakeLists.txt builds the fork's runtime, swaps its placeholder function table for the generated one and links everything into ps2EntryRunner.
• runtime/jc2_overrides.cpp holds the game-specific bindings.

The PS2Recomp fork lives in PS2Recomp/ (git submodule, boubou666/PS2Recomp), shared with the Twisted Metal: Black, The Third Age, Valkyrie Profile 2 and Drakengard recompilations.

• Windows 10/11 with MSYS2 (UCRT64, see below) or Linux
• CMake 3.21+, Ninja, GCC 13+ or Clang with C++20
• FFmpeg development libraries (libavcodec, libavformat, libavutil, libswresample, libswscale) and pkg-config
• bsdtar (libarchive) to extract the disc, Python 3
• To regenerate the function map: Ghidra 12 with the Emotion Engine extension and a JDK 21
• A CPU with AVX2 (the runtime is built for x86-64-v3)
• Your own copy of SLUS-20309 (check the hash above)

git clone --recurse-submodules https://github.com/TheBozos/JC2_Recomp.git
cd JC2_Recomp
scripts/extract_iso.sh "/path/to/Jade Cocoon 2 (USA).iso"   # disc files -> game/
scripts/build_tools.sh                                       # ps2_recomp, ps2_analyzer, ps2_vu_aot -> build/tools
GHIDRA_INSTALL_DIR=/path/to/ghidra scripts/ghidra.sh         # only to regenerate recomp/ghidra/jc2_functions.csv
scripts/recomp.sh                                            # ELF + recomp/jc2_slus20309.toml -> generated/
scripts/overlays.sh                                          # code overlays in CDDATA.000 -> generated/overlays/
scripts/build_runtime.sh                                     # runtime + generated code -> build/game
PS2X_IOP_NATIVE=0 PS2X_IOP_DUMP_MODULES=build/iop_modules scripts/run.sh   # once: saves the game's IOP modules
scripts/iop_recomp.sh && scripts/build_runtime.sh            # IOP modules -> generated/iop/, rebuild
scripts/run.sh                                               # ps2EntryRunner game/SLUS_203.09

The same scripts run in an MSYS2 UCRT64 shell, with MSYS2's GCC (MSVC is not supported for this port).

pacman -S --needed mingw-w64-ucrt-x86_64-{gcc,cmake,ninja,pkgconf,ffmpeg,libarchive,python} git

scripts/stage_dlls.sh copies the DLLs the runner needs next to ps2EntryRunner.exe, so it can also be started outside the MSYS2 shell. A full runner build takes about 16 minutes on 16 threads.

scripts/analyze.sh regenerates the TOML from scratch; it discards manual edits, so diff before committing.

Several PS2Recomp ports are developed on the same machine. A timed game run or benchmark takes the shared bench lock (the fork's PS2Recomp/tools/bench_lock.sh, file D:/ps2recomp_bench.lock) first, so that another port's build or game does not skew it:

scripts/bench_run.sh 5 "boot timing" scripts/run.sh   # waits for the lock, takes it, runs, releases it on any exit

Heavy builds take no lock, but do not start while someone holds it.

Everything derived from the game (game/, generated/, build/, disc images, captures) is git-ignored. Never commit or redistribute it.

• PS2Recomp by ran-j and contributors (GPL), the recompiler and runtime this port is built on.
• The Twisted Metal: Black, The Third Age, Valkyrie Profile 2: Silmeria and Drakengard recompilations, developed on the same PS2Recomp fork; runtime fixes are shared.
• Jade Cocoon 2 © Genki, published by Ubisoft in North America. This is an unofficial fan project, not affiliated with or endorsed by them.