BotServ/en

What is BotServ?   BotServ allows you to have your own bot in your room.
It was made for those who cannot host or hire a bot.
It was also designed for networks that don't allow their own bots.   I'm trying to explain the possibilities BotServ can offer you with the help of text and pictures.
For the necessary examples, I'll refer to the room #TestRoom.  

ACT

With the ACT function, the BOT executes a kind of "/me" command in the specified space with the associated text.
The command we would have to write for this would be /BS ACT CHANNEL TEXT

So for our example we use /bs act #TestRoom Hello I'm a bot!
The result looks like this:

---

ASSIGN

With the ASSIGN command you can assign an existing SystemBot to your room and configure it later.
So the executable command with suitable parameters is: /BS ASSIGN channel nick

Since there is already a bot in the #TestRoom room, we assign another to this room:
So we write: /bs assign #TestRoom BotServ

The following happened:

---

BADWORDS

With BADWORDS, the swear word filter of a room can be set and managed.
This means that the words in this filter have a kick or ban as a result when the BADWORDS KICKER is active.

The command parameters for BADWORDS are:

BADWORDS channel ADD word [SINGLE| START| END]
BADWORDS channel DEL {word| entry-num| list}
BADWORDS channel LIST [mask| list]
BADWORDS channel CLEAR

The specified word is added to the list with the ADD parameter.
An example: /BS BADWORDS #TestRoom ADD kanacke

If the parameter SINGLE is given after the word, a kick occurs only if a user says the whole word.
If the parameter START is given after the word, a kick occurs only when a user says a word that begins with the word.
If the parameter END is specified after the word, a kick occurs only if a user says a word that ends with the word.
If no parameter SINGLE, END orSTART is specified, a kick will be played whenever the word is mentioned in any way.

With the DEL parameter, the named word is removed from the list.
An example: /BS BADWORDS #TestRoom DEL kanacke

If the parameter entry-num is set to "51-100", words from entry 51-100 onwards will be removed.

With the LIST parameter, the badwords list is displayed.
If you enter a wildcard inform of *ussi*, all words where ussi occurs will be listed.
If you enter a range of numbers, these will be displayed Ranges specified.

Example: /BS BADWORDS #TestRoom LIST 2-5,6-9
This lists all entries from 2-5 and 6-9

The CLEAR parameter clears the entire badwords list

---

BOTLIST

With BOTLIST you can display which system bots are available, which you can then assign using #ASSIGN.
Example: /BS BOTLIST

---

INFO

Allows you to get information about the given room or nickname.
If a nickname is given you get information about:

• The bot
• The creation time
• The number of rooms it is in.

If the room is specified, the active or inactive kickers are displayed:

---

KICK

Management and setting of the BOT Kicker.
Parameters are KICK option channel {ON|OFF} [settings]

KICK BADWORDS

The BADWORDS parameters would be KICK BADWORDS channel {ON|OFF} [ttb]

With BADWORDS, the bot will kick if a message is sent with a BADWORD which is in in the BADWORDS list.
ttb is the number of kicks before a ban is set. If you don't give it, the ban system will be disabled.

Example: /BS KICK BADWORDS #TestRoom ON 3
Let's look at how the whole thing behaves with the word Kanake that we enter in the room #Testroom:
We proceed as follows:

1. We enter Kanacke in the badwords list of #Testraum with /BS BADWORDS #TestRaum ADD Kanake
2. We set the kicker so that it bans after 2 kicks with /BS KICK BADWORDS #TestRoom ON 2
3. Now let's see what happens when the user writes kanake and every time he types the word gets kicked See image:

---

KICK BOLDS

The bold kicker responds to messages written in bold.
 

Let's look at the example in the room test room.
So we write:/BS KICK BOLDS #TestRoom ON 2

The 2 tells us that after 2 kicks a ban follows.
See picture:

---

KICK CAPS

This kicker is a bit more difficult to set up since we have the following parameters:
KICK CAPS channel {ON|OFF} [ttb [min [percent] ]]

How does he react?

When this is active the bot will check if someone is sending a message with capital letters.
So it will kick if mincharacters are capitalized and these are percent% of the whole message.
(If min and percent are not specified, the standard is set to 10 characters at 25%)
 

ttb is again the number of kicks before a ban is set.
Here's an example:
So we want 10 characters to react to 30% of the total message and a ban after 2 kicks follows.
So we write /BS KICK CAPS #TestRoom ON 2 10 30
You can see the result in the picture:

---

KICK COLORS

This kicker reacts to colored text.
You put this over /BS KICK COLORS #channel ON|OFF ttb

ttb is the number of kicks after a ban is set.
Example: /BS KICK COLORS #TestRoom ON 2
See picture for result:

---

KICK FLOOD

Everyone knows people who like to flood a room (FLOOD).
The Flood kicker will help you with this. This works by having people send x messages in y seconds.
If none of them are specified, the defaults are used (6 messages in 10 seconds)
The command parameters here would be: /BS KICK FLOOD #Channel ON|OFF ttb x y
ttb is the number of kicks before a ban follows.

An example we want in the test room that if you send 3 messages in 5 seconds you will be kicked and a ban follows after 2 kicks.
So we write /BS KICK FLOOD #TestRoom ON 2 3 5

Results look at:

---

KICK ITALICS

The Italics Kicker responds to messages written in "italics."
We have the following parameters again: /BS KICK ITALICS #Channel ON|OFF ttb
The ttb is again the number of kicks before a ban follows

Example:
We want the bot to set a ban on the 1st violation of italics.
So the following command: /BS KICK ITALICS #Testraum ON 1

Results see at Picture:

---

KICK REPEAT

If someone writes the same message, it is called REPEAT. If you don't want this, the REPEAT Kicker helps.
This reacts when the same message is sent several times. If you don't enter a number, the default is 3x.
The parameters are /BS KICK REPEAT #Channel on|off ttb num
ttb stands for the number of kicks before the ban follows .

An example:
We want the same message to be kicked and banned once after 1x.
So we write: /BS KICK REPEAT #TestRoom on 1 1

See picture for result:

---

KICK REVERSE

The reverse kicker only reacts to MIrc clients who reject a message using ctrl+r message.
Here we have the usual parameters /BS KICK REVERSES #Channel on|off ttb

ttb would again be the number of kicks before a ban comes.

Example;
We want reverses to be banned after try 1.
So /BS KICK REVERSES #testroom on 1

Picture:

---

KICK UNDERLINES

This kicker reacts to "Underlined text".
It is set with the usual parameters: /BS KICK UNDERLINES #Channel on|off ttb

ttb is the number of kicks before a ban.
See example:

We set a ban after the 2nd try of underlined text.
So we write: /BS KICK UNDERLINES #testroom on 2

Picture:

---

SAY

The SAY command allows the bot to speak.
Just write /BS SAY #Channel message

Example:
/BS SAY #Testraum Hallo Welt
Results in:

---

SET

Advanced bot settings

SET BANEXPIRE

This sets the expiry time of the bans set by the bot.
This includes all bans from the bot including those of the kickers.
The parameters for this are /BS SET BANEXPIRE CHANNEL time
time = time in seconds.

Example:
We want all bans to expire automatically after 1 minute, so we write: /BS SET BANEXPIRE #TestRoom 60
See image:

---

SET DONTKICKOPS

With this setting, @ users will not be kicked by the bot.
The parameters are /BS SET DONTKICKOPS #CHANNEL ON|OFF

---

SET DONTKICKVOICES

With this setting + users will not be kicked by the bot.
The parameters are /BS SET DONTKICKVOICES #CHANNEL ON|OFF

---

SET FANTASY

With this setting you activate the control of the bot via ! Commands.
Note the user must have access to the command itself and the right to execute commands.
To activate it, type: /BS SET FANTASY #channel ON

SET GREET

Here you set whether the greeting message that you previously set at NickServ is displayed in the room.
Provided you have the necessary access for it.
To activate it, write: /BS SET GREET #channel on

---

UNASSIGN

With this command you remove the bot from your room
Write /BS UNASSIGN #Channel