Bot

What is a bot

A bot is a standalone client or script for an existing client or any other form of software, which has the purpose to automate certain tasks or provide special functions in for instance an IRC Chatroom.

BotServ

What is BotServ

On the Chat4All network we run a service called BotServ, which is part of the Anope Services package.

BotServ provides us with customised ChanServ aliases which contain some extra shortcuts to the most commonly used ChanServ commands, such as voicing, opping, kicking, banning, managing the accesslist and xOP list and some more commands.

BotServ Features

The bot appears as another user in the room as soon as there are 2 or more persons in the room and most of its details (Nickname, Ident, Vhost and Real name) are customisable when the bot is requested.

Through the Symbiosis-feature, all actions normally done by ChanServ, such as banning or voicing, will be done by your bot. With the BotServ's SAY and ACT commands, AOP's and higher can also make the bot 'speak' or 'act' (similar to a /me action) in the room.

ZBot feature

We have also installed the ZBot module. If ZBot is enabled by the channel's Founder for the channel, then it allows the channel's AOP's and higher, to learn the bot keywords and their meanings through the !learn command. Then everyone can use the ? keyword command to request the assigned meaning of the keyword. For more info about ZBot, please type the /helpop zbot irc-command while connected to our network. A wiki-page on ZBot will be created soon.

Request a Bot

There are two options to have a bot inside your registered chatroom:

Readymade Bot

You can choose a bot from the list that will be generated with the below command.
These bots are either created by us, or other users. The name of these bots cannot be changed. To see which readymade bots currently are available, you can type (include the /)

/msg BotServ BOTLIST

You will be presented with a list like:

 BotServ: Bot list:
 BotServ: SpongeBob (Nickelodeon@Krusty.Krab)
 BotServ: Aladdin (Wonderlamp@chat4all.org)
 BotServ: Shrek (Ogre@Far.Far.Away)

Once you've found yourself a botconfiguration you'd like in your room, type:

 /msg botserv ASSIGN #Channel BotNick

Where #Channel is the name of your registered channel, and BotNick is the name of the bot from the BotList you requested earlier.

Custommade Bot

You can choose a customised bot with your own chosen (nick)name, ident and Vhost.
This name may not be a registered username (this will be checked by us before we create the bot).
You can check this first by changing your name to the name you want the bot to have. If you receive the message that it is a registered name, then you will have to find a new name.

Bot Information

To create a custom bot, we will need some information from you:

 *a. a nickname (The name for your bot)
 *b. an ident/username (which is seen when you do a /whois)
 *c. a hostname (like a vhost e.g.: i.am.a.bot)
 *d. a Realname/Gecos (also seen when you do a /whois -- For instance I am a bot or You are not me or John Smith)
 *e. the name of the registered room the bot needs to be assigned to
 *f. your registered nickname

Example

A typical bot can look like the following example:

 Shrek!Ogre@Far.Far.Away)
 - Nick: Shrek
 - Ident: Ogre
 - Vhost: Far.Far.Away
 - Real name: I have layers!

All info above does not have to exist and may be fake (we even prefer fake info due to possible legal trademark issues). Please note that the Vhost may only be a registered domain if you own that domain. Also the ident may contain no special characters other than a dot and may be no longer than 9 characters.

Details

The bot itself will only appear when there are at least 2 users in your chatroom. As soon as only one user is left, the bot will go away and will re-appear when another user enters the room.

When you pick a bot with a self chosen name, then you can have it made "PRIVATE" by us. If you do not have it set to private, then the bot will appear in the bot listing so that other users can have your bot in their room as well.

All bots are configurable to your own liking. For more info on how to do this, type the following command while connected to our server:

 /msg botserv help

or read our Online BotServ Manual

Requestform

If, after having read the above, you decide you want a bot, open a new Bot Request Ticket at our new Chat4All Support Desk, copy the below form to it and fill it in.

a. Bot's Nickname:
b. Bot's Ident & Vhost:	ident@this.is.my.vhost
c. Bot's Realname/Gecos:
d. Channelname to assign to:	#
e. Your registered nickname
f. Private?	yes/no

If you submit the above information in a new ticket, we will process the request as soon as possible. Once the request is processed and the bot created, the support ticket will be updated with a confirmation. In case some of the information is missing or invalid, a staff member will contact you about it through updates on the support ticket.

Clarification of Form

For a clarification of the terms used in the form above:

a. Bot's Nickname:	The name under which the bot will appear in the nicklist
b. Bot's Ident & Vhost:	the 'address' the bot appears to be connected from, as seen in a /whois -- in the form of ident@this.is.my.vhost
c. Bot's Realname/Gecos:	The 'name' of the bot as seen in a /whois -- E.g.: I am a bot
d. Channelname to assign to:	Your registered channel where the bot should appear
e. Your registered nickname	This should be your nickname with which you registered the chatroom.
f. Private?	Is the bot only allowed for your chatroom (yes) or to be chosen by everyone (no).

IMPORTANT

In the past we've had users sending us the channelpassword as well, thinking that we would need that.

However, we do not need that and a staffmember will never request the password of your nickname or channel for these matters.
Please keep your password information to yourself and report anyone asking for it, claiming to be staff.

Created and last editted: --FiXato 01:51, 27 Aug 2005 (CEST)

Dutch Summary

Er zijn twee mogelijkheden om een botje op naam in je geregistreerde kamer te krijgen:

1. Je kiest uit het lijstje een al bestaande bot. Deze botjes zijn door andere gebruikers of door ons gemaakt en hun naam kun je niet wijzigen. Om te zien welke bestaande botjes op het moment beschikbaar zijn typ je:

/msg botserv BOTLIST

Je ziet dan een lijstje met o.a.

BotServ: Bot list:
BotServ: SpongeBob (Nickelodeon@Krusty.Krab)
BotServ: Aladdin (Wonderlamp@chat4all.org)
BotServ: Shrek (Ogre@Far.Far.Away)

het toevoegen aan je kamer doe je vervolgens met:

/msg BotServ Assign #kanaal Botnick

waarbij je

Botnick

vervangt met nickname van de bot die je in de botlijst hebt gevonden, en

#kanaal

vervangt met de naam van je eigen kanaal.

2. Je kiest zelf een naam voor je bot. (Deze naam mag niet een geregistreerde nickname van een gebruiker zijn, dit wordt door ons gecontroleerd. Probeer eerst even zelf de nickname van je bot aan te nemen en kijk of je een melding krijgt dat die naam al geregistreerd is.)

Hiervoor heb ik een paar door jou verzonnen namen nodig en wel:

a. een nickname (de naam van de bot)
b. een ident/user naam (op te vragen met /whois botnaam)
c. een host naam (net als een vhost, bijvoorbeeld: ik.ben.een.bot)
d. een 'echte naam'
 

Wat vul je dan in? Als voorbeeld nemen we 'Shrek (Ogre@Far.Far.Away)'

- a. nick: Shrek
- b. ident: Ogre
- c. host: Far.Far.Away
- d. en de real name/echte naam is: I have layers!

Je mag dus al deze namen zelf bedenken.
Het botje zelf verschijnt pas in je kamer zodra er 2 gebruikers of meer in je kamer aanwezig zijn. Wanneer je alleen overblijft gaat het botje weg en komt pas terug als er weer iemand bijkomt.

Als je een botje met zelf gekozen namen neemt, kun je het door ons PRIVATE (privé) laten zetten. Doe je dat niet dan verschijnt het in de botlist (te zien via /msg botserv BOTLIST) en kunnen ook andere gebruikers dit botje aan hun kamer laten verbinden.

Voor alle botjes geldt hetzelfde, je kunt ze naar eigen wens configureren, typ /msg botserv help.

Als je besloten hebt dat je een botje wil, laat ons dan even weten onder welke naam/namen en vermeld dan tevens in welke (geregistreerde) kamer je dit botje wil hebben.

Aanvraagformulier

Even samenvattend, wat we willen weten is dus:

a. Nickname van Bot:
b. Ident & Vhost voor de Bot:	ident@dit.is.mijn.vhost
c. Echte naam/Gecos van de Bot:
d. Naam van het Kanaal voor de Bot:	#
e. Jouw geregistreerde nickname
f. Prive?	ja/nee

Als je besloten hebt hoe je bot 'eruit moet komen te zien', open dan een nieuw Bot Request Ticket via ons Chat4All Ondersteunings Systeem, kopieer de bovenstaande informatie naar het ticket en vul het in. We zullen we je verzoek zo spoedig mogelijk behandelen. Zodra de aanvraag is verwerkt en de bot is aangemaakt, zal je een bevestigingse-mail krijgen. In het geval dat de opgegeven informatie onvoldoende of incorrect is, zal een stafflid contact met je opnemen via updates op het ticket.

Uitleg Terminologie

Voor een uitleg van de termen die in het bovenstaande formulier zijn gebruikt:

a. Nickname van Bot:	De naam van de bot waarmee de bot in de nicklijst zal verschijnen in de kamer.
b. Ident & Vhost van de bot:	het 'hostadres' waarvan de bot via verbonden te lijkt te zijn, zoals te zien is in een /whois -- in het formaat ident@dit.is.mijn.vhost
c. Echte Naam/Gecos van de Bot:	De 'echte naam' van de bot zoals te zien in een /whois -- V.b.: Ik ben een botje
d. Naam van het Kanaal voor de Bot:	Jouw geregistreerde kanaal waaraan de bot gekoppeld dient te worden en dus zal verschijnen.
e. Jouw geregistreerde nickname	Dit dient de nickname te zijn waarmee je de desbetreffende kamer hebt geregistreerd.
f. Prive?	Is het alleen toegestaan om de bot voor jouw kamer te gebruiken (ja) of is hij publiekelijk opvraagbaar in de botlist en dus door iedereen te gebruiken (nee).