User Commands

Commands are indexed alphabetically. Examples of the actual commands that you can copy, paste, and send are listed in purple. A description of the command follows the command. Underlined words in the command are variables that need to be changed to send the command correctly. For example #channel should be changed to your channel’s name, Nick is your nick or the nick of the user, Text might be the message you want to be displayed. These can vary by command and will be explained in the command’s description that follows. Variables inside curly braces like {ON|OFF} are selections that require one of the options inside the curly braces to be specified.

  • ADMIN: /admin [Server]
    Provides administrative information regarding the server. If a server name is included it will display the information of that server.
  • AWAY: /away [Reason]
    Sets your online status to “away” Without a reason will unset you away.
  • BOTMOTD: /botmotd [Server]
    Displays the servers bot message of the day. Including a server name allows you to check other servers.
  • CONNECT: /connect [leaf] [port] [hub]
    Links another IRC server to the one you are currently on. Remote connections are also possible.
  • CREDITS: /credits
    Credits for Unreal IRCD.
  • CYCLE: /cycle #chan,#chan2,#chan3
    Cycles the given channel(s). This command is equivalent to sending a PART then a JOIN command.
  • DNS: /dns option
    Returns information about the IRC server’s DNS cache. Note, since most clients have a built-in DNS command, you will most likely need to use /raw DNS to use this. Opers may specify an l as the first parameter to the command to receive a list of entries in the DNS cache.
  • HELPOP: /helpop ?topic or /helpop ! topic
    HelpOp is a system of getting IRC Server help. You type either /HELPOP ? help system topic or /HELPOP ! question The “?” in /HELPOP means query the help system and if you get no response you can choose ‘!’ to send it to the Help Operators online. Using neither ? nor ! will mean the command will be first queried within the help system and if no match if found , it will be forwarded to the help operators.
  • IDENTIFY: /identify password
    Sends your password to NickServ services system to identify to your nick.
  • INVITE: /invite user #channel
    Sends a user an invitation to join a particular channel. You must be an operator on the channel in order to invite a user into it.
  • JOIN: /join #chan,#chan2,#chan3
    Used to enter one or more channels on an IRC server. All occupants of the channel will be notified of your arrival. Using the command /join 0 will make you PART all channels.
  • KICK: /kick #channel user reason
    Removes a user from a channel. Can only be used by Operators or Half-Ops. If no reason is specified, your nickname becomes the reason.
  • KNOCK: /knock #channel message
    For channels which are invite only, you can “knock” on the channel to request an invite. Will not work if channel has one of the following modes set: +K +V. Will also not work if you are banned.
  • LICENSE: /license
    Displays the GNU License.
  • LINKS: /links
    Lists all of the servers currently linked to the network.
  • LIST: /list searchstring
    Provides a complete listing of all channels on the network. If a search string is specified, it will only show those matching the search string. If you don’t include a search string, the default is to send you the entire unfiltered list of channels. Below are the options you can use, and what channels LIST will return when you use them.

    • >#number List channels with more than #<number> people
    • <#number List channels with less than #<number> people
    • !*mask* List channels that do not match *mask*
  • LUSERS: /lusers server
    Provides local and global user information (such as current and maximum user count). Adding a server name allows you to view the statistics from other servers.
  • MAP: /map
    Provides a “network map” of the IRC network. Mainly used for routing purposes.
  • MODE: /mode user modes
    Used to change the mode of a channel or a user. You can only change modes for channel you are an Operator or Half-Op on. Also, you can only changes user modes for yourself.
    User Modes:

    • o = Global IRC Operator
    • O = Local IRC Operator
    • a = Is a Services Administrator
    • A = Is a Server Administrator
    • N = Is a Network Administrator
    • C = Is a Co Administrator
    • d = Only receive channel PRIVMSGs starting with a bot command character (Deaf)
    • g = Can read & send to GlobOps, and LocOps
    • h = Available for Help (Help Operator)
    • i = Invisible (Not shown in /WHO searches)
    • p = Hide all channels in /whois and /who
    • q = Only U:lines can kick you (Services Admins/Net Admins only)
    • r = Identifies the nick as being Registered (settable by services only)
    • s = Can listen to Server notices
    • t = Says that you are using a /VHOST
    • v = Receive infected DCC send rejection notices
    • w = Can listen to Wallop messages
    • x = Gives the user Hidden Hostname (security)
    • z = Marks the client as being on a Secure Connection (SSL)
    • B = Marks you as being a Bot
    • G = Filters out all Bad words in your messages with
    • H = Hide IRCop status in /WHO and /WHOIS. (IRC Operators only)
    • I = Hide an oper’s idle time (in /whois output) from regular users.
    • R = Allows you to only receive PRIVMSGs/NOTICEs from registered (+r) users
    • S = For Services only. (Protects them)
    • T = Prevents you from receiving CTCPs
    • V = Marks the client as a WebTV user
    • W = Lets you see when people do a /WHOIS on you (IRC Operators only)

    Snomask stands for ‘Service NOtice MASK’, it (mainly) controls which server notices you will receive.”;
    Usage: /MODE nick +s Ex: /MODE blah +s +cF-j
    The parameter specifies which snomasks you want (or don’t want). You can also remove all snomasks by simply doing /MODE nick -s.
    Below is a list of possible snomasks:

    • c = View connects/disconnects on local server
    • e = View ‘Eyes’ server messages (OperOverride, /CHG* and /SET* usage, ..)
    • F = View connects/disconnects on remote servers (except U-lines)
    • f = View flood alerts
    • G = View TKL notices (Gline, GZline, Shun, etc)
    • j = View Junk notices (not recommended for normal use)
    • k = View KILL notices
    • n = View nick changes on local server
    • N = View nick changes on remote servers
    • o = View oper-up notices
    • q = View rejected nick changes due to Q:lines
    • S = View spamfilter matches
    • s = View general notices
    • v = View usage of /VHOST command


  • ExtBans:
    These bans let you ban based on things other than the traditional nick!user@host mask. They also provide support for things like “quieting” users (on other IRCds you might do +q hostmask,
    on UnrealIRCd use +b ~q:hostmask).
    These bantypes specify which actions are affected by a ban:

    • ~q = People matching these bans can join but are unable to speak, unless they have +v or higher.
      Example: /mode #channel +bb ~q:*!* ~q:nick*!*@*
    • ~n = People matching these bans cannot change nicks, unless they have +v or higher.
      Example: /mode #channel +bb ~n:*!*@* ~n:nick*!*@*
    • ~j = If a user matches this, (s)he may not join the channel. (s)He may perform all other activities if (s)he is already on the channel, such as speaking and changing his/her nick.
      Example: /mode #channel +bb ~j:*!*

    These bantypes introduce new criteria which can be used:

    • ~c = If the user is in this channel then (s)he is unable to join. A prefix can also be specified (+/%/@/&/~) which means that it will only match if the user has that rights or higher on the specified channel.
      Example:/mode #channel +b ~c:#lamers,/mode #channel +e ~c:@#trusted
    • ~r = If the realname of a user matches this then (s)he is unable to join.
      Example: /mode #channel +b ~r:*Stupid_bot_script*
      NOTE: an underscore (‘_’) matches both a space (‘ ‘) and an underscore (‘_’), so this ban would match ‘Stupid bot script v1.4’.
    • ~R = If a user has identified to services and matches this nickname, then this ban will match. This means this ban is really only useful for ban exemptions (+e). Will allow Nick in the channel, regardless of other bans, if he identified to NickServ and is using the nickname Nick.
      Example: /mode #channel +e ~R:Nick
    • ~a = If a user is logged in to services with this account name, then this ban will match. This is slightly different than ~R, in the sense that a user with nick ABC may be logged in under account XYZ. Not all services packages support this, in which case you will have to use ~R instead.
      Example: /mode #channel +e ~a:Name

    You may stack extended bans from the first group with the second group. For example /mode #channel +b ~q:~c:#lamers would quiet all users who have joined #lamers. Bans from the second group may also be used for invite exceptions (+I), such as /mode #channel +I ~c:#trusted and /mode #channel +I ~a:accountname.

  • MOTD: /motd server
    Displays the Message of the Day.
  • NAMES: /names #channel
    Provides a list of users on the specified channel.
  • NICK: /nick newnickname
    Changes your “online identity” on a server. All those in the channel you are in will be alerted of your nickname change.
  • NOTICE: /notice nick,nick2,nick3,nick4 text
    Mainly used for one-time communication or for the results of a command.
  • PART: /part #chan,#chan2,#chan3,#chan4
    Used to part (or leave) a channel you currently occupy. All those in the channel will be notified of your departure.
  • PING: /ping user
    Determines the amount of lag (time it takes for a response to reach a person and comeback) between yourself and someone else. DO NOT DO THIS WITHOUT ASKING THE USER IF YOU MAY DO SO.
  • PRIVMSG: /msg nick,nick2,nick3,nick4 text
    Used to send a message to a person or a channel.
  • QUIT: /quit reason
    Disconnects you from the IRC server. Those in the channels you occupy will be notified of your departure. If you do not specify a reason, your nickname becomes the reason.
  • RULES: /rules server
    Displays the ircd.rules of a server. Adding a server name allows you to view rules on other servers.
  • SETNAME: /setname name
    Changes the “IRC Name” (or “Real Name”) of yourself. Available to everyone.
  • TIME: /time server
    Displays the servers date and time. Including a server name allows you to check other servers.
  • TOPIC: /topic channel topic
    Sets/Changes the topic of the channel in question, or just display the current topic. Topic channel will display the current topic of the given channel. Topic channel topic will change the topic of the given channel.
  • USERHOST: /userhost nick
    Returns the userhost of the user in question. Usually used by scripts or bots to retrieve userhost information.
  • VERSION: /version nick
    Sends a CTCP Version request to the user. If configured to do so, their client will respond with the client version. DO NOT DO THIS WITHOUT ASKING THE USER IF YOU MAY DO SO.
  • WATCH /watch +-nick +-nick
    Watch is a new notify-type system in UnrealIRCd which is both faster and uses less network resources than any old-style notify system. The server will send you a message when any nickname in your watch list logs on or off. The watch list DOES NOT REMAIN BETWEEN SESSIONS – you (or your script or client) must add the nicknames to your watch list every time you connect to an IRC server.
  • WHO: /who search
    Searches user information (-i users only) for supplied information. (IRCops and higher are able to search +i users.) Masks include: nickname, #channel, hostmask (*
  • WHOIS: /whois user
    Shows information about the user in question, such as their “name”, channels they are currently in, their hostmask, etc.
  • WHOWAS: /whowas nick max replies
    Retrieves previous ‘WHOIS’ information for users no longer connected to the server. The max replies field is optional, and limits how many records will be returned.

Back to Top