SRB2 Persona
SRB2 Persona is a 3D Sonic the Hedgehog fangame based on Doom Legacy that supports stereoscopic 3D with seven display modes.
- Type: standalone game
- Runs on Windows
- By oneup03
- Latest release latest, 2026-09-04
- Source: https://github.com/oneup03/SRB2Persona3D
README
Sonic Robo Blast 2
Sonic Robo Blast 2 is a 3D Sonic the Hedgehog fangame based on a modified version of Doom Legacy.
Dependencies
- NASM (x86 builds only)
- SDL2 (Linux/OS X only)
- SDL2-Mixer (Linux/OS X only)
- libupnp (Linux/OS X only)
- libgme (Linux/OS X only)
- libopenmpt (Linux/OS X only)
Compiling
Windows (MinGW-w64, 64-bit)
Requires MinGW-w64 and make, run from git-bash. build.sh adds the default
chocolatey MinGW location (C:\ProgramData\mingw64\mingw64\bin) to PATH
automatically if it's there.
./build.sh # Release, then stage deploy/Release
./build.sh --clean # make clean first
./build.sh --debug # DEBUGMODE=1, staged into deploy/Debug
./build.sh --no-deploy # build only
build.sh builds bundled zlib/libpng, compiles bin/srb2win64.exe via
src/Makefile (MINGW64=1 SDL=1), and stages a directly runnable game folder
under deploy/<Release|Debug>: SRB2Persona.exe, the SDL2/audio runtime DLLs
from libs/, and the game data from assets/installer.
Two things the script handles that are easy to trip over:
- The bundled
libz64.adoesn't exist andlibpng64.ais stale (it references__iob_func, which current mingw-w64 no longer exports), so both are rebuilt from the sources inlibs/on every run. CPPFLAGS=-std=gnu17— this codebase predates the C23()-means-(void)change that became GCC's default in 14+.
The same script cross-compiles from Linux with gcc-mingw-w64-x86-64-win32,
which is what CI does.
In VS Code, Ctrl+Shift+B runs "Build SRB2 Persona (Release)"; Clean, Debug, and Run tasks are also wired up.
The src/sdl/Srb2SDL-vc10.vcxproj MSVC project still compiles (the source is
MSVC-clean), but the resulting binary renders incorrectly and is not
supported — use the MinGW build. Note that an MSVC build also creates an
objs/ directory, which makes src/Makefile refuse to run until you delete it.
Stereoscopic 3D
Seven display modes on the OpenGL renderer, under Video Options -> Stereoscopic 3D: Side-by-Side, Top-and-Bottom, Anaglyph (Dubois red/cyan), Row-Interlaced, Column-Interlaced, Checkerboard, and LeiaSR autostereoscopic. Eye separation, convergence plane, eye swap, and separate HUD/crosshair depth are all adjustable.
LeiaSR needs leiasr_shim.dll, an MSVC-built bridge to the Simulated Reality
runtime -- MinGW can't link the SR SDK directly. build.sh builds it when
Visual Studio and the libs/SR-lib submodule are present, and skips it
otherwise; if the DLL, the SR runtime, or SR hardware is missing at runtime,
LeiaSR simply falls back to Side-by-Side.
libs/SR-lib (bo3b/SR-lib) is a private repository. Locally that's
transparent as long as your git credentials can reach it. In CI it needs a
personal access token with read access to it, stored as the SUBMODULE_PAT
repository secret -- without it the shim job skips with a warning and the
Windows zip ships without LeiaSR. Every other stereo mode is unaffected.
Game data
The v1.3.6 data files (srb2.pk3, SRB2P-*.pk3 / .wad, patch.pk3) are
tracked in assets/installer/, so a fresh clone builds into a playable game
with no extra downloads.
CI
.github/workflows/build.yml runs the same build.sh on ubuntu-latest
(cross-compiling with MinGW-w64), zips deploy/Release, and attaches it to a
rolling latest pre-release on every push to srb2p_22. Pushing a tag
publishes a permanent release.
For upstream's build instructions see SRB2 Wiki/Source code compiling
Disclaimer
Sonic Team Junior is in no way affiliated with SEGA or Sonic Team. We do not claim ownership of any of SEGA's intellectual property used in SRB2.