Channel Services is a utility that helps users protect their channel from malicious users who might try to "take over" the channel. It basically can be used to enforce channel modes, and operator priveledges in the channel. Command Explanation and Usage Access Maintains the access list for a channel. The access list specifies which users are allowed chanop status or access to ChanServ commands on the channel. Different user levels allow for access to different subsets of privileges; see below for more specific information. By default, any nick not on the access list has a user level of 0. The ACCESS ADD command adds the given nickname or usermask to the access list with the given user level; if the nick or mask is already present on the list, its access level is changed to the level specified in the command. User access level There are currently five distinct access levels available, unless changed by Level Set Level Description Founder Full access to ChanServ functions; automatic opping upon entering channel. Note that only one person may have founder status (it cannot be given using the ACCES command). 10 Access to AKICK command; automatic opping. 5 Automatic opping. 0 No special privileges; can be opped by other ops (unless secure-op is set). < 0 May not be opped. In addition, any user with access level greater than zero can add other users to the access list, as long as the new entries are for levels less than the user's own. So, for example, a level 10 user can add level 5 users, and either a level 10 or a level 5 user can add negative-level users. Founders can add users at any level they want. Usage: /msg chanserv access #channel add nick level The ACCESS DEL command removes the given nick or mask from the access list. Usage: /msg chanserv access #channel del [nick or entry#] The ACCESS LIST command displays the access list; if a mask is given, only those entries matching the mask are displayed. Usage: /msg chanserv acess #channel list [mask] Akick 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. 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 "You have been banned from the channel". Usage: /msg chanserv akick #channel add mask reason 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. Usage: /msg chanserv akick #channel del mask The AKICK LIST command displays the AutoKick list, or optionally only those AutoKick entries which match the given mask. Usage: /msg chanserv akick #channel list mask Auth See Identify BAN Bans and kicks selected nick from a channel. This command also adds an AKICK to the channel AutoKick list. USAGE: /msg chanserv ban #channel (nick) (Nick) need not be in the channel for the ban to work, but (nick) does need to be online. Clear Your access level on the channel must be at least 10 to use this command. Mode --- Resets all modes on the channel (i.e. clears modes i,k,l,m,n,p,s,t) Usage: /msg chanserv clear #channel mode Ban --- Clears all bans on the channel. Usage: /msg chanserv clear #channel ban Op --- Removes channel-operator status (mode +o) from all channel operators. Usage: /msg chanserv clear #channel Op Voice --- Removes "voice" status (mode +v) from anyone with that mode set. Usage: /msg chanserv clear #channel voice User --- Removes (kicks) all users from the channel. Usage: /msg chanserv clear #channel user Deop Deops a selected nick on a channel. Limited to those with level five access and above on said channel. Usage: /msg chanserv deop #channel nick Devoice Removes voice (+) from a selected nick on a channel. Limited to those with level five access and above on said channel. Usage: /msg chanserv devoice #channel nick Drop Drops a channel from Chanserv's database. You must have Identified as the founder prior to using this command. Usage: /msg chanserv drop #channel GETKEY If a key (mode +k) is set in the given channel and the user has sufficient access to use this command (see LEVELS GETKEY), it will return the key of that channel. Response will be "NO KEY" if no key is set. USAGE: /msg chanserv getkey #channel Help Gives a short explanation of commands. Usage: /msg chanserv help Ident See Identify Identify Authenticates you to ChanServ as the founder of the given channel. Many commands require you to use this command before using them. The password should be the same one you sent with the REGISTER command. You may also use Auth or Ident in place of Identify Usage: /msg chanserv identify #channel password Info Lists information about the named registered channel, including its founder, time of registration, last time used, description, and mode lock, if any. Usage: /msg chanserv info #channel Invite Tells ChanServ to invite you into the given channel. Only works if your access level on that channel is greater than zero. Usage: /msg chanserv invite #channel Kick Tells ChanServ to kick a user from the channel. You must be a channel operator to use this command, regardless of your access level in the channel. Usage: /msg chanserv kick #channel user reason Levels The LEVELS command allows fine control over the meaning of the numeric access levels used for channels. With this command, you can define the access level required for most of ChanServ's functions. (The SET FOUNDER and SET PASSWORD commands, as well as this command, are always restricted to the channel founder.) New Command, More Help Coming Soon! Set SET allows the access level for a function or group of functions to be changed. The following feature/function names are understood. Note that the levels for AUTODEOP and NOJOIN are maximum levels, while all others are minimum levels. ACC-LIST Allowed to view the access list ACC-CHANGE Allowed to modify the access list AKICK Allowed to use AKICK command ASSIGN Allowed to ASSIGN/DEASSIGN a BOTSERV bot to/from the channel AUTODEOP Channel operator status Disallowed AUTOOP Automatic channel operator status AUTOVOICE Automatic mode +v BADWORDS Allowed to use BOTSERV bot BADWORDS command BAN Allowed to use the BAN command CLEAR Allowed to use CLEAR command GETKEY Allowed to use the GETKEY command INVITE Allowed to use INVITE command KICK Allowed to use BOTSERV bot KICK command MEMO Allowed to list/read channel memos NOJOIN Users below this level on the access list will not be allowed to join the channel if it is set to restricted NOKICK Users at or above this level can not be kicked by the BOTSERV Bot OPDEOP Allowed to use OP/DEOP commands PUBCMD Allowed to use BOTSERV bot PUBCMD command SAY Allowed to use BOTSERV bot SAY and ACT commands SET Allowed to use SET command (not FOUNDER/PASSWORD) UNBAN Allowed to use UNBAN command Voice Allowed to use the Voice / Devoice commands Dis or Disable disables an automatic feature or disallows access to a function by anyone other than the channel founder List shows the current levels for each function or group of functions. Reset Resets the levels to the default levels of a newly-created channel (see ACCESS LEVELS) LIST Usage: /msg chanserv list <pattern> Lists all registered channels matching the given pattern. (Channels with the PRIVATE option set are not listed.) LOGOUT This command makes the selected nickname unidentified for the given channel. If you are the founder of the channel, you can logout any nickname identified to that channel. USAGE: /msg chanserv logout #channel (nick) OP Ops a selected nick on a channel. Limited to those with level five access and above on said channel. Usage: /msg chanserv op #channel nick Register Allows you to register a channel on COOLCHAT, provided 3 things are true... You have registered your nick with Nickserv You are an operator in the channel to register and the channel isnt already registered Usage: /msg chanserv register #channel password description Set Allows the channel founder to set various channel options and other information. The founder must use the IDENTIFY command before using SET BANTYPE Sets the default banmask that will be used by services when it places it a ban on the channel. Option is a number between 0 and 3 and represent the following masks: 0 *!user@host.domain 1 *!*user@host.domain 2 *!*@host.domain 3 *!*user@*.domain USAGE : /msg chanserv set #channel bantype (0 | 1 | 2 | 3) Desc Sets the description for the channel, which shows up with the INFO commands. Usage: /msg chanserv set #channel description EMAIL Associates the given E-mail address with the channel. This address will be displayed whenever someone requests information on the channel with the INFO command. If no parameter is given, deletes any current E-mail address for the channel. EntryMsg Sets the message which will be sent to users when they enter the channel. If no parameter is given, causes no message to be sent upon entering the channel. Founder Changes the founder of a channel. The new nickname must be a registered one Usage: /msg chanserv set #channel founder nick Keeptopic Enables or disables the topic retention option for a channel. When topic retention is set, the topic for the channel will be remembered by ChanServ even after the last user leaves the channel, and will be restored the next time a user enters the channel. USAGE: /msg chanserv set #channel keeptopic on to enable or /msg chanserv set #channel keeptopic off to disable LeaveOps Enables or disables the leaveops option for a channel. When leaveops is on, ChanServ will never de-op a user in that channel except with the DEOP command. Mlock Sets the mode-lock parameter for the channel. ChanServ allows you to define certain channel modes to be always on (or off). The modes that can be locked are i,k,l,m,n,p,s and t ; each of these modes can be locked on, locked off, or not locked. The parameter is constructed exactly the same way as a /MODE command; that is, modes followed by a + are locked on, and modes followed by a - are locked off. --- Warning --- If you set a mode-locked key, as in the second example below, you should also set the RESTRICTED option for the channel, or anyone entering the channel when it is empty will be able to see the key! Examples: /msg chanserv SET #channel MLOCK +nt-iklps Forces modes n and t on, and modes i, k, l, p, and s off. Mode m is left free to be either on or off. /msg chanserv SET #channel MLOCK +knst-ilmp my-key Forces modes k, n, s, and t on, and modes i, l, m, and p off. Also forces the channel key to be "my-key". /msg chanserv SET #channel MLOCK + Removes the mode lock; all channel modes are free to be either on or off. OPnotice Enables or disables theop-notic option for a channel. When opnotice is on, ChanServ will send a notice to the channel whenever the OP or DEOP commands are used for a user in the channel. Password Changes the founder's channel password. Usage: /msg chanserv set #channel password Private Enables or disables the private option for a channel. When private is set, a /msg ChanServ LIST will not include the channel in any lists. NOTE: CoolChat has disabled the /MSG CHANSERV LIST function for other than Server Administrators. Channel Owners not wanting their channels seen by anyone should us this command, and the SET MLOCK +s mode. USAGE: /msg chanserv set #channel private on to enable or /msg chanserv set #channel private off to disable. Restricted Enables or disables the restricted access option for a channel. When restricted access is set, users who would normally be disallowed from having channel operator privileges (users with negative access levels and, if secure op is set, users not on the access list) will instead be kicked and banned from the channel. USAGE: /msg chanserv set #channel restricted on to enable, or /msg chanserv set #channel restricted off to disable Secure Enables or disables ChanServ's security features for a channel. When SECURE is set, only users who have registered their nicknames with NickServ and IDENTIFY'd with their password will be given access to the channel as controlled by the access list. Note that the access list may only contain registered nicknames if SECURE is set. USAGE: /msg chanserv set #channel secure on to enable, or /msg chanserv set #channel secure off to disable SECUREFOUNDER Enables or disables the secure founder option for a channel. When secure founder is set, only the real founder will be able to drop the channel, change its password, its founder and its successor, and not those who are IDENTIFY'd with ChanServ. USAGE: /msg chanserv set #channel Securefounder (on | off) Secureops --- Enables or disables the secure operator option for a channel. When secureops is set, only users in the access list with a level greater than 0 will be allowed chanop status. USAGE: /msg chanserv set #channel secureops on to enable, or /msg chanserv set #channel secureops off to disable. Successor Changes the successor of a channel. If the founder's nickname expires or is dropped while the channel is still registered, the successor will become the new founder of the channel. However, if the successor already has too many channels registered (0), the channel will be dropped instead, just as if no successor had been set. The new nickname must be a registered one. Topic Causes ChanServ to set the channel topic to the one specified. This command is most useful in conjunction with SET LOCKTOPIC. Usage: /msg chanserv set #channel topic Topiclock Enables or disables the topic lock option for a channel. When topic lock is set, ChanServ will not allow the channel topic to be changed except via the SET TOPIC command. USAGE: /msg chanserv set #channel topiclock on to enable, or /msg chanserv set #channel topiclock off to disable URL Associates the given URL with the channel. This URL will be displayed whenever someone requests information on the channel with the INFO command. If no parameter is given, deletes any current URL for the channel. Unban Tells ChanServ to remove all bans preventing you from entering the given channel. Only works if your access level on that channel is greater than zero. Usage: /msg chanserv unban #channel Voice Instructs ChanServ to give voice to a user. Only useful in a +m (moderated) channel. Usage: Usage: /msg chanserv voice #channel [nick] whois Reports back the user mask of the targeted nick name. Useful for channel founders who are trying to akick a user that changes nicks. It will also tell you which CoolCHAT.net server they are currently connected to, what non-secret channels they may be on, and if they are currently and irc-operator. Usage: /msg chanserv WHOIS <nick>