How Can We Help?
Extended Bans
Table of Contents
Extended Bans
Some list modes, such as channel mode b (ban), take a <nick>!<user>@<host> mask as their parameter. These list modes can be extended to support alternate forms of matching and actions.
Acting
Acting extended bans allow restricting actions that users can perform. Such actions can include preventing a user from speaking in a channel (requires the muteban module) or changing their nickname (requires the nonicks module). Acting extended bans can also be stacked with matching extended bans (see below).
| Name | Character | Ban Syntax | Module | Description |
|---|---|---|---|---|
| blockinvite | A | A:<mask> |
allowinvite | Bans <mask> from using the /INVITE command. |
| blockcaps | B | B:<mask> |
blockcaps | Bans <mask> from sending messages with excessive capitalisation. |
| noctcp | C | C:<mask> |
noctcp | Bans <mask> from sending messages that contain CTCPs. |
| blockcolor | c | c:<mask> |
blockcolor | Bans <mask> from sending messages that contain IRC formatting codes. |
| mute | m | m:<mask> |
muteban | Bans <mask> from speaking in the channel. |
| nonick | N | N:<mask> |
nonicks | Bans users matching <mask> from changing their nickname whilst in the channel. |
| partmsg | p | p:<mask> |
nopartmsg | Bans <mask> from sending a /PART message. |
| nokick | Q | Q:<mask> |
nokicks | Bans privileged users matching <mask> from using the /KICK command. |
| stripcolor | S | S:<mask> |
stripcolor | Strips IRC formatting codes from messages sent by users matching <mask>. |
| nonotice | T | T:<mask> |
nonotice | Bans <mask> from sending messages with the /NOTICE command. |
Matching
Matching extended bans allow matching against extended user attributes such as account name (requires the services_account module) or TLS (SSL) fingerprint (requires the sslmodes module).
| Name | Character | Ban Syntax | Module | Description |
|---|---|---|---|---|
| realmask | a | a:<pattern> |
gecosban | Checks whether users have a nick!user@host+real mask matching <pattern>. |
| country | G | G:<pattern> |
geoban | Matches against the two letter country code for the country that users are connecting from. |
| channel | j | j:<pattern> |
channelban | Checks whether users are in a channel matching <pattern>. |
| class | n | n:<pattern> |
classban | Checks whether users are in a connect class <pattern>. |
| oper | O | O:<pattern> |
operchans | Checks whether users are logged into a server operator account matching <pattern>. |
| account | R | R:<pattern> |
services_account | Checks whether users are logged into a services account matching <pattern>. |
| realname | r | r:<pattern> |
gecosban | Checks whether users have a a real name (gecos) matching <pattern>. |
| server | s | s:<pattern> |
serverban | Checks whether users are on a server matching <pattern>. |
| unauthed | U | U:<pattern> |
services_account | Checks whether users matching <pattern> are not logged into a services account. |
| gateway | w | w:<pattern> |
cgiirc | New in v3.10.0! Matches against the name of the gateway that WebIRC users are connecting from. |
| sslfp | z | z:<pattern> |
sslmodes | Checks whether users have an TLS (SSL) client certificate with a fingerprint matching <pattern>. |