SanctuaryPort
SanctuaryPort is a native PC port of Diablo III: Reaper of Souls Ultimate Evil Edition for PlayStation 4 that supports local co-op and Xbox button icons.
- Type: PC port
- Game: Diablo III: Eternal Collection
- Runs on Windows and Linux
- By CaduGimenes
- Latest release v0.7.0, 2026-11-20
- Source: https://github.com/CaduGimenes/SanctuaryPort
README
A native PC port of Diablo III: Reaper of Souls – Ultimate Evil Edition (PS4)
English · Português (Brasil)
SanctuaryPort runs the PlayStation 4 version of Diablo III natively on a PC: the Brazilian (CUSA00243), US (CUSA00242) and European (CUSA00433/CUSA00434) releases of Reaper of Souls – Ultimate Evil Edition, with each one's last update (1.47 for the Brazilian and US ones, 1.46 for the European one), which is the Eternal Collection (2.7.7, with the Necromancer). The game's original x86-64 code runs directly on your processor, a runtime replaces the PS4 system libraries, and the PS4 GPU commands are translated to Vulkan by a video core derived from shadPS4. There is no CPU emulator.
Important
SanctuaryPort is the port only — the game is not included and is not distributed here. This repository and its releases hold the runtime that recompiles and runs the PS4 code, the GPU translation layer and the launcher. No Diablo III files (executables, data, PKGs, keys or artwork) are part of the source or of any download, and none will be provided. To play, you need your own copy of the game, dumped from a PS4 you own.
This project is not affiliated with or endorsed by Blizzard Entertainment or Sony Interactive Entertainment. Diablo is a trademark of Blizzard Entertainment, Inc.
Download
Get the latest build from the Releases:
- Linux:
SanctuaryPort-linux-x86_64.AppImage— make it executable and run it. Needs a distro with glibc 2.39 or newer (SteamOS, Ubuntu 24.04+, Debian 13, Fedora 40+...),python3, and a GPU with Vulkan 1.3. Saves and settings go to~/.local/share/sanctuaryport, or, if you create aSanctuaryPort-datafolder next to the AppImage, into that folder (portable mode).SanctuaryPort-linux-x86_64.tar.gzis the same thing as a plain folder: extract it and runSanctuaryPortinside; it is portable (everything stays in itsSanctuaryPort-data). - Windows:
SanctuaryPort-windows.zip— extract it and openSanctuaryPort.exe(instructions inREADME-Windows.txt). Python comes inside the folder.
Then follow Getting your game ready with your own dump.
Status
Playable. Developed on Linux (AMD Radeon 780M / 760M, Mesa) with the Brazilian 1.47 and US 1.00 dumps, and played by the community on the hardware below:
| ✅ Title screen, hero creation, cinematics, Act I world | 60 FPS, 20+ minute sessions without a crash |
| ✅ Saving and Continue | saves live in user/savedata/ (backed up on every start) |
| ✅ Local co-op for up to 4 players | every extra gamepad is one more player |
| ✅ Xbox button icons in the game's prompts and HUD | optional, drawn over the game's own icons |
| ✅ DLC entitlements | from your own add-on packages; they need the game's update 1.46 or later (the launcher warns otherwise) |
| ✅ Install straight from your PKG files | in the launcher, no external tools |
| ✅ Languages | whatever your dump ships, in any region's release (English, French, Spanish, Portuguese, German, Italian, Polish, Russian...) |
| ✅ Trophies | an on-screen notice with the trophy's name as you earn it, the platinum by itself, and a Trophies page in the launcher |
| ✅ Render resolution 480p–4K, ultrawide 21:9 / 32:9, 16:10 (Steam Deck 1280x800) | resolution patches for the 1.47 and 1.00 executables (the camera widens to the screen); FSR 1 upscaling and RCAS sharpening |
| 🧪 FSR 3 (experimental) | temporal anti-aliasing, or upscaling to the window with the HUD at full size (Graphics > Anti-aliasing) |
| ✅ FXAA | cheap anti-aliasing of the 3D picture before the HUD (Graphics > Anti-aliasing), when FSR 3 is off |
| ✅ Frame rate 30 / 60 / 120 / 200 | the game's own frame limiter (Graphics > Frame rate; 200 is the game's own maximum); the game's speed stays the same; at 60 and above each frame is shown as soon as it is done (VRR and gamescope friendly) |
| 🧪 Game MSAA on AMD and Intel (Windows) | off by default there (black lines); On is experimental: its depth is created without compression |
| 🧪 MSAA 2x / 4x | the game's scene drawn with more samples and averaged into the picture, as on PC (Graphics > MSAA samples); the game's own copy keeps one sample |
| ✅ Updates | from their own folder, read over the game in place: nothing is copied, on any drive (microSD cards on the ROG Ally / Steam Deck included); the base game is never changed |
| ✅ Windows 10 / 11, Linux, SteamOS | played by the community on NVIDIA, AMD and Intel graphics, Steam Deck / Steam Machine and ROG Ally; every release is also tested under Wine |
| ❌ Online play / PSN | offline only |
The launcher
launcher-rust/ is the SanctuaryPort launcher, a Rust/iced app adapted from
SpartanPort's launcher:
- Home with your game's own key art (
sce_sys/pic1.png, read from your dump; nothing is shipped); - Graphics: window mode, render resolution, anti-aliasing (the game's MSAA, FSR 3), upscaling (FSR 1) and sharpening, frame limit, graphics card;
- Game: game folder, language, player name, saves, and installation from PKG (base game, update and add-ons);
- Trophies: every trophy with its icon (from your dump), name and description, and which ones you have earned with the port;
- Controls (keyboard, mouse and gamepad mapping, button icon style) and Advanced (launcher options, shortcuts and the log of the last start).
Its interface follows your system language (English, Portuguese and many more), and it works with a gamepad alone: LB / RB change tab, A / Start on Home plays, B goes back.
Command line
The same options on Windows (SanctuaryPort.exe) and Linux (the AppImage or SanctuaryPort in the
tarball). Play SanctuaryPort.exe (Windows) is --play without a console window, for Steam and
shortcuts.
--play start the game with the saved settings, without the launcher window
--game DIR the game folder (with eboot.bin), for this start
--update DIR the update folder, for this start
--data-dir DIR keep settings, saves and generated files in DIR
--fullscreen | --borderless | --windowed
the display mode (saved, as the Graphics page does)
--set KEY=VALUE any sanctuary.ini setting, e.g. --set frame_rate=120 (saved; repeatable)
--install-pkg PKG DIR install a game, update or add-on PKG into the games folder DIR
--version, --help
For example, straight into the game in full screen at 120 FPS:
SanctuaryPort.exe --play --fullscreen --set frame_rate=120 --game D:\PS4\CUSA00242.
Building from source (Linux)
You need a C/C++ toolchain (clang or gcc), CMake, Ninja, SDL3, the Vulkan headers and loader,
Python 3.10+ (Pillow optional, for the window icon) and rustup for the
launcher (it installs the Rust version launcher-rust/rust-toolchain.toml pins). On Ubuntu
24.04, bash packaging/linux/ci-deps.sh installs everything; with Nix, nix-shell.
git clone --recursive https://github.com/CaduGimenes/SanctuaryPort.git
cd SanctuaryPort
bash build.sh # if CMake cannot find vk_mem_alloc.h:
# CMAKE_INCLUDE_PATH=$PWD/third_party/vma/include bash build.sh
cargo build --release --manifest-path launcher-rust/Cargo.toml
Packages: bash packaging/linux/build.sh makes the AppImage (release builds come from
.github/workflows/release.yml on Ubuntu 24.04), and
bash packaging/windows/package.sh cross-compiles the Windows zip from Linux — see
packaging/windows/README.md, which also covers building on Windows
with MSYS2.
Getting your game ready
-
Dump Diablo III (the Brazilian CUSA00243 release with its 01.47 update, or the US CUSA00242 Ultimate Evil Edition) from your own PS4 as fake PKG files: base game, update and, if you have them, the add-ons. This project does not provide the game or help obtaining it.
-
Start the launcher (the AppImage,
SanctuaryPort.exe, orlauncher-rust/target/release/sanctuaryport-launcherfrom source), open Game and choose Install from PKG with the game, its update and add-ons. The game goes to~/Games/PS4/<TITLE_ID>, the update to<TITLE_ID>-UPDATEand the add-ons toaddcont/; the launcher sets the folders. The same works from a terminal:launcher-rust/target/release/sanctuaryport-launcher --install-pkg <file.pkg> ~/Games/PS4An already extracted dump works too: point the launcher at the folder that holds
eboot.bin.Keep the game and its update in separate folders: the port reads the update over the game in place, without copying anything. Add-ons (the Necromancer) need the update (1.46 or later): 1.00 has no Necromancer.
Playing
Press PLAY in the launcher, or from a terminal:
SANCTUARY_GAME_DIR=~/Games/PS4/CUSA00243 SANCTUARY_PATCH_DIR=~/Games/PS4/CUSA00243-UPDATE bash run.sh
-
Gamepads (Xbox, DualSense, DualShock 4, anything SDL recognises) work out of the box. Keyboard and mouse work too, with these default keys (change them in the launcher's Controls):
Key PS4 button W A S D left stick (move) Arrow keys right stick (evade) Space ✕ Left Shift ○ Left mouse button / right mouse button □ / △ Q / E L1 (potion) / R1 R / mouse forward button L2 / R2 Z / X L3 / R3 1 2 3 4 d-pad up, right, down, left Tab Options P / Esc touchpad left / right Insert the port's menu (cannot be changed) F12 screenshot ( user/screenshots/) -
Local co-op: connect more gamepads. The first one is player 1; another one joins when you press a button on it, as player 2, 3 or 4 in the order the buttons are pressed (so a device that only reports motion, like a DualSense's motion sensors on Linux, never takes a seat). Press the bottom face button (A / ✕) on the new gamepad to join.
-
Xbox button icons: launcher → Controls → Gamepad → In-game button icons → Xbox (or Match my controller). Your game files are never changed.
-
In-game port menu:
Insert(or R3 + L2). Screenshot:F12(user/screenshots/).
Known issues
- The analog stick icons still read L3/R3 with Xbox icons on; Nintendo letters are not drawn yet.
- Ultrawide: 21:9 (2560x1080, 3440x1440, 3840x1600) and 32:9 (5120x1440) render resolutions, with the camera widened to them (Graphics > Aspect ratio); 2560x1080 checked in game, the others use the same patch. 16:10: 1280x800 (Steam Deck), 1920x1200 and 2560x1600; 1280x800 checked in game.
Road to 1.0 and reporting problems
1.0 ships when the whole campaign can be played on common hardware without help. Tell how far you got, and on which device, in the pinned issue Road to 1.0.
For a problem, open an issue with the bug template and attach user/last_run.log. For stutter or
frame drops, first turn on Advanced → Frame statistics in the log and play the same spot: the
log then records the frame pacing and every long frame.
How it works
See docs/DIABLO3.md for the Diablo III specifics (game profile, co-op, button icon replacement, PKG installer, debugging switches and reverse-engineering helpers) and docs/ for the shared runtime and GPU core.
Credits
SanctuaryPort stands on the work of others:
- knack_pc and wipeout_pc by Abdelmoumen Deghbouche: the native PS4 runtime this port is built on (its full history is kept in this repository);
- SpartanPort by Felipe Prado: the launcher;
- bbport: the native port approach;
- shadPS4: the video core and shader recompiler;
- LibOrbisPkg: the PKG/PFS format knowledge behind the installer;
- fonts: Metamorphous and Cinzel (SIL Open Font License), DejaVu.
License
GPL-2.0, like the projects it derives from. Third-party code under gpu/third_party/
and third_party/ keeps its own licenses. The license covers this project's code only; it grants
nothing over Diablo III, which belongs to its owners.