InspIRCd v4 is still early in development!

If you use this branch you may experience crashes, weird behaviour, and unannounced breaking changes.

You probably want to use InspIRCd v3 instead.

The "chanfilter" Module (v4)


This module adds channel mode g (filter) which allows channel operators to define glob patterns for inappropriate phrases that are not allowed to be used in the channel.


To load this module use the following <module> tag:

<module name="chanfilter">


The <chanfilter> tag defines settings about how the chanfilter module should behave. This tag can only be defined once.

Name Type Default Value Description
hidemask Boolean No Whether users can see the inappropriate phrase that their message matched.
notifyuser Boolean Yes Whether to notify users when they have matched a filter.
maxlen Number 35 The maximum length of a parameter for channel mode g (filter).
Example Usage
<chanfilter hidemask="no"


This module extends the core <class:privs> field with the following values:

Name Description
channels/ignore-chanfilter Allows server operators to send a message to a channel that matches a filter entry.
Example Usage

Allows server operators with the class named BasicOper to send a message to a channel that matches a filter entry.

<class name="BasicOper"
       privs="... channels/ignore-chanfilter ...">

Channel Modes

Name Character Type Parameter Syntax Usable By Description
filter g List <glob> Channel operators Prevents users from sending messages that match <glob>.


Name Description
filter Allows exempted users to send messages that contain censored phrases.

Special Notes

Due to limitations of the IRC protocol filters containing spaces can not be added.