Nickserv

NickServ Commands NOTE: Some IRC servers provide an alias for '/msg NickServ' where you can use '/ns' or '/nickserv' in it's place. Some irc networks, though uncommon, may require you to use the full '/msg nickserv@services.networkname.tld COMMAND_HERE Options_here' version of the command

Register

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! ANOPE, Anope, and anope are all different passwords!)

Note that some networks may make the email address optional, but it is required by default.

Once you have issues the register command, check your email address for a confirmation code. Don't forget to check the trash, junk mail, and spam folders if you do nto receive the email in a reasonable (1 hour?) amount of time. This code expires, as does the registration, if not confirmed, in 1 day by default.

Syntax

/msg NickServ REGISTER Password_here Email@address.here Examples /msg NickServ REGISTER MyPassword Freddy@dreamscape.org

ResetPass

Sends a passcode to the nickname with instructions on how to reset their password. Email must be the email address associated to the nickname.

Syntax

/msg NickServ RESETPASS nickname email Examples /msg NickServ RESETPASS Freddy Freddy@elmstreet.com

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 meed to send an IDENTIFY command to make NickServ recognize you. Services Operators may provide a nick to modify other users' access lists.

Syntax

See what is on your access list /msg NickServ ACCESS LIST Add to your access list /msg NickServ ACCESS ADD Host@mask.goes.here

Remove entry on your access list /msg NickServ ACCESS DEL Host@mask.goes.here IrcOps my specify a nick and remove entries from other peoples access list. /msg NiskServ ACCESS DEL Nick_here Host@mask.goes.here /msg NiskServ ACCESS ADD Nick_here Host@mask.goes.here /msg NickServ ACCESS LIST Nick_here Examples /msg NickServ ACCESS LIST /msg NickServ ACCESS ADD Freddy@dreamsaremine.org /msg NickServ ACCESS DEL Freddy@wakemeup.net

AJoin

This command manages your auto join list. When you identify you will automatically join the channels on your auto join list. Services Operators may provide a nick to modify other users' auto join lists.

Syntax

Add to Auto join list /msg NickServ AJOIN ADD #channel_name channel_entry_password_if_needed Delete from Auto join list /msg NickServ AJOIN DEL #channel_name List your auto join list /msg NickServ AJOIN LIST IrcOps my specify a nick and look or change other peoples AJOIN list. /msg NickServ AJOIN ADD Nick_here #channel_name optional_channel_entry_passowrd_as_needed /msg NickServ AJOIN DEL Nick_here #channel_name /msg NickServ AJOIN LIST Nick_here

Examples

/msg NickServ AJOIN ADD #DreamScape FreddyLives /msg NickServ AJOIN ADD #DreamScape /msg NickServ AJOIN DEL #DreamScape /msg NickServ AJOIN LIST

AList

Lists all channels you have access on. Channels that have the NOEXPIRE option set will be prefixed by an exclamation mark. The nickname parameter is limited to Services Operators

Syntax

Standard command /msg NickServ ALIST IRC Operator/Services Operator command allows for looking at other people's lists /msg NickServ nick_here ALIST Examples /msg NickServ ALIST

Cert

Modifies or displays the certificate list for your nick. If you connect to IRC and provide a client certificate with a matching fingerprint in the cert list, your nick will be automatically identified to services. Services Operators may provide a nick to modify other users' certificate lists.

NOTE: Not available on all IRC netowrks. Disabled by default.

Syntax

Add to the Certificate list /msg NickServ CERT ADD Remove from the Certificate list /msg NickServ CERT DEL certificate_fingerprint_here List available Certificates /msg NickServ CERT LSIT

Examples

/msg NickServ CERT LIST /msg NickServ CERT DEL f4e5a234b9 /msg NickServ CERT ADD

Confirm

This command is used by several commands as a way to confirm changes made to your account. This is most commonly used to confirm your email address once you register or change it. This is also used after the RESETPASS command has been used to force identify you to your nick so you may change your password. Additionally, Services Operators with the correct access permissions can replace passcode with a users nick to force validate them.

NOTE: Confirmation codes are case sensitive.

Syntax

/msg NickServ CONFIRM confirmation_code_goes_here Examples /msg NickServ CONFIRM H49dlTa9

Drop

Drops the currently in-use, and identified for nick from the database. Once your nickname is dropped you may lose all of your access and channels that you may own. Any other user will also have the option to register the nick.

IRC Services Operators, can drop any nick, not just their own.

Syntax

Standard User /msg NickServ DROP Services Operator /msg NickServ DROP Nick_goes_here

Examples

/msg NickServ DROP Forbid This is often times aliased to the "/msg OperServ FORBID" comamnd. See OperServ's FORBID command for details.

NOTE: Access to this command requires the proper permissions to be present in your opertype.

GetEmail

Returns the matching nicks that used given email. Note that you can not use wildcards. Whenever this command is used, a message including the person who issued the command and the email it was used on will be logged.

NOTE: Access to this command requires the proper permissions to be present in your opertype.

Syntax

/msg NickServ GETEMAIL Email@address.goes.here Examples /msg NiskServ GETMAIL FreddyK@dreamscape.net

GetPass

Returns the password for the given nickname. Note that whenever this command is used, a message including the person who issued the command and the nickname it was used on will be logged and sent out as a WALLOPS/GLOBOPS.

NOTE: Access to this command requires the correct permissions to be present in your opertype.

Syntax

/msg NickServ GETPASS Nick_goes_here

Examples

/msg NickServ GETPASS Freddy

Group

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 may be able to 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.

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.

Syntax

/msg NickServ GROUP main_nick_here main_nicks_password_here /msg NickServ GLIST Examples /msg NickServ GROUP Freddy IKillPeoleInTheirSleep /msg NickServ GLIST

Help

Shows a list of commands available to you. If you do not have access to a command, it is normally not shown.

Syntax

/msg NickServ HELP

Examples

/msg NickServ HELP

Identify

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 "/msg NickServ REGISTER" command.

NOTE: Some networks alias this command to "/msg NickServ ID"

Syntax

/msg NickServ IDENTIFY optional_nick_here password_here

Examples

/msg NickServ IDENTIFY ISlayInDreams /msg NickSerc IDENTIFY FreddyK ISlayInDreams

Info

Displays information about the given nickname, such as the nick's owner, last seen address and time, and nick options. If no nick is given, and you are identified, your account name is used, else your current nickname is used.

This information can be masked with several other NickServ settings. See /msg NickServ SET elsewhere on this page.

Syntax

/msg NickServ INFO optional_nick_here

Examples

/msg NickServ INFO /msg NickServ INFO Freddy

List

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 IrcOps with the proper access. Nicks with the NOEXPIRE option set will have a ! prefixed to the nickname for IrcOps to see.

Note that a preceding '#' specifies a range.

If the SUSPENDED, UNCONFIRMED or NOEXPIRE options are given, only nicks which, respectively, are SUSPENDED, UNCONFIRMED or have the NOEXPIRE flag set will be displayed. If multiple options are given, all nicks matching at least one option will be displayed. Note that these options are limited to IrcOps with the correct permissions.

Regex matches are also supported using the regex/posix engine. Enclose your pattern in // if this is desired.

Syntax

/msg NickServ LIST pattern optional_keyword_SUSPENDED optional_keyword_NOEXPIRE optional_keyword_UNCONFIRMED

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. /msg NickServ LIST #51-100 Lists all registered nicks within the given range (51-100).

Logout

Without a parameter, 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.

With a parameter, does the same for the given nick. If you specify REVALIDATE as well, Services will ask the given nick to re-identify. This is limited to Services IrcOps.

Syntax

/msg NickServ LOGOUT optional_nick_here Optional_word_'REVALIDATE'_here

Standard User

/msg NickServ LOGOUT IrcOps my specify a nick to remove the identified status of another without notice /msg NickServ Logout Freddy IrcOps my specify a nick and REVALIDATE to remove the identified status of another asking them to Re-Identify /msg NickServ Logout Freddy REVALIDATE

Recover

Recovers your nick from another user or from services. If services are currently holding your nick, the hold will be released. If another user is holding your nick and is identified they will be killed (similar to the old GHOST command). If they are not identified they will be forced off of the nick.

• Also sometimes aliased to GHOST and RELEASE for backwards compatibility

Syntax

/msg NickServ RECOVER Nick_goes_here semi-optional_password_goes_here

Examples

/msg NickServ RECOVER Freddy Mypassword

Set

Sets various nickname options.

the option can be one of:

SET AUTOOP Sets whether services should set channel status modes on you automatically. SET DISPLAY Set the display of your group in Services SET EMAIL Associate an E-mail address with your nickname SET FACEBOOK Associate a Facebook URL with your account SET GREET Associate a greet message with your nickname, displayed when you join a channel SET HIDE Hide certain pieces of nickname information SET KEEPMODES Enable or disable keep modes SET KILL Turn protection on or off SET LANGUAGE Set the language Services will use when messaging you, see /msg NickServ HELP SET LANGUAGE for list of available languages SET PASSWORD Set your nickname password SET PRIVATE Prevent the nickname from appearing in the LIST command SET SECURE Turn nickname security on or off SET TWITTER Associate a Twitter account with your account SET URL Associate a URL with your account

Syntax

/msg NickServ SET AUTOOP ON_or_OFF /msg NickServ SET DISPLAY nick_to_display_as_master_for_nick_group /msg NickServ SET EMAIL your@email.address.here /msg NickServ SET FACEBOOK your_facebook_address_here_leave_empty_to_disable /msg NickServ SET GREET Message_goes_here_leave_empty_to_disable /msg NickServ SET HIDE EMAIL ON_or_OFF /msg NickServ SET HIDE STATUS ON_of_OFF /msg NickServ SET HIDE USERMASK ON_or_OFF /msg NickServ SET HIDE QUIT ON_or_OFF /msg NickServ SET KILL ON_or_QUICK_or_IMMED_or_OFF /msg NickServ SET LANGUAGE Your_language_code_here /msg NickServ SET PASSWORD your_new_password_here /msg NickServ SET SECURE ON_or_OFF /msg NickServ SET TWITTER Your_twitter_handle_here_or_blank_to_disable /msg NickServ SET URL Your_website_address_here_or_blank_to_disable

Examples

/msg NickServ SET AUTOOP OFF /msg NickServ SET DISPLAY Freddy /msg NickServ SET EMAIL Freddy@dreamscape.org /msg NickServ SET FACEBOOK FreddyKrugerLives /msg NickServ SET GREET I come out of your nightmares to bring death and destruction /msg NickServ SET HIDE EMAIL ON /msg NickServ SET HIDE STATUS ON /msg NickServ SET HIDE USERMASK ON /msg NickServ SET HIDE QUIT OFF /msg NickServ SET KILL ON /msg NickServ SET LANGUAGE en_US /msg NickServ SET PASSWORD IKillPeopleInTheirSleep /msg NickServ SET SECURE ON /msg NickServ SET TWITTER @FreddyKrugerLives /msg NickServ SET URL http://nightmare.onelmstreet.us

Status

Returns whether the user using the given nickname is recognized as the owner of the nickname. The response has this format:

nickname status-code account

where nickname is the nickname sent with the command, status-code is one of the following, and account is the account they are logged in as.

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 If no nickname is given, your status will be returned.

Syntax

/msg NickServ STATUS Optional_nick_here Examples /msg NickServ STATUS /msg NickServ STATUS Freddy

UnGroup

This command ungroups your nick, or if given, the specificed nick, from the group it is in. The ungrouped nick keeps its registration time, password, email, greet, language, and url. Everything else is reset. You may not ungroup yourself if there is only one nick in your group.

Syntax

/msg NickServ UNGROUP Optional_nick_here

Examples

/msg NickServ UNGROUP /msg NickServ UNGROUP Freddy_K

Update

Updates your current status, i.e. it checks for new memos, sets needed channel modes and updates your vhost and your userflags (lastseentime, etc).

Syntax

/msg NickServ UPDATE

Examples

/msg NickServ UPDATE

GetEmail

Returns the matching nicks that used given email. Note that you can not use wildcards. Whenever this command is used, a message including the person who issued the command and the email it was used on will be logged. This requires a Services Operator with the correct permissions to use it.

Syntax

/msg NickServ GETEMAIL email@address.goes.here

Examples

/msg NickServ GETEMAIL freddy@elmstreet.com

SaSet

Sets various nickname options. option can be one of:

SASET AUTOOP Sets whether services should set channel status modes on you automatically. SASET DISPLAY Set the display of your group in Services SASET EMAIL Associate an E-mail address with your nickname SASET GREET Associate a greet message with your nickname SASET HIDE Hide certain pieces of nickname information SASET KEEPMODES Enable or disable keep modes SASET KILL Turn protection on or off SASET LANGUAGE Set the language Services will use when messaging you SASET NOEXPIRE Prevent the nickname from expiring SASET PASSWORD Set the nickname password SASET PRIVATE Prevent the nickname from appearing in the LIST command SASET SECURE Turn nickname security on or off SASET URL Associate a URL with this account Type /msg NickServ HELP saset option for more information on a specific option. The options will be set on the given nickname.

Access to this command requires the proper Services Operator permissions to be set.

Syntax

/msg NickServ SASET AUTOOP nick ON_or_OFF /msg NickServ SASET DISPLAY nick nick_to_display_as_master_for_nick_group /msg NickServ SASET EMAIL nick your@email.address.here /msg NickServ SASET GREET Message_goes_here_leave_empty_to_disable /msg NickServ SASET HIDE nick EMAIL ON_or_OFF /msg NickServ SASET HIDE nick STATUS ON_of_OFF /msg NickServ SASET HIDE nick USERMASK ON_or_OFF /msg NickServ SASET HIDE nick QUIT ON_or_OFF /msg NickServ SASET KEEPMODES nick ON_or_OFF /msg NickServ SASET KILL nick ON_or_QUICK_or_IMMED_or_OFF /msg NickServ SASET LANGUAGE nick Your_language_code_here /msg NickServ SASET NOEXPIRE nick ON_or_OFF /msg NickServ SASET PASSWORD nick your_new_password_here /msg NickServ SASET SECURE nick ON_or_OFF /msg NickServ SASET URL nick Your_website_address_here_or_blank_to_disable

Examples

/msg NickServ SASET AUTOOP Freddy OFF /msg NickServ SASET DISPLAY Freddy Freddy /msg NickServ SASET EMAIL Freddy Freddy@dreamscape.org /msg NickServ SASET GREET Freddy I come out of your nightmares to bring death and destruction /msg NickServ SASET HIDE Freddy EMAIL ON /msg NickServ SASET HIDE Freddy STATUS ON /msg NickServ SASET HIDE Freddy USERMASK ON /msg NickServ SASET HIDE Freddy QUIT OFF /msg NickServ SASET KEEPMODES Freddy ON /msg NickServ SASET KILL Freddy ON /msg NickServ SASET LANGUAGE Freddy en_US /msg NickServ SASET PASSWORD Freddy IKillPeopleInTheirSleep /msg NickServ SASET SECURE Freddy ON /msg NickServ SASET URL Freddy http://nightmare.onelmstreet.us Suspend Suspends a registered nickname, which prevents it from being used while keeping all the data for that nick. If an expiry is given the nick will be unsuspended after that period of time, else the default expiry from the configuration is used.

Access to this command requires the proper Servvices Operator permissions to be set you.

Syntax

/msg NickServ SUSPEND nickname +optional_expire_length Optionsal_reason

Examples

/msg NickServ SUSPEND Jason +30d You have been vanquished. Come back in 30 days.

UnSuspend

Unsuspends a nickname which allows it to be used again.

Access to this command requires the proper Services Operator permissions to be set for you.

Syntax

/msg NickServ UNSUSPEND nick

Examples

/msg NickServ UNSUSPEND Jason