******************************************************************************* ****************************** Intermud v1.00 ********************************* ******************************************************************************* INTRODUCTION Well, it's been about 2 years now that Intermud has been in a BETA type form and now I think the major networking mechanics are pretty solid. In the past I have never included decent documentation or an easy way to get Intermud installed on a new mud. Hopefully with this release and this new README more people will be able to install Intermud and get it up and running. It's actually very simple. There are three ways I guess that you can get Intermud up and running. The first, and fastest would be to FTP circle30bpl11+imud.tar.gz, unpack it and type make all, presto, it's all but done. However, for the most part that's extreamly unlikely. Most will want to use the intermud_circle30bpl11.patch file which will patch in everything for you. And last but not least there will be some of you that have so heavily modified Circle 3.0 that the patch file won't work, or you are trying to port Intermud to a different mud platform. Either way, I have documented some instructions on all three senerios below. HOW IT WORKS There are three parts to the Intermud enviornment. The first is nothing that you have to run or worry about, I call it the BOOTMASTER. The BOOTMASTER runs at styx.ph.msstate.edu and all of the muds connected to the Intermud network connect to it to get the MUDLIST. The second part is the intermud_client.c source which compiles into ../bin/intermud. This is your client version of the software. Your mud talks to your local copy of the client which in turns send messages etc to the rest of the muds connected to the Intermud network. Your copy of intermud is a seperate binary executable that runs as it's own process on your machine. The third part is act.intermud.c which is compiled into your mud and acts as the interface to the Intermud process. HOW TO INSTALL IT If you have FTP'd circle30bpl11+imud.tar.gz then start here. 1) Uncompress and Untar circle30bpl11+imud.tar.gz into a place where you want to run it from. gzip -dc circle30bpl11+imud.tar.gz | tar xvf - This will create a directory called circle30bpl11. You can then cd into this directory and type ./configure (part of the regular CircleMUD install process) 2) Now, cd into the src/ directory and edit the intermud.h file, you will have to change what you need, all of the settings are explained. 3) Edit the intermud_script file and make sure that the port specified matches the INTERMUD_PORT you dave defined in the intermud.h file. 4) Type :- make all This will compile CircleMUD for you and Intermud as well. You can now move on to the HOW TO GET IT TO RUN section. If you have FTP'd intermud_circle30bpl11_patch.tar.gz and want to patch Intermud into your copy of CircleMUD, start here. 1) Move intermud_circle30bpl11_patch.tar.gz into the top level directory of your mud. IE /usr/local/src/circle30bpl11 2) Uncompress and Untar intermud_circle30bpl11.tar.gz. gzip -dc intermud_circle30bpl11.tar.gz | tar xvf - This will create these files :- README.intermud intermud_circle30bpl11.patch intermud_script 3) Now you will patch Intermud into your source tree. Type in :- patch -p0