
These are instructions to compile and run mbot. Please check the README for
further info.

PLEASE NOTE: I will not answer any questions related to unix environment, be
it copying and editing files, configuring crontab, whatever.

>> COMPILING

If you are upgrading from a previous install, first type

"make clean"

and read the ChangeLog and/or example.conf, because things change.

Then,

"./configure"
(some systems have a strange shell in /bin/sh, try "bash ./configure" if you
get the error "configure: Command not found.")

and if all goes well,

"make"

If compilation fails in your system, contact me so I can fix mbot. I hope to
get mbot up and running in all recent unix-likes. Currently, I know it works
on Linux, FreeBSD, OpenBSD, SunOS and Tru64 UNIX. However, my main development
platform is Linux, so if something breaks in another OS, please report it.

In case you want to use the ALICE module, you'll also need to get this:
http://alunos.uevora.pt/~l12697/prog/mbot/alice.tgz
It contains the necessary data files to get alice talking and dancing. :)
Just untar it in mbot's directory. Also don't forget to read mod/alice.cpp.

>> QUICKSTART

- Copy all ./example/example.* files to ./bot_nick.* (one by one, and of
  course bot_nick can be any filename, but for clarity's sake you should use
  your bot's nickname)

- Edit bot_nick.conf and configure it to your needs, don't forget to change
  the filenames.

- Edit bot_nick.users and change the mask in it (mirage!*@*) to your
  own, like yournick!*@*, and *don't* touch or add anything else. This
  should be the only time you'll mess with the user file directly, because
  it's safer to use mbot's commands to configure things.

- Start the bot with './mbot -c bot_nick.conf'. Then, inside irc, do a 
  '/msg bot_nick !pass _dark'. Yes, "_dark" is the default password. It should
  say "Password correct". If not, try '/msg bot_nick !level' and make sure it
  responds with a "Access level 10, not identified.". If it doesn't, either
  the mask is messed up, or you didn't load any user file in the configuration
  file.

- Now at least change your password with !setpass, and use !help to explore :)

- If something goes wrong, try running mbot with the '-d' option, which turns
  on some debugging output and prevents it from forking into background. Also
  don't forget to look inside mbot.log for error messages.

