Mozbot/Documentation
Contents
- 1 The Bot Itself
- 2 Standard Modules
- 2.1 Admin
- 2.2 Bugzilla
- 2.3 Converter
- 2.4 FTP
- 2.5 Filter
- 2.6 Flood
- 2.7 FortuneCookies
- 2.8 General
- 2.9 God
- 2.10 Greeting
- 2.11 HelloWorld
- 2.12 Infobot
- 2.13 Karma
- 2.14 KeepAlive
- 2.15 KookBot
- 2.16 List
- 2.17 MagicEightBall
- 2.18 MiniLogger
- 2.19 Parrot
- 2.20 Quiz
- 2.21 RDF
- 2.22 Rude
- 2.23 Sheriff
- 2.24 Stocks
- 2.25 Tinderbox
- 2.26 Translate
- 2.27 UUIDGen
- 2.28 WWW
- 2.29 Wishlist
- 2.30 XMLLogger
The Bot Itself
We have some documents concerning a few aspects of mozbot.
- README: A brief description of mozbot.-->
- INSTALL: Instructions on installing and configuring mozbot for the first time.
- INSTALL.UNIX.CHROOT-JAIL: A description of setting up mozbot in a chroot jail environment (specifically on Solaris).
- INSTALL.WIN32: A placeholder document for instructions on installing mozbot on Windows.
- FAQ: Answers to Frequently Asked Questions about mozbot.
- Downloading Mozbot: Instructions on downloading mozbot.
- Installing Mozbot Modules: Instructions on setting up new mozbot modules on the fly.
- Module API: This documents the methods used by the mozbot module architecture. (For Developers.)
Standard Modules
The modules currently in CVS or planned for the near future are listed below. Some of these modules have associated documentation, those that don't usually have some sort of online help.
Admin
The built in module that handles user authentication and configuration.
Bugzilla
An IRC interface to Bugzilla. Automatically looks up bugs that people mention and does some queries when asked.
Converter
A simple tool to convert numbers between different units and bases. For example it can convert hex to binary, Fahrenheit to Centigrade, and meters to miles.
FTP
Monitors an FTP directory and reports new files as they arrive.
Filter
Runs text through text filters like l33t
or chef
.
Flood
Basic flood protection for channels.
FortuneCookies
Remembers witty sayings given to it, and spits them out on request.
General
The module that handles the help command and keeps track of the version number.
God
An autoopper. Getting Opped: A guide to using mozbot as an autoop bot.
Greeting
A friendly module. Says hi and so on. Also implements the "seen" command and other niceties.
HelloWorld
A demo module.
Infobot
A module supporting the functionality of the well known infobot: stored factoids that it can report on demand. Infobot Protocol: The Infobot interbot communication protocol specification (aimed mainly at other bot authors wanting to write interoperable IRC bots).
Karma
Keeps track of people's Karma rating. (++/--)
KeepAlive
Sends a message to a particular channel or user at regular intervals.
KookBot
Do you have a moron on your channel who is arguing inanely? Set the kookbot on them! The Original KookBot: This module is based on kookbot.pl by Keunwoo Lee.
List
Keeps hold of personal lists for people. For example, TODO lists.
MagicEightBall
A digital version of the old favourite, the magic eight ball.
Confused? Puzzled? Ask the Magic Eight Ball by simply saying:
!8ball <yes/no question>
MiniLogger
Logs messages matching particular patterns. By default, simply logs URIs (links).
Parrot
Speak or act on command in channels.
Quiz
A Quiz Bot similar to MoxQuizz. Currently mozbot does not ship with any question files, we welcome submissions! [ README.database]: The official MoxQuizz description of the question database format.
RDF
Regularly examines site summary RDF files and reports changes. (e.g. report new Slashdot stories)
Rude
An interface to an insult server and an excuse server.
Sheriff
Regularly checks the sheriff status of ["http://www.mozilla.org/projects/tinderbox/ Tinderbox]es and reports any changes.
Stocks
Looks up stocks on request and reports their value.
Tinderbox
Reports the status of a project's Tinderboxes.
Translate
An interface to translate strings on request.
UUIDGen
Generates UUIDs on request.
WWW
Reports some simple details about web pages on request, e.g. title, size, doctype.
Wishlist
Stores requests for changes to the bot.
XMLLogger
Saves a log of channel events as XML files (one per channel). You can tell what modules a bot has loaded from the response it gives to a CTCP VERSION message (this only works for more recent releases). If anyone feels like writing documentation for any of these modules, please do so! Source code for all the standard module is available through LXR.