NickServ

NickServ allows you to “register” a nickname and prevent others from using it. The following commands allow for registration and maintenance of nicknames; to use them, type /msg nickserv command. For more information on a specific command, type /msg nickserv help command.
This service is intended to provide a way for IRC users to ensure their identity is not compromised. It is NOT intended to facilitate “stealing” of nicknames or other malicious actions. Abuse of NickServ will result in, at minimum, loss of the abused nickname(s). Nicknames that are not used anymore are subject to the automatic expiration, i.e. they will be deleted after 30 days if not used.

Commands are indexed alphabetically. Examples of the actual commands that you can copy, paste, and send are listed in italics. 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.

  • ACCESS:Modifies or displays the access list for your nick. This is the list of addresses which will be automatically recognized by NickServ as allowed to use the nick. If you want to use the nick from a different address, you need to send an IDENTIFY command to make NickServ recognize you.
  • ADD: /msg nickserv access add mask
  • DEL: /msg nickserv access del mask
  • LIST: /msg nickserv access list

Examples:
/msg nickserv ACCESS ADD anyone@*.example.com
Allows access to user anyone from any machine in the example.com domain.
/msg nickserv ACCESS DEL anyone@*.example.com
Reverses the previous command.
/msg nickserv ACCESS LIST
Displays the current access list.

  • ALIST: /msg nickserv alist
    Lists channels you have access on.
  • AJOIN: /msg nickserv ajoin ADD | DEL | LIST Manages the list of channels that you will automatically join to on connect. To add a channel /msg nickserv ajoin ADD [nickname] #channel [key]. To remove a channel /msg nickserv ajoin DEL [nickname] #channel [key]. To list all channels that you will join on connect /msg nickserv ajoin LIST
  • DROP: /msg nickserv drop nickname
    Drops your nickname from the NickServ database. A nick that has been dropped is free for anyone to re-register.
    You may drop a nick within your group by passing it as the nick parameter.
    In order to use this command, you must first identify with your password (/msg nickserv help identify for more information).
  • GLIST: /msg nickserv glist
    Lists all nicks in your group.
  • GROUP: /msg nickserv group target password
    This command makes your nickname join the target nickname’s group. password is the password of the target nickname. Joining a group will allow you to share your configuration, memos, and channel privileges with all the nicknames in the group, and much more! A group exists as long as it is useful. This means that even if a nick of the group is dropped, you won’t lose the shared things described above, as long as there is at least one nick remaining in the group. You can use this command even if you have not registered your nick yet. If your nick is already registered, you’ll need to identify yourself before using this command. Type /msg nickserv help identify for more information. This last may be not possible on your IRC network. It is recommended to use this command with a non-registered nick because it will be registered automatically when using this command. You may use it with a registered nick (to change your group) only if your network administrators allowed it. You can only be in one group at a time. Group merging is not possible. Note: all the nicknames of a group have the same password.
  • IDENTIFY: /msg nickserv identify password
    Tells NickServ that you are really the owner of this nick. Many commands require you to authenticate yourself with this command before you use them. The password should be the same one you sent with the REGISTER command.
  • INFO: /msg nickserv info nick ALL
    Displays information about the given nickname, such as the nick’s owner, last seen address and time, and nick options. If you are identified for the nick you’re getting information for and ALL is specified, you will be shown all the information; regardless of whether it’s hidden or not.
  • LOGOUT: /msg nickserv logout
    This reverses the effect of the IDENTIFY command, i.e. make you not recognized as the real owner of the nick anymore. Note, however, that you won’t be asked to reidentify yourself.
  • RECOVER: /msg nickserv recover nick password
    Allows you to recover your nickname if someone else has taken it; this does the same thing that NickServ does automatically if someone tries to use a kill-protected nick.
    When you give this command, NickServ will bring a fake user online with the same nickname as the user you’re trying to recover your nick from. This causes the IRC servers to disconnect the other user. This fake user will remain online for one minute to ensure that the other user does not immediately reconnect; after that minute, you can reclaim your nick.
    In order to use the RECOVER command for a nick, your current address as shown in /WHOIS must be on that nick’s access list, you must be identified and in the group of that nick, or you must supply the correct password for the nickname.
  • REGISTER: /msg nickserv register password email
    Registers your nickname in the NickServ database. Once your nick is registered, you can use the SET and ACCESS commands to configure your nick’s settings as you like them. Make sure you remember the password you use when registering – you’ll need it to make changes to your nick later. (Note that case matters! EPONA, Epona, and epona are all different passwords!)
    Guidelines on choosing passwords:
    Passwords should not be easily guessable. For example, using your real name as a password is a bad idea. Using your nickname as a password is a much worse idea 😉 and, in fact, NickServ will not allow it. Also, short passwords are vulnerable to trial-and-error searches, so you should choose a password at least 5 characters long.
    Finally, the space character cannot be used in passwords.
    The parameter email is optional and will set the email for your nick immediately. However, it may be required on certain networks. Your privacy is respected; this e-mail won’t be given to any third-party person.
    This command also creates a new group for your nickname, that will allow you to register other nicks later sharing the same configuration, the same set of memos and the same channel privileges. For more information on this feature, type /msg nickserv help group.

  • SET: Sets various nickname options. option can be one of:
    • DISPLAY: /msg nickserv set display new-display
      Changes the display used to refer to your nickname group in Services. The new display MUST be a nick of your group.
    • EMAIL: /msg nickserv set email address
      Associates the given E-mail address with your nickname. This address will be displayed whenever someone requests information on the channel with the info command.
    • FACEBOOK: /msg nickserv set facebook url Associates a facebook url with your NickServ account
    • GREET: /msg nickserv set greet message
      Makes the given message the greet of your nickname, that will be displayed when joining a channel that has GREET option enabled, provided that you have the necessary access on it.
    • HIDE: /msg nickserv set hide {EMAIL|USERMASK|QUIT} {ON|OFF}
      Allows you to prevent certain pieces of information from being displayed when someone does a NickServ INFO on your nick. You can hide your E-mail address (EMAIL), last seen user@host mask (USERMASK), and last quit message (QUIT). The second parameter specifies whether the information should be displayed (OFF) or hidden (ON).
    • KILL: /msg nickserv set kill {ON|QUICK|IMMED|OFF}
      Turns the automatic protection option for your nick on or off. With protection on, if another user tries to take your nick, they will be given one minute to change to another nick, after which NickServ will forcibly change their nick.
      If you select QUICK, the user will be given only 20 seconds to change nicks instead of the usual 60. If you select IMMED, user’s nick will be changed immediately without being warned first or given a chance to change their nick; please do not use this option unless necessary. Also, your network’s administrators may have disabled this option.
    • LANGUAGE: /msg nickserv set language number
      Changes the language Services uses when sending messages to you (for example, when responding to a command you send). number should be chosen from the following list of supported languages:
      1) English
      2) Français (French)
      3) Deutsch (German)
      4) Português (Portuguese)
      5) Español (Spanish)
      6) Türkçe (Turkish)
      7) Catala (Catalan)
    • MSG: /msg nickserv set msg {ON|OFF}
      Allows you to choose the way Services are communicating with you. With MSG set, Services will use messages, else they’ll use notices.
    • PASSWORD: /msg nickserv set password new-password
      Changes the password used to identify you as the nick’s owner.
    • PRIVATE: /msg nickserv set private {ON|OFF}
      Turns NickServ’s privacy option on or off for your nick. With PRIVATE set, your nickname will not appear in nickname lists generated with NickServ’s LIST command. (However, anyone who knows your nickname can still get information on it using the INFO command.)
    • SECURE: /msg nickserv set secure {ON|OFF}
      Turns NickServ’s security features on or off for your nick. With SECURE set, you must enter your password before you will be recognized as the owner of the nick, regardless of whether your address is on the access list. However, if you are on the access list, NickServ will not auto-kill you regardless of the setting of the KILL option.
    • TWITTER: /msg nickserv set twitter twittername Associates a Twitter account with your NickServ account
    • URL: /msg nickserv set url url
      Associates the given URL with your nickname. This URL will be displayed whenever someone requests information on your nick with the INFO command.

 

  • STATUS: /msg nickserv status nick
    Returns whether the user using the given nickname is recognized as the owner of the nickname. The response has this format:
    nickname status-code
    where nickname is the nickname sent with the command, and status-code is one of the following:
    0 – no such user online or nickname not registered
    1 – user not recognized as nickname’s owner
    2 – user recognized as owner via access list only
    3 – user recognized as owner via password identification
    Up to sixteen nicknames may be sent with each command; the rest will be ignored. No error message is generated if no nickname is given.

 

The following commands are for the IdleChat IRC Staff:

  • ALIST: /msg nickserv alist nickname level
    With no parameters, lists channels user has access on. With one parameter, lists channels that nickname has access on. With two parameters lists channels that nickname has level access or greater on.
  • DROP: /msg nickserv drop nickname
    Drops any nickname from the NickServ database.
  • FORBID: /msg nickserv forbid nickname reason
    Disallows a nickname from being registered or used by anyone. May be cancelled by dropping the nick.
  • GETEMAIL: /msg nickserv getemail user@emailhost
    Returns the matching nicks that used given email. Note that you can not use wildcards for either user or emailhost. Whenever this command is used, a message including the person who issued the command and the email it was used on will be logged.
  • GLIST: /msg nickserv glist nickname
    Lists all nicknames that are in the group of the given nick.
  • LIST: /msg nickserv list pattern {forbidden|noexpire|unconfirmed}
    Lists all registered nicknames which match the given pattern, in nick!user@host format. Nicks with the PRIVATE option set will only be displayed to Services admins. Nicks with the NOEXPIRE option set will have a ! appended to the nickname for Services admins. If the FORBIDDEN, NOEXPIRE or UNCONFIRMED options are given, only nicks which, respectively, are FORBIDDEN, UNCONFIRMED or have the NOEXPIRE flag set will be displayed. If all three options are given, all three types of nicks will be displayed.
    Examples:
    /msg nickserv list *!joeuser@foo.com
    Lists all registered nicks owned by joeuser@foo.com.
    /msg nickserv list *Bot*!*@*
    Lists all registered nicks with Bot in their names (case insensitive).’
    /msg nickserv list * noexpire
    Lists all registered nicks which have been set to not expire.
  • SASET: Sets various nickname options. Option can be one of:
    • AUTOP: /msg nickserv saset nick autoop {ON|OFF}
      If set to {ON|OFF} services will automatically op the user when they join channels if they’re a channel operator. If set to OFF they will not be opped automatically when joining channels.
    • DISPLAY: /msg nickserv saset nick display new-display
      Changes the display used to refer to user’s nickname group in Services. The new display MUST be a nick of user’s group.
    • EMAIL: /msg nickserv saset nick email address
      Associates the given E-mail address with user’s nickname. This address will be displayed whenever someone requests information on the channel with the info command.
    • GREET: /msg nickserv saset nick greet message
      Makes the given message the greet of user’s nickname, that will be displayed when joining a channel that has GREET option enabled, provided that the user has the necessary access on it.
    • HIDE: /msg nickserv saset nick hide {EMAIL|USERMASK|QUIT} {ON|OFF}
      Allows you to prevent certain pieces of information from being displayed when someone does a NickServ INFO on user’s nick. You can hide user’s E-mail address (EMAIL), last seen user@host mask (USERMASK), and last quit message (QUIT). The second parameter specifies whether the information should be displayed (OFF) or hidden (ON).
    • ICQ: /msg nickserv saset nick icq number
      Associates the given ICQ number with user’s nickname. This number will be displayed whenever someone requests information on user’s nick with the INFO command.
    • KILL: /msg nickserv saset nick kill {ON|QUICK|IMMED|OFF}
      Turns the automatic protection option for user’s nick on or off. With protection on, if another user tries to take user’s nick, they will be given one minute to change to another nick, after which NickServ will forcibly change their nick.
      If you select QUICK, the user will be given only 20 seconds to change nicks instead of the usual 60. If you select IMMED, user’s nick will be changed immediately without being warned first or given a chance to change their nick; please do not use this option unless necessary.
    • LANGUAGE: /msg nickserv saset nick language number
      Changes the language Services uses when sending messages to user (for example, when responding to a command the user sends). Number should be chosen from the following list of supported languages:
      1) English
      2) Français (French)
      3) Deutsch (German)
      4) Português (Portuguese)
      5) Español (Spanish)
      6) Türkçe (Turkish)
      7) Catala (Catalan)
    • MSG: /msg nickserv saset nick msg {ON|OFF}
      Allows you to choose the way Services are communicating with the user. With MSG set, Services will use messages, else they’ll use notices.
    • NOEXPIRE: /msg nickserv saset nick noexpire {ON|OFF}
      Sets whether the given nickname will expire. Setting this to ON prevents the nickname from expiring.
    • PASSWORD: /msg nickserv saset nick password new-password
      Changes the password used to identify the user as the nick’s owner.
    • PRIVATE: /msg nickserv saset nick private {ON|OFF}
      Turns NickServ’s privacy option on or off for user’s nick. With PRIVATE set, user’s nickname will not appear in nickname lists generated with NickServ’s LIST command. (However, anyone who knows user’s nickname can still get information on it using the INFO command.)
    • SECURE: /msg nickserv saset nick secure {ON|OFF}
      Turns NickServ’s security features on or off for user’s nick. With SECURE set, the user must enter user’s password before user will be recognized as the owner of the nick, regardless of whether user’s address is on the access list. However, if user is on the access list, NickServ will not auto-kill the user regardless of the setting of the KILL option.
    • URL: /msg nickserv saset nick url url
      Associates the given URL with user’s nickname. This URL will be displayed whenever someone requests information on user’s nick with the INFO command.