Difference between revisions of "Bot"

From Chat4AllFAQ
Jump to: navigation, search
m (Dutch Summary)
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
[[Category:EN]]
 
== What is a 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.
 
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.
Line 12: Line 13:
 
Through the Symbiosis-feature, all actions normally done by ChanServ, such as banning or voicing, will be done by your bot.  
 
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.
 
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.
 +
 +
'''To be clear: our BotServ bots ''do <u>not</u> have !trivia, !quote, !uno, !start or other similar (game) commands built-in!'''''<br />
 +
You need to search and run a bot of your own for this. We can't help you set one up for you. Useful search terms are: ''eggdrop'', ''windrop'', ''mIRC bot'', ''ruby cinch bot'', or ''ruby rbot''.
 +
 +
=== Expectations ===
 +
'''What can you expect of a BotServ bot?'''
 +
 +
* '''Keyword definitions through [[ZBot]].'''
 +
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 teach the bot keywords and their meanings through the '''!learn''' command.
 +
This allows everyone to use the '''? keyword''' command to request the assigned definition of the keyword.
 +
For more info about ZBot, either use the:
 +
  '''''/helpop zbot'''''
 +
irc-command while connected to our network; issue '''''!zhelp''''' on your channel while your BotServ bot is there (and ZBot is enabled), or ''read our [[ZBot|ZBot wiki page]]'' for more in-depth information about ZBot.
 +
 +
* '''Fantasy commands.''' These are actually just simplified forms of several ChanServ and BotServ commands such as !kick, !ban, !kb and !akick. For an overview of all fantasy commands, type the following command in your channel (when your BotServ Bot is in the room):
 +
  '''''!help'''''
 +
 +
* '''Automatic kicks and bans''' based on the use of specific words (see ''/BOTSERV HELP BADWORDS''), excessive caps-, bold- or other formatting abuse or repeated text. For more details, read the text given by the services when using the commands:
 +
  '''''/BOTSERV HELP'''''
 +
and for instance:
 +
  '''''/BOTSERV HELP KICK'''''
 +
 +
* '''Saying messages or /me actions through the bot.''' You can use the '''/BOTSERV SAY''' and '''/BOTSERV ACT''' commands to make the bot say or 'do' things.<br />
 +
For more information about this feature, use:
 +
  '''''/BOTSERV HELP SAY'''''
 +
and
 +
  '''''/BOTSERV HELP ACT'''''
 +
 
=== ZBot feature ===
 
=== 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.  
 
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.  
Line 25: Line 54:
 
To see which readymade bots currently are available, you can type '''''(include the /)'''''
 
To see which readymade bots currently are available, you can type '''''(include the /)'''''
  
  '''''/msg botserv BOTLIST'''''
+
'''''/msg BotServ BOTLIST'''''
  
 
You will be presented with a list like:
 
You will be presented with a list like:
Line 33: Line 62:
 
   '''BotServ:''' Aladdin (Wonderlamp@chat4all.org)
 
   '''BotServ:''' Aladdin (Wonderlamp@chat4all.org)
 
   '''BotServ:''' Shrek (Ogre@Far.Far.Away)
 
   '''BotServ:''' Shrek (Ogre@Far.Far.Away)
 +
 +
Once you've found yourself a botconfiguration you'd like in your room, type:
 +
  '''''/msg botserv ASSIGN <font style="color: blue;">#Channel</font> <font style="color: red;">BotNick</font>'''''
 +
Where ''<font style="color: blue;">#Channel</font>'' is the name of your '''registered''' channel, and '' <font style="color: red;">BotNick</font>'' is the name of the bot from the BotList you requested earlier.
  
 
=== Custommade Bot ===
 
=== Custommade Bot ===
Line 70: Line 103:
  
 
=== Requestform ===
 
=== Requestform ===
If, after having read the above, you decide you want a bot, then copy the below form to an e-mail, fill it in and send it to '''''bot @ chat4all.org'''''
+
If, after having read the above, you decide you want a bot, [http://support.chat4all.net/index.php?/Tickets/Submit open a new Bot Request Ticket] at our [http://support.chat4all.net Chat4All Support Desk], copy the below form to it and fill it in.
 
{|
 
{|
 
|---- bgcolor=#CCCCCC
 
|---- bgcolor=#CCCCCC
Line 92: Line 125:
 
|}
 
|}
  
If you submit the above information to '''''bot @ chat4all.org''''', we will process the request as soon as possible.
+
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, you will receive an e-mail with the confirmation.
+
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 by e-mail.
+
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 ===
 
=== Clarification of Form ===
Line 124: Line 157:
 
Please keep your password information to yourself and report anyone asking for it, claiming to be staff.
 
Please keep your password information to yourself and report anyone asking for it, claiming to be staff.
 
</div>
 
</div>
Created and last editted: --[[User:FiXato|FiXato]] 01:51, 27 Aug 2005 (CEST)
 
  
 
== Dutch Summary ==
 
== Dutch Summary ==
Er zijn twee mogelijkheden om een botje op naam in je geregistreerde kamer te krijgen:
+
Zie [[NL/Bot]]
 
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 <font style="color: red;">Botnick</font> <font style="color: blue;">#kanaal</font>
 
 
waarbij je ''<div style="display: inline;color: red;">Botnick</div>'' vervangt met nickname van de bot die je in de botlijst hebt gevonden, en <div style="display: inline;color: blue;">#kanaal</div> 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.<br />
 
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.
 
 
 
 
Even samenvattend, wat we willen weten is dus:
 
 
A. de naam/namen van het botje, gekozen uit punt 1 of 2 (nickname - ident - hostname - echte naam)
 
B. in welke geregistreerde kamer komt dit botje
 
C. mag het botje voor iedereen beschikbaar zijn of wil je de PRIVATE optie aangezet hebben.
 

Latest revision as of 15:52, 3 April 2016

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.

To be clear: our BotServ bots do not have !trivia, !quote, !uno, !start or other similar (game) commands built-in!
You need to search and run a bot of your own for this. We can't help you set one up for you. Useful search terms are: eggdrop, windrop, mIRC bot, ruby cinch bot, or ruby rbot.

Expectations

What can you expect of a BotServ bot?

  • Keyword definitions through ZBot.

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 teach the bot keywords and their meanings through the !learn command. This allows everyone to use the ? keyword command to request the assigned definition of the keyword. For more info about ZBot, either use the:

 /helpop zbot

irc-command while connected to our network; issue !zhelp on your channel while your BotServ bot is there (and ZBot is enabled), or read our ZBot wiki page for more in-depth information about ZBot.

  • Fantasy commands. These are actually just simplified forms of several ChanServ and BotServ commands such as !kick, !ban, !kb and !akick. For an overview of all fantasy commands, type the following command in your channel (when your BotServ Bot is in the room):
 !help
  • Automatic kicks and bans based on the use of specific words (see /BOTSERV HELP BADWORDS), excessive caps-, bold- or other formatting abuse or repeated text. For more details, read the text given by the services when using the commands:
 /BOTSERV HELP

and for instance:

 /BOTSERV HELP KICK
  • Saying messages or /me actions through the bot. You can use the /BOTSERV SAY and /BOTSERV ACT commands to make the bot say or 'do' things.

For more information about this feature, use:

 /BOTSERV HELP SAY

and

 /BOTSERV HELP ACT

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 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.

Dutch Summary

Zie NL/Bot