NAME

Bot::Jabbot - simple pluggable jabber bot

SYNOPSIS

#!/usr/bin/perl
use Bot::Jabbot;
use warnings;
use strict;

my $bot = Bot::Jabbot->new("./config.yaml");
$bot->start();

DESCRIPTION

Bot::Jabbot allows you to easily create jabber bot. All you need is to write config file and use or write some modules that will handle messages.

METHODS

new(...)

Creates new bot instance. Accepts path to configuration file in yaml format as first param (defaults to ./bot.conf)

start()

Initializes required modules and starts bot.

setlang()

Changes currently used language for bot and all loaded modules.

CONFIGURATION

jid: jabbot@somehost.ru
password: somepassword
nickname: Jabbot
debug: 0
modules:
  replier: Bot::Jabbot::Module::Replier
  replier: Bot::Jabbot::Module::Replier
  replier: Bot::Jabbot::Module::Replier
rooms:
  - someroom@conference.somehost.ru
      password: secret
  - someotherroom@conference.somehost.ru
status: "I'm bot, i'm bot, you know that i'm a bot"
lang: en

jid - jid of jabber bot

password - password for jabber bot

nickname - nickname for MUC

modules - hash of module name => module package. You can define any unical module name, as it used only for !help command

rooms - list of MUC rooms jid's. Room can be eather a string or a hash with join parameters (for info look at %args description in AnyEvent::XMPP::Ext::MUC join_room method)

debug - enable debug output

status - status text

lang - language of the bot (Language files are stored in the Jabbot/I18N subdirectory for bot, and ModuleName/I18N subdirectory for modules)

DEPENDENCIES

AnyEvent

AnyEvent::XMPP

Class::MOP

Config::Any

Encode

AUTHOR

Epifanov Ivan isage@aumi.ru

COPYRIGHT

This module copyright (c) 2009 Ivan Epifanov.
All rights reserved. This module is free software; you can redistribute it 
and/or modify it under the terms of the Perl Artistic License.
(see http://www.perl.com/perl/misc/Artistic.html)