IRC/Bots/eir

General Information

Explanation	Commands
[blah] denotes an optional command.	Not used
[blah]|[bleh] denotes that at least one must be used.	!btset
(blah|bleh) denotes that one must be used.	!btinfo, !btcheck, !btpending, !btexpired (see note below)

• Note: When the bot asks you for a reason it need to be given in the following format: [action][time]|[reason]. In PM, the bot does not recognise !, so you must set the ban in the format: btset banid ~time reason.

Commands

Note: If you are using the bot in personal message, it is important that you omit the !, as the bot does not recognise it. Include the ! if you are using the bot in #wikimedia-ops.

!btinfo (index|nick|#channel)

This will show you information about one ban if !info index is used. However, if !btinfo nick is used, then it will show all the active bans set by the nick, and how many bans the nick has set in total. If !info #channel is used, the it will return a list of all the active bans set in a channel. Be careful when using this command for channels with lots of bans, as it will flood the channel it is used in.

(e.g. !btinfo 1234, !btinfo #wikipedia or !btinfo Thehelpfulone)

!btcheck #channel (nick|fullMask)

This will return a list of active bans on the #channel that match the user either by nick or full mask (nick will use the bot's internal list)

(e.g. !btcheck #wikipedia Thehelpfulone or !btcheck #wikipedia wikimedia/Thehelpfulone)

!btpending (#channel|nick)

This command will list all of the bans that are both active and uncommented for the #channel or set by the nick.

(e.g. !btpending #wikipedia or !btpending Thehelpfulone)

!btexpired #channel

This command will list all of the bans in #channel that are active and expired.

(e.g. !btexpired #wikipedia)

!btset index [~time]|[reason]

Sets the ban expire time and/or the reason for the ban by index. The index comes from a PM by eir when you set a ban in the channel. The PM will ask you to specify a reason for the ban, if you wish to extend the default ban time (24 hours), type this when you enter your reason: ~time reason, so for the example used, it would be ~14d Trolling.

(e.g. btset 1234 ~14d Trolling)

Time

The default time for bans is 24 hours (for #wikimedia-ops, the default time is 3 hours). To set the time, you need to make sure that you use a ~ when setting the time, or it will set as the reason instead of the time! The following abbreviations are used when setting the time for the bot:

Code	Meaning
d	day
h	hour
m	minute
s	second

Examples of usage

Command	Explanation
~1h	For 1 hour from the time set.
~4h1m4s	For 4 hours, 1 minute and 4 seconds from the time set.
~48h	For 48 hours from the time set, (can also use ~2d).
~14d	For 2 weeks (or 14 days) from the time set.