IRCHelper.co.uk
Please note: This information is *not* guaranteed 100% correct - please email me any errors.

Channel Services

(Extra Operserv commands need to be added)

A summary/overview of the chanserv commands for experienced users can be found here

Services are provided to make your IRC'ing life more enjoyable. This file is to help answer any questions you may have about channel services. If you have questions which are not answered in this document, please join the #help channel usually specified in the MOTD (message of the day).

Please note that all commands for services need a / in front of the command, such as:

/msg chanserv info #channelname or /msg chanserv op #channelname. These commands will NOT work without the / prefixing it.  To make life easier, the abbreviation /cs can be used in place of /chanserv e.g. /cs op #channelname.

Information contained inside brackets <> are items where YOU determine what should be typed; for example, in the command /msg chanserv register #channelname <password> <description>, you would substitute the password and description you have chosen. DO NOT type the brackets <>.

Chanserv:

Chanserv is used to register and control different aspects of a channel. A registered channel will automatically be dropped after a period of time of not being used (e.g. Some one on the access joining that particular channel).  Ask in the help channel of your irc net for details.

Chanserv Commands:

For general Chanserv help, type /msg ChanServ HELP. Abuse of ChanServ may result in the loss of the abusing channel(s).

Register:

/msg chanserv register #channelname <password> <description>
example: /msg chanserv register #chat4fun peanuts fun chat here!
This would add the channel #chat4fun with a password of 'peanuts' and a description of 'fun chat here!'
Note: You must register your nickname with NickServ before you can register a channel. (See NickServ commands: Register for more information)

This command will register a channel in the ChanServ database. The password is needed to IDENTIFY (See ChanServ commands: Identify for more information) as the channel founder in order to make changes to channel settings which you wish to change later. The description MUST be entered in order for a channel to be registered.

When you register a channel, you become the "founder" and can make changes to the channel settings. As channel founder, chanserv will automatically op you upon entering the channel, provided you have identified to nickserv first.

Suggested Guidelines for choosing passwords:
*Your password should be at least 5 characters long
*Passwords can not include spaces
*Don't use easy to guess passwords such as 123456
*Generally, the most secure passwords are those composed of random letters and numbers such as w1q4o7z10b6v

Info:

/msg chanserv info #channelname
Example: /msg chanserv info #chat4fun would produce:

This command gives you information on a channel, including: founder, description, time registered, time last used, last topic, channel options, contact information (as set with the chanserv SET command), and channel url (as set with the chanserv SET command).

Clearops:

/msg chanserv clearops #channelname
Example: /msg chanserv clearops #chat4fun would clear all the current ops on #chat4fun but NOT clear the access list. (See ChanServ commands: Access for more information)

This command will deop all the ops in the channel you specify but it will not remove those people from the access list. If this command isn't working for you, you may need to identify to nickserv first (See NickServ commands: identify for more information) or your level on that channel's access list may not be high enough. In order to use this command, you must have at least a level 15 in the channel you are attempting to use it for. It will not work for any one who has a lower access than 15.

Clearbans:

/msg chanserv clearbans #channelname
Example: /msg chanserv clearbans #chat4fun would clear all the channel bans in the channel #chat4fun.

Clear bans is similar the Clearops command. It is used to clear all the current channel bans. In order to use this command, you must identify to nickserv and have an access level of at least 15. This will clear the current bans but will not remove an akick (See ChanServ commands: Akick for more information)

Identify:

/msg chanserv identify #channelname <password>
Example: /msg chanserv identify #chat4fun peanuts would Identify you as the channel founder in the for the channel #chat4fun, provided the password is peanuts. The password will be the password you used to register the channel with, unless it has been changed with the SET command. (See ChanServ commands: Set for more information)

This command is used to identify you as the channel founder, allowing you to change channel settings (See Chanserv commands: SET for more information). You do not have to identify to NickServ before you can identify to Chanserv, nor do you have to be on the channel's access list. Be careful who you give your channel password out to, if any one, as they can alter many things in your channel with it.

List:

/msg chanserv list mask
Example: /msg chanserv list #chat* would show a list similar to:

This command will list registered channels that match your specifications. This will not list registered channels that are private.

Set:

/msg chanserv set #channelname <option> <parameters>
Example: /msg chanserv set #chat4fun founder Joe would set the founder of #chat4fun as "Joe."

The set command is used to alter various aspects of a channel, including: founder, password, url, description, topic, mode lock, keep topic, topic lock, private, secure ops, restricted, secure, leave ops and auto ops. In order for this command to work, you must have at least a level 20 in the channel you are attempting to use this command for and have identified to chanserv.

Set Founder:
/msg chanserv set #channelname founder <new channel founder>
Example: /msg chanserv set #chat4fun founder Joe would change the channel founder of #chat4fun to "Joe."

This command changes the channel founder, which can be found by using /msg chanserv info #channelname. The nick you change the founder to MUST be registered with nickserv (See Nickserv commands: Register for more information)

Set Password:
/msg chanserv set #channelname password <new password>
Example: /msg chanserv set #chat4fun password popcorn would change #chat4fun's password to 'popcorn'

This command is used to change the password for a channel. It is suggested that you change your channel password frequently, being careful of who you give it out to. It is advised to write down your new password incase you happen to forget it.

Set URL:
/msg chanserv set #channelname URL <url>
Example: /msg chanserv set #chat4fun URL http://www.chat4fun.com would set the channel's URL to http://www.chat4fun.com

This command is used to set the channel's URL in the channel information (See ChanServ commands: Info for more information). As a default, no URL is set. If after you have set a URL, you want to remove it, you can either set a new URL, using the same command, or /msg chanserv set #channelname URL none to completely remove the channel's URL listing.

Set Desc:
/msg chanserv set #channelname DESC <new description>
Example: /msg chanserv set #chat4fun DESC chat 24/7 would change the channel #chat4fun's channel description, which can be found by doing a channel info (See ChanServ commands: info for more information) to "chat 24/7."

This command will change the channel's description in the channel info.

Set topic:
/msg chanserv set #channelname topic <new topic>
Example: /msg chanserv set #chat4fun topic Join here for friendly chat would replace the current topic with "Join here for friendly chat."

This command will change the topic in the channel and is most useful when used with topic lock (See ChanServ commands: Set topiclock for more information)

Set mlock:
/msg chanserv set #channelname mlock <modes>
Example: /msg chanserv set #chat4fun mlock +tn would turn ON the "No external msgs" and "only ops change topic" modes.

This command is used to set certain channel modes always on or off. The modes include: invite only, key, private, secret, limit, key, moderated, no external msgs and only ops change topics.

Set keeptopic:
/msg chanserv set #channelname keeptopic on|off
Example: /msg chanserv set #chat4fun keeptopic on would keep the topic in #chat4fun, even after the last user leaves and restore it when a user enters the channel again.
Example: /msg chanserv set #chat4fun keeptopic off would NOT keep the topic in #chat4fun, even after the last user leaves the channel and another returns. The topic will simply say (ChanServ).

When this command is ON, ChanServ will remember the last topic in the channel it is set on once every one has left the channel. The topic will be restored once some one has entered the channel again.

Set topiclock:
/msg chanserv set #channelname topiclock on|off
Example: /msg chanserv set #chat4fun topiclock on would set the topiclock ON for #chat4fun
Example: /msg chanserv set #chat4fun topiclock off would set the topiclock OFF for #chat4fun

This command is used to keep the topic in a certain channel while it is set ON. It can not be changed unless:
a) It is changed with the chanserv topic command (See ChanServ commands: Topic for more information)
b) The topiclock is removed (/msg chanserv set #channelname topiclock off) before the topic is changed.

Set private:
/msg chanserv set #channelname private on|off
Example: /msg chanserv set #chat4fun private on would set private ON in #chat4fun
Example: /msg chanserv set #chat4fun private off would set private OFF in #chat4fun

If this mode is ON, the channel will show up in a /list but not any one's /whois that is in the channel unless the person doing the /whois on them is in the channel which has private on with them.

Set Secureops:
/msg chanserv set #channelname secureops on|off
Example: /msg chanserv set #chat4fun secureops on would set secureops ON in #chat4fun
Example: /msg chanserv set #chat4fun secureops off would set secureops OFF in #chat4fun

If secureops is ON, people who are NOT on the channel access list will be deop'd by chanserv. This is a way to secure your channel so that people who aren't on chanserv can't have ops. Don't assume that since secureops are on, people on access with level 5 can't add people. If a person is on the access list with a level 1, they can be manually op, although chanserv won't op them.

Set restricted:
/msg chanserv set #channelname restricted on|off
Example: /msg chanserv set #chat4fun restricted on would turn restriction ON in #chat4fun
Example: /msg chanserv set #chat4fun restricted off would turn restriction OFF in #chat4fun

If restriction is set ON, users with a negative number on the access list will be kick/banned from the channel instead of just not being allowed channel operator privilages.

Set secure:
/msg chanserv set #channelname secure on|off
Example: /msg chanserv set #chat4fun secure on would turn on 'secure' in #chat4fun
Example: /msg chanserv set #chat4fun secure off would turn off 'secure' in #chat4fun

If secure is set on, only people who have registered and identified to their nicks (See NickServ commands: identify and register for more information) will be allowed to join the channel if they are on the channel access list.

Set Leaveops:
/msg chanserv set #channelname leaveops on|off
Example: /msg chanserv set #chat4fun leaveops on would turn leaveops ON for #chat4fun
Example: /msg chanserv set #chat4fun leaveops off would turn leaveops OFF for #chat4fun

If leaveops is set ON, chanserv will op the first person to join the empty channel which it is set ON in, even if they are not on the channel access list. This is a bit friendlier but does give that first person some control of your channel until more people join and they leave or another channel operator comes and deops them.

Set Autoops:
/msg chanserv set #channelname autoops on|off
Example: /msg chanserv set #chat4fun autoops on would turn autoops ON for #caht4fun
Example: /msg chanserv set #chat4fun autoops off would turn autoops OFF for #chat4fun

This is set ON by default when you register a channel. If this is set on, chanserv will automatically op any one with a level 5 or higher on the channel access list. In a channel with many ops, you may want to disable this. If this is turned off, chanserv will not auto-op some one with a level 5 or greater on the access list when they join. In order to get ops in a channel which autoops is set OFF, you must:
a) Have an access level greater than 5 on the channel access list and
b) Type /msg chanserv op #channelname in order for chanserv to op you.

 Set keepopen:
/msg chanserv set #channelname keepopen on|off
Example: /msg chanserv set #chat4fun keepopen on - this would make are friendly GuardServ join the channel when it becomes empty.  This allows the channel to always be shown in a /list of channels.

To turn off:
/msg chanserv set #chat4fun keepopen off

To control access to your channel - please see here