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