Xertion Wiki - User contributions [en]

Xertion:About

2015-05-27T17:59:55Z

White Wolf: Xertion about page, copy pasted to help give a dead link life

Xertion was established in February of 2011 with aspirations of becoming a network able to provide the ultimate experience for our worldwide consortium of clients. Ever since the beginning, Xertion had amazing potential and the staff have all contributed to the creation of the network in a vast amount of ways; something that is greatly enjoyed by our clients.

Although there are many other highly used networks, they don't provide the expertise, protection, connection speeds, reliability, and stability that Xertion provides everyday.

We urge users to use their own IRC clients to connect to our network, however if you don't wish to install a client on your system, an ajax coded version is available on our website which will connect you to our network at the click of a button.

We pride ourselves in the quality of services we provide for our community and aim to keep the network operating at its full potential with constant updates to our servers and security, this enables a seamless connection to Xertion and a secure environment for our clients.

ChanServ

2015-05-27T17:55:58Z

White Wolf: /* Set */ More anope password references...

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who have owner level access to the channel can drop it, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder access (level 9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a), and level 9999 grants channel owner (+q). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

Channel management

2015-05-27T17:44:18Z

White Wolf: /* Owner Mode and Protect Mode */ Page no longer needed (Anope2.0 update)

== Types of Commands ==

* '''Fantasy commands''' are commands initiated with a period. "."
* Commands in this guide will be given in both the <code>/msg</code> format, and the fantasy command format.

Okay, so most things related to channel management are controlled via [[ChanServ]], part of Anope IRC services, the system we use on Xertion.

Commands to [[ChanServ]] can be given in a number of ways:
* Messages: <code>/msg ChanServ [command] [variable]</code>
* Fantasy: <code>.[command] [variable]</code>

==Managing Channel Access==
===Adding Access===
====Access Levels====
Administrators and operators are an important part of a channel. You've probably seen them around, with the '''&''' (Admin) or '''@''' (Op) in front of their name on some of our larger channels. Now, how do you assign them?
* <code>/msg ChanServ ACCESS #moo ADD Elchzard level
* .access add Elchzard level</code>

<pre>Level = A number between 3 and 9999 inclusive.
Level 3 -- Gives user voice (+).
Level 4 -- Gives user half-operator (%) status.
Levels 5 - 9 -- Gives user operator (@) status.
Levels 10 - 9998 -- Gives user administrator (&) status.
Level 9999 -- Gives user co-founder (~) status.</pre>

For fantasy commands using .access, there is also a shortcut available - <code>.axx</code>

So one of the access commands would be -- <code>.axx add Elchzard level</code>

====xOP====
If you're confused by access levels, xOP might be easier for you. Rather than using 9996 different levels, there are four:

{{Note|Turning xOP ON will no longer allow usage of the access levels system.}}

* SOP - SuperOP -- Equivalent to admin status, &, or levels 10-9998
* AOP - AutoOP -- Equivalent to operator status, @, or levels 5-9.
* HOP - HalfOP -- Equivalent to half-op status, %, or level 4.
* VOP - VOicePerson -- Equivalent to voice, +, or level 3.

To turn on the xOP system, you need to use one ChanServ command, and then you're good to go with assigning your operators.
* Turn on XOP -- <code>/msg ChanServ SET #moo XOP on</code>
* Assign SOPs -- <code>/msg ChanServ SOP #moo add Elchzard</code>
* Assign AOPs -- <code>/msg ChanServ AOP #moo add Elchzard</code>
* Assign HOPs -- <code>/msg ChanServ HOP #moo add Elchzard</code>
* Assign VOPs -- <code>/msg ChanServ VOP #moo add Elchzard</code>

Or using fantasy commands...
* Turn on XOP -- <code>.set xop on</code>
* Assign SOPs -- <code>.sop add Elchzard</code>
* Assign AOPs -- <code>.aop add Elchzard</code>
* Assign HOPs -- <code>.hop add Elchzard</code>
* Assign VOPs -- <code>.vop add Elchzard</code>

===Removing Access===
If ever the sad time comes when you need to remove a user's status on a channel, then it's equally as simple as giving the person ops in the first place. Also, if you want to change from xOP back to the normal access list system, it's simple.
* <code>/msg ChanServ ACCESS #moo DEL Sakura`Kinomoto</code> -- This will remove a users access on a channel.
* <code>/msg ChanServ ''X''OP #moo DEL Sakura`Kinomoto</code> -- Replace "X" with S, A, H or V to reflect the users current position - This command will then remove a users access on a channel when using the xOP system.
* <code>/msg ChanServ SET #moo XOP off</code> -- Will move you from xOP back to the normal access list system.

Alternatively, use our good old friends fantasy commands...
* <code>.access del Sakura`Kinomoto</code> -- This will remove a users access on a channel.
* <code>.XOP del Sakura`Kinomoto</code> -- Replace "X" with S, A, H or V to reflect the users current position - This command will then remove a users access on a channel when using the xOP system.
* <code>.set XOP off</code> -- Will move you from xOP back to the normal access list system.

==Channel Modes==
To enable a mode, simply type this...
* <code>/mode #moo +''Mode letter''</code>
Or, to remove a mode...
* <code>/mode #moo -''Mode letter''</code>

So, now, some commonly used modes:
* Block all messages containing colour codes - +c
* Strip colour, bold, italics, underline (making them appear as plain text) - +S
* Makes a channel secret, hiding it from the "/list" command - +s
* Adds a channel password - +k cows (The channel password is now cows).
* Make a channel invite only. (Must be invited to enter) - +i
* Set a user-limit for your channel - +l 500 (That's a lower case "L").
* Moderate a channel - i.e, set it so only users with voice (+) and above can speak - +m
* Block messages containing over 50% capitals, when they're longer than 5 characters - +B

==Banning==
Banning a user from a channel basically means they can't join it and talk there. You can ban a user with a certain nick, hostmask or ident from the channel.
* To ban a user's hostmask, (the most effective way) - <code>/mode #moo +b *!*@xertion-moo.moomoo-moo</code>
* To ban a user's nick - <code>/mode #moo +b MooMooGirl!*@*</code>
* To ban a user's ident - <code>/mode #moo +b *!Moo@*</code>

Or, with fantasy commands -
* For a hostmask - <code>.ban *!*@xertion-moo.moomoo-moo</code>
* For a nick - <code>.ban MooMooGirl!*@*</code>
* For an ident - <code>.ban *!Moo@*</code>

===Extended Bans===
Is that guy just changing his nick that '''''bit''''' too much? Is the dude there talking too often for your liking? Well, that's all solvable too!
Extended bans allow you to control a user's actions within your channel very finely.
Bear in mind, though, that most of these bans don't work on users with voice, or above.
* Mutes, or m: bans - Prevent a user from talking in the channel.
* No nick-changes, or N: bans - Prevent a user from changing their nick.
* Caps-bans, or B: bans - Prevent a specific user from using more than 50% caps in messages over 5 characters.
* Kick-block, or Q: bans - Prevent a specific user from making kicks (DOES work on hops and ops).
* Colour-strips, or S: bans - Strips colour from a specific user's messages.
* Colour-blocks, or c: bans - Prevents a user from sending messages containing mIRC colour codes.

So, how do you implement these?

The simplest for most of these is to grab the users hostmask, and then type this:
<pre>/mode #moo +b N:*!*@xertion-moo.moomoo-moo</pre>

Obviously, you have to change the example to the correct values for your purpose.

So essentially, you use the method above for a classic ban, and add a colon, preceded by the letter of the extban you want to use at the front of the identifier for the user.

Bear in mind that these extended bans don't work with the ".ban" fantasy command.

Mute, however, does have its own fantasy command - <code>.mute MooCow</code>

==Miscellaneous==
* <code>/whois MooCow</code> - Will give you general information about a user, as well as their '''hostmask''', which you can take from the whois data, for easy use in a ban or extended ban.
* <code>/list</code> - Will give you a list of all the network's channels that don't have +s or +p active.

See also: [[Channel Modes]], [[ChanServ]], [[Channel Management (cont.)]]

[[Category:Tutorials]]
[[Category:Services]]
[[Category:Commands]]

ChanServ

2015-05-27T13:51:30Z

White Wolf: /* Owner */ Noticed grammatical error

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a), and level 9999 grants channel owner (+q). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ:Register

2015-05-27T13:42:44Z

White Wolf: /* Registering your channel */ Channels no longer need passwords under Anope2.

'''BEFORE proceeding, please make sure you are registered and identified with NickServ! See [[NickServ:Register|Register your nickname]] for more info.'''

===Registering your channel===
In order to register a channel on Xertion, you must meet all of the following conditions:
* You must be registered with and identified to NickServ.
* You must have channel operator or above in the desired channel - you will be given channel operator status automatically if you join an empty, unregistered channel.
** '''NOTE:''' If the channel has people idling in it, and the channel is NOT registered, you may only register it if NONE of the people in it have operator status. If this is the case then <code>/join #help</code> for assistance.
* The channel must be unregistered - to check this, issue the command <code>/msg ChanServ info #channel</code>, replacing <code>#channel</code> with the channel you wish to check.

If you meet all these conditions, then you may register the channel using the command <code>/msg ChanServ REGISTER #channel description</code>.
* <code>#channel</code> - the name of the channel you wish to register
* <code>description</code> - a short description of your channel's purpose. This is not the channel's topic. The description you specify here will be seen when anyone uses the INFO command to view your channel's information, and can be changed at a later time.

===Post-registration===
Congratulations, your channel is now registered! You may now wish to review [[Channel_Management|Channel Management]] to see what you can do with your channel.

====BotServ====
You may also wish to request a BotServ bot sit in your channel. Type <code>/msg BotServ BOTLIST</code> to see which bots are available for assignment.

Then, once you have found a bot nick you like, assign it using the command <code>/msg BotServ assign #channel botnick</code>, where <code>#channel</code> is your channel name and <code>botnick</code> is the bot nickname you wish to assign.

[[Category:Tutorials]]

ChanServ

2015-05-27T13:40:56Z

White Wolf: /* Autovoice */ AutoVoice has been removed in anope2.0

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a), and level 9999 grants channel owner (+q). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:38:50Z

White Wolf: /* Adding */ Removed referance to ownermode since it is no longer important under anope2.0

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a), and level 9999 grants channel owner (+q). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:37:31Z

White Wolf: /* Adding */ Removed protectmode as well, missed it in initial edits

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a), and level 9999 grants channel owner (+q). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:36:36Z

White Wolf: /* Adding */ Removed referance to ownermode since it is no longer important under anope2.0

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:35:32Z

White Wolf: /* Set */ Added referance to SecureFounder to the Founder command, kept passwords out of it

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is available to the current channel founder, unless SECUREFOUNDER is set to OFF.
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:31:03Z

White Wolf: /* Set */ Edited more password references, this one is minor

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is always restricted to the official founder
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who are co-founder level (9999) on the channel
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:28:37Z

White Wolf: Removed more invalid commands and password references due to the anope 2 upgrade

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** description - a short description of the channel's purpose.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is always restricted to the official founder
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who simply identify to ChanServ.
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-27T13:24:13Z

White Wolf: /* Set */

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel password description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** password - a password to use with the channel. This password will be used to give others almost-complete founder access, so make sure it's a good password.
** description - a short description of the channel's purpose.

=== Identify ===

The IDENTIFY command identifies you to ChanServ, which will grant you almost-complete founder access to the channel.

* '''Syntax:''' <code>/msg ChanServ IDENTIFY #channel password</code>
** #channel - the name of the channel you want to identify to.
** password - the password for the channel.
*** NOTE: While this command identifies you as a founder of the channel, several ChanServ commands will still be unavailable to you if the channel has the SECUREFOUNDER option set.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is always restricted to the official founder
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who simply identify to ChanServ.
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ:Autokick

2015-05-09T16:33:35Z

White Wolf: Auto Kick

== <div class="moduleheader">Description</div> ==
Maintains the AutoKick list for a channel. If a user on the AutoKick list attempts to join the channel, ChanServ will ban that user from the channel, then kick
the user.

== <div class="moduleheader">Commands</div> ==
;AKICK channel ADD {nick | mask} [reason]
:The AKICK ADD command adds the given nick or usermask to the AutoKick list. If a reason is given with the command, that reason will be used when the user is kicked; if not, the default reason is "User has been banned from the channel". When akicking a registered nick the NickServ account will be added to the akick list instead of the mask. All users within that nickgroup will then be akicked.
;AKICK channel DEL {nick | mask | entry-num | list}
:The AKICK DEL command removes the given nick or mask from the AutoKick list. It does not, however, remove any bans placed by an AutoKick; those must be removed manually.
;AKICK channel LIST [mask | entry-num | list]
:The AKICK LIST command displays the AutoKick list, or optionally only those AutoKick entries which match the given mask.
;AKICK channel VIEW [mask | entry-num | list]
:The AKICK VIEW command is a more verbose version of the AKICK LIST command.
;AKICK channel ENFORCE
:The AKICK ENFORCE command causes ChanServ to enforce the current AKICK list by removing those users who match an AKICK mask.
;AKICK channel CLEAR
:The AKICK CLEAR command clears all entries of the akick list.
== <div class="moduleheader">Examples</div> ==
/msg ChanServ AKICK #myChannel ADD *Fred@*.example.com Idiot

/msg ChanServ AKICK #myChannel DEL *Fred@*.example.com

/msg ChanServ AKICK #myChannel LIST 1-12

/msg ChanServ AKICK #myChannel ENFORCE

/msg ChanServ AKICK #myChannel CLEAR

ChanServ

2015-05-09T16:31:12Z

White Wolf: /* Drop */

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel password description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** password - a password to use with the channel. This password will be used to give others almost-complete founder access, so make sure it's a good password.
** description - a short description of the channel's purpose.

=== Identify ===

The IDENTIFY command identifies you to ChanServ, which will grant you almost-complete founder access to the channel.

* '''Syntax:''' <code>/msg ChanServ IDENTIFY #channel password</code>
** #channel - the name of the channel you want to identify to.
** password - the password for the channel.
*** NOTE: While this command identifies you as a founder of the channel, several ChanServ commands will still be unavailable to you if the channel has the SECUREFOUNDER option set.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is always restricted to the official founder (e.g not for those who used ChanServ's IDENTIFY command).
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who simply identify to ChanServ.
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-09T16:29:29Z

White Wolf: /* Logout */

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel password description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** password - a password to use with the channel. This password will be used to give others almost-complete founder access, so make sure it's a good password.
** description - a short description of the channel's purpose.

=== Identify ===

The IDENTIFY command identifies you to ChanServ, which will grant you almost-complete founder access to the channel.

* '''Syntax:''' <code>/msg ChanServ IDENTIFY #channel password</code>
** #channel - the name of the channel you want to identify to.
** password - the password for the channel.
*** NOTE: While this command identifies you as a founder of the channel, several ChanServ commands will still be unavailable to you if the channel has the SECUREFOUNDER option set.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is always restricted to the official founder (e.g not for those who used ChanServ's IDENTIFY command).
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who simply identify to ChanServ.
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command. Otherwise, you must identify for the channel with ChanServ's IDENTIFY command first before you can drop it.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

ChanServ

2015-05-09T16:28:19Z

White Wolf: /* Set */

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below.

For more information on a specific command, type <code>/msg ChanServ HELP command</code>

=== Register ===

The REGISTER command registers a channel in the database. Registering a channel protects the channel's name and allows the owner to use a variety of Services functions to manage it.

* '''Syntax:''' <code>/msg ChanServ REGISTER #channel password description</code>
** #channel - the name of the channel you want to register. Be sure you take a look at [[ChanServ:Register|Channel Registration]] before using this command to make sure you can actually register one to begin with!
** password - a password to use with the channel. This password will be used to give others almost-complete founder access, so make sure it's a good password.
** description - a short description of the channel's purpose.

=== Identify ===

The IDENTIFY command identifies you to ChanServ, which will grant you almost-complete founder access to the channel.

* '''Syntax:''' <code>/msg ChanServ IDENTIFY #channel password</code>
** #channel - the name of the channel you want to identify to.
** password - the password for the channel.
*** NOTE: While this command identifies you as a founder of the channel, several ChanServ commands will still be unavailable to you if the channel has the SECUREFOUNDER option set.

=== Set ===

The SET command allows you to change various ChanServ settings for the channel. By default, this command is always restricted to the channel founder.

* '''Syntax:''' <code>/msg ChanServ SET #channel option parameter(s)</code>
** #channel - the name of the channel you wish to change options for.
** option parameter(s) - the specific setting you want to change along with its parameters. The available settings for option are as follows:
*** '''FOUNDER''' - change the channel's official founder. Give the new founder as the parameter to this option. This command is always restricted to the official founder (e.g not for those who used ChanServ's IDENTIFY command).
*** '''SUCCESSOR''' - change the channel's successor. Give the new successor as the parameter to this option. This nickname will become the channel's new founder automatically, if the founder's nickname is dropped or it expires while the channel is still registered. The successor nickname must be registered already.
**** NOTE: If the person you set as a channel's successor already has too many channels registered, and the founder nick is dropped or otherwise expires, then the channel will also be dropped, instead of transferred to the successor.
*** '''DESC''' - change the channel's description. Pass the new description in its entirety as the parameter for this option.
*** '''URL''' - associate a URL with the channel, which can be viewed with ChanServ's INFO command. Give the URL as the parameter for this option.
*** '''EMAIL''' - set an email address for the channel. Give the email address as the parameter with this option.
*** '''ENTRYMSG''' - defines an entry message shown to users who join the channel. This can be something like a notice to read the rules, a list of triggers for a channel with XDCC bots, or other things. The message you want to set is passed as the parameter with this option.
*** '''BANTYPE''' - change the user@host format that ChanServ uses to set bans on in a channel. This option takes a number between 0 and 3 as the parameter. See <code>/msg ChanServ help set bantype</code> to see the ban types you can set.
*** '''MLOCK''' - change the channel mode(s) that ChanServ will lock; that is, the channel modes you wish to always be set and/or always be unset. This command takes any valid channel mode (see [[Channel_Modes|Channel Modes]] for a list of valid modes). For further help with this command, check <code>/msg ChanServ help set mlock</code>.
*** '''KEEPTOPIC''' - toggle whether or not ChanServ will maintain the channel's topic if the channel becomes empty. Use either ON or OFF as the parameter - when ON, ChanServ will maintain the channel's last known topic when the channel becomes empty.
*** '''OPNOTICE''' - toggle whether or not ChanServ sends a notice to the channel whenever the OP or DEOP commands are used on someone. This is an ON/OFF toggle.
*** '''PEACE''' - toggles the 'peace' mode of a channel. When 'peace' is set ON, a user cannot kick, ban, or remove the channel status of another user who has a level superior or equal to them via ChanServ commands. This is an ON/OFF toggle.
*** '''PRIVATE''' - toggles whether or not the channel will show up in ChanServ's LIST command. This is an ON/OFF toggle.
*** '''RESTRICTED''' - Toggles 'restricted' mode. When the RESTRICTED option is set ON, any user who is not on the channel's access list will be automatically kicked and banned. This is an ON/OFF toggle.
*** '''SECURE''' - Enables or disables ChanServ's security features for a channel. With this option set ON, access to the channel (including applicable ChanServ commands) will only be granted to registered users who have identified to NickServ and are on the channel's access list. This is an ON/OFF toggle.
*** '''SECUREOPS''' - Change whether users not on the channel's access list can be given ops (+o) or not. If set to ON, then ChanServ will not allow any user to be set +o unless they are on the access list with the proper access level.
*** '''SECUREFOUNDER''' - Change whether users who identify to ChanServ for the channel with the channel's password can drop it, change its password, or change its founder and/or successor. If set to ON, then these functions will only be available to the channel's real founder and not those who simply identify to ChanServ.
*** '''SIGNKICK''' - Change whether or not kicks done with ChanServ's KICK command are signed with the nickname of the user who issued the command. If set to ON, all kicks done with ChanServ's KICK command will have the issuing user's nickname in the kick reason. If set to LEVEL, then users who have an access level superior or equal to the channel's current SIGNKICK level will not have their kicks signed.
*** '''TOPICLOCK''' - Allow/disallow channel topic changes outside of ChanServ. If this is set to ON, then topic changes will only be allowed with ChanServ's TOPIC command.
*** '''XOP''' - Enable/disable xOP access lists. When turned ON, you will need to use ChanServ's AOP/SOP/VOP commands to alter the access list. When turned OFF, you will need to use ChanServ's ACCESS command instead.
**** NOTE 1: When switching from the access list system to the xOP access system, all the level definitions and user levels will be changed. This means that if you should switch back to the access system, those values won't be the same as they were before!
**** NOTE 2: Be EXTREMELY careful when changing the access system from access lists to xOP. In some cases, some users may not end up on the correct xOP list or even at all. Matter of fact, it is '''highly discouraged''' to use the xOP system if you have changed any of the default level definitions on the channel with the LEVELS command, for this reason!

=== SOP/AOP/HOP/VOP commands ===

The various xOP commands manage user access levels. These commands are ONLY available if the XOP option is set ON, as detailed above. We HIGHLY recommend you not use these commands and stick with the access list system. As such, detailed help will not be provided on this page.

For detailed help on the various xOP commands, use these commands:
* <code>/msg ChanServ help VOP</code>
* <code>/msg ChanServ help HOP</code>
* <code>/msg ChanServ help AOP</code>
* <code>/msg ChanServ help SOP</code>

=== Access ===

The ACCESS command provides the means to grant/remove channel access for users.

==== Adding ====

The ACCESS ADD command adds someone to the channel's access list with a specific level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel ADD nickname level</code>
** #channel - the channel whose access list you want to modify.
** nickname - the nickname of the user who you want to add. The nickname must already be registered.
** level - the desired access level for the user. By default, level 3 is voice (+v), level 4 is halfop (+h), level 5 is chanop (+o), level 10 is channel admin (+a, if PROTECTMODE is enabled), and level 9999 grants channel owner (+q, if OWNERMODE is enabled). These pre-defined levels may be different for various channels.
*** NOTE 1: level must be LESS than your own current access level.
*** NOTE 2: If the given nickname is already on the access list, this command will change it to the level specified with the command, ONLY if the given nickname's current level is LESS than your own.

==== Removing ====

The ACCESS DEL command removes a user from the channel's access list entirely.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel DEL (nickname | entry-number | list)</code>
** #channel - the channel whose access list you want to modify.
** nickname | entry-number | list - the nickname of the user who you want to remove from the access list, the corresponding entry number for the user, or a list of access entries to remove by number.
*** NOTE: Again, you cannot alter another user's access level if yours is less than or equal to theirs.

==== Viewing ====

The ACCESS LIST command displays a list of users on the channel's access list with their level.

* '''Syntax:''' <code>/msg ChanServ ACCESS #channel LIST [mask | list]</code>
** #channel - the channel whose access list you want to view.
** [mask | list] - OPTIONAL: A wildcard mask to specify which entries to view, or a list of entry numbers to show. If none given, all entries will be shown.
*** NOTE: By default, you must be on the channel's access list to be able to use the ACCESS LIST command.

=== Levels ===

The LEVELS command allows channel founders to fine-tune the meanings of various access levels on the channel.

Full help on this command can be found by going to [[ChanServ:Levels|Levels]].

=== Autokick ===

The AKICK command manages the channel's autokick list; that is, the list of user@host masks to automatically kick and ban from the channel on sight.

Full help on this command can be found by going to [[ChanServ:Autokick|Autokick]].

=== Drop ===

The DROP command cancels the registration of a channel, deleting all settings related to it and removing it from the database.

* '''Syntax:''' <code>/msg ChanServ DROP #channel</code>
** #channel - the name of the channel to drop.
*** NOTE: If the channel has SECUREFOUNDER set, then you must be the REAL channel founder to be able to use this command. Otherwise, you must identify for the channel with ChanServ's IDENTIFY command first before you can drop it.

=== Ban ===

The BAN command bans a user from a channel. By default, this command is restricted to users with at least level 4 access on the channel.

* '''Syntax:''' <code>/msg ChanServ BAN [#channel] [nickname] [reason]</code>
** [#channel] - OPTIONAL: The channel to ban the user from. If neither this nor nickname is given, this command will ban you from all channels you have access to use BAN on.
** [nickname] - OPTIONAL: The nickname of the user to ban. If not given, you will be banned.
** [reason] - OPTIONAL: The reason for the ban.

=== Unban ===

The UNBAN command removes any bans matching a user from the channel.

* '''Syntax:''' <code>/msg ChanServ UNBAN #channel <em[nickname]</code>
** #channel - the channel to remove the ban from.
** [nickname] - the nickname to remove a ban or bans for. If not given, you will be unbanned.

=== Clear ===

The CLEAR command tells ChanServ to clear certain settings (or other things) on a channel.

* '''Syntax:''' <code>/msg ChanServ CLEAR #channel thing</code>
** #channel - the channel which you want to apply the command to.
** thing - the specific setting or thing you want to clear from the channel. Valid values are as follows:
*** '''MODES''' - Resets all non-status modes on the channel (such as +i/+k/+l/+m/+n/+p/+s/+t)
*** '''BANS''' - Removes all bans from the channel.
*** '''EXCEPTS''' - Removes all exceptions (+e) from the channel.
*** '''INVITES''' - Removes all invite-exceptions (+I) from the channel.
*** '''OPS''' - Removes +o (and +a and/or +q, if enabled) from all users.
*** '''HOPS''' - Removes +h (halfop) from all users.
*** '''VOICES''' - Removes +v (voice) from all users.
*** '''STATUS''' - Removes all +o, +h, +v, +a, and +q modes from all users.
*** '''USERS''' - Kicks all users out of the channel.
**** NOTE: By default, this command is limited to the channel founder.

=== Owner ===

The OWNER command sets channel mode +q on yourself.

* '''Syntax:''' <code>/msg ChanServ OWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to give yourself +q on, if it is enabled on the channel. If not given, this command will give you channel mode +q on all channels you have sufficient access on.
*** NOTE 1: This command has no effect on channels which don't have OWNERMODE enabled.
*** NOTE 2: By default, this command is limited to those with founder access on a channel.

=== Deowner ===

The DEOWNER command removes channel mode +q from yourself.

* '''Syntax:''' <code>/msg ChanServ DEOWNER [#channel]</code>
** [#channel] - OPTIONAL: The channel you wish to remove +q from yourself on. If not specified, removes +q from all channels you have sufficient access on.
*** NOTE: By default, this command is limited to those with founder access on a channel.

=== Protect ===

The PROTECT command sets channel mode +a on a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ PROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to set +a on a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will set +a on you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to set +a on in the given channel. If nickname is not given, it will set +a on you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Deprotect ===

The DEPROTECT command removes channel mode +a from a user, or yourself.

* '''Syntax:''' <code>/msg ChanServ DEPROTECT [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove +a from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove +a from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove +a from in the given channel. If nickname is not given, it will remove +a from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must be a channel founder to use this command on another user. Otherwise, you must have at least SOP or level 10 access and above to use this command on yourself.

=== Op ===

The OP command gives a user (or you) channel op (+o) on a channel.

* '''Syntax:''' <code>/msg ChanServ OP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to op (+o) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will op you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give ops to in the given channel. If nickname is not given, it will op you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Deop ===

The DEOP command removes channel op (+o) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove ops from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove ops from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove ops from in the given channel. If nickname is not given, it will remove ops from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command.

=== Halfop ===

The HALFOP command gives a user (or you) channel halfop (+h) on a channel.

* '''Syntax:''' <code>/msg ChanServ HALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to halfop (+h) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will halfop you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give halfop to in the given channel. If nickname is not given, it will halfop you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Dehalfop ===

The DEHALFOP command removes channel halfop (+h) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEHALFOP [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove halfop (+h) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove halfop from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove halfop from in the given channel. If nickname is not given, it will remove halfop from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least HOP or level 4 access and above to use this command on yourself.

=== Voice ===

The VOICE command gives a user (or you) channel voice (+v) on a channel.

* '''Syntax:''' <code>/msg ChanServ VOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to voice (+v) a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will voice you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to give voice to in the given channel. If nickname is not given, it will voice you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Devoice ===

The DEVOICE command removes channel voice (+v) from a user (or you) on a channel.

* '''Syntax:''' <code>/msg ChanServ DEVOICE [#channel [nickname]]</code>
** [#channel] - OPTIONAL: The channel you want to remove voice (+v) from a user in. This is REQUIRED if you wish to specify a specific user. Otherwise, if not specified, it will remove voice from you in all channels you have sufficient access in.
** [nickname] - OPTIONAL: The nickname you want to remove voice from in the given channel. If nickname is not given, it will remove voice from you in the given channel instead, provided you have sufficient access.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use this command on other users. Otherwise, you must have at least VOP or level 3 access and above to use this command on yourself.

=== Getkey ===

The GETKEY command shows the current key (password) for a channel, if one is set.

* '''Syntax:''' <code>/msg ChanServ GETKEY #channel</code>
** #channel - the channel whose key you wish to get.
*** NOTE 1: By default, this command is limited to those with HOP or level 4 access and above on the given channel.
*** NOTE 2: If the channel does not have a key set, this command will return "NO KEY".

=== Invite ===

The INVITE command tells ChanServ to invite you to the given channel.

* '''Syntax:''' <code>/msg ChanServ INVITE #channel</code>
** #channel - the channel you want to be invited to.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Kick ===

The KICK command kicks a user (or you) out of a given channel.

* '''Syntax:''' <code>/msg ChanServ KICK [#channel [nickname [reason]]]</code>
** [#channel] - OPTIONAL: The channel to kick from. If not given, you will be kicked from all channels you have the appropriate access on.
** [nickname] - OPTIONAL: The nickname you want to kick from the specified channel. If not given, you will be kicked from the given channel instead, provided you have sufficient access.
** [reason] - OPTIONAL: The reason to give for the kick. If not given, a default reason is used.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Logout ===

The LOGOUT command logs the given nickname out of a given channel, thereby removing their ChanServ access; the user will have to reidentify to regain that access.

* '''Syntax:''' <code>/msg ChanServ LOGOUT #channel nickname</code>
** #channel - the channel to log out of.
** nickname - the nickname to log out of the channel.
*** NOTE: If you are a channel founder, you can use this command on any nickname in the channel. Otherwise, you can only log yourself out.

=== Topic ===

The TOPIC command changes the topic of a given channel.

* '''Syntax:''' <code>/msg ChanServ TOPIC #channel [topic]</code>
** #channel - the channel to change the topic on.
** [topic] - OPTIONAL: The new topic to set. If not given, an empty topic is set.
*** NOTE: By default this command is limited to those with HOP or level 4 access and above on the given channel.

=== Info ===

The INFO command displays various pieces of information about a given channel.

* '''Syntax:''' <code>/msg ChanServ INFO #channel [ALL]</code>
** #channel - the channel whose info you want to view.
*** NOTE: By default, you must have at least AOP or level 5 access and above to use the ALL keyword for a channel.

=== Sync ===

The SYNC command synchronizes all users' status modes with the access they are entitled to in ChanServ for the given channel.

* '''Syntax:''' <code>/msg ChanServ SYNC #channel</code>
** #channel - the channel you want to synchronize the access list on.
*** NOTE: By default, this command is limited to SOP or level 10 access and above.

=== Acchistory ===

The ACCHISTORY command displays the last 30 changes to a channel's access list, with most recent changes listed first.

* '''Syntax:''' <code>/msg ChanServ ACCHISTORY #channel</code>
** #channel - the channel whose access history you want to view.
*** NOTE: By default, you must be on the access list, or if the xOP system is in use on a channel, you must have VOP or higher, to use this command.

=== Autovoice ===

The AUTOVOICE command enables or disables automatic voicing of users on a given channel.

* '''Syntax:''' <code>/msg ChanServ AUTOVOICE #channel (REG | ALL | STATUS | OFF)</code>
** #channel - the channel to change autovoice on.
** (REG | ALL | STATUS | OFF) - the mode to use. Specify REG to autovoice all registered users, specify ALL to autovoice all users, specify STATUS to autovoice users with VOP or access level 3 only, or specify OFF to completely disable autovoice.
*** NOTE: By default, you must have SOP or access level 10 and above to use this command.

=== Up / Down ===

The UP and DOWN commands are used to grant you your highest possible status in a channel or remove all status, respectively.

* '''Syntax:''' <code>/msg ChanServ UP #channel [nickname]</code>
* '''Syntax:''' <code>/msg ChanServ DOWN #channel [nickname]</code>
** #channel - the channel to apply the command to.
** [nickname] - OPTIONAL: The nickname to apply the command to. Only channel founders and Services Root Admins can specify this parameter.

[[Category:Commands]]
[[Category:Services]]

User:White Wolf

2012-10-24T10:06:33Z

White Wolf:

White Wolf is a user on Xertion IRC, He runs the channel #blupawradio and frequents #Cartoon-World and #neko-radio.
He is a good person to go to for basic help in IRC if there is no one else available
*NOTE* This page will be edited more over time tight now all I have is basic information*

User:White Wolf

2012-10-15T06:41:07Z

White Wolf: Created page with "White Wolf is a user on Xertion IRC, He runs the channel #blupawradio and frequents #Cartoon-World and #nekoradio. He is a good person to go to for basic help in IRC if there ..."

White Wolf is a user on Xertion IRC, He runs the channel #blupawradio and frequents #Cartoon-World and #nekoradio.
He is a good person to go to for basic help in IRC if there is no one else available
*NOTE* This page will be edited more over time tight now all I have is basic information*