Let's play Wolfenstein-3D!


People on this forum have shown how to run games like Doom and Quake natively on the GameShell with a good performance!

This is such a method to play Wolfenstein-3D and Spear of Destiny!

Steps for the Game Engine (Wolf4SDL)

First, the tricky part. We are going to install the game engine called ‘wolf4sdl’. However, it has nonfree dependencies. Therefore:

  1. Append ‘contrib’ to your main repository in /etc/apt/sources.list:
sudo sed -i -- '/^deb .*stretch main$/ s/$/ contrib/' /etc/apt/sources.list

The /etc/apt/sources.list should now look like this (assuming you have not set the repo to your own country):

# deb http://debian-mirror.sakura.ne.jp/debian/ stretch main

deb http://debian-mirror.sakura.ne.jp/debian/ stretch main contrib
deb-src http://debian-mirror.sakura.ne.jp/debian/ stretch main

deb http://security.debian.org/debian-security stretch/updates main
deb-src http://security.debian.org/debian-security stretch/updates main

# stretch-updates, previously known as 'volatile'
deb http://debian-mirror.sakura.ne.jp/debian/ stretch-updates main
deb-src http://debian-mirror.sakura.ne.jp/debian/ stretch-updates main
  1. Install the game engine:
sudo apt update && sudo apt -y install wolf4sdl
  1. Check if the installation succeeded:
cpi@clockworkpi:~$ ls -l /usr/games/wolf*
 -rwxr-xr-x 1 root root   1636 Mar  4  2017 /usr/games/wolf4sdl
 -rwxr-xr-x 1 root root 240180 Mar  4  2017 /usr/games/wolf4sdl-sdm
 -rwxr-xr-x 1 root root 244460 Mar  4  2017 /usr/games/wolf4sdl-sod
 -rwxr-xr-x 1 root root 250216 Mar  4  2017 /usr/games/wolf4sdl-wl1
 -rwxr-xr-x 1 root root 250484 Mar  4  2017 /usr/games/wolf4sdl-wl6
 -rwxr-xr-x 1 root root 250528 Mar  4  2017 /usr/games/wolf4sdl-wl6a
 -rwxr-xr-x 1 root root 250528 Mar  4  2017 /usr/games/wolf4sdl-wl6a1

Steps for Wolfenstein-3D

Let’s assume you bought the full version of Wolfenstein-3D.

  1. Create a new directory for Wolfenstein-3D:
mkdir ~/games/Wolf3D
  1. Copy your .WL6 files to this new directory.

  2. Make the files completely lowercase:

cd ~/games/Wolf3D && rename 'y/A-Z/a-z/' *

The contents should now look like this:

cpi@clockworkpi:~/games/Wolf3D$ ls -l
total 2268
 -rwxr-xr-x 1 cpi cpi    1156 Aug 18 14:22 audiohed.wl6
 -rwxr-xr-x 1 cpi cpi  320209 Aug 18 14:22 audiot.wl6
 -rwxr-xr-x 1 cpi cpi     522 Aug 18 14:22 config.wl6
 -rwxr-xr-x 1 cpi cpi  150652 Aug 18 14:22 gamemaps.wl6
 -rwxr-xr-x 1 cpi cpi     402 Aug 18 14:22 maphead.wl6
 -rwxr-xr-x 1 cpi cpi    1024 Aug 18 14:22 vgadict.wl6
 -rwxr-xr-x 1 cpi cpi  275774 Aug 18 14:22 vgagraph.wl6
 -rwxr-xr-x 1 cpi cpi     450 Aug 18 14:22 vgahead.wl6
 -rwxr-xr-x 1 cpi cpi 1544376 Aug 18 14:22 vswap.wl6
  1. Create a new launch script ‘Wolfenstein 3D.sh’:
cd ~/apps/launcher/Menu/GameShell/
echo "sudo ln -s ~/games/Wolf3D /usr/share/games/wolf3d" > 'Wolfenstein 3D.sh'
echo "wolf4sdl --res 320 240" >> 'Wolfenstein 3D.sh'
echo "sudo unlink /usr/share/games/wolf3d" >> 'Wolfenstein 3D.sh'

This “dynamic linking” script is because I prefer Spear of Destiny in a separate folder later on!

  1. [OPTIONAL] Grab a fancy icon:
cd ~/apps/launcher/skin/default/Menu/GameShell/
wget http://icons.iconarchive.com/icons/3xhumed/mega-games-pack-28/128/Wolfenstein-3d-2-icon.png
mv Wolfenstein-3d-2-icon.png 'Wolfenstein 3D.png'
  1. Reboot (or continue)!

Steps for Spear of Destiny

Again, let’s assume you bought the full version of Spear of Destiny.

  1. Create a new directory for Spear of Destiny:
mkdir ~/games/Spear
  1. Copy your .SOD, .SD1, .SD2, and .SD3 files to this new directory.

  2. Make the files completely lowercase:

cd ~/games/Spear && rename 'y/A-Z/a-z/' *

The contents should now look like this:

cpi@clockworkpi:~/games/Spear$ ls -l
total 8876
 -rwxr-xr-x 1 cpi cpi    1072 Aug 18 16:34 audiohed.sod
 -rwxr-xr-x 1 cpi cpi  328620 Aug 18 16:34 audiot.sod
 -rwxr-xr-x 1 cpi cpi     522 Aug 18 16:34 config.sod
 -rwxr-xr-x 1 cpi cpi   68290 Aug 18 16:34 gamemaps.sd1
 -rwxr-xr-x 1 cpi cpi  135024 Aug 18 16:34 gamemaps.sd2
 -rwxr-xr-x 1 cpi cpi  148534 Aug 18 16:34 gamemaps.sd3
 -rwxr-xr-x 1 cpi cpi  148534 Aug 18 16:34 gamemaps.sod
 -rwxr-xr-x 1 cpi cpi     402 Aug 18 16:34 maphead.sd1
 -rwxr-xr-x 1 cpi cpi      86 Aug 18 16:34 maphead.sd2
 -rwxr-xr-x 1 cpi cpi      86 Aug 18 16:34 maphead.sd3
 -rwxr-xr-x 1 cpi cpi      86 Aug 18 16:34 maphead.sod
 -rwxr-xr-x 1 cpi cpi    1024 Aug 18 16:34 vgadict.sod
 -rwxr-xr-x 1 cpi cpi  947979 Aug 18 16:34 vgagraph.sod
 -rwxr-xr-x 1 cpi cpi     510 Aug 18 16:34 vgahead.sod
 -rwxr-xr-x 1 cpi cpi 1616544 Aug 18 16:34 vswap.sd1
 -rwxr-xr-x 1 cpi cpi 1879712 Aug 18 16:34 vswap.sd2
 -rwxr-xr-x 1 cpi cpi 1881760 Aug 18 16:34 vswap.sd3
 -rwxr-xr-x 1 cpi cpi 1881760 Aug 18 16:34 vswap.sod
  1. Create a new launch script ‘Spear of Destiny.sh’ (mind the wolf4sdl-sod):
cd ~/apps/launcher/Menu/GameShell/
echo "sudo ln -s ~/games/Spear /usr/share/games/wolf3d" > 'Spear of Destiny.sh'
echo "wolf4sdl-sod --res 320 240" >> 'Spear of Destiny.sh'
echo "sudo unlink /usr/share/games/wolf3d" >> 'Spear of Destiny.sh'
  1. [OPTIONAL] Grab a fancy icon:
cd ~/apps/launcher/skin/default/Menu/GameShell/
wget http://icons.iconarchive.com/icons/3xhumed/mega-games-pack-28/128/Wolfenstein-Spear-of-Destiny-2-icon.png
mv Wolfenstein-Spear-of-Destiny-2-icon.png 'Spear of Destiny.png'
  1. Reboot!

Finishing up!

You are now ready to play both Wolfenstein-3D and Spear of Destiny using the Wolf4SDL engine!
The final step is to specify your preferred controls in-game:

Options --> Control --> Customize controls --> Keyboard


Thank you! Works a charm!



For who likes some icons with Wolfenstein, i made a couple. Feel free the use the one u like :smiley:


Nice ! Did you use the 3drealms download version (paid) or alternative version?


The different versions you mention can be found here.

I have the version of Steam (similar to GOG/GT/ID/Activision/Bethesda).
I have not tested the version of 3D Realms (similar to Apogee 1.4).

Please let me know if someone has. :slight_smile:


Thanks ! Link is really helpful, will try and set it up tonight :grin:

EDIT: got it to work ! Ooooooh the memories :wink:


How can I press ‘y’ to exit the game? the START button doesn´t do this :frowning:


Just for those who have the SoD Episodes - The original Distribution of these was separate. For those files, you may have a .sod extension…

Be sure to change the sod’s related to the episodes as *.sd1, *.sd2 and *.sd3


The GameShell has A, B, X,and Y mapped as follows:

A = j
B = k
X = u
Y = i
Shift-A = h
Shift-B = l
Shift-X = y
Shift-Y = o

Try Shift-X.


If you have the Lightkey, the inner-left button maps to ‘Y’.



Thank you now I am playing :smile:


Hi! Works great! But I don’t know how to change weapon, I don’t find in the controls how to map it :S


Good question. Looks I did not play long enough to notice :woozy_face:. Those mappings seem hardcoded in Wolf4SDL. But that does not stop us. :smiling_imp:

I changed my ‘Wolfenstein 3D.sh’ script like this:

sudo ln -s ~/games/Wolf3D /usr/share/games/wolf3d
xmodmap -e "keysym y = 1" # Shift-X = Knife
xmodmap -e "keysym o = 2" # Shift-Y = Pistol
xmodmap -e "keysym h = 3" # Shift-A = Machine Gun
xmodmap -e "keysym l = 4" # Shift-B = Chain Gun
xmodmap -e "keysym i = y" # Y = Yes
wolf4sdl --res 320 240
setxkbmap # Undo key mappings
sudo unlink /usr/share/games/wolf3d

Don’t forget setxkbmap in the script to undo those keysyms!


Great! Thanks, I also changed with this the Spear Of Destiny.sh

By the way, you know how to select between the 3 episodes in Spear Of Destiny?:thinking:


You will have to add the --mission parameter:

Spear of Destiny:

wolf4sdl-sod --mission 1 --res 320 240

Return to Danger:

wolf4sdl-sod --mission 2 --res 320 240

Ultimate Challenge:

wolf4sdl-sod --mission 3 --res 320 240

Omitting this parameter actually brought me into a mission pack. :S


I think I am missing a step. I can’t get the *.wl6 file to turn into the multiple files shown in the table just before Step 4. At step 3. it says to make the files lowercase, but I don’t know how to get the multiple files. Is the file ‘wolf4sdl-wl6’ a compressed file format? If so, how do I uncompress?


Never mind the previous post. I finally figured out that I was supposed to use my own files. My next stumbling block is when I attempt to run the game, it shows the red start screen where you select mouse and some other variables, but crashes back to the launcher menu. I tried changing the video driver to lima, but same effect. The only other thing I can think of is when creating a new launch script, there is supposed to be a wolf3d folder here

But there is no wolf3d folder there. I tried to create it, but I am denied. Is this why Wolfenstein will not work, or do I need to look elsewhere?


If you don’t have the wolf3d directory, you must have skipped step 2, Steps for Wolfenstein-3D


I went down the post and copied and pasted every relevant command into my ssh window. Step 2 was done. I managed to create the wolf3d folder inside the usr/share/games directory, manually, but still i can not get it to load. I see that the post is old, does it matter if I am on v.03 of the clockwork pi OS?


The tilde ~ equals /home/cpi in the clockworkpi!

The ~/app/launcher has become ~/launcher in the newest clockwork pi OS.

This command:

sudo apt update && sudo apt -y install wolf4sdl

creates the folder /usr/games/wolf4sdl with the wolf4sdl program files.

This command:

mkdir ~/games/Wolf3D

creates the folder /home/cpi/games/Wolf3d in which you have to place your purchased wolf3d data files.