The following assumes that you have basic knowledge of C compilers and UNIX.

The directory tree of the MAGE source distribution should look something like:
( see the Contents files in the MAGE.1.1.2 directory for more detail )
MAGE.1.1.2/
MAGE.1.1.2/docs/
MAGE.1.1.2/examples/
MAGE.1.1.2/game/
MAGE.1.1.2/game/data/
MAGE.1.1.2/game/logs/
MAGE.1.1.2/game/muf/
MAGE.1.1.2/include/
MAGE.1.1.2/src/

Compiling TinyMAGE:

There are two files you'll want to look at before compiling.  The first is
the Makefile in the "src" directory.  Change the top part of this file to
conform with your machine's hardware and compiler.
The second file is config.h in the "include" directory.  This also contains
important hardware specific parameters which you should adjust.  It also
contains important parameters for the mud itself, so browse through the
entire file and make what changes you feel are necessary.

Next, you may also wish to edit params.h in the "include" directory.  This
file contains options only relevant to the mud itself. 

Now you are ready to compile.  From within the "src" directory, you can
either type "make" or "make install".  If you choose "make install", it
will compile and then move the executables (netmage and decompress) to the
same directory as the restart script (which most likely means the "game"
directory).  If you choose "make", you will have to copy the executable
files manually to the proper directories.

The rest assumes that you have successfully compiled TinyMAGE, and that
netmage and decompress are in the proper directory.
----------------

Go to the "game" directory and make sure it contains the directories "data",
"logs", and "muf".  Whichever of those directories do not exist, create
them.

Starting with the minimal database:

In the "examples" directory, there is a file called minimal.db.  This file
is the absolute smallest db that would provide any useful functionality.
It merely contains one room, and a player in the room.
Copy this file into the "data" directory and rename the file to "in".

Then simply find the restart script in the "game" directory, and type
"restart" from that directory.  You should get the messages:
  "Loading data/in", and
  "Loading data/in (done)".

Now the database is up, and you can log on as Wizard.  Telnet to the
mud (telnet <machine> <port)>), and do:
  connect Wizard potrzebie
when you get the welcome message.

Now you're ready to build!


Starting with a TinyMUCK 2.2 or TinyMAGE 1.0 db:

Copy your database into the "data" directory, renaming it to "in".
Copy whatever MUF programs that go with the old db into the "muf" directory.
You may optionally wish to use the muf.convert.sh utility in the "game"
directory to convert MUCK 2.2 or MAGE 1.0.  Just type
'/bin/sh muf.convert.sh' from the "game" directory.  This conversion utility
is far from perfect, but may reduce the overall time of converting programs
manually.

Then run the restart script in the "game" directory, and the database
should load.

TinyMAGE 1.1 should read MUCK 2.2 and MAGE 1.0 dbs without problem.
But to be safe, you may want to save a copy of the old database, because
MAGE 1.1 writes the db in its own unique format.


Francis
fihsu@mit.edu