allstars-ps3

Native PC port of PlayStation All-Stars Battle Royale (BCUS98472) via ps3recomp static recompilation. PPU is lifted to C and linked against the ps3recomp runtime (D3D12 backend on Windows). No emulator required.

Legal: you must own the BCUS98472 disc and dump it plus its .dkey yourself. This repo contains no Sony code, keys, firmware, game binaries, or assets — only the port project, scripts, and runtime patches.

Status

• Decrypted EBOOT.BIN -> EBOOT.BIN.elf (13.2 MB, PPC64) with own .dkey
• Analysis: 25 modules / 376 imports, 24,530 PPU functions, 3 SPU images
• Lift: 25,544 PPU functions (with --hle-stubs) + 1098 HLE handlers, 2095 SPU functions across 3 images
• Builds: MyGameRecomp.exe (~170 MB) with clang-cl 23 + MSVC
• Boots: CRT -> SPURS "Main"+"SCREAM" -> cellGame BootCheck (BCUS98472) -> FIOS 1.3.5 -> D3D12 init -> stalls on fios worker cond (invalid lwcond)
• Zero unresolved NID at boot (8 fixed: 7x cellSpursJq + _sys_spu_printf)

See docs/STATUS.md for the detailed boot log and blockers.

Layout

allstars-ps3/
  CMakeLists.txt   # port build (based on ps3recomp templates/project)
  main.cpp         # runner + PARAM.SFO title-id init fix
  stubs.cpp        # game-specific overrides (currently empty)
  config.toml      # recompiler/module settings reference
  tools/
    decrypt_iso.py # Redump ISO -> decrypted ISO with own .dkey (AES-CBC, IV=LBA)
  patches/
    ps3recomp-runtime-allstars.patch  # 8 missing HLE handlers (JQ attrs, spu printf)
  docs/
    STATUS.md      # current boot status + next steps

Build

Prerequisites: Python 3.10+, CMake 3.20+, Ninja, VS 2022, LLVM (clang-cl).

:: 1. ps3recomp checkout + our runtime patch
git clone https://github.com/sp00nznet/ps3recomp.git
cd ps3recomp
git checkout 39e4f49286447b3ae3dcc2358700c840860ee677
git apply ..\allstars-ps3\patches\ps3recomp-runtime-allstars.patch

:: 2. lift (needs decrypted EBOOT.BIN.elf from your own dump)
set PYTHONUTF8=1
python tools\ppu_loader.py EBOOT.BIN.elf -o loader_out
python tools\ppu_lifter.py EBOOT.BIN.elf ^
  --functions loader_out\EBOOT.BIN.functions.json ^
  --hle-stubs loader_out\EBOOT.BIN.imports.json ^
  -o ..\allstars-ps3-work\recompiled
python tools\gen_hle_nids.py --all ^
  --out ..\allstars-ps3-work\recompiled\ppu_hle_nids.cpp

:: 3. configure + build (VS prompt for headers, LLVM for compiler)
call "C:\Program Files\Microsoft Visual Studio\18\Community\VC\Auxiliary\Build\vcvars64.bat"
set PATH=C:\Program Files\LLVM\bin;C:\Program Files\CMake\bin;%PATH%
cmake -B build -G Ninja -DCMAKE_C_COMPILER=clang-cl ^
  -DCMAKE_CXX_COMPILER=clang-cl ^
  -DPS3RECOMP_DIR=<ps3recomp> -DRECOMP_DIR=<recompiled> <allstars-ps3>
cmake --build build

Run (needs decrypted game files for VFS):

set PS3_VFS_ROOT=C:\path\to\vfs
build\MyGameRecomp.exe C:\path\to\EBOOT.BIN.elf

tools/decrypt_iso.py decrypts a Redump ISO with the .dkey sitting next to it (same basename). It parses the region table (even regions plain, odd encrypted) and AES-CBC decrypts per sector with IV = 12 zero bytes + BE LBA.

Upstreaming

patches/ps3recomp-runtime-allstars.patch should go upstream to sp00nznet/ps3recomp: the 7 cellSpursJobQueueAttribute* setters and _sys_spu_printf_initialize are generic, not title-specific. The main.cpp PARAM.SFO init is already upstream behavior in newer templates.