BotServ

Information

Information regarding the bot service.

The BotServ is provided by us to help maintain your channels access list and provide a limited amount of control for auto-kicking and banning. It is also here to help users if they do not know how to configure their own bot program, or if we start to forbid bots from being used on the network.

Requesting a Bot

As mentioned in the Services page, you are allowed to request a bot, just as long as you follow the form there. Just do not flood us with requests or we will ban you from using the bot services for a set number of days. You can find the actual form for requesting via the Services page.

Botlist

As the network is somewhat geared towards an anime feel, some bots will be made after a particular anime or possibly somewhat relate towards anime in general. However, we are more than happy to fill it with other sort of bots for people. You can always get an up-to-date list by typing this command in IRC:
/bs botlist
We’ll talk about assigning a bot to your channel next.

Assigning a bot

Assigning a bot is easy. However, your channel has to be registered, and only people with founder access can assign a bot.
/bs assign #channel Botname
#channel - This is the channel you want the bot assigned to.
Botname - This is the bot name you wish to assign. It is case-sensitive, so be careful.

That’s all you have to do to assign a bot. Next, we’ll talk about talking through the bot.

Say and Act

Some people like to have fun with people, and this is how they usually do it. People with enough access on the access list can use these two commands to talk through the bot.
/bs say #channel text
This will allow people to talk through the bot. The result will be something like this, using our Shadow bot as an example:

<Shadow> Hello all!
<Twinshadow> How do you do that?!
<Noratetsu> hehe my secret

Corny, I know, but hey, it’s an example. ^_~ Shadow is a bot that can only be used by IRC Ops, of course, since the general theme of a ‘shdaow’ is a dark and lonely place. (But that’s not what we’re going for in a community! ^_^)
Now then, let’s move on to actually configuring the bot.

Configuration

Configuring a bot for your channel is fairly easy, but some think it will be more complicated than it should be. Well, we don’t want that, so here’s an explanation of all the options.
/bs set #channel dontkickops {ON|OFF}
DONTKICKOPS -> This should be self-explanatory, this will protect ops from the auto-kickers.
/bs set #channel dontkickvoices {ON|OFF}
DONTKICKVOICES -> Again, this should be self-explanatory.
/bs set #channel greet {ON|OFF}
GREET -> This turns on or off the greet message that is set from the ENTRYMSG option in ChanServ.
/bs set #channel fantasy {ON|OFF}
FANTASY -> This enables the fantasy commands, such as .kick or .op to be used by people with enough access for the channel.
/bs set #channel symbiosis {ON|OFF}
SYMBIOSIS -> This basically changes ChanServ to say the Botname instead. Example:

Old: ChanServ has given operator status to TwinShadow.
New: Shadow has given operator status to TwinShadow.
mIRC: Shadow sets mode +o TwinShadow

/bs kick #channel bolds {ON|OFF} {number}
KICK BOLDS -> The {number} is the number of times the bot kicks a user until that user is banned. For people running on a three-strike system, 3 is a good number. However, this is up to the channel operators, or those who have specific access to configure the bot.
/bs kick #channel badwords {ON|OFF} {number}
KICK BADWORDS -> This turns on the badwords filter (explained later). Just be careful on how you use this, or you could cause some unexpected bans.
/bs kick #channel caps {ON|OFF} {TTB} {MIN} {PERCENT}
Example: /bs kick #Shadow caps on 3 5 50%

KICK CAPS -> This turns on the caps lock filter, to prevent users from shouting all the time. {TTB} is the “Times To Ban” number. {MIN} is the minimum amount of caps there is in a sentence, while {PERCENT} is how much the caps constitutes to the entire line.
/bs kick #channel colors {ON|OFF} {number}
KICK COLORS -> This should be self-explanatory, as it just kicks users who uses colors in the channel. It’s not usually recommended to set this to ON, but it is up to the user.
/bs kick #channel flood {ON|OFF} {TTB} {LINES} {SECONDS}
KICK FLOOD -> Again, another value that shouldn’t need an explanation. {TTB} has already been explained earlier, so it shouldn’t need another. {LINES} is how many lines a user types, especially those who keep pushing enter every 3 words. {SECONDS} is the amount of time for each line before a kick is in place. A good setting is 3 kicks before a ban, with 5 lines in 8 seconds.
/bs kick #channel repeat {ON|OFF} {TTB} {LINES}
KICK REPEAT -> Basically just kicks users who keep repeating themselves. This option is up to the user, but sometimes a good value is 3-5 for some.
/bs kick #channel reverses {ON|OFF} {TTB}
KICK REVERSES -> This will kick users who use a reversed text. Can be annoying to some, but not to others, it does depend on the channel operators.
/bs kick #channel underlines {ON|OFF} {TTB}
KICK UNDERLINES -> Kicks users who uses underlines, but it is not recommended to have this on, but rather keep this off.
/bs badwords #channel ADD {word} {SINGLE|START|END}
BADWORDS ADD -> This basically adds the word to the badwords filter. If nothing is specified after the {word} value, then anytime a user says that word will be kicked. So, if you have (this is for tutorial purposes) ass in the filter with no parameter, then glass would also kick the user. {SINGLE} will kick any user that says the entire word. {START} will kick users who say the word at the beginning of a sentence. {END} will kick users who say the word at the end of the sentence.
/bs badwords #channel DEL {word}
BADWORDS DEL -> This deletes the word from the filter.
/bs badwords #channel LIST
BADWORDS LIST -> Self-explanatory, lists all the badwords in the filter, including the parameters.
/bs badwords #channel CLEAR
BADWORDS CLEAR -> This clears all of the entires in the filter.
That concludes this tutorial. If you would like more information, then type this:
/bs help
Follow the instructions for the various options. If you still need help, please join the #help channel for further assistance.

Fried Tofu!