InspIRCd v2 is coming to the end of its lifetime!

Fixes for security vulnerabilities will be provided until 2020-06-01 but after this date v2 will no longer be maintained.

InspIRCd v3 contains many new features including full support for all currently ratified IRCv3 extensions and WebSocket connections.

InspIRCd v3 installation instructions are available here and a list of breaking changes is available here.

The "censor" Module

Description

This module allows the server administrator to define inappropriate phrases that are not allowed to be used in private or channel messages.

Configuration

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

<module name="m_censor.so">

<badword>

The <badword> tag defines an inappropriate phrase. This tag can be defined as many times as required.

Name Type Default Value Description
text Text None Required! A phrase to match within a message.
replace Text None If defined then a replacement phrase to replace the matched phrase with instead of blocking the message.
Example Usage

Replaces the phrase "wibble" with "wobble":

<badword text="wibble"
         replace="wobble">

Prevents users from saying the phrase "fluffy capybara":

<badword text="fluffy capybara">

Channel Modes

Name Character Type Parameter Syntax Description
censor G Switch None Enables censoring messages sent to the channel.

User Modes

Name Character Type Parameter Syntax Description
u_censor G Switch None Enables censoring messages sent to the user.

Exemptions

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

Special Notes

The censor module does not support any kind of advanced (glob, regex, etc) matching or punishment other than message blocking. If you need that you should use the filter module instead.

You should take care to avoid the Scunthorpe problem when adding badwords.