OPEN
(US) Welcome to Xtris » You first!
A A You're here: home 
doc services user chanserv commands
User ChanServ Commands
What is ChanServ?
ChanServ is a channel service bot, intended primarily to prevent and defend against channel takeovers. It also includes convenience features aimed at making it easier to maintain control over all aspects of your channel.
ACCESS LEVELS
User access levels on ChanServ's channel user-lists range from level 0 up to 500 (channel owner) as presented below:
| 0 - 99 | User | |
| 100 - 199 | Voice | |
| 200 - 299 | Op | |
| 300 - 399 | Master | |
| 400 - 499 | CoOwner | |
| 500 | Channel Owner |
See Also: adduser, deluser
ACCESS
/cs ACCESS <#channel> [<nick|*account>]
Reports various pieces of information about a channel user, including channel and network access level, and the user's info line. If no nick or account is provided, ChanServ returns your own information.
See Also: myaccess, users
ADDBAN
/cs ADDBAN <#channel> <mask|nick> [Reason]
Adds a ban to the channels permanent ban list, remaining in effect until removed with the DELBAN command. If it exactly matches an existing ban already in the list, the reason will be updated. If the existing ban was a timed ban, it will be extended into a permanent ban.
See Also: bans, delban, mdelban
ADDUSER
/cs ADDUSER <#channel> <nick|*account> <level>
This command adds someone to the channel user list with the specified access level. (You may only add users to levels less than your own.)
The level may be one of peon, op, master, coowner, owner, or a number between 1 and 500. Only network staff may add level 500 users (owners).
See Also: access levels, deluser, users
ADDTIMEDBAN
/cs ADDTIMEDBAN <#channel> <mask|nick> <Duration> [Reason]
Adds an automatically expiring ban to the channel ban list. This command behaves in the exact same fashion as ADDBAN with the exception that the bans are automatically removed after the user-supplied duration. If it exactly matches an existing ban already in the list, the reason will be updated. If the existing ban was a timed ban, it will be extended. Timed bans can be removed with the DELBAN command, as with permanent bans.
See Also: addban, bans, delban, durations
BAN
/cs BAN <#channel> <mask|nick>
This command will temporarily add a ban for the user specified as the parameter. Masks are to be supplied in the format <nick>!<Ident>@<Host> and usually contain wildcards. If a nick is specified, a mask is automatically generated (though not completely foolproof). This ban is removed either by removing it from the channel ban list using any irc client, or sending the UNBAN or UNBANALL commands. If you are banned with this method, the UNBANME
command can be used.
For assistance, please join #support
Example: *!*serv@*.xtris.net would ban anyone with ident 'serv' and a xtris.net hostname from joining the channel.
See Also: unban, unbanall, unbanme
BANS
/cs BANS <#channel>
This command lists all permanent and timed bans in the channel.
If a nickname is specified, lists any bans that visibly match that user.
If a hostmask with no wildcards is specified, lists any bans that match that hostmask.
If a hostmask with wildcards is specified, lists any bans included in that mask.
See Also: addban, delban, mdelban
CLIST
/cs CLIST <#channel> [mask]
This command lists all users of level Coowner on a channel's userlist. If a mask is supplied, only coowners matching the mask will be shown.
See Also: addcoowner, delcoowner, mdelcoowner, users
CLVL
/cs CLVL <#channel> <nick|*account> <level>
Modifies a channel user's access level. You cannot give users access greater than or equal to your own.
You may use *Account instead of Nick as the name argument; the * makes ChanServ use the name of a account directly (useful if the user is not online).
See Also: access, users, giveownership
GIVEOWNERSHIP
/cs GIVEOWNERSHIP <#channel> <nick|*account>
Transfer ownership of the channel from you to another user on the channel's userlist. You are demoted to co-owner, and he or she is promoted to owner.
You may use *Account instead of Nick as the name argument; the * makes ChanServ use the name of a account directly (useful if the user is not online).
See Also: clvl, access, users
DELBAN
/cs DELBAN <#channel> <mask|nick>
Deletes a ban from the channel ban list. This command works for both permanent and timed bans alike.
See Also: addban, addtimedban, bans
DELNOTE
/cs DELNOTE <#channel> <note-name>
Deletes a note from the channel. To do this, you must be able to set the note.
See Also: note, note types
DELUSER
/cs DELUSER <#channel> <nick|*account>
Deletes a user from the channel user list.
You may use *Account instead of Nick as the name argument; the * makes ChanServ use the name of a account directly (useful if the user is not online).
See Also: access levels, adduser, deleteme, users
DELETEME
/cs DELETEME <#channel> [<secret>]
If you have less than owner access in a channel, deleteme removes your access from the channel. If you do this by mistake, you must find a higher-ranked user to re-add you.
The secret value changes for each channel and each user. If you do not include the secret value, ChanServ will tell you what it should be.
See Also: adduser, deluser, giveownership, users
DEOP
/cs DEOP <#channel> <nick> [nick]...
Deops the specified user[s].
See Also: down, op
DEVOICE
/cs DEVOICE <#channel> <nick> [nick]...
This command will make ChanServ devoice the selected user[s].
See Also: addpeon, delpeon, deop, voice
DOWN
/cs DOWN <#channel>
This command will devoice/deop you in the selected channel.
See Also: downall, up, upall
DOWNALL
/cs DOWNALL
Executes the down command for each channel you have access to.
See Also: down, up, upall
DURATIONS
[<n>y][<n>M][<n>w][<n>d][<n>h][<n>m][<n>[s]]
There is a standard syntax for durations that let you easily specify longer periods of time. A duration consists of one or more "duration parts", which are sequences of digits, separated by duration letters.
The valid duration letters are y (for year, or 365 days), M (for month, or 31 days), w (for week, or 7 days), d (for day, or 24 hours), h (for hour, or 60 minutes), m (for minute, or 60 seconds), and s (for second). We know not all years are 365 days and not all months are 31 days, but we pretend they are for parsing durations.
If the last duration part does not have any letter to indicate the units, seconds are assumed.
Examples: 1y1M is 365 days plus 31 days; 1y1m is 365 days plus 1 minute; 1h30m45 is ninety minutes and forty-five seconds; and so forth.
EVENTS
/cs EVENTS <#channel> [limit [pattern]]
Allows channel coowners to view a list of events related to their channel. If a pattern is provided, only events with a matching description will be displayed.
Note: You must specify a limit if you want to use a pattern to match against.
See Also: last
HELPERS
/cs HELPERS
Lists all the helpers currently online. Nicknames enclosed in parentheses are away, and likely unavailable.
See Also: staff
INFO
/cs INFO <#channel>
This command responds with various pieces of information about a channel's users, status, and registration.
INVITEME
/cs INVITEME <#channel>
Invites you into the channel.
IRCOPS
/cs IRCOPS
Lists all the IRC operators currently online. Nicknames enclosed in parentheses are away, and likely unavailable.
See Also: staff
KICK
/cs KICK <#channel> <mask|nick> [reason]
Kicks the users matching the given nick or mask with the specified reason. If no reason is provided, a default will be used.
See Also: kickban
KICKBAN
/cs KICKBAN <#channel> <mask|nick> [reason]
Kicks and bans with the specified reason any users with a matching nick or hostmask. If no reason is provided, a default one will be used.
See Also: addban, kick
MDELCOOWNER
/cs MDELCOOWNER <#channel> <pattern>
Deletes all coowners with accounts matching the given pattern from the channel user list.
See Also: clist, delcoowner
MDELMASTER
/cs MDELMASTER <#channel> <pattern>
Deletes all masters with accounts matching the given pattern from the channel user list.
See Also: mdelban, mdelcoowner, mdelop, mdelowner, mdelpeon
MDELOP
/cs MDELOP <#channel> <pattern>
Deletes all ops with accounts matching the given pattern from the channel user list.
MDELOWNER
/cs MDELOWNER <#channel> <pattern>
Deletes all owners with accounts matching the given pattern from the channel user list.
See Also: addowner, mdelcoowner, mdelmaster, mdelop, mdelpeon
MDELPEON
/cs MDELPEON <#channel> <pattern>
Deletes all peons with accounts matching the given pattern from the channel user list.
See Also: addpeon, mdelcoowner, mdelmaster, mdelop
MLIST
/cs MLIST <#channel> [mask]
This command lists all users of level Master on a channel's userlist. If a mask is supplied, only masters matching the mask will be shown.
See Also: addmaster, delmaster, mdelmaster, users
MODE
/cs MODE <#channel>
Resets the modes in the channel to their default.
See Also: open, set
MYACCESS
/cs MYACCESS [<nick|*account>]
Lists channels where you have access and infolines in each.
Network staff may specify a nickname or *account to view the list for another user.
Your access level in the channel may be followed by a comma and one of the following characters:
s Your access in the channel has been suspended.
o AutoOp is active.
v AutoVoice is active.
i AutoInvite is active.
See Also: access, users
NETINFO
/cs NETINFO
Displays some assorted pieces of information about network-wide ChanServ statistics.
See Also: info, staff
NOTE
/cs NOTE <#channel> [<type> [new-note-text]]
With no arguments, lists all visible notes on the specified channel.
With one argument, lists the note type you name (if it is visible to you).
With two arguments, sets the note type (if you can set it).
See Also: delnote, note types
NOTE TYPES
Note Type Visibility Max Length
Forums all 130
Purpose unknown 250
Staff unknown 400
Staff2 unknown 400
Website all 130
See Also: note, delnote
OLIST
/cs OLIST <#channel> [mask]
This command lists all users of level Op on a channel's userlist. If a mask is supplied, only ops matching the mask will be shown.
See Also: addop, delop, mdelop, users
OP
/cs OP <#channel> <nick> [nick]...
This command makes ChanServ op the specified user.
See Also: addop, delop, deop
OPEN
/cs OPEN <#channel>
This command will make ChanServ remove all modes preventing a user from the specified channel, and remove all bans matching the users hostmask.
See Also: unbanme
PEEK
/cs PEEK <#channel>
Displays the current topic, modes, and ops of the specified channel. Unlike info, peek displays channel information unrelated to ChanServ.
See Also: info
PLIST
/cs PLIST <#channel>
This command lists all users of level Peon on a channel's userlist. If a mask is supplied, only peons matching the mask will be shown.
See Also: addpeon, delpeon, mdelpeon, users
RESYNC
/cs RESYNC <#channel>
Synchronizes users in the channel with the userlist. This means that if the user can normally get ops, ChanServ makes sure the user has ops. Otherwise, if the user normally gets voice, ChanServ makes sure the user has voice but not ops. Otherwise, ChanServ makes sure the user has neither voice nor ops.
SEEN
/cs SEEN <#channel> <account>
This command will tell you if the selected user is in the channel, or when was the last time the user was seen in the channel.
See Also: access, users
SET
/cs SET <#channel> [<parameter> [setting]]
This command will set various channel options. With no arguments, it will show the current values of all channel options.
DEFAULTTOPIC: The channel's default topic.
TOPICMASK: A pattern that topics must match.
GREETING: A greeting message for visitors to the channel.
USERGREETING: A greeting message for users on the channel's userlist.
MODES: The channel's default modes.
PUBCMD: Restrictions to use commands in public.
INVITEME: Minimum level for users to use INVITEME or AUTOINVITE.
USERINFO: Minimum level for users to show an infoline on join.
GIVEVOICE: The users that ChanServ will autovoice.
GIVEOPS: The users that ChanServ will autoop.
ENFOPS: Restrictions for opping users.
ENFMODES: Restrictions to change the default modes.
ENFTOPIC: Restrictions on changing the topic.
TOPICSNARF: Topics set manually (by /TOPIC #channel ...) by users this level and above change the default ChanServ topic.
SETTERS: Who may change channel settings (using SET).
CTCPUSERS: Who is allowed to send CTCPs to the channel.
CTCPREACTION: What happens when a disallowed CTCP is sent to the channel.
PROTECT: The protection level ChanServ provides.
TOYS: Toggles how ChanServ will respond to toy commands (!8ball etc).
TOPICREFRESH: Controls if (and how often) ChanServ will reset the topic.
DYNLIMIT: Adjusts user limit (+l channel mode) to prevent join floods.
IRCOP ONLY:
NODELETE: Prevents channel deletion.
UNREVIEWED: Indicates channels that have not been manually reviewed.
If you wish to reset your channel to the default settings, you can use the SET DEFAULTS command.
See Also: set pubcmd, set giveops, set enfops, set enfmodes, set enftopic, set protect, set toys, set setters, set topicrefresh, set ctcpusers, set ctcpreaction, set defaults
SET DEFAULTTOPIC
/cs SET <#channel> DEFAULTTOPIC <New default topic>
This changes the default topic for the channel. ChanServ will set the IRC topic to this value when the topic command is used with no arguments, when the topic refresh happens (if you have set topicrefresh), or when an unauthorized user changes the topic to something else.
See Also: set, set topicrefresh, set enftopic, set topicmask
SET TOPICMASK
/cs SET <#channel> TOPICMASK <Topic mask with * and ?>
This sets a pattern that ChanServ allows for the topic. A * will match any number of characters (including 0); a ? will match any single character -- the same as with IRC hostmasks. A user may set a topic if either topicmask or enftopic allow it.
For example, !set topicmask Hello * allows anyone to set the topic to be Hello world, but they must be able to override the topic (according to the EnfTopic setting) to set the topic to Goodbye world.
You may "escape" those characters by putting a \ before them in the topic mask; for example, !set topicmask Whassup\? would only allow the topic to be Whassup?, while leaving out the \ would allow the topic to be Whassup! (among other things).
For ease of use, if the TopicMask has only one * and no ?, then using !topic something will (if something does not match the TopicMask and you cannot override the topic lock) replace the * with the text something. If there is more than one * or any ? at all, !topic something will not work like that.
See Also: set, set topic, set enftopic
SET TOYS
/cs SET <#channel> TOYS <value>
This setting changes how ChanServ will respond to commands like !8ball, or whether it responds at all. Valid settings are:
0 Toys are completely disabled.
1 Toys will only reply privately.
2 Toys will reply publicly.
See Also: set
SET PUBCMD
/cs SET <#channel> PUBCMD <value>
This setting restricts the access necessary to use in-channel commands. It is a numeric user level, or 501 to mean no one may use public commands.
See Also: set
SET ENFOPS
/cs SET <#channel> ENFOPS <value>
This setting restricts who may op users who are not at least ops on the userlist. If ChanServ sees someone with access below the specified access op someone not on the userlist (or who is a peon), it will deop the second user. It is a numeric user level, or 501 to mean no one may op unrecognized users.
See Also: set
SET GIVEOPS
/cs SET <#channel> GIVEOPS <value>
This setting restricts the minimum access someone must be to be automatically op'ed by ChanServ. It is a numeric user level.
See Also: set
SET ENFMODES
/cs SET <#channel> ENFMODES <value>
This setting restricts the minimum access someone must have to change the channel modes from what is specified in the channel settings. It is a numeric user level, or 501 to mean no one may override the default modes.
See Also: set
SET ENFTOPIC
/cs SET <#channel> ENFTOPIC <value>
This setting restricts the minimum access someone must have to change the channel topic. It is a numeric user level, or 501 to mean no one may override the default topic.
If a topic mask is set, then a person may change the topic as long as it matches that mask or they have the above access.
If no topic mask is set, then a person must have the above access to change the topic from the default.
See Also: set, set topic, set topicmask
SET PROTECT
/cs SET <#channel> PROTECT <value>
This setting restricts the protection that ChanServ enforces. Valid settings are:
0 Non-users and users will be protected from those of equal or lower access
1 Users will be protected from those of equal or lower access.
2 Users will be protected from those of lower access.
3 No users will be protected.
See Also: set
SET SETTERS
/cs SET <#channel> SETTERS <value>
Users with at least this user level can use the set command for ChanServ.
See Also: set
SET TOPICREFRESH
/cs SET <#channel> TOPICREFRESH <value>
This setting controls if (and how often) ChanServ refreshes the topic to the default value. Valid settings are:
0 Never refresh topic.
1 Refresh every 3 hours.
2 Refresh every 6 hours.
3 Refresh every 12 hours.
4 Refresh every 24 hours.
See Also: set, set topic
SET CTCPUSERS
/cs SET <#channel> CTCPUSERS <value>
This setting controls who is allowed to send CTCPs to the channel. CTCP ACTION, the way that /me is implemented, are always allowed. For any other CTCP, the user must have this access level. 501 indicates no users may use CTCPs in the channel.
If a user below the specified level sends a CTCP (besides ACTION) to the channel, the enforcement is specified by the CTCPReaction setting.
See Also: set, set ctcpreaction
SET CTCPREACTION
/cs SET <#channel> CTCPREACTION <value>
This setting controls what happens to those who send disallowed CTCPs to the channel:
0 Kick on disallowed CTCPs.
1 Kickban on disallowed CTCPs.
2 Short timed ban (defaults to 3 minutes) on disallowed CTCPs.
3 Long timed ban (defaults to 1 hour) on disallowed CTCPs.
See Also: set, set ctcpusers
SET DEFAULTS
/cs SET <#channel> DEFAULTS [<confirmation>]
With the proper confirmation string, resets all the options for the channel to their default values.
With no confirmation string, displays the appropriate confirmation string.
See Also: set
STAFF
/cs STAFF
Lists all the IRC operators and helpers currently online. Nicknames enclosed in parentheses are away, and likely unavailable.
See Also: helpers, ircops, netinfo
SUSPEND
/cs SUSPEND <#channel> <nick|*account>
This disables the target's access to the channel. That access can be restored using the unsuspend command.
See Also: unsuspend, deluser
TOPIC
/cs TOPIC <#channel> [topic]
Sets the current topic for the specified channel. If no topic is specified, then set the current topic to the default topic.
TRIM
/cs TRIM <#channel> <target> <duration> [vacation]
The trim command removes target objects inactive for more than a certain duration from a channel. The target must be a channel access level, a range of access levels (for example, "300-399"), "users" or "bans". The duration argument specifies the amount of time the target has been inactive for to be removed.
If the vacation argument is given for the users target, users who are on vacation will be trimmed. By default they are skipped.
See Also: durations
UNBAN
/cs UNBAN <#channel> <mask|nick>
Unbans the specified nick or hostmask. If a nick is given, ChanServ determines what hostmask(s) to unban.
See Also: ban, kick, kickban
UNBANALL
/cs UNBANALL <#channel>
Clears the specified channel's banlist. If the channel is omitted, then unbanall will be done in the channel where the command was given.
See Also: ban, unban, unbanme
UNBANME
/cs UNBANME <#channel>
Unbans your hostmask from the specified channel.
See Also: ban, unban
UNREGISTER
/cs UNREGISTER <#channel> [<confirmation>]
Unregisters a channel that is registered with ChanServ. IMPORTANT: Once the channel is unregistered, the userlist cannot be recovered.
If you are not network staff, you must add a confirmation string to the end of your line to confirm the unregistration. If you leave it out, ChanServ will show the proper confirmation string.
See Also: register
UNSUSPEND
/cs UNSUSPEND <#channel> <nick|*account>
This restores the target's access to the channel (after it has been suspended).
See Also: suspend, deluser
UP
/cs UP <#channel>
Grants you your normal channel privileges. If your access in the channel is less than the GiveVoice setting, this does nothing. Otherwise, if your access is less than the GiveOps setting, ChanServ will give you voice. If your access is at least GiveOps, ChanServ will give you ops.
UPALL
/cs UPALL
Executes the up command for each channel you have access in.
See Also: up, down, downall
USET
/cs USET <#channel> [<option> [<setting>]]
The uset command allows you to toggle various channel user settings. With no arguments, it will print the current values of all channel user options.
Options:
INFO: Sets the infoline that ChanServ sends when you join the channel.
NOAUTOOP: Enable or disable ChanServ automatically opping you upon joining or authenticating.
AUTOINVITE: ChanServ will invite you to this channel if you have access to and are not in when you authenticate if this setting is on.
NOTE: The NoAutoOp setting is equivalent to the !togop command in previous versions.
See Also: set
USET INFO
/cs USET <#channel> INFO <info>
This command will set a user defined information message to be displayed when you join the channel. By setting the message to '*', you will clear your message.
See Also: access
USERS
/cs USERS <#channel> [mask]
Displays the userlist for the specified channel. If a mask is supplied, only users matching the mask will be shown.
See Also: clist, mlist, olist, plist, wlist
VOICE
/cs VOICE <#channel> <nick> [nick]...
Voices the specified nick in the specified channel. If the channel is omitted, then voice will be done in the channel where the command was given.
See Also: devoice
WIPEINFO
/cs WIPEINFO <#channel> <nick|*account>
Removes the named user's infoline in the channel.
WLIST
/cs WLIST <#channel> [mask]
This command lists all users of level Owner on a channel's userlist. If a mask is supplied, only owners matching the mask will be shown.
See Also: addcoowner, delcoowner, mdelcoowner, users
The third-rate mind is only happy when it is thinking with the majority. The second-rate mind is only happy when it is thinking with the minority. The first-rate mind is only happy when it is thinking. -- A. A. Milne