WipEout Omega Collection for PC (wipeout_pc)

A native PC port of WipEout Omega Collection (PlayStation 4) for Windows 10/11, in the style of bbport: the game's original x86-64 code runs directly on the PC's processor, a runtime replaces the PS4 system libraries, and the graphics are translated to Vulkan by the shadPS4 video core. There is no CPU emulator.

Status: playable, in active development. Menus and races (HD and 2048) play above 60 FPS. See Progress.

For contributors: build and debug on Windows, or optionally edit from WSL2. Debugging scripts and tests are versioned; GDB and the compiler are installed as development dependencies.

Download and play (Windows)

1. Download wipeout-windows.zip from the latest release and extract it.
2. Open WipEout.exe, choose your game folder (the one with eboot.bin) and click PLAY.

Requirements: Windows 10 or 11 (64-bit), a CPU with AVX, a GPU with Vulkan 1.3. The README-Windows.txt in the zip has the details. Linux: build from source (below).

No game files are included. You need your own copy of the game, dumped from your own PS4. This project is not affiliated with Sony Interactive Entertainment, XDev, Clever Beans or EPOS Game Studios. WipEout is a trademark of Sony Interactive Entertainment.

Help make it better

• ⭐ Star the repo if you like it. It helps other players find the port.
• 🐞 Found a bug? Open an issue with your GPU, driver and user/last_run.log. Every report helps me fix the game, and I read all of them.
• 💡 Want something? Feature requests are welcome too. Open an issue and tell me what you would like.
• 🛠️ Can test or code? Reports from AMD, Intel, Linux and Steam Deck players help a lot, and pull requests are welcome.

Known problems are in the open issues. Thanks to everyone who has played, tested and reported so far!

Progress

Step	State
Unpack the game and its update	Done (scripts/pkg_extract.py)
Load and link the executable (eboot.bin, libc, Fios2, NpToolkit2)	Done
PS4 system functions the game uses	Done for menus and races; PSN, VR and camera answer as an offline console
Boot, menus, saves	Done
Races (HD and 2048), race results	Done
Game speed	Done: the game runs on real time at any frame rate
Frame rate above 60 FPS	Done: up to 240 FPS, set by the frame rate limit (110–150 FPS in 2048 races on an RTX 4070 Laptop)
Graphics: Metro Park terrain	Fixed (shader recompiler, #5)
Render resolutions: native 1080p, 2560x1440, 3840x2160 (4K), 2560x1080, 3440x1440, 5120x2160	Done: pick one in the in-game Render resolution menu (Insert key) (patches/WipEout_Omega_Collection.xml, #2, #48). The HUD stays 16:9 in the middle of wider screens. 4K and 5120x2160 need a lot of video memory: HD races at 4K can run out on 8 GB
HDR	Done; the darker picture when RCAS runs is fixed, waiting for a test (#4)
Sound: music and effects (Audio3d)	Done; the effects are new, please report anything that sounds wrong
Your own music (custom soundtrack)	Done: see Your own music (#47)
Launcher and settings	Done (launcher/gow3_launcher_win.py)
Windows package (zip)	Done (packaging/windows/package.sh, Actions > Windows zip)
Linux	Builds from source; no package yet
PS4 Pro mode	Experimental (GOW3_NEO=1): loads a race with a correct picture since v0.2.3 (#32, #33); not tested further
PSVR mode	Not planned for now (#7)
Every game and event type (HD, HD Fury, 2048)	Not all tested yet

2048 races need red-zone protection on Windows (src/redzone.cpp): the game's profile turns it on. Without it they run at less than 1 FPS.

The game times itself with the processor's time stamp counter (rdtsc), so the runtime gives it the real counter and its measured frequency (src/runtime_kernel.c). Its speed then does not depend on the frame rate.

Your own music

Play your own songs instead of the game's music, as on a PS4 playing your own music. The game's sound effects stay.

1. In the launcher, open the Music page. Put your songs (MP3, OGG, FLAC, WAV, M4A, ...) in the music folder: user\music next to WipEout.exe, or any folder you choose there. Subfolders count too. The page lists the songs it finds.
2. Click PLAY. Your songs play in menus and races, shuffled. The song name shows in the lower right corner when a song starts.
3. In the game, press Insert (or R3 + L2) and open the Music tab: pick a song, go to the previous or next one, switch shuffle or your music off, and set the Music volume.

Each song is leveled, so loud and quiet songs sound alike; Music volume 100% is about as loud as the game's own music. Without the launcher, GOW3_MUSIC_DIR points to another folder.

Supported game versions

Title ID	Region	Version	State
CUSA07671	US	01.00 + update 01.07	Development target
CUSA05670	EU	—	Playable (five races tested, #19)

The base game and the update are merged into one folder (the update's files replace the base game's). One eboot.bin runs all three games: WipEout 2048, WipEout HD and WipEout Fury.

Building (Windows)

1. Install MSYS2 (winget install MSYS2.MSYS2) and, in the MSYS2 CLANG64 shell, the packages listed in packaging/windows/README.md.

2. Install Python 3.10+ from python.org (with Tk), then:

   python -m pip install pillow iced-x86==1.21.0 cryptography
   

3. Clone with submodules and build in the MSYS2 CLANG64 shell:

   git clone --recursive https://github.com/AbdelmoumenDeghbouche/wipeout_pc
   cd wipeout_pc
   bash build.sh
   

   If Git converts line endings on your PC (core.autocrlf=true), the FSR patches do not apply. Turn it off for this repository and its submodules before building:

   git config core.autocrlf false
   git submodule foreach --recursive git config core.autocrlf false
   git rm -rq --cached . && git reset -q --hard
   git submodule foreach --recursive 'git rm -rq --cached . && git reset -q --hard'
   

Preparing your game

From fake PKGs of your own dump (base game and update):

python scripts/pkg_extract.py <base.pkg> D:\games\CUSA07671
python scripts/pkg_extract.py <update.pkg> D:\games\CUSA07671-patch

Extraction first reads the PKG to calculate its SHA-256. A retry keeps only files recorded as complete for that exact package whose size and modification time have not changed. Older extractions without this record are extracted again once, even when file sizes match.

Then move the update's files over the base game folder, or pass the update folder with GOW3_PATCH_DIR. A folder dumped with GoldHEN works the same way.

Running

Start the launcher, choose your game folder on the Game page, then click Play:

python launcher\gow3_launcher_win.py

The Advanced page can put a shortcut on the desktop. Settings: display mode, frame rate limit, VSync, anisotropic filtering, HDR, controls, mods and the game language.

Without the launcher, run.py starts the game:

$env:GOW3_GAME_DIR = 'D:\games\CUSA07671'
python run.py

List the PS4 functions the runtime does not have yet:

$env:GOW3_GAME_DIR = 'D:\games\CUSA07671'
$env:GOW3_MODS_ENABLED = '0'
python run.py --check-imports

Without --check-imports, run.py starts the game. The loader stops at the first system function the runtime does not implement and prints its name.

How it works

Part	Where	What it does
PKG unpack	scripts/pkg_extract.py	Decrypts and unpacks fake PKGs (PFS, PFSC), as shadPS4 does
Game profiles	scripts/game_profiles.py	System modules to link per title ID
Preparation	scripts/prepare.py, link_libc.py, link_modules.py	Reads eboot.bin and links the game's own libc, libSceFios2 and libSceNpToolkit2
Import names	scripts/gen_import_names.py, src/import_names.inc	Maps the game's import NIDs to function names
Loader	src/probe.c	Loads the image and starts the game's original code
Runtime	src/runtime_*.c	PS4 system functions
Audio3d	src/runtime_audio.c	Mixes the bed and the sound objects of the Wwise sink into one output
Json2	src/runtime_json.c	sce::Json values, parser and serializer (race results)
Red zones	src/redzone.cpp, scripts/function_starts.py	Keeps Windows exception records out of the game's red zones
Launcher	launcher/	Settings window and game start
GPU	gpu/shadps4/	shadPS4 video core (Vulkan)

Many names (gow3-probe.exe, GOW3_* variables, the launcher) still come from the God of War III port this project is based on. They will be renamed.

Credits

This project is a fork of FelipePrado0's God of War III port, which comes from Supermedo's Windows port of deadinside28's original:

• FelipePrado0: gow3_pc, the base of this project.
• bc160201983: medievil_2019_pc_port, the first port of another game on that runtime. pkg_extract.py, game_profiles.py and gen_import_names.py come from it.
• deadinside28: bloodborne_pc, the original native port.
• Supermedo: bloodborne_pc for Windows.
• cuesta4: shadPS4 fork (branch eltutz): the GNM blend rewrite, depth/stencil state and image aliasing fixes.
• shadPS4 team: the shadPS4 video core, the PKG format and the symbol names (tools/aerolib.inl).

Contributors to this port: d4g (render resolution patches, the Metro Park terrain fix), carlosmarind (save and heap fixes, PS4 Pro mode work), Extremenis (the overexposed SDR fix), ahmanwoods (Audio3d IDs), alhockly (EU version test), benhaslett (game clock measurements, Linux build fix) and iannitram (PS4 FPU state).

Also used: LibAtrac9, FFmpeg, SDL3, Dear ImGui, sirit, magic_enum, miniz, xbyak, Vulkan Memory Allocator, FSR-Vulkan and the AMD FidelityFX SDK, MSYS2, LLVM and Pillow.

License

GNU GPL v2 or later (LICENSE). Third-party components keep their own licenses.