|
Everyone will want to grab bitchbot-1.0.2.tar.gz (34kb). This contains the
perl script that is bitchbot, a basic readme, the stats module, and a config template that you can fill in. For help on getting the bot running,
be sure to read through the notes in the config file and bitch.pl file.
The other downloads are split by OS:
| linux, solaris, freebsd, etc
|
|
| qstat (link)
|
|
| qstat game server query tool by Steve Jankowski. Bitchbot can use this tool to return game information
for a variety of FPS games to the channel. This link will take you to the qstat website where you can download the source
code for qstat. You will then need to compile it - refer to the instructions that come with qstat. Once compiled, move the
file 'qstat' to the same directory as bitch.pl for bitchbot to notice it. |
| |
|
| Time::HiRes source (link to CPAN)
|
|
| Time::HiRes is a perl module that bitchbot can optionally use to perform high resolution timing for
ping replies. Basically if someone issues 'ping me', the reply time will be to the nearest second without this module. With
it, the precision is greatly increased into milliseconds and beyond. Note, you will need administrative access to install
this to your local perl installation. If in doubt, ask your administrator to use CPAN 'install Time::HiRes'. |
| |
|
| Net::FTP (libnet) source (link to CPAN)
|
|
| Bitchbot can optionally use Net::FTP to upload the generated channel statistics to a remote FTP server
such as to your ISP. You will need administrative access to install this to your local perl installation. If in doubt, ask
your adminstrator to use CPAN 'install Net::FTP'. |
| |
|
| spawn.sh.tar.gz (0.1k)
|
|
| This is a sample shell script that will continuously run the bot if it exits. Since the bot will exit if the
server connection breaks or for a new config, etc it will be handy to have it automatically restart. Place this
script with the same directory as bitch.pl, chmod 755 spawn.sh then ./spawn.sh & to send the bot to the background with
automatic restarting. Do note though, if you edit the config and then tell the bot to restart, this script will try and restart
it - if you messed up the config, the bot will not return and sit there infinitely trying to launch a new copy of itself
over and over. (In case you're wonndering why I would bother to tar.gz such a small file it's because otherwise some
browsers would either interpret it as text and not save it, or perform on-the-fly gzip decompression and again, show text)
|
| |
| Win32
|
|
| qstat (link)
|
|
| qstat game server query tool by Steve Jankowski. Bitchbot can use this tool to return game information
for a variety of FPS games to the channel. Since most Windows users won't have a compiler, this link will take you to a
the qstat site, where you can download the program. Place the qstat.exe file in the same folder as bitch.pl for bitchbot to start using it. |
| |
|
| spawn.zip (0.1k)
|
|
| This is a sample batch file that will continuously run the bot if it exits. Since the bot will exit if the
server connection breaks, or for a new config, etc it will be handy to have it automatically restart. Place this
file into the same folder as bitch.pl, then run spawn.bat from the command line to have the bot in an auto-restart loop.
Do note though, if you edit the config and then tell the bot to restart, this batch file will obviously try and restart
it - if you messed up the config, the bot will not return and sit there infinitely trying to launch a new copy of itself
over and over.
|
| |
|
| Time::HiRes binary (7.8kb)
|
|
| Time::HiRes is a perl module that bitchbot can optionally use to perform high resolution timing for
ping replies. Basically if someone issues 'ping me', the reply time will be to the nearest second without this module. With
it, the precision is greatly increased into milliseconds and beyond. Again, since most Windows users do not have a compiler,
this link will take you to a pre-compiled version that you can extract into your ActivePerl installation. Just extract the .zip
into your ActivePerl directory with folders enabled. |
| |
|
| Net::FTP (libnet) binary (52.2kb)
|
|
| Bitchbot can optionally use Net::FTP to upload the generated channel statistics to a remote FTP server
such as to your ISP. Just download this .zip and extract it into your ActivePerl directory with folders enabled. |
| |
|
| Emulated uptime binary (16.8kb)
|
|
| This file will allow the 'uptime' command to report the system's uptime to the channel. Since unix
users have an uptime command by default, this .exe will fake the same type of functionality for Windows. Simply download the
.zip file and extract it into the same folder as bitch.pl |
All of the above downloads are optional, but will add various extra functionality to the bot. For Win32 users, if you only
want to run bitchbot it will probably be easier if you throw the contents of bitch-1.0.2.tar.gz into your ActivePerl 'bin' directory as this
will save you having to set paths and such.
Please keep in mind that the bot will exit if the server connection breaks or you issue the restart command. If you
use the 'quit' command, the bot will try and tell the auto-restart script not to run another copy, so to load a new config
it is best to use 'restart'. The above sample scripts will do the job, take a look at them if you want more customisation. |
