User Commands
Note: These are basic user commands (non-oper commands).
ACCEPT
/ACCEPT *|(+|-)<nick>[,(+|-)<nick>]+
Manages your accept list. This list is used to determine who can private message you when you have user mode +g set.
/ACCEPT * - List accepted nicks /ACCEPT +<nick> - Add a nick /ACCEPT -<nick> - Remove a nick
This command accepts multiple nicks like so:
/ACCEPT +<nick>,-<nick>,+<nick>
ADMIN
/ADMIN [<servername>]
Shows the administrative information for the given server.
AWAY
/AWAY [:<message>]
If a message is given, marks you as being away, otherwise removes your away status and previous message.
COMMANDS
/COMMANDS
Shows all currently available commands.
CYCLE
/CYCLE <#channel> [:<reason>]
Cycles a channel (leaving and rejoining), overrides restrictions that would stop a new user joining, such as user limits and channel keys.
DCCALLOW
/DCCALLOW [(+|-)<nick> [
/DCCALLOW - List allowed nicks /DCCALLOW LIST - This also lists allowed nicks /DCCALLOW +<nick> [<duration>] - Add a nick /DCCALLOW -<nick> - Remove a nick /DCCALLOW HELP - Display help
Duration is optional, and may be specified in seconds or in the form of 1y2w3d4h5m6s - meaning one year, two weeks, three days, four hours, five minutes and six seconds. All fields in this format are optional.
FART
/FART <#channel> <nick> [:<reason>]
This behaves identically to /REMOVE. /REMOVE is a built-in mIRC command which caused trouble for some users.
HEXIP
/HEXIP <hex-ip|raw-ip>
If the specified argument is a raw IP address then respond with the hex encoded equivalent as if sent by an ident gateway. Otherwise, if the specified argument is a hex encoded IP address then respond with the equivalent raw IP address.
INFO
/INFO [<servername>]
Returns information on the developers and supporters who made this IRC server possible.
INVITE
/INVITE [<nick> <#channel> [
Invites a user to a channel. If the channel is NOT +A, only channel halfoperators or above can invite people. If +A is set, anyone can invite people to the channel, as long as the person doing the invite is a member of the channel they wish to invite the user to.
Invited users may override bans, +k, and similar in addition to +i, depending on configuration.
If a time is provided, the invite expires after that time and the user can no longer use it to enter the channel. The time can be specified in the form of 1y2w3d4h5m6s - meaning one year, two weeks, three days, four hours, five minutes and six seconds. All fields in this format are optional. Alternatively, the time may just be specified as a number of seconds.
/INVITE without a parameter will list pending invitations for channels you have been invited to.
ISON
/ISON <nick> [<nick>]+
Returns a subset of the nicks you give, showing only those that are currently online.
JOIN
/JOIN <#channel>[,<#channel>]+ [<key>[,<key>]+]
Joins one or more channels you provide the names for.
KICK
/KICK <#channel> <nick>[,<nick>]+ [:<reason>]
Kicks a user from a channel you specify. You must be at least a channel halfoperator to kick a user.
KNOCK
/KNOCK <#channel> :<reason>
Sends a notice to a channel indicating you wish to join.
LINKS
/LINKS
Shows all linked servers.
LIST
/LIST [<pattern>]
Creates a list of all existing channels matching the glob pattern <pattern>, e.g. *chat* or bot*.
LUSERS
/LUSERS
Shows a count of local and remote users, servers and channels.
MAP
/MAP
Shows a graphical representation of all users and servers on the network, and the links between them, as a tree from the perspective of your server.
MKPASSWD
/MKPASSWD <hashtype> <plaintext>
Encodes the plaintext to a hash of the given type and displays the result.
MODE
/MODE <target> -)]<modes> [<mode-parameters>
Change or view modes of <target>.
/MODE <target> - Show modes of <target>.
/MODE <#channel> <list mode char> - List bans, exceptions, etc. set on <channel>.
Sets the mode for a channel or a nickname specified in <target>. A user may only set modes upon themselves, and may not set the +o user mode, and a user may only change channel modes of channels where they are at least a halfoperator.
For a list of all user and channel modes, enter /HELPOP UMODES or /HELPOP CHMODES.
MODULES
/MODULES [<servername>]
Lists currently loaded modules, their memory offsets, version numbers, and flags. If you are not an operator, you will see reduced detail.
MONITOR
/MONITOR C|L|S|(+|-) <nick>[,<nick>]+
/MONITOR L - List all monitored nicks, not differentiating between online and offline nicks /MONITOR C - Clear all monitored nicks /MONITOR S - List all monitored nicks, indicating which are online and which are offline /MONITOR + <nick> - Add a nick /MONITOR - <nick> - Remove a nick
This command accepts multiple nicks like so:
/MONITOR + <nick>,<nick>,<nick> /MONITOR - <nick>,<nick>,<nick>
MOTD
/MOTD [<servername>]
Show the message of the day for <server>. Messages of the day often contain important server rules and notices and should be read prior to using a server.
NAMES
/NAMES [<channel>[,<channel>]+]
Return a list of users on the channel(s) you provide.
NICK
/NICK <newnick>
Change your nickname to <newnick>.
NOTICE
/NOTICE <target>[,<target>]+ :<message>
Sends a notice to a user or channel specified in <target>.
OPER
/OPER <username> <password>
Attempts to authenticate as a server operator.
Both successful and unsuccessful oper attempts are logged, and sent to online server operators.
PART
/PART <#channel>[,<#channel>]+ [:<reason>]
Leaves one or more channels you specify.
PASS
/PASS <password>
This command is used by your client when setting up your IRC session to submit a server password to the server.
You should not use it during an established connection.
PING
/PING <cookie> [<servername>]
Ping a server. The server will answer with a PONG.
PONG
/PONG <cookie> [<servername>]
Your client should send this to answer server PINGs. You should not issue this command manually.
PRIVMSG
/PRIVMSG <target>[,<target>]+ :<message>
Sends a message to a user or channel specified in <target>.
QUIT
/QUIT [:<message>]
Quit from IRC and end your current session.
REMOVE
/REMOVE <#channel> <nick> [:<reason>]
Removes a user from a channel you specify. You must be at least a channel halfoperator to remove a user. A removed user will part with a message stating they were removed from the channel and by whom.
SERVLIST
/SERVLIST [<mask>]
List network services that are currently connected to the network and visible to you. The optional glob-based mask parameter matches against the network service nickname.
SETNAME
/SETNAME :<realname>
Sets your real name to the specified real name.
SILENCE
/SILENCE [(+|-)<mask> [CcdiNnPpTtx]]
A server-side ignore of the given n!u@h mask. If the optional flags field is specified then it must contain one or more flags which specify what kind of messages should be blocked and how they should be blocked.
/SILENCE - Shows a list of silenced masks /SILENCE +<mask> [<flags>] - Add a mask /SILENCE -<mask> - Remove a mask
Valid SILENCE Flags
C Matches a CTCP targeted at a user. c Matches a CTCP targeted at a channel. d Default behaviour; equivalent to CciNnPpTt. i Matches an invite to a channel. N Matches a NOTICE targeted at a user. n Matches a NOTICE targeted at a channel. P Matches a PRIVMSG targeted at a user. p Matches a PRIVMSG targeted at a channel. T Matches a TAGMSG targeted at a user. t Matches a TAGMSG targeted at a channel. x Exempt the mask from silence rules.
Any combination of flags is valid.
SQUERY
/SQUERY <target> :<message>
Sends a message to the network service specified in <target>.
SSLINFO
/SSLINFO <nick>
Displays information on the TLS (SSL) connection and certificate of the target user.
STATS
/STATS <symbol> [<servername>]
Shows various server statistics. Depending on configuration, some symbols may be only available to opers.
Valid symbols are:
e Show E-lines (global user@host ban exceptions) g Show G-lines (global user@host bans) k Show K-lines (local user@host bans) q Show Q-lines (global nick bans) R Show R-lines (global regular expression bans) Z Show Z-lines (global IP mask bans)
s Show filters (global) C Show channel bans (global) H Show shuns (global)
c Show link blocks d Show configured DNSBLs and related statistics m Show command statistics, number of times commands have been used o Show a list of all valid oper usernames and hostmasks p Show open client ports, and the port type (ssl, plaintext, etc) u Show server uptime z Show memory usage statistics i Show connect class permissions l Show all client connections with information (sendq, commands, bytes, time connected) L Show all client connections with information and IP address P Show online opers and their idle times T Show bandwidth/socket statistics U Show U-lined servers Y Show connection classes O Show opertypes and the allowed user and channel modes it can set E Show socket engine events S Show currently held registered nicknames G Show how many local users are connected from each country
Note that all /STATS use is broadcast to online server operators.
TBAN
/TBAN <#channel> <duration> <banmask>
Sets a timed ban. The duration of the ban can be specified in the form of 1y2w3d4h5m6s - meaning one year, two weeks, three days, four hours, five minutes and six seconds. All fields in this format are optional. Alternatively, the ban may just be specified as a number of seconds. All timed bans appear in the banlist as normal bans and may be safely removed before their time is up.
TIME
/TIME [<servername>]
Returns the local time of the server, or remote time of another server.
TITLE
/TITLE <username> <password>
Authenticate for a WHOIS title line and optionally a vhost using the specified username and password.
TOPIC
/TOPIC <#channel> [:<topic>]
Sets or retrieves the channel topic. If a channel topic is given in the command and either the channel is not +t, or you are at least a halfoperator, the channel topic will be changed to the new one you provide.
UNINVITE
/UNINVITE <nick> <#channel>
Uninvite a user from a channel, same syntax as INVITE.
USER
/USER <username> <unused> <unused> :<realname>
This command is used by your client to register your IRC session, providing your ident and real name to the server.
You should not use it during an established connection.
USERHOST
/USERHOST <nick> [<nick>]+
Returns the hostname and nickname of a user, and some other miscellaneous information.
VERSION
/VERSION [<servername>]
Returns the server's version information.
VHOST
/VHOST <username> <password>
Authenticate for a vhost using the specified username and password.
WATCH
/WATCH C|L|l|S|(+|-)<nick> [(+|-)<nick>]+
/WATCH - List watched nicks that are online /WATCH l - List watched nicks that are online /WATCH L - List watched nicks, online and offline /WATCH C - Clear all watched nicks /WATCH S - Show statistics /WATCH +<nick> - Add a nick /WATCH -<nick> - Remove a nick
This command accepts multiple nicks like so:
/WATCH +<nick> -<nick> +<nick>
WHO
/WHO <pattern> [<flags>][%[<fields>[,<querytype>]]] <pattern>
Looks up information about users matching the provided pattern. You can specify a flag specific pattern, a channel name, user hostname, a user server name, a user real name, or a user nickname. Matching users will only be included in the WHO response if:
- The specified pattern is an exact channel name that does not have the private or secret channel modes set and the user does not have the invisible user mode set.
- The specified pattern is an exact nickname.
- You share one or more common channels with the user.
- The user does not have the invisible user mode set.
- You are a server operator with the users/auspex privilege.
If you specify any fields the response returned will be a WHOX response rather than a RFC 1459 WHO response.
Valid WHO Flags
The following flags use <pattern> to match against the specified user data:
A Show users who have an away message matching <pattern>. a Show users who have an account name matching <pattern>. h Show users who have a hostname matching <pattern>. If the 'x' modifier is specified then this will match against the real hostname instead of the display hostname. i Show users who have an IP address matching <pattern>. m Show users who have the modes listed in <pattern>. The pattern should be in the same format as a mode change e.g. +ow-i (server operators only). n Show users who have a nickname matching <pattern>. p Show users who are connected to a port in the <pattern> range (server operators only). r Show users who have a real name matching <pattern>. s Show users who are on a server with a name matching <pattern>. If the 'x' modifier is specified then this will match against the real server name instead of the masked server name. t Show users who have connected in the last <pattern> seconds. u Show users who have an ident (username) matching <pattern>.
The following flags filter users by their status:
f Only show users on remote (far) servers. l Only show users on the local server. o Only show server operators.
The following flags modify the command output:
x Show sensitive data like real user hostnames and, when hideserver is enabled, real server hostnames.
You may combine one flag from the first group and multiple from the others in one WHO command.
Valid WHO Fields
a Include the user's account name in the response. c Include the first common channel name in the response. d Include the user's server distance from you in the response. f Include the user's away status, oper status, and highest channel prefix in the response. h Include the user's hostname in the response. If the 'x' flag was specified then this is the real host rather than the display host. i Include the user's IP address in the response. l Include the user's idle time in the response. n Include the user's nickname in the response. o Include the user's channel operator rank level in the response. r Include the user's real name in the response. s Include the user's server name in the response. If the 'x' flag was specified then this is the real server name rather than the masked server name. t Include the query type in the response. u Include the user's ident in the response.
WHOIS
/WHOIS [<servername>] <nick>[,<nick>]+
Returns the WHOIS information of a user, their channels, hostname, etc. If a servername is provided, then a whois is performed from the server where the user is actually located rather than locally, showing idle and signon times.
WHOWAS
/WHOWAS <nick>
Returns a list of times the user was seen recently on IRC along with the time they were last seen and their server.
