LizardBot/Setup

Note: Some experience in the PHP programming language - which this bot is written in - is recommended for using this bot. The documentation on this site assumes that you are familiar with at least the basics of PHP (such as declaring variables, how to quote strings, etc.). That said, this is only a recommendation - if you don't know PHP at all, you are welcome to try out LizardBot, and do ask for help on our IRC channel or elsewhere if you need it.

The first thing you need is the bot itself. Go to the Google Code project and check out lizardbot.php and lizardbot.conf.php from SVN.

Next, you'll need a configuration file. Checkout a copy of the default configuration file from SVN (lizardbot.conf.php, if you haven't already, see the download link above) and verify it is named lizardbot.conf.php (if you haven't already) - place it in the same place as lizardbot.php.

Configuration Options

Here is some configuration help.

• $nickname: String. The bot's default nickname.
• $users: Array. This is an array containing the people privleged enough to use the bot. You should be root. *!*@* is everyone.
• $privgroups: Multidimentional array. This is a multidimentional array containing the various access levels. If you don't know what you should do here, don't touch it.
• $setFantasy: Boolean. Whether or not the bot's Pandorabot AI should be enabled by default. TRUE enables it. Note that this can be overriden by those with root access by calling @fantasy-on or @fantasy-off. Note that if you set it this way, a rehash of the configuration file will cause the state to fall back to whatever $setFantasy is set to.
• $setIsOnWindows: Boolean. Set to TRUE if you are running the bot on Windows. FALSE by default. Note: If you want to run the bot on Windows, please read the Windows Manual instead of the standard bot setup and bot operation manuals.
• $setIdent: String. What the bot's username, or IDENT, should be. It is "bot" by default, althouth I recommend setting it to your usual nickname.
• $setGecos: String. What the bot's realname, or gecos, should be. By default, it is the version number of the bot. I recommend adding " operated by x" to the end of it, replacing x with your nickname.
• $setTrigger: String. What the bot's trigger should be. By default, it is @.
• $setNoBolds: Boolean. If true, the bot will send color codes, but will not send bolds.
• $setAIDefaultRE: String. The default reply for the AI should the API not return a response.
• $setCTCP*: Strings. These CTCP variables control the bot's response to various CTCP commands.
• $setNSUsername: String. The default username for NickServ, should the bot use a registered nickname.
• $setEnableExec: Boolean. Whether or not the @exec command should be enabled. True to enable.
• $setEnableEval: Boolean. Whether or not the @eval command should be enabled. True to enable.
• $setTrustGoogle: Boolean. If you are extremely paranoid and don't trust the google, set this to false. True by default. (Currently disables only Google Calc)
• $setUsePCREs: Boolean. Set to true if you want to use PCREs with the access list instead of standard hostmask syntax as used on IRC. Automatically true on Windows. Boolean, default FALSE on POSIX systems, default TRUE on Windows systems (note that you must include the regex delimiters [# is recommended] with the hostmask).

Done?

When you are done configuring the bot, see Operating the Bot.