LavaBot Readme file
-------------------

Only one thing to say, but this must be emphasized:
	LavaBot isn't perfect!	You may have trouble installing,
	configuring, or running the damn thing, so don't expect it to
	work the first time.  This is not to be used in mission-critical
	environments, government agencies, nuclear power plants, medical
	equipment, etc.  If you don't enjoy playing around with IRC
	bots, then LavaBot ain't for you!
	Two big weaknesses of LavaBot: he can only be in one channel at
	a time, and only works (as far as i know) on EnterTheGame.com
	servers (such as ky.enterthegame.com).	If you'd like to try him
	out on a different server, you'll need to edit the danger.pl file.
	Otherwise, check out the doc/INSTALL.txt for install instructions,
	and then peruse doc/lavabot.txt for general usage.

Programming Support
-------------------
	LavaBot's code is public domain.  You can do absolutely anything
	you want with it.  Out of courtesy, I'd request that you email me
	if you're using my code, but hell, you don't even have to do that.
	The only semi-useful parts are the small libraries: Msg_parse.pm,
	Cfg_file.pm, and possibly Leetize.pm.  I haven't documented
	these, but if you can't figure out how they work, email me and
	I'll be glad to write something up.
	Also, it's (somewhat) easy to write LavaBot modules of your own.
	There are only a few requirements for such a module:
	1. It must contain the text ':LavaBot:Modulename:' in the first
	line of the file
	2. It must be a valid perl module, and in the same directory
	as lavabot.pl
	3. It must implement the following methods (called by lavabot.pl):
		-init($channelname)	#called upon loading of the module
		-chanmsg($line)		#$line is the full message
		-privmsg($handle, $body)  #$handle is who sent it, $body
		is the text they sent
		-stop()

	Briefly, LavaBot calls chanmsg($line) in a module anytime
	a message is sent to the channel.  Likewise, it calls
	privmsg($handle, $body) anytime a message is privately sent to
	your module (via ':mod yourmodule').  The '$line' passed to
	chanmsg is exactly what the IRC server sends to the client.
	It's a bit cryptic, so perhaps you want to check out the RFC
	for IRC.  Msg_parse is the little library dedicated to extracting
	useful information from $line.
	Apologies for this being brief/unhelpful.  I'm a bit rushed for
	time :P  If you have any questions, just email and I promise
	I'll respond.

	Lavahead
	Friday, May 19, 2000
	jwmohr@students.wisc.edu