PennMUSH for Win32
------------------

Ported by Nick Gammon   <nick@gammon.com.au>

31st August 1999


If you have trouble reading this file use Notepad and check
"Word Wrap" under the Edit menu.


This is version 1.7.2 p17 of PennMUSH, compiled for Win32 - namely Windows 95 and Windows NT. 

Detailed instructions for setting up the PennMUSH server, including screendumps and FAQs, can be found at:

http://www.gammon.com.au/pennmush/setuppennmush.htm

Instructions
------------

1. Create a suitable directory (eg. Pennmush), and then unzip the archive into it, making sure you preserve folder names (ie. you should have lots of subfolders). Use Winzip to do this, obtainable from:  http://www.winzip.com

2. You should edit MUSH.CNF file in the GAME directory, and change the name of the MUSH, like this:

mud_name YourMUSHname

3. If you are not permanently connected to a Domain Name Server (ie if you are experimenting at home), set "use_dns" (in MUSH.CNF) to "no", like this:

use_dns no

4. Open a command window, change to the GAME directory, and start up the server by typing:

pennmush /run

5. If all is well, the server should be up. Try looking in the GAME.LOG file in the GAME\LOG directory to confirm this.

6. Use a client program (eg. MUSHclient) to connect to your server. To connect locally (ie. at your own PC) connect to address "localhost" port 4201.

7. If you are using the minimal database, you should be able to log in as "one", no password.

8. If all is well, and you are using Windows NT, you are advised to run the server as a "service". See the file SERVICE.TXT for more details about doing this.


Note re passwords
-----------------

There has been some confusion about passwords in MUSH databases. If you copy a database from a Unix implementation it may well have encrypted passwords, which this version cannot process. You will need to edit the database and change the password for "one" with a text editor, and then @newpassword all players.

More details about doing this are at: http://www.gammon.com.au/pennmush/pennmushfaq.htm

The other problem is that some Unix implementations, and some former Win32 implementations are using the SHA (secure hash algorithm) method, however there has been a problem with the way these are calculated. To circumvent this, there is now a new configuration directive:

reverse_shs no

(or)

reverse_shs yes


The default is "yes" which should be consistent with databases produced by earlier Win32 versions. However, if you are using an old database which uses SHA hashing for passwords, and none of your passwords are recognised, try changing that directive to "reverse_shs no" and restarting the server. This directive goes in the MUSH.CNF file.

You will know if you have SHA passwords in the file, because they look like this:

]XYXXY^1^65590		<---- the XYXXY line identifies a password
"XX3581105091875382106"		<--- this is a hashed password


------------------------------------

Have fun!

- Nick Gammon

http://www.gammon.com.au


