<p align="center"> <img src="docs/images/logo.png" alt="CTR Nitro-Fueled PC" width="360"> </p>

OCTR: CTR Nitro-Fueled PC, online

EU mod packages: CUSA14876 01.21 loader support and update instructions. CNK Drift Gauge + Reserves Meter — EU: original mod by tomtotom, EU adaptation by Majed-allababedi. Select Speedometer HUD in-game.

Crash Team Racing: Nitro-Fueled (PS4, CUSA13795 v1.21) running natively on Windows 10/11 and Linux, with online play on a community server.

This is the online fork of GetLostIn's CTR-NitroFueled-PC, the Windows build of SacredFire, the native Linux port of the game by T3CHNOLOG1C. The game's own x86-64 code runs directly on the CPU, a small runtime replaces the PS4 system libraries, and a renderer derived from shadPS4 translates the PS4 GPU work to Vulkan. The Windows layer (loader, memory, TLS, exceptions, files, timers) comes from Supermedo's Windows port of bbport: see packaging/windows/README.md.

On top of that, this fork adds online play (see Online below): public races, private rooms, groups, friends and the Pit Stop through the RyuNET server, with your own nickname, Discord account linking and Discord invites.

No game files are included. You need your own dump of the game and its 1.21 update. Both builds of the 1.21 update work: the one for firmware 5.05 (the reference) and the one for 6.72+ (since v0.2.1). Not affiliated with or endorsed by Sony Interactive Entertainment, Activision or Beenox. Crash Team Racing, Nitro-Fueled and PlayStation are trademarks of their owners, named here only to identify the game this software runs.

Status on Windows: playable. Menus, Adventure and Arcade, races, sound, cutscenes, Xbox/SDL controllers and keyboard, saving, the community patches (60 FPS, no motion blur), restart from the in-game menu, and the game's DLC from your own packages (optional). Internal resolution from 480p to native 4K, with AMD FSR 1 or temporal upscaling (AMD FSR 3.1, or NVIDIA DLSS on RTX cards; experimental). Tested on Windows 11 24H2 with an NVIDIA RTX 3070 and an Intel i5-9500: 110-130 FPS uncapped in races with the 60 FPS patch (the FPS limit keeps it at 60 by default; up to 240). From v0.5.3 the first start prepares the game's shaders for your GPU from your own dump (a few seconds, once: shaders/README.md), so new tracks and racers no longer stop the game to compile them; the few the recipe lacks are compiled when first seen and cached.

Time Trial on recognized USA/EU 1.21 executables credits every challenge beaten by a finish: N. Tropy, Oxide, Velo and developer times, even with no ghost selected. Times must be strictly faster; existing progress is kept. Rewards still require completing their required tracks. Other executable layouts keep the game's original progression.

Release	What it brought
v0.8.1	Private races in sync: team positions and finishes, Cup rules kept between tracks, AI catch-up and smarter high-difficulty driving (n0buholic); private extended modes need the whole party on the same version; 21:9 and 32:9 layouts start again with Online on (tcosi); NVIDIA GPUs found when the Linux AppImage is the first thing opened after boot (Vo1dTear); controller names in the launcher follow its language
v0.8	Public Itemless matchmaking with its own queue and private team races (n0buholic); much faster starts (boot cache, n0buholic; Itemless kept between starts) and no black screen from Steam shortcuts; one save with or without mods; online item odds the client cannot change; bans that follow the player's PC; GPU picker by name for laptops; time trials credit every beaten ghost at once (n0buholic); borderless window covers the screen and faster native Vulkan compiles on NVIDIA (Enrique-Ale); Bahasa Indonesia in the launcher
v0.7.5	Another player's racer from a mod you don't have shows as Crash instead of freezing the lobby at 0; Itemless no longer carries over to public races (no items, Tiger Temple's door open); Discord invites with mods on (Vo1dTear); a clear message when an antivirus blocks the game
v0.7.4	Private online cups: four tracks with the game's points and a podium from the totals (n0buholic); a native Graphics page and no crash opening Options in a race (n0buholic); Speed Mode renamed Itemless, where bumping another kart keeps your reserves (n0buholic); experimental 16:10 (david-labib); AMD FSR 4 (experimental, shown only with its model files; GetLostIn's wiring); crash signatures in the anonymous performance data
v0.7.3	Native Vulkan: faster (translated shaders about half as heavy, no hitches from descriptor sets, a lighter capture thread in the adventure hub), Hyper Spaceway's dark sheet of triangles and Assembly Lane's whitish steam fixed; a damaged game file no longer stops online at start (Speed Mode is skipped); Graphics and Quit Game in Arabic (Majed-allababedi)
v0.7.2	Online with a 21:9/32:9 layout starts again (amscova); Aspect Ratio in the in-game Graphics menu (immaculatevibes2025); EU 1.21 gets the Graphics menu, Quit Game and private Speed Mode (n0buholic), the native Vulkan engine and the faster loading; native Vulkan: the sun's glow and lens flares, and fur without holes on AMD GPUs
v0.7	Native Vulkan engine as an experimental choice in the launcher (straightarrows), with a shader build window; Speed Mode for private rooms, synced to the players who join (n0buholic); loading screens about half as long (liblzma decoding, n0buholic, and a RAM cache); motion blur off by default; older GPUs start again; opt-in anonymous performance reports; foldable friends list; in-game Graphics menu, Quit Game, Skip intro and the MSAA sky lines fixed on NVIDIA (immaculatevibes2025)
v0.6.5	Online item-box odds set by the server; 21:9/32:9 layouts render at the chosen internal resolution up to 4K (startupandhold); mods start at any internal resolution (Vo1dTear), EU mod packages (Majed-allababedi) and several name mods together (SoyAlejandroCalixto); no code 20 at a first start without GitHub; nicknames register behind ISP filters; GPUs without sparse buffers get a clear message
v0.6.4	Mods checked at the code they change, so they work on more 1.21 dumps (tcosi); mods import from deep folders; no freeze when a controller connects or drops (SoyAlejandroCalixto); the Controllers tab shows each player's controller; Linux launcher with Achievements and Mods (Brony666); a racer's outfit no longer ends the game with code 3
v0.6.3	Mod fixes: game mods start again without a 21:9/32:9 layout, "Apply and restart" works with mods, and loose mods work with the game on another drive
v0.6.2	Mods load without copying the game (tcosi); ping counter in the corner and a Room tab in the in-game menu; online login goes through networks and antivirus filters that redirect it; GameBanana link on the Mods page
v0.6.1	Xbox button prompts (option); split screen assigns controllers automatically and players 2-4 play as guests (no extra saves); ping of the players in the room (in-game menu); Report in its own tab; mouse buttons and the wheel in the key bindings; online works with a PC clock that is off, and the login is no longer held by antivirus web shields; a new folder can bring the settings, saves and nickname of another installation; a nickname taken by another installation on the same PC is recovered; the Mods page (tcosi); ultrawide on every 1.21 build the layout fits (tcosi); DLC on Linux (Vo1dTear); controller ownership in split screen (n0buholic)
v0.6	Friends inside the game (search, requests, invitations, notices when they come online; the game's Invite button works); report players from the game, reviewed by the server's moderators (bans, cheated records removed); messages and announcements from the administrators as in-game notices; online rules and the community Discord in the launchers, which also say why a player is banned; online races end 30 s after the first player finishes; notice position and a notice when a new version is out; the Linux AppImage updates itself; NVIDIA laptops on Linux; a GPU without Vulkan 1.3 is named as such instead of code 23 (code 23 itself is not fixed); the NAT test detects networks that drop the server's replies; identical controllers in split screen. Versions 0.4.1 and older can no longer play online
v0.5.4	Every race track in public matchmaking, at the same chance (Koala Carnival and the later Grand Prix tracks included); regional relays for the online tunnel; corrected 21:9 and 32:9 menus and centered HUD (tcosi; USA and EU 1.21, offline); CPUs without MOVBE/BMI1/LZCNT (Sandy and Ivy Bridge) can play; achievements with in-game notices and a launcher page; the in-game menu in Spanish, General tab first; a badly extracted game is reported instead of a code 3 (contributions from GetLostIn's repository by MetaHeart and Naif Alqurashi). Code 23 is not fixed and can still happen.
v0.5.3	The European edition (CUSA14876, with or without its 1.21 update), online with the USA one; ultrawide screens; the first start prepares the game's shaders for your GPU (far fewer stalls in the first races); one more cause of the code 23 GPU hang removed (a stale GPU idle signal; code 23 itself is not fixed and can still happen); shadPS4 crash fixes; Bluetooth controllers no longer drop from rumble; the launcher checks for updates and installs them keeping your files; the Linux launcher gets the Windows options (volume, player per controller, window settings, more languages, patches)
v0.5.2	Two causes of the code 23 GPU hang mitigated (garbage buffer descriptors, a minimised window) and more detail in crash logs; Linux launcher close to the Windows one: controls, DLC, friends, internal resolution, Discord account link, status and invites (also from Steam), AppImage icon, Steam shortcut that survives updates
v0.5.1 (pre-release)	Fix for the code 3 crash at start; the game no longer stops when VRAM runs short; GPU hangs (code 23) report their cause in the log; a server tunnel for players who cannot reach each other directly; redesigned launcher, now named Crash™ Team Racing Nitro-Fueled, in nine languages, with the NAT type on its Play page; Linux launcher: FPS limit, Unlock Everything, in-game settings kept
v0.5	Your own online nickname, linked to your Discord account and recoverable on any PC; Discord invites that join a private room directly; Discord presence; game volume (0-200%); keyboard as a split-screen player; optional "Unlock Everything" patch; Pit Stop items from the server or from your save; players on the same network can join each other; fixes for error code 3 and for some causes of code 23; first Linux AppImage of this fork
v0.4	Private matches and groups; the in-game friends list
v0.3 online	First online build: matchmaking, lobbies and the Pit Stop on the RyuNET server; Online section in the launcher (server and nickname); hostnames for the server; bundled Python 3.14

Earlier releases, from GetLostIn's repository:

Release	What it brought
v0.3	Internal resolution 480p to native 4K (the game's own render scale; replaces the PS4 Pro switch); one Upscaling list: AMD FSR 1, AMD FSR 3.1 or NVIDIA DLSS (temporal, experimental) with DLSS quality modes, output and model (Transformer/CNN); game languages of this build (English, Latin American Spanish, French, Brazilian Portuguese); PS4 PKG Tool dumps (Image0 + Sc0); fullscreen switch in game fixed
v0.2.1	The 1.21 update built for firmware 6.72+ is accepted (patches found by signature); keyboard page in the launcher to rebind keys
v0.2.0	Launcher (CTR-NitroFueled-PC.exe): game setup with hard-link merge, settings, patches, save backups and imports, optional DLC; bundled Python; the project's icon
v0.1.1	First portable build: FPS limit up to 240, fullscreen switch, licenses in the package

Quick start (Windows)

Easiest: the portable build. Download CTR-NitroFueled-PC-portable-<version>-windows.zip from Releases, unzip it anywhere and open Crash™ Team Racing Nitro-Fueled.exe (CTR-NitroFueled-PC.exe before v0.5.1), the launcher: choose your CUSA13795 (base game) and CUSA13795-patch (update 1.21) folders, press Prepare the game once (it merges them with hard links, no extra disk space) and then Play. Python is bundled; you only need a Vulkan 1.3 GPU.

Updating: unzip the new version over your folder to keep your settings, saves and nickname key, or unzip it into a new folder and copy user\, bbport.ini, launcher.ini and ryunet_online.key across.

Linux and Steam Deck: Download the AppImage from the same Releases page (see AppImage below). The v0.5 asset is SacredFire-x86_64.AppImage; automated releases use SacredFire-<version>-x86_64.AppImage. Data, saves and the nickname key live in ~/.local/share/sacredfire.

Online

Online is on by default and connects to the community server octr.ryu7w7.xyz (RyuNET, a Demonware server written for this game). From the game's own menus you can:

• race in public matches with other players, alone or with your group;
• create private rooms and invite your friends;
• see your friends list in the game;
• buy items in the Pit Stop: with the items bought on the server, or with the ones already unlocked in your own save (launcher: Online tab).

Your nickname. Each player needs their own nickname (3 to 16 letters, digits, _ or -). Shared default names (RyuPC, Player, Jugador...) are refused. The first installation that plays with a nickname keeps it, through the key in ryunet_online.key (copied to %APPDATA%\CTR-NitroFueled-PC): never share that file.

Fair play. Players banned for cheating are banned with their PC, not only their nickname: a new nickname or a fresh install does not bring them back. For this the game sends the server an anonymous fingerprint of the PC: two SHA-256 digests of Windows' installation ID and the motherboard's ID (scripts/machine_id.py). The server can only tell whether it saw the same PC again; it never learns the hardware, and the IDs themselves never leave the PC.

Discord (Windows launcher, Online tab):

• Link with Discord ties your nickname to your Discord account. Recover with Discord gets it back on any PC or after reinstalling. Linked nicknames never expire; unlinked ones that nobody uses for 60 days become free again.
• Presence and invites: with Discord open, your profile shows what you are playing, and an invite sent from Discord drops the friend who accepts it straight into your private room.

Playing offline: turn online off in the launcher's Online tab, or set BB_ONLINE=0. The server address can be changed there too, to play on your own RyuNET server.

Connection problems: the game connects players directly to each other (UDP port 3074), as on the PS4. Some home connections (strict NAT, mobile data, carrier-grade NAT) cannot reach some other players. If a match keeps failing with the same people, enabling UPnP on your router or forwarding UDP 3074 to your PC helps.

No donations: this is a non-commercial fan project. It does not accept donations and sells nothing; online play is free and the same for everyone. You need your own copy of the game.

Picture (launcher: Settings > Display; in game: Insert):

• Internal resolution: the size the game draws its 3D scene at. 480p and 720p for modest PCs; 1440p to 2160p output a 4K picture, which also smooths edges on a 1080p screen. Needs a restart (the in-game menu does it).
• Upscaling, one at a time, switched live:
  • AMD FSR 1 (default): a sharper spatial enlargement than the game's own stretch.
  • AMD FSR 3 (experimental, any GPU) and NVIDIA DLSS (experimental, GeForce RTX; the files come in the package): temporal upscaling that rebuilds detail over several frames from the game's depth and motion, and works as anti-aliasing at the same resolution. Turn them off if you see trails.
• With DLSS: DLSS quality (Auto follows the internal resolution; DLAA, Quality, Balanced, Performance and Ultra Performance render at NVIDIA's share of the DLSS output, 1080p or 4K, after a restart) and DLSS model (Transformer, recommended, or the lighter CNN).

Game language (launcher: Settings > Console): the languages this build (CUSA13795, the Americas) has: English, Latin American Spanish, French and Brazilian Portuguese. Spain's Spanish is not in it.

The launcher also has the game patches, FPS limit, display, monitor and controller settings, save backups and imports (including decrypted PS4 saves), and optional DLC: add your own DLC packages (.pkg) and the port reports them installed (CTR Nitro-Fueled's DLC only carry the license; the content is in the game). Spanish and English.

Which game dumps work

The launcher needs the game as folders of decrypted files from CUSA13795 (the USA edition) or, from v0.5.3, CUSA14876 (the European edition): the base game (v01.00) and the 1.21 update. The launcher tells which edition you chose and shows its patches and languages. The folder names do not matter. When you choose a folder, the launcher says in green or red what it found.

Your dump	What it looks like	Works?
Dumped from your own PS4 with a game dumper	eboot.bin, sce_module\, sce_sys\param.sfo… directly in each folder (base, update)	Yes
Extracted with PS4 PKG Tool	Image0\ (eboot.bin, sce_module, the game data) and Sc0\ (param.sfo and the rest of sce_sys)	Yes, from v0.3: choose the folder that holds Image0 and Sc0 and press Prepare the game. With v0.2.1, first copy everything in Image0 to that folder and everything in Sc0 to a new sce_sys folder in it
Any other tool	Works if the files end up in one of the two layouts above	Yes
A .pkg file that was not extracted		No: extract it first. Only the DLC tab takes .pkg files
The European edition (CUSA14876)		Yes, from v0.5.3, also online with the USA edition
Another region or edition (JP…)		No: each one has a different executable
Encrypted files (straight from a disc or an official package)	eboot.bin could not be read as a decrypted PS4 executable	No: dump the game again

Both builds of the 1.21 update work (for firmware 5.05 and for 6.72+). If something fails, the launcher's log and user\last_run.log say which file is missing; attach last_run.log when you open an issue.

Or build it yourself:

1. Install MSYS2 to C:\msys64 and the packages listed in packaging/windows/README.md.
2. In the MSYS2 CLANG64 shell: git clone --recursive <this repository>, then bash build.sh (builds out/sacredfire.exe).
3. Merge the 1.21 update over the base game without copying it: python tools/merge_update.py <CUSA13795> <CUSA13795-patch> <CUSA13795-1.21>.
4. Run: set BB_GAME_DIR=<CUSA13795-1.21> and C:\msys64\clang64\bin\python.exe run.py. In the game, Insert (or L3+R3) opens the port's menu.

For local builds, GitHub Actions builds, and tagged releases, follow the desktop build guide.

CPUs without MOVBE, BMI1 or LZCNT (Sandy Bridge, Ivy Bridge) also need iced-x86 for the Python that runs run.py, which the port uses to rewrite those instructions at start (15-isa-rewrite.md, issue #31). MSYS2's Python cannot install the wheel: use a python.org Python 3 (pip install iced-x86) or the portable ZIP from Releases, which bundles it.

Credits

This fork stands on the work of:

• T3CHNOLOG1C: SacredFire, the native port of CTR Nitro-Fueled this fork is built from.
• deadinside28: bbport, the native Bloodborne port whose loader, runtime and renderer SacredFire builds on.
• Supermedo: the Windows port of bbport (branch windows), whose Windows layer is merged here.
• shadPS4: the video core and shader recompiler.
• illusion and TroyWarez: the game patches (illusionyy/PS-Game-Patch).
• IFreemz: shadPS4-Bloodborne-DLSS-FSR, whose DLSS bridge (MIT, dlss_bridge/) and NGX loader this fork uses.
• FireBurn/FSR-Vulkan: AMD FidelityFX FSR 3.1 on Vulkan (MIT).
• NVIDIA DLSS: nvngx_dlss.dll from the NVIDIA DLSS SDK, redistributed under its license (in licenses\ of the package). NVIDIA, the NVIDIA logo, DLSS and GeForce RTX are trademarks and/or registered trademarks of NVIDIA Corporation. The GPL program contains no NVIDIA code: it loads the separate bridge DLL when present.
• Windows port of SacredFire: GetLostIn, with Claude (Anthropic).
• Online (this fork) and the RyuNET server: Ryu7w7, with Claude (Anthropic).
• leomoon: Linux crash diagnostics.
• Camiloop: the "Unlock Everything" patch.

Licensed under the GNU GPL v2 or later, as SacredFire, bbport and shadPS4. The rest of this README is SacredFire's own (Linux, Steam Deck).

---

SacredFire

SacredFire runs Crash Team Racing: Nitro-Fueled (PlayStation 4, CUSA13795, update 1.21) as a native x86-64 Linux executable. It is built on bbport (GPL-2.0-or-later), the native Linux port of Bloodborne: the game's own code runs on the CPU, a small runtime replaces the PS4 system libraries, and a renderer derived from shadPS4 translates the PS4 GPU work to Vulkan. Developed and tested on a Steam Deck.

No game files are included. You need your own dump of the game and its 1.21 update. Both builds of the 1.21 update work: the one for firmware 5.05 (the reference) and the one for 6.72+ (since v0.2.1). This project is not affiliated with or endorsed by Sony Interactive Entertainment, Activision or Beenox. Crash Team Racing, Nitro-Fueled and PlayStation are trademarks of their owners, named here only to identify the game this software runs.

Status: playable. Menus, arcade and adventure races with sound, controller and saving; split screen with a second controller; fur and the sky render correctly. 30 FPS as on the PS4, or the 60 FPS patch from the in-game menu (60 FPS in menus, 37–45 FPS in races on the Steam Deck). A full play-through has not been verified, and the Steam Deck (RADV) is the only tested machine.

How it works

• Native execution. The eboot is converted offline (scripts/) into a flat memory image with the game's own PS4 libc, libSceFios2 and libSceNpToolkit2 linked in as native code. No CPU emulation: the game code runs at full speed.
• A runtime for this game (src/runtime_*.c) implements the PS4 OS functions the game calls: memory, threads, synchronisation, event flags, files, audio (ATRAC9 included), pad, saves, user service, network stubs. Imports are resolved by NID and library name; the names come from shadPS4's aerolib list, fetched once at the first start.
• GPU (gpu/): the vendored shadPS4 video core and shader recompiler with bbport's multi-threaded command processing (decode and draw recording on separate threads) and SacredFire's fixes: geometry-shader ring addressing (fur), 1D textures lowered to 2D (the sky's colour LUT), texture overlap resolution at 1080p, PM4 stream resynchronisation, a reliable on-disk shader cache.
• Game patches from illusionyy/PS-Game-Patch (patches/CrashTeamRacing.xml, authors illusion and TroyWarez) are compiled at start: 60 FPS unlock, motion blur off, 1080p in PS4 Pro mode (the published address of that one was off by one byte; our copy is corrected).

Requirements

• Linux x86-64 with a Vulkan 1.3 GPU. Tested: Steam Deck (AMD Van Gogh, Mesa RADV). Geometry shaders are required (fur), so macOS/MoltenVK is out; see docs/sacredfire/10-other-platforms.md.
• Or Windows 10 (1903+)/11 64-bit with a Vulkan 1.3 GPU, built with MSYS2 CLANG64: see packaging/windows/README.md. Tested: Windows 11, NVIDIA RTX 3070.
• Your decrypted dump of CUSA13795 with the 1.21 update merged in: copy the dumped update over the base game, replacing files (eboot.bin and sce_sys too), or use tools/merge_update.py (it also reads PS4 PKG Tool's Image0 + Sc0 layout; see "Which game dumps work" above). The launcher and run.sh check the executable image and say what is missing (BB_SKIP_GAME_CHECK=1 skips the check).
• To build: GCC, CMake, Ninja, Python 3 (for CPUs without MOVBE, BMI1 or LZCNT, pip install iced-x86: 15-isa-rewrite.md), glslang, SDL3, Vulkan headers and the libraries in shell.nix (with Nix, shell.nix provides them). On Arch: tools/deps.sh fetches the header-only libraries the distribution lacks.

Build and run

git clone --recursive https://github.com/T3CHNOLOG1C/SacredFire.git && cd SacredFire
bash build.sh                        # out/sacredfire and out/gpu/libbbgpu.so (~40 CPU-minutes)
BB_GAME_DIR=/path/to/CUSA13795 bash run.sh

run.sh prepares the image (out/), compiles the selected patches, builds if needed and starts the game. The game folder defaults to orig/CUSA13795. Saves and the shader cache go to user/, settings to bbport.ini; BB_DATA_DIR moves all of them. The first start compiles shaders as it goes; later starts preload them from the cache (BB_CLEAR_SHADER_CACHE=1 starts fresh).

Or the launcher (pick the game folder and the controller, then Start):

bash launcher/bb-launcher.sh         # launcher/install-desktop.sh adds it to the app menu

The launcher (GTK4/libadwaita) has pages for the game folder, the controller, the game patches, PS4 Pro mode, display (fullscreen, FPS counter) and developer switches (frame statistics, log to a file, clear the shader cache, Vulkan validation, extra environment), and shows the game's output. --play starts the game with the saved settings and no window (Steam Deck game mode). The menu entry and the launcher use the game's own icon (sce_sys/icon0.png), copied from your game folder into your icon theme; the game window shows it too.

Native LZMA decoder (Linux). Recognized CTR 01.21 executables use liblzma for independent archive blocks, keeping the original compressed game files and requiring no disk cache. The patch checks the decoder and its one-shot caller before installing; unsupported layouts and blocks retain the original decoder. Set BB_NATIVE_LZMA=0 in the launcher's extra environment to compare or disable it. The streaming queue keeps the game's four workers to limit concurrent memory use. BB_LZMA_WORKERS=6 experimentally enables six on hosts with at least eight logical CPUs. Source builds require liblzma 5.4 or newer (xz in shell.nix).

In-game menu (Insert, or L3+R3 on the pad): game patches, controller ports for split screen, FPS limit, fullscreen, FPS counter, menu language. It is saved to bbport.ini; patches apply after a restart.

Controllers. SDL3 gamepads; the launcher's Controller page or BB_GAMEPAD=<GUID or part of the name> picks the one for port 1, and the port switches to whichever pad was used last when the chosen one is missing. Split screen: assign pads to ports 2–4 in the in-game menu (or port.N=<GUID> in bbport.ini); each port logs a user in and out as the pad comes and goes. The keyboard works next to a gamepad: WASD left stick, arrow keys right stick, Space Cross, LShift Circle, E Square, Q Triangle, 1/3 L1/R1, R/F L2/R2, Z/C L3/R3, Enter Options, IJKL d-pad. The launcher's Keyboard page rebinds them (key.<input>= lines in bbport.ini; pad.<input>= rebinds gamepad buttons).

Achievements (v0.4). The game's trophies unlock as on a PS4: each one is kept in user\trophies\<TITLE_ID>\unlocked.txt with its date, shows a notice over the game, and the platinum comes once all the others are. The launcher's Achievements tab shows them with their pictures (from sce_sys\trophy\trophy00.trp), progress, dates and a reset (with a backup). Names, descriptions and grades are encrypted in the game with the PS4's trophy key, which this port does not include: with your own key (the same shadPS4 uses; paste it, or import it from shadPS4's keys.json) they are decrypted as shadPS4 does and kept in trophies.tsv.

PS4 Pro mode (BB_NEO=1, the launcher's switch): the game sees a PS4 Pro (7-CPU mode, 5568 MiB of direct memory) and takes its Pro rendering path; with the 1080p patch it renders at 1920×1080. Off by default: the Steam Deck is closer to a base PS4.

Mods (Windows): the Mods page lists built-in patches first, followed by installed add-ons. Add .pak, .zip, .xml files or an unpacked folder to mods/ beside the launcher, using Add files / Add folder or copying them there and pressing Reload. Manifest packages can combine assets and executable patches under one switch; creator descriptions appear when the card's chevron is expanded. Legacy patches/ is still read. See the creator and packaging guide and implementation notes, also available from the Mods page. No actual mod payloads are bundled with this feature. Online compatibility is a package declaration, not a server approval or whitelist service.

Enabled mods override matching relative paths through the engine's read-only file map and sparse archive overlays. The selected source game directory stays unchanged: no original game files are copied, linked, repacked or overwritten. Disabling mods restores source reads. Only mod payloads, generated metadata and separate user saves/ shader caches are stored. This path requires the matching updated engine, not only new launcher scripts. Multiple versions of a stable mod ID appear once, using the newest validated version; older inputs remain available for rollback. Different content claiming the same selected version is reported as a conflict.

Mods do not need an engine-version/hash allowlist. Older manifests containing those fields still load; the fields are no longer a launch gate. Engine features are negotiated automatically, while game executable hashes, resource checksums, XML signatures, conflicts and online declarations remain enforced.

The existing loose-folder CLI loader and mods.json remain available for older workflows (docs/MODS.md, originally written for bbport). The unified Mods UI/import flow is Windows-only in this revision; AppImage run.sh integration is not included.

AppImage (Steam Deck)

packaging/appimage.sh builds dist/SacredFire-x86_64.AppImage (about 430 MB) with Nix: the binaries are built in nix-shell shell.nix so the bundle can collect their libraries, then nix bundle packs them with the GTK launcher, Python and Mesa's Vulkan drivers (the header of the script has the exact steps). Running it opens the launcher; --play starts the game. Data lives in ~/.local/share/sacredfire, launcher settings in ~/.config/sacredfire-launcher. Without a game folder chosen, the launcher shows the Game row as not chosen with Play disabled until a folder passes the game check.

The desktop build guide has the GitHub Actions workflow, Nix commands, version checks, Windows ZIP steps, and output checks.

Adding the AppImage to Steam: the launcher's Settings → Steam → Add to Steam writes the shortcut (with --play, for the Steam Deck's game mode) while Steam is closed; by hand, Add a Non-Steam Game needs no options. The compatibility tool does not matter. Steam's overlay is removed before the port's own programs start. Where Steam runs games without FUSE, set the launch options to

TMPDIR=$HOME/.cache APPIMAGE_EXTRACT_AND_RUN=1 NO_CLEANUP=1 %command%

The AppImage then unpacks itself (~1.2 GB, ~/.cache/appimage_extracted_*) on the first start and reuses that copy; TMPDIR keeps that out of a RAM-backed /tmp. Add --play after %command% to skip the launcher. NVIDIA: startup discovers the host's 64-bit NVIDIA Vulkan ICD and exposes its libraries next to the bundled AMD/Intel drivers (BB_NVIDIA_LIB_DIR when they are not under /usr/lib*); --vulkan-info prints what the package sees. MangoHud is bundled (launcher switch) and drawn once even when a system MangoHud or Steam's overlay is on.

Useful variables

BB_GAMEPAD (controller for port 1), BB_NEO=1 (PS4 Pro mode), BB_FPS=30|60 (virtual vblank; the 60 FPS patch sets 480 Hz by itself), BB_FRAME_STATS=1 (frame statistics in the log, including VRAM, GTT and RSS), BB_CLEAR_SHADER_CACHE=1, BB_VK_VALIDATION=1 (validation layer), BB_FULLSCREEN=1, BB_PRESENT_MODE, BB_TIMEOUT=N (stop after N seconds with thread stacks; 0 = never), BB_GAME_DIR, BB_USER_DIR, BB_DATA_DIR, BB_CONFIG, BB_PATCHES_DIR, BB_SKIP_GAME_CHECK=1, BB_PAD_RECORD=file / BB_PAD_REPLAY=file (record and replay input), BB_PRESENT_DUMP_TRIGGER=file with BB_PRESENT_DUMP_COUNT=N (dump presented frames), BB_CAPTURE_TRIGGER=file (frame analysis), BB_BREADCRUMBS=0 (no GPU breadcrumbs), BB_GPU_PROFILE=1, BB_ANISO=N (anisotropic filtering, 16 by default), BB_PC_MODEL=1 (bbport's experimental in-place memory model: frees CPU time but needs more GPU-visible memory than the Steam Deck has). bbport's temporal upscalers (BB_UPSCALER, BB_OBJECT_MOTION, BB_UPSCALER_MENU=1 for their menu sections) were built for Bloodborne's scene and stay off.

Repository layout

Path	Contents
src/	Loader (probe.c) and the runtime
scripts/	Offline preparation of the game image, module linking, game check, patch compiler, mods
gpu/	Renderer library: vendored shadPS4 video core (gpu/VENDOR.txt) with bbport's and SacredFire's changes, shims, ImGui menu
patches/	Community patches for CTR (CrashTeamRacing.xml)
launcher/, packaging/	GTK4 launcher and desktop entry; Nix package and AppImage
tools/	Developer tools: import-name generation, scripted runs, screenshots, A/B toggles, GPU checks
tests/	Loader, runtime, patch, game-check and renderer tests
docs/sacredfire/	SacredFire's notes: status, setup, imports, Bloodborne gating and removal, fur, controllers, patches, other platforms
docs/	bbport's design notes and history (upscaler, parallel GPU, motion vectors, roadmap); its README: docs/bbport/README.md (Русский)

Tests: bash build.sh --test, python3 -m unittest discover -s tests, and ninja -C out/gpu motion-history-test ui-composition-test scene-resolution-test motion-shader-test settings-test.

Reporting problems and contributing

Use the bug report template; the log (launcher Log tab or run.sh output, with BB_FRAME_STATS=1 for rendering and performance issues) is what matters. If the log says SacredFire issue #2 (the launcher shows a notice with an Open issue #2 button), the game hit the known clobbered command buffer bug: please attach that whole log to issue #2, it carries the diagnostics that can find the cause. No game files in issues or pull requests. See CONTRIBUTING.md.

Known limitations

• Races with the 60 FPS patch reach 37–45 FPS on the Steam Deck: the port's GPU command thread is the limit at ~1400 draws per frame (docs/sacredfire/08-patches.md).
• Online features are stubbed in SacredFire; this fork plays online (see Online).
• Windows: native build, from source only for now, without the GTK launcher and without the PC memory model (packaging/windows/README.md).
• macOS is not supported (docs/sacredfire/10-other-platforms.md).

History

SacredFire started from bbport on 2026-10-09. The Bloodborne profile, its patches, launcher and FSR 4 tooling were removed the same day (docs/sacredfire/09-bloodborne-strip.md). bbport's temporal upscalers and motion vectors remain in gpu/, off; its libGnm hook code remains without a function table (the table was generated from Bloodborne's executable and is not distributed).

Credits and licenses

SacredFire is licensed under the GNU GPL v2 or later (LICENSE): it contains code from bbport and shadPS4 (both GPL-2.0-or-later). Third-party components keep their licenses: bbport by deadinside28 (the loader, runtime and renderer this builds on), shadPS4 video core and shader recompiler, sirit, half, FSR-Vulkan by FireBurn (MIT), AMD FidelityFX SDK (MIT), LibAtrac9 (MIT), Dear ImGui (MIT), DejaVu fonts, miniz (MIT). Game patches by illusion and TroyWarez (illusionyy/PS-Game-Patch). Import names from shadPS4's aerolib list.

Aspect ratio

Display settings offer 16:9 (default), 16:10, 21:9 and 32:9. The in-game Graphics page offers the same choices after a restart. 16:10 supports 1280x800, 1920x1200 and 2560x1600 through its own display/camera preparation, with aligned HUD effects (including Adventure collectibles and the filling drift gauge) and corrected gauge proportions. The original menu layout is retained. See aspect ratio settings and 16:10 verification.

Corrected widescreen layouts (Windows)

The 21:9 and 32:9 layouts include menu/background/HUD asset fixes and centered-HUD shaders. The initial integration is for the tested USA 1.21 game and official v0.5.3 Windows engine, offline. See setup, verification and limitations.