InspIRCd v2 is coming to the end of its lifetime!
Fixes for security vulnerabilities will be provided until 2021-01-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.
The "alias" Module
This module allows the server administrator to define custom channel commands (e.g.
!kick) and server commands (e.g.
To load this module use the following
<alias> tag defines a custom channel or server command. This tag can be defined as many times as required.
|text||Text||None||Required! The name of the custom command.|
|replace||Text||None||Required! The message to replace the custom command with.|
|format||Text||None||If defined then a glob pattern that the command parameters must match.|
|requires||Text||None||If defined then the nickname of a user which must be online for the alias to work.|
|channelcommand||Boolean||No||Whether the command can be executed as a channel command.|
|usercommand||Boolean||Yes||Whether the command can be executed as a server command.|
|operonly||Boolean||No||Whether the user executing the command must be a server operator.|
|uline||Boolean||No||Whether the user specified in the requires value must be on a U-lined server.|
The replacement field can contain any of the following template variables:
|$1 to $9||The value of the parameter at the specified position.|
|$1- to $9-||The values of the parameters at and after the specified position.|
|$chan||If executed as a channel command then the name of the channel.|
|$host||The real hostname of the user that executed the command.|
|$ident||The username (ident) of the user that executed the command.|
|$nick||The nickname of the user that executed the command.|
|$vhost||The virtual hostname of the user that executed the command.|
Defines an oper-only
/OPERSERV server command that messages the OperServ client if it is on a U-lined server:
<alias text="OPERSERV" replace="PRIVMSG OperServ :$2-" format="*" requires="OperServ" channelcommand="no" usercommand="yes" operonly="yes" uline="yes">
<fantasy> tag defines settings about custom channel commands. This tag can only be defined once.
|allowbots||Boolean||No||Whether users with the bot user mode (+B) can execute channel commands.|
|prefix||Text||!||The single-character prefix that indicates that a message is a channel command|
<fantasy allowbots="no" prefix=".">
If you are using services you may find it useful to use one of the predefined alias files which ship with InspIRCd.
If you are using Anope for your services add the following tag to your configuration:
If you are using Atheme for your services add the following tag to your configuration:
If you are using a system-wide installation you will need to use an absolute path to these files.