Speed Force
Speed Force is a native Windows port of Justice League Heroes that adds modern PC features like high resolutions and frame generation.
- Type: PC port
- Game: Justice League Heroes
- Runs on Windows
- By GhostDucky13
- Latest release v2.0.0, 2026-11-15
- Source: https://github.com/GhostDucky13/Speed-Force-Justice-League-Heroes-Windows-Recompilation
README
Speed Force
An unofficial native Windows version of Justice League Heroes (2006), built on your PC from your own Xbox and PSP discs.
Speed Force statically recompiles the original Xbox game into a native x64 Windows program, adds the content that was only on the PSP version, and adds modern PC features: high resolutions, 240 Hz frame generation, DLSS / FSR / XeSS, anti-aliasing, modern controllers and more. See FEATURES.md for a detailed explanation of everything.
Highlights
- A real native PC game: the Xbox program is translated to C and compiled for Windows (no emulator), with a Direct3D 11 renderer, XAudio2 audio and SDL3 controllers.
- Speed Force frame generation up to 240 Hz, DLSS / FSR / XeSS, FXAA / TAA, up to 4x resolution scale, widescreen.
- Challenge Missions are unlocked, with fully maxed-out heroes: they are meant for after you beat the game. Chapter Select is unlocked the same way.
- A character selector at the start of each mission when you play from Chapter Select, with only flying heroes offered for the flying levels (for example in space). It keeps appearing for every level after that, like a New Game Plus.
- Supergirl and Black Canary unlocked, brought over from the PSP version, plus the PSP's Challenge Missions and three PSP-only story levels.
- A Costume button in the character selector for Chapter Select and Challenge Missions, with Wonder Woman's last-mission costume available too.
- Two players on one PC, each with their own controller, or online with a friend on another PC (the launcher's Online page).
- Bring your Xbox saves over; completed saves start Episode 1 the Chapter Select way.
Two versions are available on Releases:
- 2.1.x (stable, "Latest"): everything below except online play.
- 3.0.2 (pre-release): adds online play (guide). It works in our tests, but hasn't been tried by many players yet: please report how it goes. Both versions use the same saves and settings, so you can switch between them.
No game code or data is included in this repository or in the setup. You need your own dumps of both discs. The setup rebuilds everything on your PC from them.
What you need
- Windows 10 or 11, 64-bit, or Linux / Steam Deck (see below)
- A DirectX 11 graphics card (DLSS needs an NVIDIA RTX card; FSR and XeSS run on any modern GPU)
- About 14 GB free disk space while the game is built (12 GB, plus 2 GB to be safe); about 5 GB afterwards
- Your own dumps (disc images) of:
- Justice League Heroes for the original Xbox (USA)
- Justice League Heroes for the PSP (USA)
How to make the dumps from discs you own: docs/DUMPING.md.
Installing
- Download
SpeedForce-Setup-<version>.exefrom Releases (the stable 2.1.x, or the 3.0.2 pre-release for online play) and run it. It's one program, the Speed Force Builder: no administrator rights are needed. - Game files: choose where to install (by default
%LOCALAPPDATA%\Programs\Speed Force) and your Xbox and PSP disc images. Each one is checked on the spot, and so is the free space. - Options: optionally, a folder of saves copied from an Xbox (see docs/SAVES.md), and a desktop shortcut.
- Build: the builder unpacks its tools, checks your dumps, extracts them, rebuilds the mod,
translates the game program to C and compiles it, all on your PC, with every step, its time
and the time left on screen (about 20-40 minutes; Show details shows the full log, which is
also saved as
install.log). When it's done, press Play.
Two programs are installed:
- Speed Force (
SpeedForceLauncher.exe, in the Start menu and on the desktop): Play, the main settings, your save slots and Xbox save import, the update check, and Uninstall. - Speed Force (game only) (
SpeedForce.exe): the game itself. It runs on its own too; press F10 in game for every setting.
Your saves are in the saves folder inside the install folder, and your settings in
config\config.toml. Uninstall from the launcher's About page or from Windows Settings > Apps;
you can keep your saves and settings.
The launcher checks this repository's Releases when it opens and offers a newer version when there is one (it only asks GitHub for the list of releases; nothing about you or your PC is sent). The 2.x versions offer stable releases only; the 3.0.2 pre-release also offers newer pre-releases.
Supported dumps (SHA-1 of the whole image):
| Disc | SHA-1 |
|---|---|
| Xbox (USA) | 76ec8ba8466ecc32b5129c2513707c8e59f687e8 |
| PSP (USA) | 87055c512472e8fd160361a84c2fb5444bba422d |
Other dumps are refused by default, because the mod tools patch exact byte offsets.
Linux and Steam Deck
Download SpeedForce-<version>-x86_64.AppImage from Releases (the stable 2.1.x,
or the 3.0.2 pre-release for online play), make it executable (right-click > Properties > Allow
executing, or chmod +x SpeedForce-<version>-x86_64.AppImage) and
open it. The same builder opens, with the same steps: choose the install folder (by default
~/Games/Speed Force) and your two dumps, and it builds the game on your PC. It needs about 9 GB
free while building and about 5 GB afterwards. When it's done, the AppImage is the launcher
(Play, settings, saves, update check, uninstall); it also adds Speed Force to your app menu.
The game itself is the Windows SpeedForce.exe, so it runs through a compatibility layer. The
launcher picks one for you (you can change it on the About page, under "Run the game with"):
- Proton, when Steam is installed (the newest numbered Proton or GE-Proton it finds; Proton Experimental if that is the only one). This is the best choice, and the one a Steam Deck uses.
- Wine installed on your system.
- Otherwise, the built-in Wine in the AppImage (Wine 11 with DXVK and vkd3d-proton), so nothing else has to be installed.
Notes:
- Your graphics driver needs Vulkan (any GPU from the last 10 years with Mesa or the NVIDIA
driver). Without Vulkan, start the AppImage with
SPEEDFORCE_WINED3D=1(Wine only, not Proton) to use Wine's OpenGL renderer instead; it is slower and frame generation may not be available. - DLSS needs Proton with an NVIDIA RTX card; FSR and XeSS work everywhere.
- The game's log for the Linux side is
SpeedForce-linux.login the install folder. - Needs a Linux from 2021 or later (glibc 2.34: Ubuntu 22.04, Debian 12, Fedora 35, SteamOS 3 or newer), because of the compiler it carries. The builder tells you if yours is older.
- The launcher follows your desktop's light or dark setting; change it under "Theme" at the bottom of the sidebar.
- Updates: the launcher tells you when there is a new version, and the AppImage carries update information, so AppImageUpdate (or a tool like Gear Lever) can update it in place.
Playing online
In the 3.0.2 pre-release.
Two players on two computers, through the launcher's Online page: one player hosts, the other joins with the address the host's window shows. Both computers run the whole game and swap only their controllers every frame, so the game plays exactly as two players on one couch. Windows and Linux / Steam Deck can play together in any combination.
Step-by-step guide: docs/ONLINE.md: Windows and Windows, Linux and Linux, Linux and Windows, port forwarding, Tailscale / ZeroTier, firewalls and troubleshooting.
In short:
- Both players need the same Speed Force version, built from the USA discs, with no mods. The game checks this when you connect.
- The host's saves are used for the session (the joiner's own saves are left alone). Pick Two Players in a new game or Chapter Select, or add player 2 from the pause menu.
- Connecting: on the same home network, join with the host's local address. Over the internet, the host's PC asks the router to open the port (UPnP); if that doesn't work, forward the TCP port (default 47001) on the host's router, or both join the same free Tailscale or ZeroTier network and use that address.
- Input delay is set from the ping when you connect: about 4 to 8 frames (0.07 to 0.13 s). If one PC falls behind, both wait for it.
- Your PC needs some headroom: online play runs the game in a strict, step-by-step mode so both PCs stay identical, which costs more CPU than normal play. If the game runs below 60 fps online, lower the resolution scale and turn off frame generation.
- If a player leaves, the other can keep playing. If the two games ever get out of sync, the game says so; start the online session again.
Controls
Xbox, PlayStation (DualSense / DualShock), Nintendo (Switch Pro, Joy-Con, GameCube adapters) and most other controllers work, with matching button icons in game. Keyboard: WASD move, IJKL camera, Z / X / C / V = A / B / X / Y, Enter = Start, F10 = settings, F11 = fullscreen. Every button can be remapped in F10 > Controls.
Building from source
See docs/BUILDING.md. In short: the builder (launcher/sfbuilder.c) carries
a build kit and runs setup/sf_install.py, which does the same steps a developer would: extract,
setup/sf_buildmod.py, the xboxrecomp pipeline, CMake + Ninja + LLVM-MinGW. The builder and the
launcher are plain Win32 C with a small shared UI (launcher/sfui.h).
Repository layout
| Folder | What it is |
|---|---|
toolkit/ | Fork of the xboxrecomp static recompilation toolkit (runtime, D3D11 renderer, audio, input, the F10 menu, Speed Force frame generation) |
game/ | The Justice League Heroes port: entry point, settings, lifter seeds. The translated game code is generated during setup, never committed |
jlh-upscale/ | DLSS / FSR / XeSS bridge (jlh_upscale.dll) |
setup/modtools/ | The mod's tools: XBE patcher, menu and data editors, PSP to Xbox character and level converters |
setup/ | Disc extractor, mod builder, save importer and the build steps the builder runs |
launcher/ | The Speed Force Builder (the setup) and launcher, their UI and the build-kit packer |
linux/ | The Linux AppImage: builder and launcher (Python / Tk), AppDir packer, fonts |
assets/ | Button icon pack (generated, original artwork) |
docs/ | Dumping, building, and the mod's technical notes |
Known issues
-
Online play (3.0.2 pre-release): the deterministic mode it needs is slower than normal play, so weaker PCs may run below 60 fps online. Tested with two copies on one Windows PC and on Linux, and Windows against Linux with the same inputs; not yet between two players over the internet. Reports are welcome.
-
Episode 5, Mars (e5l1): laser fire can be invisible, too many meteors appear, and some debris textures vanish.
Acknowledgements
Speed Force stands on the work of many people. Thank you to:
- sp00nz and the contributors of xboxrecomp, the static recompilation toolkit and Xbox runtime that this whole port is built on.
- Snowblind Studios, for making Justice League Heroes, and everyone who worked on the Xbox and PSP versions.
- The xemu team for dsp56300, which brings the original DSP audio effects back, and for years of documenting the Xbox.
- The SDL team, for making every controller just work.
- Martin Storsjö for LLVM-MinGW, and the LLVM, CMake and Ninja projects, which compile the game on your PC.
- The Capstone engine, the disassembler behind the recompiler.
- Python, NumPy and Pillow, which run the setup and the mod tools.
- NVIDIA (DLSS), AMD (FidelityFX) and Intel (XeSS) for their upscalers.
- SnowflakePowered for librashader.
- The DejaVu fonts project, and Rasmus Andersson for the Inter typeface.
- Everyone in the Xbox and PSP preservation and modding communities whose research made the formats in this game understandable.
If your work is used here and you're missing from this list, please open an issue.
Legal
Speed Force is a fan project. It is not affiliated with, endorsed or sponsored by Warner Bros. Games, DC, Snowblind Studios or Eidos. Justice League Heroes and all related names and trademarks belong to their owners. Read LEGAL.txt.
The project's own code is under the MIT License. Third-party components keep their own licenses: see THIRD_PARTY_NOTICES.md.