Project Raccoon
Project Raccoon is a native Windows PC recompilation of Ratchet & Clank: Into the Nexus that supports up to 4K resolution and unlocked FPS.
- Type: PC port
- Game: Ratchet & Clank: Into the Nexus
- Runs on Windows
- By vagenam
- Latest release v0.3.1, 2026-11-16
- Source: https://github.com/vagenam/nexus-recomp
README
Project Raccoon — Ratchet & Clank: Into the Nexus PC Recomp (v0.3.1)
Project Raccoon is a native Windows x86-64 static recompilation of Ratchet & Clank: Into the Nexus (PS3 USA Disc version, BCUS99245 v1.00) powered by the ps3recomp runtime.
Note: This project is created with Artificial Intelligence (AI). For a deep dive into the engineering, profiling, and gameplay fixes, see TECH_WRITEUP.md.
Current Project Status (v0.3.1)
- Testing Scope: The game has not been tested thoroughly yet — only the first level (Nebulox 7) has been tested, and it plays alright there. Later levels and full playthrough stability are unverified.
- Test Hardware: Tested on an Intel Xeon E5-2680 v4 (older server CPU, not optimal for single-thread/PPU-heavy emulation) and an AMD Radeon RX 9060 XT 16 GB. Systems with newer, faster desktop CPUs will likely get noticeably better performance.
- Shipping Defaults: Ships in stock PS3 720p (
1.00x, stock texture filtering & shadow resolution) with unlocked FPS, from my testing increasing resolution to 4k and maxing out shadow resolution had next to no negative impact on fps but it might be different for you - Graphics (RSX → Vulkan 1.3): Supports up to 4K (
3.00x,3840×2160) internal resolution scaling, anisotropic/trilinear filtering, and VRAM budget management. - Audio: Full FMV, menu, and in-game
cellAudiomixing. - Controls: Keyboard & Mouse + SDL2 Gamepads (PlayStation DualSense / DualShock 4 with native HIDAPI haptics/speaker/triggers/lightbar, Xbox / XInput).
Known Issues
- Untested Beyond Level 1: Only the first level (Nebulox 7) has been tested so far; later planets/levels and full playthrough stability are unverified.
- Graphical Glitches: Some rendering and shader glitches still remain in certain scenes.
- Performance Dips: Framerate is not locked 60 FPS everywhere yet and can dip in heavy scenes (especially on older server/multi-core CPUs such as Xeon E5-2680 v4).
- Audio Slowdown: Audio can experience slowdown during startup or heavy CPU/SPU load.
- Bolt & Crate Debris Caps (Workaround): Physical bolt spawns (
func_004E9F98, value-scaled) and crate-plank debris Mobys (func_00784E20,cls=0x55) are capped at 3 per burst during active gameplay to prevent SPUigAnimstalls. - 4K Resolution Cap: Internal resolution is capped at
3.00x(4K3840×2160);5K (4.00x)is disabled to avoid VulkanVK_ERROR_OUT_OF_DEVICE_MEMORYstalls.
Requirements
- Windows 10 / 11 (x86-64)
- CPU with AVX2 support (Intel Haswell / AMD Zen or newer)
- Vulkan 1.3 capable GPU
- No manual tool installs required in release zips: The prepackaged release zip includes
RecompBuilder.exewith a prebundled portable toolchain (tools\.portable\). When running from a clean git clone,RecompBuilderorbuild_pipeline.pywill automatically download and verify pinned toolchain dependencies (Python 3.12 embeddable, CMake, Ninja, Zig). - Your Own Game Dump (Zero Copyrighted Code/Assets Shipped):
- Extracted
PS3_GAMEfolder from Ratchet & Clank: Into the Nexus (USA) (BCUS99245v1.00) — must be the extractedPS3_GAMEfolder (containingUSRDIR\andPARAM.SFO), NOT a.pkg, NOT an.iso(extract.iso/.pkgfirst if needed). (Note: during setup, your decryptedEBOOT.elfis copied intoPS3_GAME\USRDIR\EBOOT.elfso the recomp runtime can locate it). - Decrypted
EBOOT.ELFfrom RPCS3: In RPCS3, go to Utilities → Decrypt PS3 Binaries, selectPS3_GAME\USRDIR\EBOOT.BIN, and save the decryptedEBOOT.ELF(SHA-256 is verified up front againstBCUS99245v1.00).
- Extracted
Quick Start (RecompBuilder.exe)
Note: This Quick Start guide is for users downloading the ready-to-use Releases zip (
Project-Raccoon-v0.3.1-win64.zip), which comes withRecompBuilder.exeand offline toolchain prebundled. If you are building from a Git clone, compiletools/RecompBuilder.cppor runbuild_pipeline.py/build.bat.
We do not ship a precompiled NexusRecomp.exe or any copyrighted game code/assets. RecompBuilder.exe is a native Windows GUI app that handles everything automatically:
- Double-click
RecompBuilder.exe(no console commands or manual tool installs). - Drop your extracted
PS3_GAMEfolder intoPut_Game_Folder_Here\(or click Browse... — must containUSRDIR\andPARAM.SFO, not.isoor.pkg). - Drop your RPCS3-decrypted
EBOOT.ELFintoPut_ELF_Here\(or click Browse...). - Click Build & Setup — it verifies your dump & ELF, lifts & compiles your executable into
RecompFolder\NexusRecomp.exe, and writesRecompFolder\settings.txt(stock 720p, unlocked FPS, FPS counter on). - Click Play (or launch
RecompFolder\NexusRecomp.exe/ the Desktop shortcut).
v0.3.1 Changelog
- Fixed Installer & Setup: Resolved issues where v0.3 release / setup failed on fresh clones or external paths (untracked stale CMake caches and hardcoded directories).
- ELF & Game Dump Verification: Added up-front SHA-256 verification of
EBOOT.ELFand title-ID validation ofPARAM.SFO(BCUS99245v1.00), preventing cryptic lifter crashes when an incompatible dump is provided. - Lift Stamp Invalidation: The pipeline and builder now track lift stamps (
out/lift_stamp.txt), correctly invalidating outdated or stale lifts instead of silently skipping them. - Pinned & Hash-Verified Toolchain: Pin exact versions of
cmake,ninja, andziglangwith SHA-256 hash checks viatools/toolchain-requirements.txt. - Dynamic Threading / Hardware Scaling: Replaced hardcoded core counts (
-j14/-j10) withos.cpu_count()and%NUMBER_OF_PROCESSORS%(configurable viaNEXUS_JOBS). - Cleaned Repo Bloat & Licenses: Untracked vendored redundant source trees (saving ~170MB), added root
LICENSE(MIT), and updatedTHIRD_PARTY_NOTICES.txtwith Vulkan-Headers, glslang, zlib, and LGPL-2.1at3_standalone.
- Dynamic Bolt Spawn Cap (
func_004E9F98): Caps physical bolt spawns at 3 per burst while scaling each bolt's value so economy/progression remains 100% exact. - Crate Debris Moby Burst Cap (
func_00784E20): Caps runaway crate-plank Moby bursts (cls=0x55) during active gameplay (after the first 2s of level load), eliminating theigAnim(0x00588B80) SPU stall and 8.5 FPS hang. - SPU / SPURS Channel & Drain Optimizations: AVX2
spu_mem_ne, 64-entry_Thread_localoverlay cache, hoistedw0/w1checks,spu_lr_waitSleepConditionVariableSRWbackoff, power-of-2 ring (RING=32), and guardedyz_lockstep_tick. - RSX VRAM Budget & 4K Cap: Clamped
rt_budget+z_budgetto stay within 80% of card VRAM, lowered proactive eviction to 84%, and capped internal resolution at4K (3.00x)(removing5K / 4.00xwhich causedVkResult -2OOM stalls). - GUI Builder & Offline Toolchain (
RecompBuilder.exe): Native Win32 GUI setup/builder withPut_Game_Folder_Here\&Put_ELF_Here\auto-detection, prebundled portable toolchain,RecompFolder\output, and Desktop shortcut creation.
Roadmap
- Fix all remaining visual and graphical glitches
- Achieve stable 60 FPS across full gameplay
- Optional graphics enhancements (e.g., SMAA, improved shadows, and possibly FSR)
- Nicer, more polished installer experience
- Test the whole game, make sure its playable from start to the end
Reporting Bugs
If you run into crashes, graphical glitches, or gameplay issues, please report them using GitHub Issues.
Support
If for some reason someone wants to, you can buy me a coffee. The recomp is completely free and always will. I do this bc i love ps3 era games, hate that they are stuck on ps3 and bc ratchet is one of my fav childhood series ;)
Credits
ps3recomp— Core PS3 PPU/SPU/RSX static recompilation runtime and toolingRACiT— Ratchet & Clank: A Crack in Time recompilation research & runtime foundationsratchet-tod-recomp— Ratchet & Clank: Tools of Destruction recompilation insightsinfamous2-recomp— inFAMOUS 2 recompilation & SPURS/RSX researchresistance-recomp— Resistance recompilation & Insomniac/PS3 runtime patternsSoulbrandt— Community research and tooling contributions
Legal
- This project is not affiliated with, endorsed, or sponsored by Sony Interactive Entertainment or Insomniac Games.
- Ratchet & Clank, Ratchet & Clank: Into the Nexus, PlayStation, PS3, DualShock, and DualSense are trademarks of Sony Interactive Entertainment; all other trademarks belong to their respective owners and are used solely to describe compatibility.
- No game code, assets, Sony firmware, or decryption keys are included, nor anything derived from them. This repository and its releases contain only original runtime/host code, build scripts, and documentation.
- You must own the game (
BCUS99245) and dump/decrypt it yourself for your own personal use.RecompBuilder.exetranslates your own copy locally on your PC. Do not share the built executable (RecompFolder\NexusRecomp.exe), lifted sources (game\src\recomp\,game\spu\),elf\EBOOT.ELF, or yourPS3_GAMEdump, as they contain the game's code or data. - See THIRD_PARTY_NOTICES.txt for third-party open-source licenses.