Odf bot

From ODF::Wiki

Jump to: navigation, search

The ODF Bot is an IRC bot, complete with the D321GO!! netcode. It can display information about the Descent 3 servers listed in the tracker.

ODF Bot
{{{Screenshot}}}
{{{Description}}}
Information
Producer: The Open Descent Foundation
Developers: D.Cent
Current version: 0.05 (in development)
Latest release: none yet
Operating systems: Linux
Category: Utilities
License: GPL version 2
Languages: C++
Website: none
Project page: click here

Contents

[edit] Detailed Description

The ODF Bot works entirely using text commands. If you send text that isn't listed as a command, it will give some information about itself, as well as what you can do with it. (the following text may not be current):

<odf_bot> Hello, I'm the ODF-bot. You can use the following commands:
<odf_bot> help, version, ip, player, quit, contact, say, me, enable_joking, disable_joking, remove_joke, add_joke, ?joking,
create_poll, vote_yes, vote_no
<odf_bot> Use help <command> to get information about the command.

The bot will list all of the commands currently implemented, which you can then use. Commands are executed by typing them in (with paramaters if needed). For example, to list the current version of the bot you would send it the word Version To get help for a certain command, type "help <command>". For example:

help version
<odf_bot> version - dumps current version of the bot

[edit] Command List

The bot currently supports the following commands (as of January 1st, 2009):

help, version, ip, player, quit, contact, say, me, enable_joking, disable_joking, remove_joke, add_joke, ?joking,
create_poll, vote_yes, vote_no

Following is a list of all of the commands usable by regular users.

[edit] Command: help

Usage: help <command>

Get help about a certain command.

[edit] Command: version

Usage: version

Prints the current version of the bot.

[edit] Command: ip

Usage: ip <direct-ip(:port)>

This command queries information about a Descent3 server that is listed in the tracker. This command has nothing to do with the IRC chat. Example:

<D_Cent> ip 85.25.6.74:2096
<odf_bot> Name: DIII DeepBlue 6 AC, Mission: Subway Dancer (sd.mn3), Mod: anarchy, Players: 7/8
<odf_bot> Players on this server: MASHER, famous, mental floss, Wolfman, Matthew, bizmark, sputnik

The port does not need to be specified. It will use 2092 by default. Also, if you leave the d3:// in front of the ip address it will still work

"ip 85.25.6.74" , "ip d3://85.25.6.74:2096"

[edit] Command: player

Usage: player <player's name>

This command searches for the specified player on all D3 servers listed in the tracker.
Example:

<D_Cent> player ernie
<odf_bot> Matches: [BOZ]Ernie ( Descentforum.NET II 9, Kataclysmica1.2, Anarchy, d3://87.106.184.173:2089 )

[edit] Command: contact

Usage: contact

This command will give you instructions how to contact the ODF if you have questions.

[edit] Command: ?joking

Usage: ?joking

This command will print out whether the bot will tell jokes every 30 minutes. Example:

[19:12] <D_Cent> ?joking
[19:12] <odf_bot> Joking is enabled.

[edit] Command: create_poll

Usage: create_poll <time in minutes> <question>

This command creates a poll which will be sent to each user in the channel. The poll may not be longer than 30 minutes. See vote_yes and vote_no for how to answer. Example:

[19:14] <D_Cent> create_poll 10 Are you drunk? :P

[edit] Command: vote_yes

Usage: vote_yes

This command answers "yes" to the current poll.

[edit] Command: vote_no

Usage: vote_no

This command answers "no" to the current poll.

[edit] Additional Information

The bot can be found on the irc.descentforum.net IRC network. The software uses libircclient v1.3 by Georgy Yunaev (http://libircclient.sourceforge.net/).

Personal tools