mirror of
https://github.com/pragma-/pbot.git
synced 2024-12-24 11:42:35 +01:00
60 lines
1.9 KiB
Plaintext
60 lines
1.9 KiB
Plaintext
See also: http://www.iso-9899.info/wiki/Candide
|
|
--------------------------
|
|
PBot requires Perl 5.10, especially for !cc
|
|
--------------------------
|
|
PBot is intended for the Freenode IRC network. As such, it has not been
|
|
tested on other networks. Some IRC features, such as NickServ auto-join, may need adjusting.
|
|
--------------------------
|
|
The first thing you'll want to do is edit pbot.pl and change the default
|
|
settings:
|
|
|
|
* If you did not extract/checkout PBot into ~/pbot (where ~/pbot/PBot
|
|
contains the PBot.pm module), you'll want to change $pbothome in pbot.pl
|
|
to point to the directory that contains the PBot, config, data, etc directories.
|
|
|
|
* Change the IRC settings in pbot.pl so that the bot-nick and identify password are
|
|
associated with a registered NickServ account, if you want channel auto-join to succeed.
|
|
--------------------------
|
|
Then you'll need to get several modules from CPAN. If you do not have root access, see
|
|
http://perl.jonallen.info/writing/articles/install-perl-modules-without-root
|
|
|
|
AppConfig::Std
|
|
Data::Dumper
|
|
Getopt::Std
|
|
HTML::Entities
|
|
HTML::FormatText
|
|
HTML::Parse
|
|
IPC::Open2
|
|
LWP::Simple
|
|
LWP::UserAgent
|
|
LWP::UserAgent::WithCache
|
|
Net::Dict
|
|
SOAP::Lite
|
|
Text::Autoformat
|
|
Text::Balanced
|
|
URI::Escape
|
|
WWW::Wikipedia
|
|
XML::RSS
|
|
--------------------------
|
|
Some quick-and-dirty info on using stdin (pbot shell after running pbot.sh):
|
|
|
|
You can type in the bot's stdin to talk in channels as the bot,
|
|
e.g. by typing 'msg #pbot2 hi' from the bot's stdin.
|
|
|
|
You can send bot commands to channel by using: ~channel command
|
|
|
|
For instance, the kick command must be run in a channel:
|
|
|
|
~#pbot2 kick somenick Example reason
|
|
|
|
The bot may be backgrounded via ^Z.
|
|
--------------------------
|
|
Coming soon to README:
|
|
|
|
* Description of each PBot module, for dev customisation.
|
|
--------------------------
|
|
Todo:
|
|
|
|
* Add SSL and port options to pbot.pl.
|
|
* Use DualIndexHashObject as base for a Registry class?
|