N is our account nickname services bot. It allows you to maintain your account and claim ownership of the nicknames you most commonly use.
Contents
- Usage
- Registering an account
- Deleting an account
- Authenticating
- Account password
- Changing your email address
- Nickname management
- Account settings
- Ignore list management
- Miscellaneous
Usage
You can communicate with N via private message, or through server-side aliases, as shown below:
- /msg N <text>
- /msg N@services.darenet.org <text>
- /nickserv <text>
- /ns <text>
For the purpose of this guide, we will be using the first method listed, as not all IRC clients readily support server-side aliases without additional setup and/or client commands; however, you can choose to use any of the above methods as they are all equivalent.
Registering an account
To create a DareNET account, vist the sign up page.
Deleting an account
You can delete your account at anytime by visiting your account settings page.
Authenticating
AUTH
Syntax: /msg N AUTH [username|email] <password>
The AUTH command authenticates you with services, which is also commonly referred to as identifying or logging in.
If you are a using a nickname that is registered to your account, you only need to supply your password; otherwise, you must specify your username or email address.
AUTHCOOKIE
Syntax: /msg N AUTHCOOKIE <username>
The AUTHCOOKIE command is used to request a 'cookie', which is sent by email and can be used to authenticate.
This is often used when IRCing from a host that has not been added to your account's allowed host list.
ADDCERT
Syntax: /msg N ADDCERT [fingerprint]
The ADDCERT command is used to associate a client certificate fingerprint with your account.
If no fingerprint is given, your current client certificate fingerprint will be used.
Your client certificate fingerprints are used to automatically authenticate you to your account when connecting. For more information on this feature, check out the CertFP Authentication guide.
DELCERT
Syntax: /msg N DELCERT <fingerprint>
The DELCERT command is used to remove a client certificate fingerprint from your account.
LISTCERT
Syntax: /msg N LISTCERT
The LISTCERT command is used to list all client certificate fingerprints that are associated with your account.
GHOST
Syntax: /msg N GHOST <nick>
The GHOST command is used to disconnect an old client that's authenticated to your account.
ADDMASK
Syntax: /msg N ADDMASK [mask]
The ADDMASK command adds a user@host mask to your account's allowed hosts list.
When N's TRUSTED
setting is enabled for you account, you can only authenticate when your user@host information matches a mask on your allowed hosts list.
If no mask is specified, your current user@host will be used.
DELMASK
Syntax: /msg N DELMASK <mask>
The DELMASK command removes a user@host mask from your account's allowed hosts list.
LISTMASK
Syntax: /msg N LISTMASK
The LISTMASK command lists all user@host masks on your account's allowed hosts list.
Account password
You can change your password by visiting your account settings page.
If you have forgotten your account password, you can reset it by visiting the forgot password page.
Changing your email address
You can change the email address associated with your account by visiting your account settings page.
Nickname management
REGNICK
Syntax: /msg N REGNICK
The REGNICK command registers the nickname you're using to your account.
UNREGNICK
Syntax: /msg N UNREGNICK [nick]
The UNREGNICK command allows you to unregister a nickname that is registered to your account.
If no nickname is specified, your current nickname will be used.
Once a nickname has been unregistered, anyone is free to register to it.
NICKS
Syntax: /msg N NICKS
The NICKS command allows you to list all nicknames that are registered to your account.
NICKINFO
Syntax: /msg NICKINFO [nick]
The NICKINFO command displays registration information about the nickname specified.
Such information includes the date the nickname was registered, when it was last used and the account it belongs to.
If no nickname is specified, the nickname you're using will be used.
RECLAIM
Syntax: /msg N RECLAIM <nick>
The RECLAIM command allows you regain access to your nickname if another user is using it.
When you issue this command, the other user's nickname will be changed and N will temporarily hold your nickname to prevent them from reusing it (known as an "enforcer"). You will need to use N's RELEASE
command if you'd like to use it yourself.
RELEASE
Syntax: /msg N RELEASE <nick>
The RELEASE command removes any enforcer for the nickname, allowing you to use it again.
Nickname enforces are created when someone other than you attempts to your nickname if N's RECLAIM
setting is enabled for your account, or when you use the RECLAIM
command, to prevent the use of it.
Account settings
SET
Syntax: /msg N SET [<option> [value]]
The SET command allows you to change your account settings.
If no value is given for an option, then the current value for it will be shown.
If no arguments are given, then the current values for all settings will be shown.
SET AUTOHIDE
Syntax: /msg N SET AUTOHIDE [ON|OFF]
The AUTOHIDE setting enables or disables automatic host hiding for your account.
If ON, any fakehost or title set for your account will be automatically applied when you authenticate.
SET COLOR
Syntax: /msg N SET COLOR [ON|OFF]
The COLOR setting determines how service bots, such as N, format messages sent to you.
If ON, service bots may user ctrl-codes (i.e., bold, color and under-line text) when sending you messages.
SET INFO
Syntax: /msg N SET INFO [text|*]
The INFO setting sets an informational line (also known as an infoline) for your account.
Infolines are shown when other users use the INFO command for your account.
To remove an infoline, specify * as the text.
SET MAXLOGINS
Syntax: /msg N SET MAXLOGINS [value]
The MAXLOGINS setting defines the maximum number of clients that can be authenticated to your account at the same time.
You may specify a value between 0 and 5. A value of 0 will use the default setting.
SET NOOP
Syntax: /msg N SET NOOP [ON|OFF]
The NOOP setting determines whether you can be added to channel access lists.
When ON, users will not be able to add you to a channel's access list.
SET PARANOID
Syntax: /msg N SET PARANOID [ON|OFF]
The PARANOID setting determines whether N should send you some additional information when you authenticate.
When ON, N will show you some information about the last successful login for your account, and the number of failed attempts.
SET PRIVMSG
Syntax: /msg SET PRIVMSG [ON|OFF]
The PRIVMSG setting determines whether service bots should send their replies as a private message or notice.
By default, service bots reply using notices.
SET RECLAIM
Syntax: /msg N SET RECLAIM [ON|OFF]
The RECLAIM command enables or disables nickname enforcement for nicknames registered to your account.
When ON, N will prevent other users from using any nicknames registered to your account.
SET TABLEWIDTH
Syntax: /msg N SET TABLEWIDTH [value]
The TABLEWIDTH settings sets the width services bots should wrap table-formatted text when sending you replies.
The value may be a number between 0 and 16959. A value of 0 will use the default setting.
SET TRUSTED
Syntax: /msg N SET TRUSTED [ON|OFF]
The TRUSTED setting enables or disables use of your account's allowed host list.
When ON, you will only be allowed to authenticate to your account if your hostmask matches an entry on your allowed hosts list. In the case it doesn't match, you may have to use N's AUTHCOOKIE command to authenticate instead.
Ignore list management
ADDIGNORE
Syntax: /msg N ADDIGNORE <mask>
The ADDIGNORE adds the specified mask to your ignore list.
N automatically adds these masks to your SILENCE list on IRC.
DELIGNORE
Syntax: /msg N DELIGNORE <mask>
The DELIGNORE commands removes the specified mask from your ignore list.
N will also remove this mask from your SILENCE list on IRC.
LISTIGNORE
Syntax: /msg N LISTIGNORE
The LISTIGNORE command lists all masks on your ignore list.
Miscellaneous
INFO
Syntax: /msg N INFO [nick|*account]
The INFO command displays various information about the account specified.
If no account is specified, information about your account will be shown.
USERINFO
Syntax: /msg N USERINFO <nick>
The USERINFO command will show which account a user is authenticated to.
VACATION
Syntax: /msg N VACATION
The VACATION command allows you indicate that you will be away from IRC for a extended period of time (e.g., going on vacation). This will prevent your nickname(s) from being expired due to inactivity.
You account will stay marked until the time you authenticate.