INSTALLATION GUIDE: a) Copy the Makefile.dist file to Makefile, the version.h.dist file to version.h and the config.h.dist file to config.h b) Edit config.h and change any parameters you want to change. PLEASE make sure to read the entire file and change everything you need to. The file is fairly liberally commented, so read them too :) If you are changing over from PernMUSH 1.15 or earlier, you will need to compile once with the ADD_LOCKS option, @shutdown, and then compile again with ADD_LOCKS off. You will probably want to make a backup of the database before doing this. See config.h for details. If you are changing over from PernMUSH 1.16 or earlier, you will need to compile once with the ADD_ZONES options (if you are planning on using zones), @shutdown, and then compile again with ADD_ZONES off. If you are starting with the minimal database provided, you do not need to do the lock conversion, but you will need to do the zone one. c) Edit version.h and change the MUD name (this is VERY important for people who will make use of the RWHO server -- see below). d) Edit interface.c if needed to make sure you are set up for the IPC you need for your machine. The only IPC package that I guarantee to work is the bsd.c one. Neither the concentrator code, the xenix code, nor the xsocket code has even been hacked on or even looked at by myself. If you use one of them and get it working, let me know and your patches will be included in the next release e) Edit the Makefile and choose the option you want. The main thing you will want to worry about is how to set up the RWHO. There are three possible states of RWHO use. 1) Do not use it.. This is the default, and if you don't want to deal with it, you should have no problems. 2) Send login info to a remote RWHO server. This is very simple and painless. It uses UDP to send the info, so there will be no slowdown of the game by enabling this. However to get it set up you need to do the following. a) Find the admin of an RHWO server (I run one -- jt1o@andrew.cmu.edu) and convince him to allow you to set up a link from your mud. This is rather painless, and the RWHO server admin will know what you need to change in the source code. b) Make those changes and compile :) 3) Send info to the RWHO server, AND enable reading RHWO server info from within the mud. This is a BAD idea unless the RWHO server and the mud are on the SAME LOCAL NETWORK. The reason for this is that retrieving the RWHO info uses a stream port, and the mud could freeze if the net between the mud and the RWHO server went down. If you MUST run this way, I would recommend talking to mjr@decuac.dec.com to see how to go about setting up an RWHO server. I will however allow you to link your RWHO server to my node in the tree if you end up running one. f) Do a make install. This will set up a few symbolic links so that the restart script runs correctly. g) Build the news and help index files. The format for the mkindx command is 'mkindx _text_file_ _index_file_'. An index file will need to be changed every time the associated text file is changed. The default pairs are news.txt and newsindx and helptext and helpindx. These default names can be changed in config.h h) Edit the restart script. You will probably want to rename the in-database to indb.Z, if you haven't done so already. i) You should now be ready to run and go. A minimal database is provided in this distribution. The password for the default god character (One) is potrzebie. You should change this (via @password) immediately. The Master Room defaults to room #2, which is already created. JT Traub (Moonchilde), who for a year has taken loving care of this PernMUSH code, is no longer maintaining this version of MUSH, since the MUD he runs (still Pern) is now using 2.x code (soon to be released). If you make any fixes/improvements, please do NOT submit them to him, although he will still try to help with compilation problems (email jt1o@andrew.cmu.edu) The 1.x code has branched off in three directions. This is currently the only publicly available version. Spellbound MUSH (god, Joarm) uses a variant of 1.13, and SouCon MUSH (god, T'nor) uses a variant of 1.15. I am planning on maintaining this code for a while. Lydia Leong (me. I'm Amberyl, everywhere) - T'nor, and Joarm are all interested in any fixes/improvements. If you find bugs in this version, please notify me (lwl@eniac.seas.upenn.edu).