Welcome to the 4th Encounter

What is it?

A slightly modified version of the Wolfenstein 3D 2nd Encounter
game engine, based on the source released by Bill Heinemann.

This version still includes the proprietary sound/music
library that Bill has told us shouldn't be redistributed, so you
shouldn't use it unless you already own Wolfenstein.
I'm looking into removing this restriction.

What's been changed?

So far the following modifications have been made:

* A dialog providing the option of playing a built-in scenario
(if any) or opening an external scenario created by WolfEdit.

* Loading of sound resources is now delayed until the scenario
file is open, so that sounds can be included in a scenario file.

* To facilitate sharing of art, sounds and music between sets
of levels, the engine will search the following  files for resources 
(in order):

0) The scenario file selected by the user (if any)
1) In the same folder as the user-selected scenario file:
1a) "Shapes"
1b) "Sounds"
1c) "Music"
2) In the same folder as the 4thEncounter application:
2a) "Levels"
2b) "Shapes"
2c) "Sounds"
2d) "Music"
3) Finally, the resource fork of the 4thEncounter application.

You can use WolfEdit to create all of these files, although
currently you'll have to use ResEdit to install sounds
or instruments.

Levels should be put either in the user-selected scenario file, 
or in the "Levels" file. If the user selects "Choose Scenario"
from the opening dialogue, the levels in the chosen file
will be loaded, and the search path will start at (0). If
the user selects "New Game", the levels from the
ÒLevelsÓ file will be loaded, and the search path will
start at (2).

Note that you don't have  to split the resources up in this
way; you can still put your whole scenario in one file if you
want. The search path is simply there for added flexibility.

How do I run it?

Currently you'll need the 2nd Encounter as well, because there
are no levels or artwork included with the 4th Encounter Ð it's
just an engine. 

Put a copy of the 2nd Encounter in the same folder as the
4thEncounter application and rename it ÒShapesÓ. Then
launch 4thEncounter.

How do I compile it?

To compile your own version from the source, you'll need 
CodeWarrior Pro 3 or later.

It might be possible to get it to compile under MPW, but
you're on your own for that.

Have fun,

Greg Ewing
greg@cosc.canterbury.ac.nz