ban: Enhanced banmask tracking

All commands described here are only available to bot admins. !ban and !unban are only enabled once the bot is a channel operator.

Creating bans

!ban subject [duration] [reason]

Creates a ban on subject for the given duration and reason and kicks anyone who matches the created ban.

See the Duration type for the duration option. reason can be anything. It will show in the banlist and in the kick message(s) if applicable.

The bot will do its best to find out the correct hostmask to ban:

• If subject is a full hostmask and contains wildcards like *, the bot will create a ban on that hostmask.
• If subject is a full hostmask and contains no wildcards, the bot will apply a wildcard on the username part and another on the ident part if no identd authentified it(~), leaving just the host part, sometimes with the identd.
• If subject is the nickname of someone present in the channel, the bot will select the user’s full hostmask and run the transformation above.
• If not, it creates a ban on the nickname itself (ie. nick!*@*).

Some examples:

!ban paul 5d ragequitter

• If paul is present in the channel, it will do a host/ip ban on him.
• If paul is not present in the channel, the bot will create a ban on paul!*@*, meaning that nobody with the nickname paul can enter the channel. However, an offending user can circumvent this ban simply by changing nickname.

In both cases, the ban will stand for 5 days and have ragequitter as reason.

!ban paul!*@* 5d ragequitter

Forces a nickname ban regardless of whether paul is online or not.

!ban roger!~rfeder@1.2.3.4 5d too good for us

Creates a ban on *!*@1.2.3.4.

!ban frank!feinst@4.3.2.1 5d aimbotter

Creates a ban on *!feinst@4.3.2.1.

!ban *!*@225.70.*

Creates a ban on *!*@225.70.*. (IP range ban from 225.70.0.0 to 225.70.255.255)

!ban

Bans the last kicked person for the default duration with the kick message as the reason.

Searching bans

!banlist

!banlist #id

!banlist search

Show active or recently expired bans.

If search is provided, the bot will search against all data on the bans. Also, if you provide a hostmask as search text, it will be matched against existing banmasks. Useful if you know someone’s hostmask and want too know why they are banned.

If the search returns only one result (for instance if you used the #id form), all details will be shown, including the ban reason.

!banhistory [search|#id]

Show expired bans.

Editing bans

!unban search|#id

Lifts a ban. Use a hostmask as search to your advantage here.

!ban search|#id [duration] [reason]

Edits a ban.

Configuration

[Ban]default duration = permanent (Duration)

Default duration for bans in case it isn’t specified.

[Ban]keep expired bans for = 1 week (Duration)

Purge the database of bans which expired more than this time ago.

[Ban]check interval = 2 min (Duration)

Interval between two of the bot’s periodic checks on bans to lift. You don’t really need to touch it.