Help

This is a manual for network services. The header name of each section is a part of a command.

Information is organized alphabetically by bot. Here's a quick link for each specific bot, but it is also listed in the Table of Contents.

BotServ is a bot that handles network-hosted channel bots.

ACT

Makes the bot do the equivalent of a “/me” command on the given channel using the given text.

Syntax: ACT <chan> <text>
Examples:

/msg BotServ ACT #help yawns!

ASSIGN

Assigns a bot pointed out by nick to the channel chan. You can then configure the bot for the channel so it fits your needs.

Syntax: ASSIGN <chan> <nick>
Examples:

/msg BotServ ASSIGN #help Security

BOTLIST

Lists all available bots on this network.

Syntax: BOTLIST
Examples:

/msg BotServ BOTLIST

INFO

INFO allows you to see BotServ information about a channel or a bot.

Syntax: INFO <#channel|botnick>

SAY

Makes the bot say the given text on the given channel.

Syntax: SAY <chan> <text>
Examples:

/msg BotServ SAY #help Welcome to #help!

SET

SET allows you to set various bot options.

FANTASY

Enables or disables fantasy mode on a channel. When it is enabled, users will be able to use all chanserv commands like !op, !deop, !voice, !devoice, !kick, !kb, !unban, !akick, !info on a channel.

Syntax: SET <#channel> FANTASY {ON|OFF}
Examples:

/msg BotServ SET #help FANTASY ON

NOBOT

This option makes a channel be unassignable. If a bot is already assigned to the channel, it is unassigned automatically when you enable the option.

Syntax: SET <#channel> NOBOT {ON|OFF}
Examples:

/msg BotServ SET #help NOBOT ON

UNASSIGN

Unassigns a bot from a channel. When you use this command, the bot won't join the channel anymore. However, bot configuration for the channel is kept, so you will always be able to reassign a bot later without having to reconfigure it entirely.

Syntax: UNASSIGN <chan>
Examples:

/msg BotServ UNASSIGN #help

ChanServ is a bot that handles channel operations.

ACCESS

ACCESS allows you to manage channel access.

Syntax: SET <#channel> <OPTION> [argument]

The options are below.

ADD

ACCESS ADD will assign the given user to the given channel role.

Syntax: ACCESS <#channel> ADD <user> <role>
Examples:

/msg ChanServ ACCESS #atheme ADD stitch helpers

DEL

ACCESS DEL will remove all channel access from a given user.

Syntax: ACCESS <#channel> DEL <user>
Examples:

/msg ChanServ ACCESS #atheme DEL stitch

INFO

ACCESS INFO displays what level of access a given user has in a given channel. It will display role, long-form flags and short-form flags along with the last date the user's access was modified.

Syntax: ACCESS <#channel> INFO <user>
Examples:

/msg ChanServ ACCESS #atheme INFO nenolod

LIST

ACCESS LIST lists all users with channel access and their roles in the channel. It uses fuzzy matching so if a user does not exactly match any role, they will be listed as the closest role they match.

Syntax: ACCESS <#channel> LIST
Examples:

/msg ChanServ ACCESS #atheme LIST

SET

ACCESS SET will change the given user's role to the given channel role.

Syntax: ACCESS <#channel> SET <user> <role>
Examples:

/msg ChanServ ACCESS #atheme SET stitch lowlevel-staff

AKICK

The AKICK command allows you to maintain channel ban lists. Users on the AKICK list will be automatically kickbanned when they join the channel, removing any matching ban exceptions first. Users with the +r flag are exempt.

Syntax: AKICK <#channel> ADD <nickname|hostmask> [!P|!T <minutes>] [reason]

You may also specify a hostmask ([email protected]) for the AKICK list.

The reason is used when kicking and is visible in AKICK LIST. If the reason contains a '|' character, everything after it does not appear in kick reasons but does appear in AKICK LIST.

If the !P token is specified, the AKICK will never expire (permanent). If the !T token is specified, expire time must follow, in minutes, hours (“h”), days (“d”) or weeks (“w”).

Syntax: AKICK <#channel> DEL <nickname|hostmask>

This will remove an entry from the AKICK list. Removing an entry will remove any matching channel bans unless the channel is set NOSYNC.

Syntax: AKICK <#channel> LIST

This will list all entries in the AKICK list, including the reason and time left until expiration.

Examples:

/msg ChanServ AKICK #foo ADD bar you are annoying | private op info 
/msg ChanServ AKICK #foo ADD *!*[email protected] !T 5d 
/msg ChanServ AKICK #foo DEL bar 
/msg ChanServ AKICK #foo LIST

BAN

The BAN command allows you to ban a user or hostmask from a channel.

Syntax: BAN <#channel> <nickname|hostmask>
Examples:

/msg ChanServ BAN #chat carnell 
/msg ChanServ BAN #chat *!*@*.ipt.aol.com

CLEAR BANS

Clear bans will remove all bans found in a specific channel. If your ircd supports other lists associated with a channel (e.g. ban exceptions), you can clear these by specifying the mode letters. Specify an asterisk to clear all lists.

Syntax: CLEAR <#channel> BANS [types]
Examples:

/msg ChanServ CLEAR #support BANS

Clears #support ban list.

/msg ChanServ CLEAR #support BANS eI

Removes all ban and invite exceptions on #support (if your ircd supports them).

/msg ChanServ CLEAR #support BANS *

Clears all lists of #support.

/msg ChanServ CLEAR #support BANS +

Shows the possible letters.

CLEAR FLAGS

CLEAR FLAGS will remove all flags from all users (or groups) with channel access on the channel specified except for users who are channel founders.

This command can only be used by channel founders.

Syntax: CLEAR <#channel> FLAGS
Examples:

/msg ChanServ CLEAR #atheme FLAGS

CLEAR USERS

Clear users will kick all users out of the channel, except you. The channel will be cycled (recreated) if you are not on it.

If a reason is specified, it will be included in the kick message.

Syntax: CLEAR <#channel> USERS [reason]
Examples:

/msg ChanServ CLEAR #ChatZone USERS

COUNT

This will give a count of how many entries are in each of the channel's xOP lists and how many entries on the access list do not match a xOP value.

The second line shows how many access entries have each flag.

Syntax: COUNT <#channel>
Examples:

/msg ChanServ COUNT #oscn

DROP

DROP allows you to “unregister” a registered channel.

Once you DROP a channel all of the data associated with it (access lists, etc) are removed and cannot be restored.

See help on SET FOUNDER and FLAGS for transferring a channel to another user.

Syntax: DROP <#channel>
Examples:

/msg ChanServ DROP #foo

FLAGS

The FLAGS command allows for the granting/removal of channel privileges on a more specific, non-generalized level. It supports nicknames, groups and hostmasks as targets.

When only the channel argument is given, a listing of permissions granted to users will be displayed.

Syntax: FLAGS <#channel>

Otherwise, an access entry is modified. A modification may be specified by a template name (changes the access to the template) or a flags change (starts with + or -). See the TEMPLATE help entry for more information about templates.

If you are not a founder, you may only manipulate flags you have yourself, and may not edit users that have flags you don't have. For this purpose, +v grants the ability to grant +V, +o grants the ability to grant +O, and +r grants the ability to grant +b. If you are not a founder, you may only manipulate flags you have yourself, and may not edit users that have flags you don't have. For this purpose, +v grants the ability to grant +V, +h grants the ability to grant +H, +o grants the ability to grant +O, and +r grants the ability to grant +b.

As of Atheme 7.0, there are now extended entity targets which allow you to match chanacs against a situation instead of against a nickname, hostmask or group.

Available exttargets are: $oper - Any user who is an oper (user mode +o). $registered - Any user who is identified to services. $channel:#channel - Any user who is the member of the given channel. $chanacs:#channel - Any user with channel access in the given channel (including hostmasks).

If you do not have +f you may still remove your own access with -*.

Syntax: FLAGS <#channel> [nickname|hostmask|group template]
Syntax: FLAGS <#channel> [nickname|hostmask|group flag_changes]

Permissions:
+v - Enables use of the voice/devoice commands.
+V - Enables automatic voice.
+h - Enables use of the halfop/dehalfop commands.
+H - Enables automatic halfop.
+o - Enables use of the op/deop commands.
+O - Enables automatic op.
+a - Enables use of the protect/deprotect commands.
+q - Enables use of the owner/deowner commands.
+s - Enables use of the set command.
+i - Enables use of the invite and getkey commands.
+r - Enables use of the kick, kickban, ban and unban commands.
+R - Enables use of the recover, sync and clear commands.
+f - Enables modification of channel access lists.
+t - Enables use of the topic and topicappend commands.
+A - Enables viewing of channel access lists.
+S - Marks the user as a successor.
+F - Grants full founder access.
+b - Enables automatic kickban.
+e - Exempts from +b and enables unbanning self.

The special permission +* adds all permissions except +b, +S, and +F. The special permission -* removes all permissions including +b and +F.

Examples:

/msg ChanServ FLAGS #foo 
/msg ChanServ FLAGS #foo foo!*@bar.com VOP 
/msg ChanServ FLAGS #foo foo!*@bar.com -V+oO 
/msg ChanServ FLAGS #foo foo!*@bar.com -* 
/msg ChanServ FLAGS #foo foo +oOtsi 
/msg ChanServ FLAGS #foo TroubleUser!*@*.troubleisp.net +b 
/msg ChanServ FLAGS #foo !baz +*

GETKEY

GETKEY returns the key (+k, password to be allowed in) of the specified channel: /join #channel key

Syntax: GETKEY <#channel>
Examples:

/msg ChanServ GETKEY #foo

HALFOP|DEHALFOP

These commands perform status mode changes on a channel.

If you perform an operation on another user, they will be notified that you did it.

If the last parameter is omitted the action is performed on the person requesting the command.

Syntax: HALFOP|DEHALFOP <#channel> [nickname]
Examples:

/msg ChanServ HALFOP #foo

INFO

INFO displays channel information such as registration time, flags, and other details.

Syntax: INFO <#channel>
Examples:

/msg ChanServ INFO #foo

INVITE

INVITE requests services to invite you to the specified channel. This is useful if you use the +i channel mode.

Syntax: INVITE <#channel>
Examples:

/msg ChanServ INVITE #foo

KICK

The KICK command allows for the removal of a user from a channel. The user can immediately rejoin.

Your nick will be added to the kick reason.

Syntax: KICK <#channel> <nick> [reason]
Examples:

/msg ChanServ KICK #foo abuser 
/msg ChanServ KICK #foo abuser please stop

KICKBAN

The KICKBAN command allows for the removal of a user from a channel while placing a ban on the user.

Any matching ban exceptions will be removed.

Syntax: KICKBAN <#channel> <nick> [reason]
Examples:

/msg ChanServ KICKBAN #foo abuser 
/msg ChanServ KICKBAN #foo abuser go away

MARK

MARK allows operators to attach a note to a channel. For Examples, an operator could mark the channel of a spammer so that others know it has previously been warned.

MARK information will be displayed in INFO output.

Syntax: MARK <#channel> ON|OFF <reason>
Examples:

/msg ChanServ MARK #lobby ON Takeover: returned to bill

OP|DEOP|VOICE|DEVOICE

These commands perform status mode changes on a channel.

If you perform an operation on another user, they will be notified that you did it.

If the last parameter is omitted the action is performed on the person requesting the command.

Syntax: OP|DEOP <#channel> [nickname]
Syntax: VOICE|DEVOICE <#channel> [nickname]
Examples:

/msg ChanServ OP #foo bar 
/msg ChanServ DEVOICE #foo

OWNER|DEOWNER

These commands perform status mode changes on a channel.

If you perform an operation on another user, they will be notified that you did it.

If the last parameter is omitted the action is performed on the person requesting the command.

Syntax: OWNER|DEOWNER <#channel> [nickname]
Examples:

/msg ChanServ OWNER #foo

PROTECT|DEPROTECT

These commands perform status mode changes on a channel.

If you perform an operation on another user, they will be notified that you did it.

If the last parameter is omitted the action is performed on the person requesting the command.

Syntax: PROTECT|DEPROTECT <#channel> [nickname]
Examples:

/msg ChanServ PROTECT #foo

QUIET

The QUIET command allows you to mute a user or hostmask in a channel. Affected users will be notified that you did it.

Syntax: QUIET <#channel> <nickname|hostmask>
Examples:

/msg ChanServ QUIET #chat AfterDeath 
/msg ChanServ QUIET #chat *!*@*.ipt.aol.com

RECOVER

RECOVER allows you to regain control of your channel in the event of a takeover.

More precisely, everyone will be deopped, limit and key will be cleared, all bans matching you are removed, a ban exception matching you is added (in case of bans Atheme can't see), the channel is set invite-only and moderated and you are invited.

If you are on channel, you will be opped and no ban exception will be added.

Syntax: RECOVER <#channel>
Examples:

/msg ChanServ RECOVER #foo

REGISTER

REGISTER allows you to register a channel so that you have better control. Registration allows you to maintain a channel access list and other functions that are normally provided by IRC bots.

Syntax: REGISTER <#channel>
Examples:

/msg ChanServ REGISTER #atheme

ROLE ADD

ROLE ADD will create a channel role with the given flags. Multiple flags should be separated by a space.

Syntax: ROLE <#channel> ADD <role> [flags]

Flags:
+acl-change - Enables modification of channel access lists.
+acl-view - Enables viewing of channel access lists.
+autohalfop - Enables automatic halfop.
+autoop - Enables automatic op.
+autovoice - Enables automatic voice.
+banned - Enables automatic kickban.
+founder - Grants full founder access.
+halfop - Enables use of the halfop/dehalfop commands.
+invite - Enables use of the invite and getkey commands.
+op - Enables use of the op/deop commands.
+owner - Enables use of the owner/deowner commands.
+protect - Enables use of the protect/deprotect commands.
+recover - Enables use of the recover and clear commands.
+remove - Enables use of the kick, kickban, ban and unban commands.
+set - Enables use of the set command.
+successor - Marks the user as a successor.
+topic - Enables use of the topic and topicappend commands.
+voice - Enables use of the voice/devoice commands.

Examples:

/msg ChanServ ROLE #atheme ADD helpers topic autovoice

ROLE DEL

ROLE DEL will delete a channel-specific role.

Syntax: ROLE <#channel> DEL <role>
Examples:

/msg ChanServ ROLE #atheme DEL helpers

ROLE LIST

ROLE LIST lists all channel-specific and network-wide roles and the flags that each role has.

Syntax: ROLE <#channel> LIST
Examples:

/msg ChanServ ROLE #baz LIST

ROLE SET

ROLE SET allows you to modify the flags of a role that already exists. All users in the given role will receive the effects of the changes. Multiple flags should be seperated by a space and have the modifier (+ or -) before each flag.

Syntax: ROLE <#channel> SET <role> <flags>
Examples:

/msg ChanServ ROLE #atheme SET channel-ops +acl-change +set +recover 
/msg ChanServ ROLE #atheme SET helpers +invite 
/msg ChanServ ROLE #foo SET helpers -topic -invite Help for SET ANTIFLOOD: SET ANTIFLOOD configures ChanServ flood control settings. The action parameter can be QUIET, KICKBAN or AKILL. Flood control can be turned off using the OFF setting, and turned on using default settings with the ON setting. Syntax: SET <#channel> ANTIFLOOD <action>

Syntax: SET <#channel> ANTIFLOOD OFF
Examples:

/msg ChanServ SET #channel ANTIFLOOD QUIET 
/msg ChanServ SET #silence ANTIFLOOD KICKBAN 
/msg ChanServ SET #trolls ANTIFLOOD AKILL 
/msg ChanServ SET #coders ANTIFLOOD OFF 
/msg ChanServ SET #defocus ANTIFLOOD ON

SET

SET allows you to set various channel options.

Syntax: SET <#channel> <OPTION> [argument]

The options are below.

EMAIL

SET EMAIL allows you to change or set the email address associated with a channel. This is shown to all users in INFO.

Syntax: SET <#channel> EMAIL [email]
Using the command in this way results in an email address being associated with the channel.

Examples:

/msg ChanServ SET #chat EMAIL [email protected]

ENTRYMSG

SET ENTRYMSG allows you to change or set a message sent to all users joining the channel.

Syntax: SET <#channel> ENTRYMSG [message]
Examples:

/msg ChanServ SET #support ENTRYMSG Welcome to #support. Please do not paste more than 5 lines.

FANTASY

SET FANTASY allows you to enable or disable ChanServ fantasy commands (!op, !deop, etc.) on your channel.

GUARD must be enabled as well for fantasy commands to work.

Syntax: SET <#channel> FANTASY ON|OFF
Examples:

/msg ChanServ SET #chatspike FANTASY ON

FOUNDER

SET FOUNDER allows you to set a new founder of the channel. The new founder has to execute the same command to confirm the transfer.

Syntax: SET <#channel> FOUNDER <newnick>
If the new founder has not yet confirmed the transfer, you can cancel it by specifying your own nick as the new founder.

Syntax: SET <#channel> FOUNDER <yournick>
Examples:

/msg ChanServ SET #foo FOUNDER bar

GAMESERV

SET GAMESERV allows gaming services to be used, sending to the channel, via /msg GameServ <command> <channel> <parameters>.

You can decide who may use GameServ:
ALL - allow all channel members
VOICE - allow ops/voiced
OP - allow ops
OFF - allow noone

For OP and VOICE, both channel status and ChanServ flags apply.

Syntax: SET <#channel> GAMESERV ALL|VOICE|OP|OFF
Examples:

/msg ChanServ SET #foo GAMESERV VOICE

GUARD

SET GUARD allows you to have ChanServ join your channel.

Syntax: SET <#channel> GUARD ON|OFF
Examples:

/msg ChanServ SET #atheme GUARD ON

KEEPTOPIC

SET KEEPTOPIC enables restoration of the old topic after the channel has become empty. In some cases, it may revert topic changes after netsplits or services outages, so it is not recommended to turn this on if your channel tends to never empty.

Syntax: SET <#channel> KEEPTOPIC ON|OFF
Examples:

/msg ChanServ SET #foo KEEPTOPIC ON

MLOCK

MLOCK (or “mode lock”) allows you to enforce a set of modes on a channel. This can prevent abuse in cases such as +kl. It can also make it harder to fight evil bots, be careful. Locked modes can be seen by anyone recreating the channel (this includes keys).

Syntax: SET <#channel> MLOCK [modes]
Examples: (some may use modes your ircd does not support)

/msg ChanServ SET #foo MLOCK +nt-lk 
/msg ChanServ SET #foo MLOCK +inst-kl 
/msg ChanServ SET #c MLOCK +ntk c 
/msg ChanServ SET #foo MLOCK +ntcjf-kl 2:30 #overflow 
/msg ChanServ SET #overflow MLOCK +mntF-kljf 
/msg ChanServ SET #foo1 MLOCK +ntlL 40 #foo2

NOSYNC

SET NOSYNC allows channel staff to disable automatic syncing of channel status when it is changed.

Syntax: SET <#channel> NOSYNC ON|OFF
Examples:

/msg ChanServ SET #foo NOSYNC ON

PREFIX

PREFIX allows you to customize the channel fantasy trigger for your channel. This is particularly useful if you have channel bots that conflict with ChanServ's default fantasy prefix. Providing no prefix argument (or DEFAULT) resets the channel fantasy prefix to the network default prefix.

Syntax: SET <#channel> PREFIX [prefix]
Examples:

/msg ChanServ SET #foo PREFIX 
/msg ChanServ SET #foo PREFIX ' 
/msg ChanServ SET #c PREFIX % 
/msg ChanServ SET #c PREFIX default

PRIVATE

SET PRIVATE hides various information about the channel from other users.

Syntax: SET <#channel> PRIVATE ON|OFF
Examples:

/msg ChanServ SET #foo PRIVATE ON

PROPERTY

SET PROPERTY manipulates metadata associated with a channel.

To delete a metadata entry, specify the name and leave the value blank.

Syntax: SET <#channel> PROPERTY <name> [value]
Examples:

/msg ChanServ SET #atheme PROPERTY URL http://www.atheme.org/ 
/msg ChanServ SET #meat PROPERTY VEGETABLES

RESTRICTED

SET RESTRICTED designates a channel as restricted access. Users who are not on the access list of the channel, or who do not have the chan:joinstaffonly privilege will be kicked and banned from the channel upon join, removing any ban exceptions matching them first. If the channel is set +i, no ban will be set and invite exceptions will be removed.

Syntax: SET <#channel> RESTRICTED ON|OFF
Examples:

/msg ChanServ SET #snoop RESTRICTED ON

SECURE

SET SECURE prevents anyone that's not on the channel's access lists from gaining operator or halfop status on the channel. This is useful if you're paranoid.

Syntax: SET <#channel> SECURE ON|OFF
Examples:

/msg ChanServ SET #foo SECURE ON

TOPICLOCK

SET TOPICLOCK causes ChanServ to revert topic changes by users without the +t flag. Topic changes during netsplits or services outages will always be reverted.

TOPICLOCK requires KEEPTOPIC and will automatically enable it; disabling KEEPTOPIC will disable TOPICLOCK also.

Syntax: SET <#channel> TOPICLOCK ON|OFF
Examples:

/msg ChanServ SET #foo TOPICLOCK ON

URL

SET URL allows you to change or set the URL associated with a channel. This is shown to all users joining the channel.

Syntax: SET <#channel> URL [url]
Examples:

/msg ChanServ SET #chat URL http://slashdot.org

VERBOSE

SET VERBOSE ON sends a notice to the channel when someone makes changes to the access lists.

SET VERBOSE OPS sends a notice to the channel operators when someone makes changes to the access lists.

Fantasy commands are always executed as if SET VERBOSE ON is in effect.

Syntax: SET <#channel> VERBOSE ON|OPS|OFF
Examples:

/msg ChanServ SET #foo VERBOSE ON

STATUS

STATUS returns information about your current state. It will show information about your nickname, IRC operator, and SRA status.

If the a channel parameter is specified, your access to the given channel is returned.

Syntax: STATUS [#channel]
Examples:

/msg ChanServ STATUS 
/msg ChanServ STATUS #foo

SYNC

The SYNC command will force all channel statuses to flags, giving and taking away ops, voice and so on where necessary. You must have the channel flag +R to run this command.

Syntax: SYNC <#channel>
Examples:

/msg ChanServ SYNC #bar

TAXONOMY

The taxonomy command lists metadata information associated with registered channels.

Examples:

/msg ChanServ TAXONOMY #atheme

TEMPLATE

The TEMPLATE command allows definition of sets of flags, simplifying the use of the FLAGS command.

Without arguments, network wide templates are shown. These include at least SOP/AOP/HOP/VOP.

Syntax: TEMPLATE
When given only the channel argument, a listing of templates for the channel will be displayed.

Syntax: TEMPLATE <#channel>
Otherwise, a template is modified. A modification may be specified by a template name (copies the template) or a flags change (starts with + or -, optionally preceded by an !). Templates cannot be the empty set (making a template empty deletes it).

If the ! form is used, all access entries which exactly match the template are changed accordingly. This is not supported if the template includes or included founder access (+F).

There is a limit on the length of all templates on a channel.

If you are not a founder, similar restrictions apply as in FLAGS.

Syntax: TEMPLATE <#channel> [template oldtemplate]
Syntax: TEMPLATE <#channel> [template flag_changes]
Syntax: TEMPLATE <#channel> [template !flag_changes]
Examples:

/msg ChanServ TEMPLATE #foo 
/msg ChanServ TEMPLATE #foo user VOP 
/msg ChanServ TEMPLATE #foo user !+A 
/msg ChanServ TEMPLATE #foo co-founder +*-OH 
/msg ChanServ TEMPLATE #foo op -*+vVhoti 
/msg ChanServ TEMPLATE #foo co-founder +*-O 
/msg ChanServ TEMPLATE #foo op -*+vVoti 
/msg ChanServ TEMPLATE #foo obsoletetemplate -*

TOPIC

The TOPIC command allows for the changing of a topic on a channel.

Syntax: TOPIC <#channel> <topic>
Examples:

/msg ChanServ TOPIC #foo bar

TOPICAPPEND

The TOPICAPPEND command allows for the addition to a topic on a channel.

Syntax: TOPICAPPEND <#channel> <topic>
Examples:

/msg ChanServ TOPICAPPEND #foo bar

TOPICPREPEND

The TOPICPREPEND command allows for the addition to a topic on a channel.

Syntax: TOPICPREPEND <#channel> <topic>
Examples:

/msg ChanServ TOPICPREPEND #foo bar

UNBAN (User)

The UNBAN command allows you to unban a user or hostmask from a channel. If no nickname or hostmask is specified, you are unbanned.

Syntax: UNBAN <#channel> [nickname|hostmask]
Examples:

/msg ChanServ UNBAN #chat pfish 
/msg ChanServ UNBAN #chat *!*@*.ucdavis.edu

UNBAN (Self)

The UNBAN command allows you to remove all bans matching you from a channel.

Syntax: UNBAN <#channel>
Examples:

/msg ChanServ UNBAN #chat

UNQUIET

The UNQUIET command allows you to unmute a user or hostmask in a channel. If no nickname or hostmask is specified, you are unquieted.

Affected users will be notified that you did it.

Syntax: UNQUIET <#channel> [nickname|hostmask]
Examples:

/msg ChanServ UNQUIET #chat Diablo-D3 
/msg ChanServ UNQUIET #chat *!*@*.trilug.org

WHY

The WHY command shows the access entries an online user matches.

Syntax: WHY <#channel> [nickname]
Examples:

/msg ChanServ WHY #atheme jilles^

GameServ is a bot that provides game operations for channels and users.

CALC

CALC lets you do some simple mathematics with services. You can also specify a number of calculations that can be done at once.

Syntax: CALC [times] <expression>
Examples:

/msg GameServ CALC 6*8 
/msg GameServ CALC 5 1+2

EIGHTBALL

Asks the magic 8-ball a question.

Syntax: EIGHTBALL
Examples:

/msg GameServ EIGHTBALL

LOTTERY

LOTTERY randomly chooses a user on the channel where it is run.

Syntax: LOTTERY
Examples:

/msg GameServ LOTTERY

NAMEGEN

NAMEGEN provides you with a list of possible names you could use.

It can display the result to either yourself or a channel.

Syntax: NAMEGEN [number of names]
Examples:

/msg GameServ NAMEGEN 5

ROLL

ROLL lets you roll a series of virtual dice and display the result to either yourself or a channel. You can also specify a number of dice rolls that can be done at once.

Syntax: ROLL [times] <#dice>d<#sides>
Examples:

/msg GameServ ROLL 2d16 
/msg GameServ ROLL 5 4d16

RPS

RPS will randomly reply “Rock”, “Paper”, or “Scissors”.

Syntax: RPS
Examples:

/msg GameServ RPS

HostServ is a bot that handles vhosts.

REQUEST

REQUEST activation of the vhost. You must be identified to a registered nick to issue this command. Please be patient while your request is considered by network staff.

Check the vHosts section of our Rules pages for guidelines on how to set your vhost.

Syntax: REQUEST <vhost>
Examples:

/msg HostServ REQUEST may.explode.on.impact

MemoServ is a bot that provides a messaging service, particularly useful to contact users that are not currently online.

DELETE

DELETE allows you to delete memos from your inbox. You can delete all memos with the ALL parameter, all read memos with the OLD parameter, or specify a memo number.

You can obtain a memo number by using the LIST command. Once you delete a memo, the numbers of all subsequent memos will change.

You can also SEND, READ, LIST and FORWARD memos.

Syntax: DELETE ALL|OLD|<memo number>
Examples:

/msg MemoServ DELETE OLD 
/msg MemoServ DELETE 1

FORWARD

FORWARD allows you to forward a memo to another account. Useful for a variety of reasons.

You can also SEND, DELETE, LIST or READ memos.

Syntax: FORWARD <user|nick> <memo number>
Examples:

/msg MemoServ FORWARD kog 1

IGNORE

IGNORE allows you to ignore memos from another user. Possible reasons include inbox spamming, annoying users, bots that have figured out how to register etc.

You can add up to 40 users to your ignore list

Syntax: IGNORE ADD|DEL|LIST|CLEAR <account>
Examples:

/msg MemoServ IGNORE ADD kog 
/msg MemoServ IGNORE DEL kog 
/msg MemoServ IGNORE LIST 
/msg MemoServ IGNORE CLEAR

LIST

LIST shows you your memos in your inbox, including who sent them and when. To read a memo, use the READ command. You can also DELETE or FORWARD a memo.

Syntax: LIST
Examples:

/msg MemoServ LIST

READ

READ allows you to read a memo that another user has sent you. You can either read a memo by number or read your new memos.

Syntax: READ <memo number>
Syntax: READ NEW
Examples:

/msg MemoServ READ 1

SEND

SEND allows you to send a memo to a nickname that is offline at the moment. When they come online they will be told they have messages waiting for them and will have an opportunity to read your memo.

Your memo cannot be more than 300 characters.

Syntax: SEND <user|nick> text
Examples:

/msg MemoServ SEND Kog pay your bills

SENDOPS

SENDOPS allows you to send a memo to all ops on a channel. Only users allowed to view the access list can do this.

Syntax: SENDOPS <#channel> <text>
Examples:

/msg MemoServ SENDOPS #chat beware of badguy

NickServ is a bot that handles name operations.

ACCESS

ACCESS maintains a list of [email protected] masks from where NickServ will recognize you, so it will not prompt you to change nick. Preventing expiry, getting channel access or editing nickname settings still requires identification, however.

Access list entries can use hostnames with optional wildcards, IP addresses and CIDR masks. There are restrictions on how much you can wildcard. If you omit the mask, NickServ will attempt to generate one matching your current connection.

Syntax: ACCESS LIST
Syntax: ACCESS ADD [mask]
Syntax: ACCESS DEL <mask>
Operators with user:auspex privilege can also view another user's access list.

Syntax: ACCESS LIST <nick>
Examples:

/msg NickServ ACCESS LIST 
/msg NickServ ACCESS ADD [email protected] 
/msg NickServ ACCESS ADD [email protected] 
/msg NickServ ACCESS ADD [email protected]/24 
/msg NickServ ACCESS DEL *[email protected]*.area.old.Examples.net

DROP

Using this command makes NickServ remove your account and stop watching your nick(s), If a nick is dropped, anyone else can register it. You will also lose all your channel access and memos.

When dropping and re-registering an account during a netsplit, users on the other side of the split may later be recognized as the new account.

Syntax: DROP <nickname> <password>
Examples:

/msg NickServ DROP foo bar

GHOST

GHOST disconnects an old user session, or somebody attempting to use your nickname without authorization.

If you are logged in to the nick's account, you need not specify a password, otherwise you have to.

Syntax: GHOST <nick> [password]
Examples:

/msg NickServ GHOST foo bar

GROUP

GROUP registers your current nickname to your account. This means that NickServ protects this nickname the same way as it protects your account name. Most services commands will accept the new nickname as an alias for your account name.

Please note that grouped nicks expire separately from accounts. To prevent this, you must use them. Otherwise, all properties of the account are shared among all nicks registered to it.

Syntax: GROUP
Examples:

/msg NickServ IDENTIFY OldNick SecretPassword 
/msg NickServ GROUP

IDENTIFY

IDENTIFY identifies you with services so that you can perform general maintenance and commands that require you to be logged in.

Syntax: IDENTIFY <password>
You can also identify for another nick than you are currently using.

Syntax: IDENTIFY <nick> <password>
Examples:

/msg NickServ IDENTIFY foo 
/msg NickServ IDENTIFY jilles foo

INFO

INFO displays account information such as registration time, flags, and other details. Additionally it will display registration and last seen time of the nick you give.

You can query the nick a user is logged in as by specifying an equals sign followed by their nick. This '=' convention works with most commands.

Syntax: INFO <nickname>
Syntax: INFO =<online user>
Examples:

/msg NickServ INFO w00t 
Shows information about the registered nick w00t. 

/msg NickServ INFO =w00tie[home] 
Shows information about the registered nick the user w00tie[home] is logged in as.

LISTCHANS

LISTCHANS shows the channels that you have access to, including those that you own.

AKICKs and host-based access are not shown.

Syntax: LISTCHANS
Operators with chan:auspex privilege can also check another user's access.

Syntax: LISTCHANS <nick>
Examples:

/msg NickServ LISTCHANS

LISTGROUPS

LISTGROUPS shows the groups that you have access to, including those that you own.

Group BANs are not shown.

Syntax: LISTGROUPS
Operators with group:auspex privilege can also check another user's access.

Syntax: LISTGROUPS <nick>
Examples:

/msg NickServ LISTGROUPS

LISTOWNMAIL

LISTOWNMAIL shows accounts registered to your account's e-mail address.

Syntax: LISTOWNMAIL
Examples:

/msg NickServ LISTOWNMAIL

LOGIN

LOGIN identifies you with services so that you can perform general maintenance and commands that require you to be logged in.

Syntax: LOGIN <account> <password>
Examples:

/msg NickServ LOGIN smith sesame

LOGOUT

LOGOUT logs you out of the account that you are currently logged into.

Syntax: LOGOUT
Examples:

/msg NickServ LOGOUT

REGAIN

REGAIN regains access to your nickname from a user that is using your nick.

If you are logged in to the account associated with the nickname, you need not specify a password, otherwise you have to.

Syntax: REGAIN <nick> [password]
Examples:

/msg NickServ REGAIN Dave2 goats

REGISTER

This will register your current nickname with NickServ. This will allow you to assert some form of identity on the network and to be added to access lists. Furthermore, NickServ will warn users using your nick without identifying and allow you to kill ghosts. The password is a case-sensitive password that you make up. Please write down or memorize your password! You will need it later to change settings.

You have to confirm the email address. To do this, follow the instructions in the message sent to the email address.

Syntax: REGISTER <password> <email-address>
Examples:

/msg NickServ REGISTER bar [email protected]

RELEASE

RELEASE removes an enforcer for your nick or changes the nick of a user that is using your nick.

Enforcers are created when someone uses your nick without identifying and prevent all use of it.

If you are logged in to the nick, you need not specify a password, otherwise you have to.

Syntax: RELEASE <nick> [password]
Examples:

/msg NickServ RELEASE smith sesame

RESETPASS

RESETPASS sets a random password for the specified account.

Syntax: RESETPASS <nickname>
Examples:

/msg NickServ RESETPASS pfish

SET

Allows you to set various options for your account.

Syntax: SET <OPTION> [arguments]

Options are listed below.

ACCOUNTNAME

ACCOUNTNAME allows you to change your account name to any nick registered to your account. Your account name is used in various places as a name for you.

Syntax: SET ACCOUNTNAME <nick>

EMAIL

EMAIL changes the e-mail address associated with an account. The e-mail address is used for password retrieval.

You may be required to confirm the new e-mail address. To confirm the address, follow the instructions in the message sent to the new address.

Syntax: SET EMAIL <new address>
Examples:

/msg NickServ SET EMAIL [email protected]

EMAILMEMOS

This will forward memos sent to your account to the email address listed on your registration.

Syntax: SET EMAILMEMOS [ON|OFF]
Examples:

/msg NickServ SET EMAILMEMOS ON

ENFORCE

ENFORCE allows you to enable more protection for all nicknames registered to your account.

This will automatically change the nick of someone who attempts to use it without identifying in time, and temporarily block its use, which can be removed at your discretion. See help on RELEASE.

Syntax: SET ENFORCE ON|OFF

HIDEMAIL

HIDEMAIL prevents an account's e-mail address from being shown to other users.

Syntax: SET HIDEMAIL ON|OFF
Examples:

/msg NickServ SET HIDEMAIL ON

LANGUAGE

LANGUAGE changes the language services uses to communicate with you.

Syntax: SET LANGUAGE <abbreviation>
Examples:

/msg NickServ SET LANGUAGE en
/msg NickServ SET LANGUAGE ru

NEVERGROUP

NEVERGROUP prevents others from adding you to group access lists.

Syntax: SET NEVERGROUP ON|OFF
Examples:

/msg NickServ SET NEVERGROUP ON

NEVEROP

NEVEROP prevents others from adding you to channel access lists.

Syntax: SET NEVEROP ON|OFF
Examples:

/msg NickServ SET NEVEROP ON

NOGREET

This setting allows you to opt-out of channel greeting notices.

Syntax: SET NOGREET ON|OFF
Examples:

/msg NickServ SET NOGREET ON

NOMEMO

This prevents people from being able to send you a memo. If you do not want to receive memos, you can just turn them off for your nick.

Syntax: SET NOMEMO ON|OFF
Examples:

/msg NickServ SET NOMEMO ON

NOOP

NOOP prevents services from automatically opping you in channels you have access in. You can choose to op/voice yourself by using the OP and VOICE commands.

Syntax: SET NOOP ON|OFF
Examples:

/msg NickServ SET NOOP ON

PASSWORD

PASSWORD changes the password of an account.

Syntax: SET PASSWORD <new password>
Examples:

/msg NickServ SET PASSWORD swordfish

PRIVATE

PRIVATE hides various information about your account from other users.

SET PRIVATE ON automatically enables HIDEMAIL too.

Syntax: SET PRIVATE ON|OFF
Examples:

/msg NickServ SET PRIVATE ON

PRIVMSG

PRIVMSG causes Services to use private messages when talking to the user authenticated on this account.

Syntax: SET PRIVMSG ON|OFF
Examples:

/msg NickServ SET PRIVMSG ON

PROPERTY

PROPERTY manipulates metadata associated with an account.

To delete a metadata entry, specify the name and leave the value blank.

Syntax: SET PROPERTY <name> [value]
Examples:

/msg NickServ SET PROPERTY URL http://www.Examples.com/~jay/ 
/msg NickServ SET PROPERTY SIGN Pisces 
/msg NickServ SET PROPERTY ICQ

QUIETCHG

QUIETCHG prevents services from automatically notifying you when ChanServ is used to affect your status in channels. When set to ON, Services will no longer send you messages of this nature.

Syntax: SET QUIETCHG ON|OFF
Examples:

/msg NickServ SET QUIETCHG ON

STATUS

STATUS returns information about your current state. It will show information about your nickname, IRC operator, and SRA status.

Syntax: STATUS
Examples:

/msg NickServ STATUS

TAXONOMY

The taxonomy command lists metadata information associated with registered users.

Examples:

/msg NickServ TAXONOMY foo

UNGROUP

UNGROUP unregisters the given nickname from your account. The nickname will be available for others to register. This will not affect your channel access or memos.

If you do not specify a nickname, your current nickname will be ungrouped. You cannot ungroup your account name.

Syntax: UNGROUP [nickname]
Examples:

/msg NickServ UNGROUP SomeNick

VACATION

VACATION extends the expiration time for your account and nicknames (but not your channels) to three times the usual value. You can only do this if your account is registered long enough.

Vacation mode is disabled automatically the next time you identify to NickServ.

Syntax: VACATION
Examples:

/msg NickServ VACATION

VERIFY

VERIFY confirms a change associated with your account registration.

Syntax: VERIFY <operation> <nickname> <key>
Examples:

/msg NickServ VERIFY REGISTER jenny 161803399 
/msg NickServ VERIFY EMAILCHG Aeriana 271828183