Wolfenstein 3D
Escott  BeebEm  Wolfenstein 3D  Home 
 
 
 
A port to the Vr3 of the Wolfenstein 3D code. To play the full version of Wolfenstein 3D you'll need the data files from your own copy. However, the code also works for the Spear of Destiny demo, which you can get from here (for example). The full version of Wolf3D (size approx. 2.5M) will just about fit in user space (i.e. somewhere under /flash) if you remove everything else (I have a stripped down romdisk and put the files there, see below). The Spear of Destiny demo is about 1.3M. Note that the full Wolf3D does not work with the RAM-kernel PMON setup, I think, because there is not enough memory to run it when the kernel is in RAM. The Spear of Destiny demo is OK with that setup though. I have done all testing on the old-PMON 1.2 SNOW kernel and toolchain, if you want to compile for non-SNOW you'll have to edit the Makefile.
 
This version is derived from David Haslam's xwolf port. Although I have rewritten a fair amount of the important stuff and fixed a few bugs, DH did all the hard work by figuring out X equivalents of the assembler graphics routines in the first place. There are still a few issues - no sound for eg. and few missing / imperfect graphical features, a few menu options crash it. However, for all intents and purposes it is all there. There are two view options, the default is fullscreen with the Agenda sideways. Starting with the '-n' option (which must be the LAST option on the command line) has a much reduced screen with the Agenda the normal way round. The keys are hard coded to the Vr3 buttons (appropriate for the orientation) look in xmain.c if you want to change them. Note that tapping the screen is ESC (for quitting) and you need to fire up the keyboard and type a 'Y' to completely get out.
 
To accomodate the limited Vr3 buttons the button for 'door open' is the same as for walking sideways, probably won't be problem unless you're in the habit of walking sideways through doors... Obviously I haven't tested it all the way up to the end of Wolfenstein level 6, so I wouldn't be surprised if there's bugs somewhere.
 
1) Download the source from here xwolf-vr3-0.1.tar.gz
 
2) Unpack:
tar xvzf xwolf-vr3-0.1.tar.gz
3) cd to directory, add SNOW to path (if SNOW compile required, note toolchain is assumed to be in /opt)
cd xwolf-vr3-0.1
source use_snow
4) Edit Makefile to build for either Spear of Destiny demo or Wolfenstein full version. This is done by uncommenting the relevant lines at the top of the Makefile. i.e. for Spear of Destiny demo it should look like this: 
#uncomment for spear demo
COMPFLAGS = -DSPEAR -DSPEARDEMO -DARTSEXTERN -DDEMOSEXTERN -DCARMACIZED
TARGETDIR = vr3_sdm/sdm/
#uncomment for wolfenstein 3d full version
#COMPFLAGS = -DCARMACIZED
#TARGETDIR = vr3_wf3d/wf3d/
or for Wolfenstein: 
#uncomment for spear demo
#COMPFLAGS = -DSPEAR -DSPEARDEMO -DARTSEXTERN -DDEMOSEXTERN -DCARMACIZED
#TARGETDIR = vr3_sdm/sdm/
#uncomment for wolfenstein 3d full version
COMPFLAGS = -DCARMACIZED
TARGETDIR = vr3_wf3d/wf3d/
5) Compile (make clean first is a good idea, if you are recompiling). There will be lots of warnings - don't worry about them, as long as it actually produces an executable. 
make clean
make all
6) Now you will find the executable in one of two places, depending on wether you have compiled the Spear demo or Wolfenstein. For Spear: 
cd vr3_sdm/sdm
For Wolfenstein: 
cd vr3_wf3d/wf3d
7) Don't forget to strip the binary! 
mipsel-linux-strip xwolf
7) Now, in the directory with the xwolf executable you need to put the following data files (for Spear): AUDIOHED.SDM
AUDIOT.SDM
GAMEMAPS.SDM
MAPHEAD.SDM
VGADICT.SDM
VGAGRAPH.SDM
VGAHEAD.SDM
VSWAP.SDM
 Important: make sure the file names are in upper case! For Wolfenstein the file names are the same but they end in '.WL6'. The data files for the Spear of Destiny demo can be downloaded, probably from several places (I got mine from the file sdmdata.zip found here). The Wolfenstein files can be got from your fully paid up version of Wolfenstein 3D that you bought all those years ago... but beware! the three VGA*.WL6 files may not be the right ones. The correct versions are available for download as the file vgafiles.zip here, I believe it is something to do with whether you have version 1.4 of Wolfenstein or not (?), anyhow my files didn't work but the downloaded ones did. Note that I have cut out the bit from the code that required the sign on screen ('signon.dat' from DH's xwolf), to save 64k. This is why when you run the program the first thing you get is an unpromising blank screen.
 
8) Install on the Vr3. If you have the room you can just rsync the whole sdm (or wf3d) directory to somewhere useful on the Vr3. e.g. Establish a network connection then 
cd ..
rsync -r sdm agenda::default/
If you want to put the files in the romdisk then you can put them anywhere, but the important thing is that you'll still need a folder somewhere under /flash with links to each of the files. When exiting, the program attempts to write a CONFIG file in the current directory, which it won't like on the romdisk since cramfs is readonly. I'm not sure what happens if it can't write it out though... probably it's not too bad (it doesn't need the file to run). If you want, try it out. See the Agenda Wiki pages for advice on how to edit romdisks (I find uncramfs and mkcramfs easiest)
 
9) Install the runner script(s). These are very simple, they just cd to the sdm directory (or wf3d) and run the program. This is because it expects to find the data files in the current directory (or the path, I guess). They also can be used to pass the '-n' option (to run xwolf with the Vr3 in the normal orientation). The typical form is like this: 
#!/bin/sh
cd /home/default/sdm
exec xwolf
Or for postage stamp sized play: 
#!/bin/sh
cd /home/default/sdm
exec xwolf -n
The 'cd' line of the above should be edited dependent on where you have installed the files. The included ones assume the executable and files are under directories in /home/default/, and the runner scripts themselves are in /home/default. If you have followed the instructions so far you can just install like this 
cd .. 
rsync sdmrun agenda::default
rsync sdmrun_n agenda::default
10) To make a link from the games menu: Telnet to the Agenda, cd to .wmx/Games and link to the runner scripts. eg. 
telnet agenda
login: default
cd .wmx/Games
ln -s /home/default/sdmrun SDM 
ln -s /home/default/sdmrun_n SDMn
exit
11) Have fun!
 
PS.
 
12) Bill Kendrick has kindly supplied an XPM file, which looks like this:
 

 
download it here.
 
Comments, etc. to: wolf3d@vaagmaer.com.