The "securelist" Module (v4)

Description

This module prevents users from using the /LIST command until a predefined period has passed.

Configuration

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

<module name="securelist">

<securehost>

The <securehost> tag defines an exception to the /LIST waiting period. This tag can be defined as many times as required.

Name	Type	Default Value	Description
exception	Text	None	Required! A glob pattern to match against the hostnames of users that run the /LIST command.

Example Usage

Adds an exception for the irc.netsplit.de crawler:

<securehost exception="*@*.netsplit.de">

<securelist>

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

Name	Type	Default Value	Description
exemptregistered	Boolean	Yes	Whether registered users are exempt from waiting.
showmsg	Boolean	No	Whether to tell the user that they need to wait before using the /LIST command.
hidesmallchans	Number	0	The minimum user count for a channel to show up in /LIST after the wait period. If a user is exempt from the wait period this will not apply to them.
waittime	Duration	1m	The time period that must pass before a user can use the /LIST command. If exemptregistered is enabled then this can be set to 0 to disable /LIST for unregistered users.
fakechans	Number	5	The number of fake channels to show in /LIST.
fakechanprefix	Text	#	The prefix for the fake channels. A random suffix will be appended to this when generating channels.
fakechantopic	Text	Fake channel for confusing spambots	The topic for the fake channels. A random format modifier will be inserted into this for randomness.

Example Usage

<securelist exemptregistered="yes"
            showmsg="yes"
            waittime="60s"
            hidesmallchans="2"
            fakechans="5"
            fakechanprefix="#"
            fakechantopic="Fake channel for confusing spambots">

<class>

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

Name	Description
servers/ignore-securelist	Allows server operators to ignore the /LIST wait.

Example Usage

Allows server operators with the class named BasicOper to ignore the /LIST wait.

<class name="BasicOper"
       ...
       privs="... servers/ignore-securelist ...">