ChanServ

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
SET	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 | private op info

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

/msg ChanServ AKICK #foo DEL bar

/msg ChanServ AKICK #foo LIST

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.

The special permission +* grants all permissions except +b and +F, while -* 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

OWNER|DEOWNER

These commands perform status mode changes on a channel. If the action is performed on another user, they will be notified of the operation.

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

Syntax:

OWNER|DEOWNER <#channel> [nickname]

Examples:

/msg ChanServ OWNER #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