ChanServ

ChanServ is a service on the IRC network that helps manage and protect channels. It allows channel operators to register their channels, set access levels for users, and enforce channel settings like topic protection and bans. ChanServ ensures that the channel settings are maintained even when the channel operator is offline, providing a stable and secure environment for the community

ChanServ Commands

Here is a list of all ChanServ commands:

AKICK	BAN	CLEAR	DEOP	DEVOICE
DROP	FLAGS	GETKEY	INFO	INVITE
KICK	KICKBAN	OP	QUIET	REGISTER
TOPIC	UNBAN	UNQUIET	VOICE
WHY	ACCESS	AOP	BADWORDS	BANSEARCH
CALC	CLONE	COUNT	DF	EIGHTBALL
DROP	FLAGS	FORCEXOP	HELP	LOTTERY
MARK	NAMEGEN	NWOD	RECOVER	ROLE
ROLL	RPS	SOP	STATUS	SYNC
TAXONOMY	TEMPLATE	TOPICAPPEND	TOPICPREPEND	TOPICSWAP
VOP	WOD

ChanServ Set Commands

Here is a list of all commands related to SET:

ANTIFLOOD	BLOCKBADWORDS	BLOCKBADWORDSOPS	EMAIL	ENTRYMSG
FANTASY	GAMESERV	GUARD	KEEPTOPIC	LIMITFLAGS
MLOCK	NOSYNC	PREFIX	PRIVATE	PROPERTY
PUBACL	RESTRICTED	SECURE	TOPICLOCK	URL
VERBOSE

ACCESS

The ACCESS command manages user roles and access within a channel. This allows channel operators and founders to assign, modify, or remove access levels and permissions for users in the channel.

Syntax:

ACCESS <#channel> ADD <user> <role>

ACCESS <#channel> DEL <user>

ACCESS <#channel> INFO <user>

ACCESS <#channel> LIST

ACCESS <#channel> SET <user> <role|flags>

Examples:

/msg ChanServ ACCESS #atheme ADD stitch helpers

/msg ChanServ ACCESS #atheme DEL stitch

/msg ChanServ ACCESS #atheme INFO nenolod

/msg ChanServ ACCESS #atheme LIST

/msg ChanServ ACCESS #atheme SET stitch channel-ops

AKICK

The AKICK command allows you to manage channel ban lists. Users on the AKICK list will be automatically kicked and banned upon joining the channel.

Syntax:

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

AKICK <#channel> DEL <nickname|hostmask>

AKICK <#channel> LIST

Examples:

/msg ChanServ AKICK #foo ADD bar you are annoying

/msg ChanServ AKICK #foo ADD *!*foo@bar.com !T 5d

/msg ChanServ AKICK #foo ADD *!*@bar.com !T 5d you are annoying

/msg ChanServ AKICK #foo DEL bar

/msg ChanServ AKICK #foo LIST

BADWORDS

The BADWORDS command maintains a list of glob strings that every word in a channel will be checked against (if BLOCKBADWORDS is set).

The ACTION parameter can be: KICK, WARN, BAN, KICKBAN, or (if your IRCd supports it) QUIET.

Syntax:

BADWORDS <#channel> LIST

BADWORDS <#channel> ADD <word> <action>

BADWORDS <#channel> DEL <word>

Examples:

/msg ChanServ BADWORDS #atheme LIST

/msg ChanServ BADWORDS #sailors ADD f?ck kick

/msg ChanServ BADWORDS #sailors ADD *dam?it* quiet

/msg ChanServ BADWORDS #desensitized DEL f?ck

BAN

The BAN command bans a user or hostmask from joining the channel.

Syntax:

BAN <#channel> <nickname|hostmask>

Examples:

/msg ChanServ BAN #chat carnell

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

CLEAR

The CLEAR BANS command removes all bans in a specific channel. It can also remove invite exceptions depending on your server's support.

Syntax:

CLEAR <#channel> BANS [<types>]

Examples:

/msg ChanServ CLEAR #support BANS

/msg ChanServ CLEAR #support BANS eI

CLEAR

The CLEAR FLAGS command will remove all flags from users or groups with channel access in the specified channel, except for channel founders.

This command can only be used by channel founders.

Syntax:

CLEAR <#channel> FLAGS

Examples:

/msg ChanServ CLEAR #atheme FLAGS

CLEAR

The CLEAR USERS command will kick all users out of the channel, except for you. The channel will be cycled (recreated) if you are not in 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

The COUNT command provides a count of entries 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

The DROP command allows you to "unregister" a channel. Once a channel is dropped, all associated data (access lists, etc.) is removed and cannot be restored.

Refer to the SET FOUNDER and FLAGS help sections for instructions on transferring channel ownership.

Syntax:

DROP <#channel>

Examples:

/msg ChanServ DROP #foo

FLAGS

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

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

Syntax:

FLAGS <#channel>

To modify an access entry, specify either a template name (which sets the access to the template) or a flags change (beginning with + or -). See the TEMPLATE help entry for more information about templates.

If you are not a channel founder, you may only manipulate flags you currently possess. For instance: - +v grants +V - +o grants +O - +r grants +b

If the channel is restricted using the LIMITFLAGS option, only specific flags can be changed. See SET LIMITFLAGS for further details.

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

Syntax:

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

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 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.
+*	Grants all permissions except +b and +F.	-*	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 +*

FORCEXOP

The FORCEXOP command resets all channel access levels to xOP-compatible values. After executing this command, the founder(s) will have all permissions, and all other users with flags will be placed into one of the xOP lists. This command is useful if the definitions of which flags correspond to each xOP level change, and the founder wishes to use only xOP commands.

Only a channel founder can execute this command.

Syntax:

FORCEXOP <#channel>

See also: SOP, AOP, HOP, VOP

Syntax:

FTRANSFER <#channel> <founder>

Examples:

/msg ChanServ FTRANSFER #casual vodkaswirl

GETKEY

The GETKEY command returns the key (password) required to join a channel. The key is used with the /join command.

Syntax:

GETKEY <#channel>

Examples:

/msg ChanServ GETKEY #foo

INFO

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

Syntax:

INFO <#channel>

Examples:

/msg ChanServ INFO #foo

INVITE

The INVITE command requests services to invite you to a specified channel. This is useful if the channel has the +i mode enabled.

Syntax:

INVITE <#channel>

Examples:

/msg ChanServ INVITE #foo

KICK

The KICK command removes a user from a channel. The user may immediately rejoin. The kicker's nickname is included in 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 removes a user from a channel while also 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

OP|DEOP|VOICE|DEVOICE

These commands perform status mode changes on a channel. When performing an operation on another user, they will be notified of the action.

If the last parameter is omitted, the action will be performed on the user requesting the command.

Syntax:

OP|DEOP <#channel> [nickname]

VOICE|DEVOICE <#channel> [nickname]

Examples:

/msg ChanServ OP #foo bar

/msg ChanServ DEVOICE #foo

PROTECT|DEPROTECT

These commands perform status mode changes on a channel. When performing an operation on another user, they will be notified of the action.

If the last parameter is omitted, the action is performed on the user 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

The RECOVER command allows you to regain control of your channel in the event of a takeover. This will deop everyone, clear the channel's limit and key, remove any matching bans, add a ban exception, set the channel to invite-only and moderated, and invite you to the channel. If you are already on the channel, you will be opped without adding a ban exception.

Syntax:

RECOVER <#channel>

Example:

/msg ChanServ RECOVER #foo

REGISTER

The REGISTER command allows you to register a channel to gain better control, including maintaining an access list and other functions typically provided by IRC bots.

Syntax:

REGISTER <#channel>

Examples:

/msg ChanServ REGISTER #atheme

ROLE ADD

The ROLE ADD command creates a channel role with the given flags. Multiple flags should be separated by a space.

Syntax:

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

Flags:

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

Examples:

/msg ChanServ ROLE #atheme ADD helpers topic autovoice

ROLE DEL

The ROLE DEL command deletes a channel-specific role.

Syntax:

ROLE <#channel> DEL <role>

Examples:

/msg ChanServ ROLE #atheme DEL helpers

ROLE LIST

The ROLE LIST command lists all channel-specific and network-wide roles and the flags assigned to each role.

Syntax:

ROLE <#channel> LIST

Examples:

/msg ChanServ ROLE #baz LIST

ROLE SET

The ROLE SET command allows you to modify the flags of an existing role. All users in that role will receive the effects of the changes. Multiple flags should be separated by a space, with a 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

STATUS

The STATUS command returns information about your current state, including your nickname, IRC operator, and SRA status. If a channel parameter is specified, it will show your access to the given channel.

Syntax:

STATUS [#channel]

Examples:

/msg ChanServ STATUS

/msg ChanServ STATUS #foo

SYNC

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

Syntax:

SYNC <#channel>

Examples:

/msg ChanServ SYNC #bar

TAXONOMY

The TAXONOMY command lists metadata information associated with registered channels.

Example:

/msg ChanServ TAXONOMY #atheme

TEMPLATE

The TEMPLATE command allows the 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.

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

Syntax:

TEMPLATE

TEMPLATE <#channel>

To modify a template, use the following syntax. You can specify a template name or a flags change (with + or -), optionally preceded by an ! for bulk changes. Templates cannot be empty, and the template system has limitations.

Syntax:

TEMPLATE <#channel> [template oldtemplate]

TEMPLATE <#channel> [template flag_changes]

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 obsoletetemplate -*

TOPIC

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

Syntax:

TOPIC <#channel> <topic>

Examples:

/msg ChanServ TOPIC #foo bar

TOPICAPPEND

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

Syntax:

TOPICAPPEND <#channel> <topic>

Examples:

/msg ChanServ TOPICAPPEND #foo bar

TOPICPREPEND

The TOPICPREPEND command allows for the addition of a topic at the beginning of the channel's topic.

Syntax:

TOPICPREPEND <#channel> <topic>

Examples:

/msg ChanServ TOPICPREPEND #foo bar

UNBAN

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

Syntax:

UNBAN <#channel> [nickname|hostmask]

Examples:

/msg ChanServ UNBAN #chat pfish

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

UNQUIET

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

Affected users will be notified.

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^

xOP

The xOP commands allow you to maintain channel access lists, which can contain registered accounts or hostmasks. The access levels may differ per network, and the TEMPLATE system is recommended for ease of use.

The privileges required to execute these commands are the same as those for the corresponding FLAGS commands.

Syntax:

VOP|AOP|SOP <#channel> ADD|DEL|LIST <nickname|hostmask>

Examples:

/msg ChanServ VOP #foo ADD bar

/msg ChanServ VOP #foo ADD foo!*@bar.com

/msg ChanServ AOP #foo DEL bar

/msg ChanServ SOP #foo LIST

ANTIFLOOD

The SET ANTIFLOOD command 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>

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

BLOCKBADWORDS

The SET BLOCKBADWORDS command determines whether a channel's messages are checked against the badword list. All users will be affected by this setting.

If you want ops to be exempt from badword checking, use SET BLOCKBADWORDSOPS.

Syntax:

SET <#channel> BLOCKBADWORDS ON|OFF

Example:

/msg ChanServ SET #sailors BLOCKBADWORDS ON

BLOCKBADWORDSOPS

The SET BLOCKBADWORDSOPS command determines whether or not ops will be exempt from badword checking on a channel where badword filtering is enabled.

See also: SET BLOCKBADWORDS and BADWORDS

Syntax:

SET <#channel> BLOCKBADWORDSOPS ON|OFF

Example:

/msg ChanServ SET #sailors BLOCKBADWORDSOPS ON

EMAIL

The SET EMAIL command allows you to change or set the email address associated with a channel. This email is shown in the channel's INFO output.

Syntax:

SET <#channel> EMAIL [email]

Example:

/msg ChanServ SET #chat EMAIL some@email.address

ENTRYMSG

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

Syntax:

SET <#channel> ENTRYMSG [message]

Example:

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

FANTASY

The SET FANTASY command allows you to enable or disable ChanServ fantasy commands (such as !op, !deop). The GUARD flag must also be enabled for fantasy commands to work.

Syntax:

SET <#channel> FANTASY ON|OFF

Example:

/msg ChanServ SET #chatspike FANTASY ON

FOUNDER

The SET FOUNDER command allows you to set a new founder for the channel. The new founder must confirm the transfer by executing the same command. If the transfer is not confirmed, you can cancel it by specifying your own nickname as the new founder.

Syntax:

SET <#channel> FOUNDER <newnick>

SET <#channel> FOUNDER <yournick>

Example:

/msg ChanServ SET #foo FOUNDER bar

GAMESERV

The SET GAMESERV command allows gaming services to be used in the channel via /msg GameServ <command> <channel> <parameters>. You can decide who may use GameServ with the following options: - ALL - Allow all channel members. - VOICE - Allow ops and voiced members. - OP - Allow only ops. - OFF - Allow no one.

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

Syntax:

SET <#channel> GAMESERV ALL|VOICE|OP|OFF

Example:

/msg ChanServ SET #foo GAMESERV VOICE

See also: GameServ

GUARD

The SET GUARD command allows ChanServ to join your channel.

Syntax:

SET <#channel> GUARD ON|OFF

Example:

/msg ChanServ SET #atheme GUARD ON

KEEPTOPIC

The SET KEEPTOPIC command enables the restoration of the old topic after the channel becomes empty. It may revert topic changes after netsplits or service outages, so it is not recommended to enable this if your channel rarely empties.

Syntax:

SET <#channel> KEEPTOPIC ON|OFF

Example:

/msg ChanServ SET #foo KEEPTOPIC ON

LIMITFLAGS

The SET LIMITFLAGS command limits the power of the +f flag. Users with +f who lack +s or +R can only set +b (akick). Users who do not have all of +s and +R cannot set +s, +R, or +f.

Syntax:

SET <#channel> LIMITFLAGS ON|OFF

Example:

/msg ChanServ SET #foo LIMITFLAGS ON

MLOCK

The SET MLOCK (mode lock) command enforces a set of modes on the channel, preventing abuse in cases such as +kl. Be cautious as it can also make it harder to fight bots. Locked modes are visible to anyone recreating the channel (including keys).

Syntax:

SET <#channel> MLOCK [modes]

Examples:

/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

The SET NOSYNC command disables automatic syncing of channel status when it is changed.

Syntax:

SET <#channel> NOSYNC ON|OFF

Example:

/msg ChanServ SET #foo NOSYNC ON

PREFIX

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

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

The SET PRIVATE command hides various channel information from other users.

Syntax:

SET <#channel> PRIVATE ON|OFF

Example:

/msg ChanServ SET #foo PRIVATE ON

PROPERTY

The SET PROPERTY command 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]

Example:

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

/msg ChanServ SET #meat PROPERTY VEGETABLES

PUBACL

The SET PUBACL command allows the channel access list to be publicly visible.

Syntax:

SET <#channel> PUBACL ON|OFF

Example:

/msg ChanServ SET #foo PUBACL ON

RESTRICTED

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

Syntax:

SET <#channel> RESTRICTED ON|OFF

Example:

/msg ChanServ SET #snoop RESTRICTED ON

SECURE

The SET SECURE command prevents anyone not on the channel's access lists from gaining operator or halfop status on the channel. This is useful if you're cautious about unauthorized access.

Syntax:

SET <#channel> SECURE ON|OFF

Example:

/msg ChanServ SET #foo SECURE ON

TOPICLOCK

The SET TOPICLOCK command causes ChanServ to revert topic changes by users without the +t flag. Topic changes during netsplits or service outages will always be reverted. TOPICLOCK requires KEEPTOPIC and will automatically enable it. Disabling KEEPTOPIC will disable TOPICLOCK as well.

Syntax:

SET <#channel> TOPICLOCK ON|OFF

Example:

/msg ChanServ SET #foo TOPICLOCK ON

URL

The SET URL command allows you to change or set the URL associated with a channel. This URL will be shown to all users joining the channel.

Syntax:

SET <#channel> URL [url]

Example:

/msg ChanServ SET #foo URL http://example.com

VERBOSE

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

The SET VERBOSE OPS command 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

Example:

/msg ChanServ SET #foo VERBOSE ON