This is the README file for AlloyMUSH 1.0p1.

-----------------------[ How do I install AlloyMUSH? ]-----------------------
1. Un-archive the AlloyMUSH files. You've probably alrady done this.

2. Configure it. Change to the <mushdir>/obj directory and type "configure".

3. Edit stuff. You may need and/or want to edit the following files:
	<mushdir>/src/config.h
	<mushdir>/obj/Makefile

4. Compile it. Type 'make'. If you have problems compiling, mail the output
of the 'uname -a' command and your src/patchlevel.h file to me,
jessem@comtch.iea.com, along with a note explaining that you need help
compiling.

5. Make a database. If you have a database from another version of MUSH,
refer to README-2.0 for instructions on how to convert it to AlloyMUSH
format (AlloyMUSH reads every format that 2.2 does, as well as MUX
databases). If not, type this in the AlloyMUSH directory:

	netmush -s netmush.conf &

When you see a message like "950325.102122 MyVeryOwnMUSH INI/LOAD : Startup
processing complete.", type this:

	telnet localhost 6250

When you see the mush connection message, type:

	connect wizard potrzebie
	@shutdown

6. Make a configuration file. Use your favorite editor to edit the
conf/netmush.conf file. The most common config directives are already in
there.

7. Edit the text files. You'll probably want to edit at least connect.txt,
quit.txt, and news.txt.

8. Start up the mush. If you want the mush to NOT restart when it crashes,
type:

	ln -sf scripts/Startmush.norestart Startmush

This is a semi-permanent change and you only have to type it once. Whether
you made that change or not, type this to start the mush:

	mush

If you did make that change, then shutting down the mush by typing
"@shutdown restart" will make it restart right after it shuts down. If you
didn't change it, typing "@shutdown norestart" will make it not restart
after it shuts down.

9. Read ALL of the documentation. That's what it's for. Well, you don't have
to read all of help.txt and wizhelp.txt, but try to read things that look
important.

-------------------------------[ Other Stuff ]--------------------------------
Every version of AlloyMUSH that hasn't been changed (except by me) is
guaranteed to work on my system, a 386DX/25 running Linux 1.3.9. If it
doesn't work on yours and I can't figure out why, perhaps you should get
Linux.

Remember: if you did not re-link the Startmush file, you will have to type
"@shutdown norestart" to actually shut down the mush, because if you don't
it will come right back up.

The log messages you see when you first set up the mush ("950325.102122
MyVeryOwnMUSH INI/LOAD : Startup processing complete.", etc.) are only there
because it's not being logged to a file, and they will be sent to a log file
instead of your screen when you start it with 'mush'.

If you have any questions, suggestions, comments, or whatevers, send them to
jessem@comtch.iea.com (Alloy on GlobalMUSH, Odie on ToonMUSH 3).  AlloyMUSH
is supported ONLY by Jesse McGrew, not the TinyMUSH authors!