Protect bots · service.tcl

Your channel, safe from takeovers. Within a second.

An EpicBots bot watches your channel day and night. It stops a takeover without waiting for its queue, gives op back to your people and leaves the channel as it was. And it brings everything you need to run it.

instant reactionhourly backup80+ commandsfree

Get my bot See the commands

#clan-nova· 03:12

#features

Everything it does for your channel

Every Protect bot runs service.tcl, the EpicBots protection engine, and is linked to the hub, which sees the whole network at once.

Stops takeovers instantly

Kick-ban, Q RECOVER, lockdown and re-op in the same second, without waiting for the message queue. 90 seconds later it restores the channel.

Flood and spam protection

Lines, joins, nick changes and CTCP. The spamscan scores colours, capitals, repeats and advertising: it warns, kicks and bans.

Clones and drones

Bans hosts with too many connections. The hub watches every channel at once and bans drones on all of them.

Full control of modes

enforcemodes, bitchmode, a known-users-only channel and a temporary lockdown with one command.

Filters your way

Forbidden words, forbidden channels, advertising, flyby and bans by Q account.

Built for Q

Secure login with CHALLENGEAUTH, a check of its chanlev, Q bans, RECOVER and your channel's settings in Q.

A backup every hour

Topic, modes, bans, users, settings and Q chanlev. If your bot changes, the new one restores everything.

Topic, welcome and notices

Topic templates, a welcome message, automatic messages, autolimit and the user record.

Always online

It restarts by itself, logs in to Q again after a server change and reports to the hub every 5 minutes. You can also ask for a second bot as a pair.

#takeover

What happens during a takeover

The bot doesn't wait for its message queue: defence orders go straight to the server, and long notices stay quiet until the attack is over.

0 s
Detects the attackSeveral deops, kicks or bans in a row from someone without access.
0 s
Throws the attacker outImmediate kick-ban and deop of anyone who shouldn't have op.
+1 s
Asks Q for helpRECOVER of the channel and removal of the attacker from the chanlev.
+1 s
Locks the channelLockdown +im so nobody else joins or talks.
+2 s
Gives op backRe-op of the ops saved with $saveop who are still there.
+90 s
Leaves it as it wasRestores topic, bans, users and chanlev from the backup taken before the attack, without the attacker. The staff is told.

constant checks

A bot never stays on an abandoned channel

Every 10 minutes the bot checks your channel. If something stops being true, it warns on the channel and the owner by notice, and only leaves when the time is up.

Check	Time
The bot has its access in Q's chanlev (`+amo`; `+ao` for trivia bots)	1 hour
The channel has enough users (5 or more)	3 days
Q is on the channel	6 hours
The bot can join (no ban, key or invite)	6 hours
It isn't kicked again and again	3 kicks / hour

#levels

Access levels on your channel

You decide who does what. The bot recognises everyone by their +x host or their Q account.

Level	Who	What they can do
owner	Who asked for the bot	Everything: on top of master, remove or give away the bot, change the language, restore backups and set the levels of the commands.
master	Your managers	Set up the protection, give and take access, manage the topic, welcome and Q bans.
op	Your ops	Op, voice, kick, ban, invite, modes and making the bot talk.
voice	Trusted users	Automatic voice and lookup commands.
ban	Unwanted users	Nothing: the bot bans them whenever they join.

#management

Run your channel from IRC

Type the commands on your channel with your trigger ($ by default, or the bot's nick: EpicGuard op). Start with the basics; the advanced ones are one click away. $help command explains any of them.

#get-a-bot

Get your bot

Type your channel, check the requirements and copy the command. You ask for it on IRC, in #EpicBots, authed with Q.

Your command

!request pro #mychannel

Auth with Q: /msg Q@CServe.quakenet.org AUTH account password
Join #EpicBots and paste the command.
When the bot arrives, give it access (the bot tells you its name): /msg Q CHANLEV #mychannel #Bot +amo
Follow the first steps to set it up.

Open the webchat in #EpicBots

#first-steps

Your channel protected in 5 minutes

What to do as soon as the bot arrives. Type each command on your channel.

Turn the protection on
$protection on
Reverts mode, kick and topic changes by strangers. Takeover protection needs it.
Save your ops
$saveop
Notes who has op now. After a takeover, the bot gives op back to them.
Give your team access
$adduser Nick handle op
Use master for managers and op for ops. The bot stores their +x host and their Q account.
Stop the flood
$flood on
Kick-ban for anyone flooding the channel with lines, joins or CTCP. Tune the limits with $flood set.
Filter the spam
$spamscan on
Scores colours, capitals, repeats and advertising: warns, kicks and bans.
Cut the clones
$clonescan on
Bans hosts with too many connections at once.
Make the first backup
$backup
The bot makes one every hour, but this way you have one from the start. $backups lists them.
Check the result
$status
Lists the features that are on. $help shows all your commands.

What you need from Q

Q is QuakeNet's channel service. Your Q account is your identity for EpicBots, and the bot needs access in your channel's chanlev.

Chanlev flags

Flag	Meaning
+n	Owner of the channel in Q.
+m	Master: manages the chanlev. A Protect bot needs it for RECOVER.
+o	Op: may ask Q for op and set Q bans.
+a	Auto-op on join. The bot uses it to get op back by itself.
+v	Voice.
+g	Auto-voice on join.
+t	May change the topic through Q.
+k	Known user of the channel.
+b	Banned by Q.
+d	Q always takes their op.

Useful Q commands

/msg Q HELLO email@example.com email@example.com

Creates your Q account. The password arrives by email.

/msg Q@CServe.quakenet.org AUTH account password

Logs you in. With this full address nobody can pretend to be Q.

/mode YourNick +x

Hides your IP behind account.users.quakenet.org. The bot recognises you by that host.

/msg Q CHANLEV #channel #EpicGuard +amo

Gives a Protect bot its access. Change the channel and the bot's name to yours; trivia bots only need +ao.

/msg Q CHANLEV #channel

Lists who has access to your channel in Q.

/msg Q WHOAMI

Shows your account and your channels in Q.

#chanserv

What you need from NickServ and ChanServ

DALnet's services: NickServ keeps your nick, ChanServ keeps your channel. Your registered nick is your identity for EpicBots, and the bot needs access in your channel's ChanServ lists.

ChanServ access

Level	Meaning
Founder	Owner of the channel in ChanServ: changes everything, SOP list included.
SOP	Super op: manages the AOP list and the AKICKs, and can MDEOP. A Protect bot needs it for the full takeover protection.
AOP	Auto-op: op on join and through ChanServ. Enough for a trivia bot to get its op back.
AKICK	Kicked and banned by ChanServ whenever they join, even with no bot on the channel.
OPGUARD	Only the AOP/SOP lists may have op. `$cssecure` turns it on with KEEPTOPIC and IDENT.
+R	Channel mode: only registered nicks may join. The bot uses it during a lockdown.

Useful NickServ and ChanServ commands

/msg NickServ@services.dal.net REGISTER password email

Registers your nick. With this full address nobody can pretend to be NickServ.

/msg NickServ@services.dal.net IDENTIFY password

Identifies you. Do it every time you connect: DALnet renames an unidentified registered nick to Guest after a minute.

/msg ChanServ@services.dal.net REGISTER #channel password description

Registers your channel (you need @ on it). You become its founder.

/msg ChanServ@services.dal.net SOP #channel ADD EpicGuard

Gives a Protect bot its access. Change the channel and the bot's name to yours; trivia bots only need AOP.

/msg ChanServ@services.dal.net SOP #channel LIST

Lists the SOPs of your channel (AOP LIST for the AOPs).

/msg ChanServ@services.dal.net INFO #channel

Shows the founder and the settings of your channel.

#rules

Rules of use

EpicBots is free and stays that way if it is used well. Asking for a bot means accepting these rules.

One bot per type and accountEvery Q account may have one bot of each type and two in total. A pair bot counts apart and the staff approves it.
Active channelsThe channel has to keep the minimum users. An empty or abandoned channel loses its bot when the time is up.
No abuseThe bot is not used to attack, flood or annoy other channels or users. Doing so means losing the bot and joining the blacklist.
No drone channelsChannels of bots, drones or illegal activities get no bot, and the ones they have are removed or suspended.
Q access staysThe bot needs its access in your chanlev. If you take it away, it warns you and leaves after an hour.
The staff decidesThe staff may deny, remove, suspend or move a bot when needed. Questions go to #EpicBots.

Ready to protect it?

One command in #EpicBots and your channel has a guardian within a minute.

Get a bot All the commands