Blacklist-module directive

NOTE: Do not confuse this with the Blacklist block, which allows you to ban users based on DNSBL (DNS Blacklists)

With blacklist-module you can tell UnrealIRCd to never load a particular module. Any loadmodule lines for the module are ignored.

This can be used by advanced users to selectively disable modules that would otherwise be automatically loaded through conf/modules.default.conf. See under Example below for more information.

Syntax

blacklist-module <file-name-without-suffix>;

UnrealIRCd automatically adds the correct suffix (.DLL or .so) and will also automatically deal with modules/ vs src/modules/ directories.

In UnrealIRCd 6.1.0 and higher you can use wildcards, eg:

blacklist-module rpc/*;

Example

/* Just load all of UnrealIRCd's functionality (all 150+ modules) */
include "modules.default.conf";

/* We don't want these channel modes! See https://www.unrealircd.org/docs/Channel_Modes for names */
blacklist-module chanmodes/halfop;

/* Disable /ADMIN (admin) and usermode +B (usermodes/bot) too */
blacklist-module "admin";
blacklist-module "usermodes/bot";

/* Disable owner (~) and admin (&) prefixes, so everyone only gets op prefix (@) */
blacklist-module "chanmodes/chanowner";
blacklist-module "chanmodes/chanadmin";

Note that disabling certain basic modules can have undesired effects. Carefully read the comments in conf/modules.default.conf! For example, it would not be wise to disable the quit module.

See also

• Loadmodule directive - the way you load modules
• Modules - generic information about modules
• Deny module block - a feature to deny other servers from loading certain modules