Skip to content
RetroBIOS

SplitWolf

SplitWolf emulates Wolfenstein 3D. It reads 46 files, none of them required: it starts games without them.

About this profile
Detail Value
Type standalone
Classification Game engine
Source https://bitbucket.org/linuxwolf6/splitwolf
Version V1.01
Revision linuxwolf6/splitwolf@f6c00044cdef, branch scrubbed
Profiled 2026-10-20
Profile YAML, JSON
Cores splitwolf
Systems Wolfenstein 3D
Checks the file by existence
Install this emulator's files

With RetroPie: the installer finds RetroPie and its BIOS folder, then downloads only the files SplitWolf reads there and checks each one.

Open a terminal on the device. Or connect from a computer with SSH, a terminal over the network. Paste the line. Press Enter.

Terminal
curl -fsSL https://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh -s -- --emulator splitwolf
Technical notes

Two to four player split screen fork of the C++ Wolf4SDL by Team RayCast (version.h:95), based on Wolf4SDL v1.7 SVN revision 256 (wl_main.cpp:2211). The Makefile builds one binary per release: VERSION_WOLF3D_SHAREWARE, VERSION_WOLF3D_APOGEE, VERSION_WOLF3D, VERSION_SPEAR, VERSION_SPEAR_MP and VERSION_SPEAR_DEMO, each turning on the Wolf4SDL defines in version.h:13-34. RetroPie builds all six.

Data files are opened under DATADIR, a path compiled in by the Makefile (Makefile:57, 151), /usr/local/share/games/wolf3d/ by default. RetroPie sets it to its ports/wolf3d ROM folder. A file that cannot be opened ends in CA_CannotOpen and the program quits.

CheckForEpisodes (wl_menu.cpp:5194) probes for vswap.<ext>: wl1 for the shareware build, wl6 then wl3 then wl1 for the full ones, sdm for the Spear demo, sod or sd1 after --mission 0 or 1 for Spear of Destiny, sd2 or sd3 after --mission 2 or 3 for the mission pack build (wl_main.cpp:2015-2040). Unlike Wolf4SDL, every Spear build reads its graphics and audio files under the sod extension (wl_menu.cpp:5341-5342) and only vswap, maphead and gamemaps under the mission extension, so the mission packs need the original game beside them.

vgahead must hold one three byte offset per chunk, less the missing episodes, or the engine quits (id_ca.cpp:482-496).

The split screen sprites, pictures and sounds are read from the lwmp directory (id_lwmp.cpp:21), or from the directory given with --splitdatadir (wl_main.cpp:2127-2137). Each lookup tries a lowercase .bmp then .BMP, and .wav, .ogg, .WAV, .OGG for sounds (id_lwmp.cpp:1831-1868, 2086-2105, id_sd.cpp:556-572). When a file is missing the engine falls back to the sprite or picture of the game data (id_lwmp.cpp:3301-3313, 3412-3445), so the directory is optional. The project publishes it as lwmp.zip in its downloads, which RetroPie extracts beside the binaries.

The shareware Wolfenstein 3D v1.4 and Spear of Destiny demo files carry hashes of the archives RetroPie downloads. The retail files carry none: the engine checks no hash, and the md5 table in RetroPie's launcher script only picks which binary to start.

Written by the engine, not read as data: config.<ext> and savegames in ~/.splitwolf.

Files

Section titled “Files”

46 files: 0 required, 46 optional. 2 more files come with the app.

By kind: 48 game data.

48 rows
File Required Hash
vswap.wl1 no MD5 6efa079414b8
vgadict.wl1 no MD5 76a6128f3c0d
vgahead.wl1 no MD5 61bf1616e783
vgagraph.wl1 no MD5 74decb641b1a
maphead.wl1 no MD5 7b6dd4e55c33
gamemaps.wl1 no MD5 30fecd7cce6b
audiohed.wl1 no MD5 58aa1b9892d5
audiot.wl1 no MD5 4b6109e957b5
vswap.wl3 no -
vgadict.wl3 no -
vgahead.wl3 no -
vgagraph.wl3 no -
maphead.wl3 no -
gamemaps.wl3 no -
audiohed.wl3 no -
audiot.wl3 no -
vswap.wl6 no -
vgadict.wl6 no -
vgahead.wl6 no -
vgagraph.wl6 no -
maphead.wl6 no -
gamemaps.wl6 no -
audiohed.wl6 no -
audiot.wl6 no -
vswap.sod no -
vgadict.sod no -
vgahead.sod no -
vgagraph.sod no -
maphead.sod no -
gamemaps.sod no -
audiohed.sod no -
audiot.sod no -
vswap.sd2 no -
maphead.sd2 no -
gamemaps.sd2 no -
vswap.sd3 no -
maphead.sd3 no -
gamemaps.sd3 no -
vswap.sdm no MD5 35afda760bea
vgadict.sdm no MD5 2f85b6763a58
vgahead.sdm no MD5 18c03cb401ed
vgagraph.sdm no MD5 1cc5ceb8e43c
maphead.sdm no MD5 40fa03caf7a1
gamemaps.sdm no MD5 4eb2f538aab6
audiohed.sdm no MD5 f0022742f86c
audiot.sdm no MD5 fcde1333c941
lwmp/ with the app -
gamecontrollerdb.txt with the app MD5 3ccf989cc6c7

In this collection: 16 in repo and 30 missing.

Game data

Section titled “Game data”
46 files

vswap.wl1 optional in repo game data

Wolfenstein 3D shareware page file: wall textures, sprites and digitized sounds

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vgadict.wl1 optional in repo game data

Wolfenstein 3D shareware Huffman dictionary of the graphics file

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vgahead.wl1 optional in repo game data

Wolfenstein 3D shareware graphics chunk offsets

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vgagraph.wl1 optional in repo game data

Wolfenstein 3D shareware graphics chunks: pictures, fonts and text articles

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

maphead.wl1 optional in repo game data

Wolfenstein 3D shareware map offsets and tile info

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

gamemaps.wl1 optional in repo game data

Wolfenstein 3D shareware level maps

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

audiohed.wl1 optional in repo game data

Wolfenstein 3D shareware audio chunk offsets

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

audiot.wl1 optional in repo game data

Wolfenstein 3D shareware AdLib sound effects and music

  • Hashes of the v1.4 shareware file in wolf3d14.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vswap.wl3 optional missing game data

Wolfenstein 3D, three episode release page file: wall textures, sprites and digitized sounds

  • Source: id_pm.cpp:20-25, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

vgadict.wl3 optional missing game data

Wolfenstein 3D, three episode release Huffman dictionary of the graphics file

  • Source: id_ca.cpp:464-468, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

vgahead.wl3 optional missing game data

Wolfenstein 3D, three episode release graphics chunk offsets

  • Source: id_ca.cpp:475-497, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

vgagraph.wl3 optional missing game data

Wolfenstein 3D, three episode release graphics chunks: pictures, fonts and text articles

  • Source: id_ca.cpp:514-518, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

maphead.wl3 optional missing game data

Wolfenstein 3D, three episode release map offsets and tile info

  • Source: id_ca.cpp:556-560, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

gamemaps.wl3 optional missing game data

Wolfenstein 3D, three episode release level maps

  • Source: id_ca.cpp:575-580, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

audiohed.wl3 optional missing game data

Wolfenstein 3D, three episode release audio chunk offsets

  • Source: id_ca.cpp:636-641, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

audiot.wl3 optional missing game data

Wolfenstein 3D, three episode release AdLib sound effects and music

  • Source: id_ca.cpp:647-651, wl_menu.cpp:5283-5288, wl_menu.cpp:5354-5355

vswap.wl6 optional missing game data

Wolfenstein 3D page file: wall textures, sprites and digitized sounds

  • Source: id_pm.cpp:20-25, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

vgadict.wl6 optional missing game data

Wolfenstein 3D Huffman dictionary of the graphics file

  • Source: id_ca.cpp:464-468, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

vgahead.wl6 optional missing game data

Wolfenstein 3D graphics chunk offsets

  • Source: id_ca.cpp:475-497, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

vgagraph.wl6 optional missing game data

Wolfenstein 3D graphics chunks: pictures, fonts and text articles

  • Source: id_ca.cpp:514-518, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

maphead.wl6 optional missing game data

Wolfenstein 3D map offsets and tile info

  • Source: id_ca.cpp:556-560, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

gamemaps.wl6 optional missing game data

Wolfenstein 3D level maps

  • Source: id_ca.cpp:575-580, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

audiohed.wl6 optional missing game data

Wolfenstein 3D audio chunk offsets

  • Source: id_ca.cpp:636-641, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

audiot.wl6 optional missing game data

Wolfenstein 3D AdLib sound effects and music

  • Source: id_ca.cpp:647-651, wl_menu.cpp:5270-5281, wl_menu.cpp:5354-5355

vswap.sod optional missing game data

Spear of Destiny page file: wall textures, sprites and digitized sounds

  • Source: id_pm.cpp:20-25, wl_menu.cpp:5324-5342

vgadict.sod optional missing game data

Spear of Destiny Huffman dictionary of the graphics file

  • Source: id_ca.cpp:464-468, wl_menu.cpp:5324-5342

vgahead.sod optional missing game data

Spear of Destiny graphics chunk offsets

  • Source: id_ca.cpp:475-497, wl_menu.cpp:5324-5342

vgagraph.sod optional missing game data

Spear of Destiny graphics chunks: pictures, fonts and text articles

  • Source: id_ca.cpp:514-518, wl_menu.cpp:5324-5342

maphead.sod optional missing game data

Spear of Destiny map offsets and tile info

  • Source: id_ca.cpp:556-560, wl_menu.cpp:5324-5342

gamemaps.sod optional missing game data

Spear of Destiny level maps

  • Source: id_ca.cpp:575-580, wl_menu.cpp:5324-5342

audiohed.sod optional missing game data

Spear of Destiny audio chunk offsets

  • Source: id_ca.cpp:636-641, wl_menu.cpp:5324-5342

audiot.sod optional missing game data

Spear of Destiny AdLib sound effects and music

  • Source: id_ca.cpp:647-651, wl_menu.cpp:5324-5342

vswap.sd2 optional missing game data

Spear of Destiny mission pack 2 page file: wall textures, sprites and digitized sounds

  • Source: id_pm.cpp:20-25, wl_menu.cpp:5307-5313

maphead.sd2 optional missing game data

Spear of Destiny mission pack 2 map offsets and tile info

  • Source: id_ca.cpp:556-560, wl_menu.cpp:5307-5313

gamemaps.sd2 optional missing game data

Spear of Destiny mission pack 2 level maps

  • Source: id_ca.cpp:575-580, wl_menu.cpp:5307-5313

vswap.sd3 optional missing game data

Spear of Destiny mission pack 3 page file: wall textures, sprites and digitized sounds

  • Source: id_pm.cpp:20-25, wl_menu.cpp:5314-5320

maphead.sd3 optional missing game data

Spear of Destiny mission pack 3 map offsets and tile info

  • Source: id_ca.cpp:556-560, wl_menu.cpp:5314-5320

gamemaps.sd3 optional missing game data

Spear of Destiny mission pack 3 level maps

  • Source: id_ca.cpp:575-580, wl_menu.cpp:5314-5320

vswap.sdm optional in repo game data

Spear of Destiny demo page file: wall textures, sprites and digitized sounds

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vgadict.sdm optional in repo game data

Spear of Destiny demo Huffman dictionary of the graphics file

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vgahead.sdm optional in repo game data

Spear of Destiny demo graphics chunk offsets

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

vgagraph.sdm optional in repo game data

Spear of Destiny demo graphics chunks: pictures, fonts and text articles

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

maphead.sdm optional in repo game data

Spear of Destiny demo map offsets and tile info

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

gamemaps.sdm optional in repo game data

Spear of Destiny demo level maps

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

audiohed.sdm optional in repo game data

Spear of Destiny demo audio chunk offsets

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

audiot.sdm optional in repo game data

Spear of Destiny demo AdLib sound effects and music

  • Hashes of the file in soddemo.zip, the archive RetroPie downloads from maniacsvault.net. The engine checks no hash.

Comes with the app

Section titled “Comes with the app”
2 files

lwmp/ comes with the app game data directory

Split screen sprites, pictures and sounds

  • Source: id_lwmp.cpp:21, id_lwmp.cpp:1831-1868, id_lwmp.cpp:2064-2149, id_sd.cpp:556-572, wl_main.cpp:2127-2137
  • lwmp.zip (sha1 1145464c5adf84ffd692b46a97cafaddc2153734) from bitbucket.org/linuxwolf6/splitwolf/downloads holds sprites/ with one dir1 to dir8 folder per rotation, pics/ and sounds/. RetroPie downloads and extracts it into the install directory during installation, with no user action.

gamecontrollerdb.txt comes with the app game data

SDL game controller mappings

  • Size: 114.6 KB
  • SHA1: cf96adc4eb2262db4cc19612ca7730e5929d1799
  • MD5: 3ccf989cc6c79e0a9441dece1773d4fe
  • Source: id_in.cpp:453, Makefile:223, Makefile:388
  • Read from the working directory by SDL_GameControllerAddMappingsFromFile. Copied from the SDL_GameControllerDB submodule (commit 01275a5bbefbab17f274e60393cd75405f74feb3) into bin/ at build time.

Next steps

Section titled “Next steps”
.

Maintained by Abdess on GitHub. Report a problem.

Packs from release v2026.10.10, .

MIT for the tooling and metadata. BIOS and firmware files are third-party system software, preserved for personal backup, archival and interoperability.