ChanServ: Difference between revisions

From HybridIRC Wiki
Jump to navigation Jump to search
No edit summary
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
ChanServ is a service on the IRC network that helps manage and protect channels. It allows channel operators to register their channels, set access levels for users, and enforce channel settings like topic protection and bans. ChanServ ensures that the channel settings are maintained even when the channel operator is offline, providing a stable and secure environment for the community
== ChanServ Commands ==
== ChanServ Commands ==
Here is a list of all ChanServ commands:
Here is a list of all ChanServ commands:
Line 10: Line 11:
| [[#KICK|KICK]] || [[#KICKBAN|KICKBAN]] || [[#OP|OP]] || [[#QUIET|QUIET]] || [[#REGISTER|REGISTER]]
| [[#KICK|KICK]] || [[#KICKBAN|KICKBAN]] || [[#OP|OP]] || [[#QUIET|QUIET]] || [[#REGISTER|REGISTER]]
|-
|-
| [[#SET|SET]] || [[#TOPIC|TOPIC]] || [[#UNBAN|UNBAN]] || [[#UNQUIET|UNQUIET]] || [[#VOICE|VOICE]]
| [[#TOPIC|TOPIC]] || [[#UNBAN|UNBAN]] || [[#UNQUIET|UNQUIET]] || [[#VOICE|VOICE]]
|-
|-
| [[#WHY|WHY]] || [[#ACCESS|ACCESS]] || [[#AOP|AOP]] || [[#BADWORDS|BADWORDS]] || [[#BANSEARCH|BANSEARCH]]
| [[#WHY|WHY]] || [[#ACCESS|ACCESS]] || [[#AOP|AOP]] || [[#BADWORDS|BADWORDS]] || [[#BANSEARCH|BANSEARCH]]
Line 34: Line 35:
| [[#ANTIFLOOD|ANTIFLOOD]] || [[#BLOCKBADWORDS|BLOCKBADWORDS]] || [[#BLOCKBADWORDSOPS|BLOCKBADWORDSOPS]] || [[#EMAIL|EMAIL]] || [[#ENTRYMSG|ENTRYMSG]]
| [[#ANTIFLOOD|ANTIFLOOD]] || [[#BLOCKBADWORDS|BLOCKBADWORDS]] || [[#BLOCKBADWORDSOPS|BLOCKBADWORDSOPS]] || [[#EMAIL|EMAIL]] || [[#ENTRYMSG|ENTRYMSG]]
|-
|-
| [[#FANTASY|FANTASY]] || [[GAMESERV|GAMESERV]] || [[#GUARD|GUARD]] || [[#KEEPTOPIC|KEEPTOPIC]] || [[#LIMITFLAGS|LIMITFLAGS]]
| [[#FANTASY|FANTASY]] || [[#GAMESERV|GAMESERV]] || [[#GUARD|GUARD]] || [[#KEEPTOPIC|KEEPTOPIC]] || [[#LIMITFLAGS|LIMITFLAGS]]
|-
|-
| [[#MLOCK|MLOCK]] || [[#NOSYNC|NOSYNC]] || [[#PREFIX|PREFIX]] || [[#PRIVATE|PRIVATE]] || [[#PROPERTY|PROPERTY]]
| [[#MLOCK|MLOCK]] || [[#NOSYNC|NOSYNC]] || [[#PREFIX|PREFIX]] || [[#PRIVATE|PRIVATE]] || [[#PROPERTY|PROPERTY]]
Line 42: Line 43:
| [[#VERBOSE|VERBOSE]]
| [[#VERBOSE|VERBOSE]]
|}
|}
=== ACCESS ===
=== ACCESS ===
The '''ACCESS''' command manages user roles and access within a channel. This allows channel operators and founders to assign, modify, or remove access levels and permissions for users in the channel.
The '''ACCESS''' command manages user roles and access within a channel. This allows channel operators and founders to assign, modify, or remove access levels and permissions for users in the channel.
Line 68: Line 70:


'''Examples:'''
'''Examples:'''
<pre>/msg ChanServ AKICK #foo ADD bar you are annoying | private op info</pre>
<pre>/msg ChanServ AKICK #foo ADD bar you are annoying</pre>
<pre>/msg ChanServ AKICK #foo ADD *!*foo@bar.com !T 5d</pre>
<pre>/msg ChanServ AKICK #foo ADD *!*foo@bar.com !T 5d</pre>
<pre>/msg ChanServ AKICK #foo ADD *!*@bar.com !T 5d you are annoying</pre>
<pre>/msg ChanServ AKICK #foo DEL bar</pre>
<pre>/msg ChanServ AKICK #foo DEL bar</pre>
<pre>/msg ChanServ AKICK #foo LIST</pre>
<pre>/msg ChanServ AKICK #foo LIST</pre>
=== BADWORDS ===
The '''BADWORDS''' command maintains a list of glob strings that every word in a channel will be checked against (if '''BLOCKBADWORDS''' is set).
The '''ACTION''' parameter can be: KICK, WARN, BAN, KICKBAN, or (if your IRCd supports it) QUIET.
'''Syntax:'''
<pre>BADWORDS &lt;#channel&gt; LIST</pre>
<pre>BADWORDS &lt;#channel&gt; ADD &lt;word&gt; &lt;action&gt;</pre>
<pre>BADWORDS &lt;#channel&gt; DEL &lt;word&gt;</pre>
'''Examples:'''
<pre>/msg ChanServ BADWORDS #atheme LIST</pre>
<pre>/msg ChanServ BADWORDS #sailors ADD f?ck kick</pre>
<pre>/msg ChanServ BADWORDS #sailors ADD *dam?it* quiet</pre>
<pre>/msg ChanServ BADWORDS #desensitized DEL f?ck</pre>


=== BAN ===
=== BAN ===
Line 161: Line 180:


'''Permissions:'''
'''Permissions:'''
+v - Enables use of the voice/devoice commands.
{| class="wikitable"
+V - Enables automatic voice.
|-
+h - Enables use of the halfop/dehalfop commands.
| +v || Enables use of the voice/devoice commands. || +V || Enables automatic voice. || +h || Enables use of the halfop/dehalfop commands.
+H - Enables automatic halfop.
|-
+o - Enables use of the op/deop commands.
| +H || Enables automatic halfop. || +o || Enables use of the op/deop commands. || +O || Enables automatic op.
+O - Enables automatic op.
|-
+a - Enables use of the protect/deprotect commands.
| +a || Enables use of the protect/deprotect commands. || +q || Enables use of the owner/deowner commands. || +s || Enables use of the set command.
+q - Enables use of the owner/deowner commands.
|-
+s - Enables use of the set command.
| +i || Enables use of the invite and getkey commands. || +r || Enables use of the kick, kickban, ban, and unban commands. || +R || Enables use of the recover and clear commands.
+i - Enables use of the invite and getkey commands.
|-
+r - Enables use of the kick, kickban, ban, and unban commands.
| +f || Enables modification of channel access lists. || +t || Enables use of the topic and topicappend commands. || +A || Enables viewing of channel access lists.
+R - Enables use of the recover and clear commands.
|-
+f - Enables modification of channel access lists.
| +S || Marks the user as a successor. || +F || Grants full founder access. || +b || Enables automatic kickban.
+t - Enables use of the topic and topicappend commands.
|-
+A - Enables viewing of channel access lists.
| +* || Grants all permissions except +b and +F. || -* || Removes all permissions, including +b and +F.
+S - Marks the user as a successor.
|}
+F - Grants full founder access.
+b - Enables automatic kickban.
 
The special permission '''+*''' grants all permissions except +b and +F, while '''-*''' removes all permissions, including +b and +F.


'''Examples:'''
'''Examples:'''
Line 265: Line 280:
<pre>/msg ChanServ OP #foo bar</pre>
<pre>/msg ChanServ OP #foo bar</pre>
<pre>/msg ChanServ DEVOICE #foo</pre>
<pre>/msg ChanServ DEVOICE #foo</pre>
=== OWNER|DEOWNER ===
These commands perform status mode changes on a channel. If the action is performed on another user, they will be notified of the operation.
If the last parameter is omitted, the action is performed on the user requesting the command.
'''Syntax:'''
<pre>OWNER|DEOWNER &lt;#channel&gt; [nickname]</pre>
'''Examples:'''
<pre>/msg ChanServ OWNER #foo</pre>


=== PROTECT|DEPROTECT ===
=== PROTECT|DEPROTECT ===
Line 322: Line 326:


'''Flags:'''
'''Flags:'''
- +voice - Enables use of the voice/devoice commands.
{| class="wikitable"
- +autovoice - Enables automatic voice.
|-
- +halfop - Enables use of the halfop/dehalfop commands.
| +voice || Enables use of the voice/devoice commands. || +autovoice || Enables automatic voice. || +halfop || Enables use of the halfop/dehalfop commands.
- +autohalfop - Enables automatic halfop.
|-
- +op - Enables use of the op/deop commands.
| +autohalfop || Enables automatic halfop. || +op || Enables use of the op/deop commands. || +autoop || Enables automatic op.
- +autoop - Enables automatic op.
|-
- +protect - Enables use of the protect/deprotect commands.
| +protect || Enables use of the protect/deprotect commands. || +owner || Enables use of the owner/deowner commands. || +set || Enables use of the set command.
- +owner - Enables use of the owner/deowner commands.
|-
- +set - Enables use of the set command.
| +invite || Enables use of the invite and getkey commands. || +remove || Enables use of the kick, kickban, ban, and unban commands. || +recover || Enables use of the recover and clear commands.
- +invite - Enables use of the invite and getkey commands.
|-
- +remove - Enables use of the kick, kickban, ban and unban commands.
| +acl-change || Enables modification of channel access lists. || +topic || Enables use of the topic and topicappend commands. || +acl-view || Enables viewing of channel access lists.
- +recover - Enables use of the recover and clear commands.
|-
- +acl-change - Enables modification of channel access lists.
| +successor || Marks the user as a successor. || +founder || Grants full founder access. || +banned || Enables automatic kickban.
- +topic - Enables use of the topic and topicappend commands.
|}
- +acl-view - Enables viewing of channel access lists.
- +successor - Marks the user as a successor.
- +founder - Grants full founder access.
- +banned - Enables automatic kickban.


'''Examples:'''
'''Examples:'''
Line 373: Line 373:
<pre>/msg ChanServ ROLE #foo SET helpers -topic -invite</pre>
<pre>/msg ChanServ ROLE #foo SET helpers -topic -invite</pre>


=== SET EMAIL ===
 
=== STATUS ===
The '''STATUS''' command returns information about your current state, including your nickname, IRC operator, and SRA status. If a channel parameter is specified, it will show your access to the given channel.
 
'''Syntax:'''
<pre>STATUS [#channel]</pre>
 
'''Examples:'''
<pre>/msg ChanServ STATUS</pre>
<pre>/msg ChanServ STATUS #foo</pre>
 
=== SYNC ===
The '''SYNC''' command forces all channel statuses to flags, giving and removing ops, voice, and so on where necessary. You must have the +R flag to run this command.
 
'''Syntax:'''
<pre>SYNC &lt;#channel&gt;</pre>
 
'''Examples:'''
<pre>/msg ChanServ SYNC #bar</pre>
 
=== TAXONOMY ===
The '''TAXONOMY''' command lists metadata information associated with registered channels.
 
'''Example:'''
<pre>/msg ChanServ TAXONOMY #atheme</pre>
 
=== TEMPLATE ===
The '''TEMPLATE''' command allows the definition of sets of flags, simplifying the use of the FLAGS command. Without arguments, network-wide templates are shown. These include at least SOP/AOP/HOP/VOP.
 
When given only the channel argument, a listing of templates for the channel will be displayed.
 
'''Syntax:'''
<pre>TEMPLATE</pre>
<pre>TEMPLATE &lt;#channel&gt;</pre>
 
To modify a template, use the following syntax. You can specify a template name or a flags change (with + or -), optionally preceded by an ! for bulk changes. Templates cannot be empty, and the template system has limitations.
 
'''Syntax:'''
<pre>TEMPLATE &lt;#channel&gt; [template oldtemplate]</pre>
<pre>TEMPLATE &lt;#channel&gt; [template flag_changes]</pre>
<pre>TEMPLATE &lt;#channel&gt; [template !flag_changes]</pre>
 
'''Examples:'''
<pre>/msg ChanServ TEMPLATE #foo</pre>
<pre>/msg ChanServ TEMPLATE #foo user VOP</pre>
<pre>/msg ChanServ TEMPLATE #foo user !+A</pre>
<pre>/msg ChanServ TEMPLATE #foo co-founder +*-OH</pre>
<pre>/msg ChanServ TEMPLATE #foo op -*+vVhoti</pre>
<pre>/msg ChanServ TEMPLATE #foo co-founder +*-O</pre>
<pre>/msg ChanServ TEMPLATE #foo obsoletetemplate -*</pre>
 
=== TOPIC ===
The '''TOPIC''' command allows for the changing of a channel's topic.
 
'''Syntax:'''
<pre>TOPIC &lt;#channel&gt; &lt;topic&gt;</pre>
 
'''Examples:'''
<pre>/msg ChanServ TOPIC #foo bar</pre>
 
=== TOPICAPPEND ===
The '''TOPICAPPEND''' command allows for the addition of a topic to a channel.
 
'''Syntax:'''
<pre>TOPICAPPEND &lt;#channel&gt; &lt;topic&gt;</pre>
 
'''Examples:'''
<pre>/msg ChanServ TOPICAPPEND #foo bar</pre>
 
=== TOPICPREPEND ===
The '''TOPICPREPEND''' command allows for the addition of a topic at the beginning of the channel's topic.
 
'''Syntax:'''
<pre>TOPICPREPEND &lt;#channel&gt; &lt;topic&gt;</pre>
 
'''Examples:'''
<pre>/msg ChanServ TOPICPREPEND #foo bar</pre>
 
=== UNBAN ===
The '''UNBAN''' command allows you to unban a user or hostmask from a channel. If no nickname or hostmask is specified, you will be unbanned.
 
'''Syntax:'''
<pre>UNBAN &lt;#channel&gt; [nickname|hostmask]</pre>
 
'''Examples:'''
<pre>/msg ChanServ UNBAN #chat pfish</pre>
<pre>/msg ChanServ UNBAN #chat *!*@*.ucdavis.edu</pre>
 
=== UNQUIET ===
The '''UNQUIET''' command allows you to unmute a user or hostmask in a channel. If no nickname or hostmask is specified, you will be unquieted.
 
Affected users will be notified.
 
'''Syntax:'''
<pre>UNQUIET &lt;#channel&gt; [nickname|hostmask]</pre>
 
'''Examples:'''
<pre>/msg ChanServ UNQUIET #chat Diablo-D3</pre>
<pre>/msg ChanServ UNQUIET #chat *!*@*.trilug.org</pre>
 
=== WHY ===
The '''WHY''' command shows the access entries an online user matches.
 
'''Syntax:'''
<pre>WHY &lt;#channel&gt; [nickname]</pre>
 
'''Examples:'''
<pre>/msg ChanServ WHY #atheme jilles^</pre>
 
=== xOP ===
The '''xOP''' commands allow you to maintain channel access lists, which can contain registered accounts or hostmasks. The access levels may differ per network, and the TEMPLATE system is recommended for ease of use.
 
The privileges required to execute these commands are the same as those for the corresponding FLAGS commands.
 
'''Syntax:'''
<pre>VOP|AOP|SOP &lt;#channel&gt; ADD|DEL|LIST &lt;nickname|hostmask&gt;</pre>
 
'''Examples:'''
<pre>/msg ChanServ VOP #foo ADD bar</pre>
<pre>/msg ChanServ VOP #foo ADD foo!*@bar.com</pre>
<pre>/msg ChanServ AOP #foo DEL bar</pre>
<pre>/msg ChanServ SOP #foo LIST</pre>
 
 
 
 
 
 
 
=== ANTIFLOOD ===
The '''SET ANTIFLOOD''' command configures ChanServ flood control settings. The action parameter can be '''QUIET''', '''KICKBAN''', or '''AKILL'''. 
 
Flood control can be turned off using the '''OFF''' setting and turned on using default settings with the '''ON''' setting. 
 
'''Syntax:'''
<pre>SET &lt;#channel&gt; ANTIFLOOD &lt;action&gt;</pre>
<pre>SET &lt;#channel&gt; ANTIFLOOD OFF</pre>
 
'''Examples:'''
<pre>/msg ChanServ SET #channel ANTIFLOOD QUIET</pre>
<pre>/msg ChanServ SET #silence ANTIFLOOD KICKBAN</pre>
<pre>/msg ChanServ SET #trolls ANTIFLOOD AKILL</pre>
<pre>/msg ChanServ SET #coders ANTIFLOOD OFF</pre>
<pre>/msg ChanServ SET #defocus ANTIFLOOD ON</pre>
 
=== BLOCKBADWORDS ===
The '''SET BLOCKBADWORDS''' command determines whether a channel's messages are checked against the badword list. All users will be affected by this setting. 
 
If you want ops to be exempt from badword checking, use '''SET BLOCKBADWORDSOPS'''. 
 
'''Syntax:'''
<pre>SET &lt;#channel&gt; BLOCKBADWORDS ON|OFF</pre>
 
'''Example:'''
<pre>/msg ChanServ SET #sailors BLOCKBADWORDS ON</pre>
 
=== BLOCKBADWORDSOPS ===
The '''SET BLOCKBADWORDSOPS''' command determines whether or not ops will be exempt from badword checking on a channel where badword filtering is enabled. 
 
'''See also:''' [[#BLOCKBADWORDS|SET BLOCKBADWORDS]] and [[#BADWORDS|BADWORDS]]
 
'''Syntax:'''
<pre>SET &lt;#channel&gt; BLOCKBADWORDSOPS ON|OFF</pre>
 
'''Example:'''
<pre>/msg ChanServ SET #sailors BLOCKBADWORDSOPS ON</pre>
 
=== EMAIL ===
The '''SET EMAIL''' command allows you to change or set the email address associated with a channel. This email is shown in the channel's '''INFO''' output.
The '''SET EMAIL''' command allows you to change or set the email address associated with a channel. This email is shown in the channel's '''INFO''' output.


Line 382: Line 549:
<pre>/msg ChanServ SET #chat EMAIL some@email.address</pre>
<pre>/msg ChanServ SET #chat EMAIL some@email.address</pre>


=== SET ENTRYMSG ===
=== ENTRYMSG ===
The '''SET ENTRYMSG''' command allows you to change or set a message sent to all users joining the channel.
The '''SET ENTRYMSG''' command allows you to change or set a message sent to all users joining the channel.


Line 391: Line 558:
<pre>/msg ChanServ SET #support ENTRYMSG Welcome to #support. Please do not paste more than 5 lines.</pre>
<pre>/msg ChanServ SET #support ENTRYMSG Welcome to #support. Please do not paste more than 5 lines.</pre>


=== SET FANTASY ===
=== FANTASY ===
The '''SET FANTASY''' command allows you to enable or disable ChanServ fantasy commands (such as !op, !deop). The '''GUARD''' flag must also be enabled for fantasy commands to work.
The '''SET FANTASY''' command allows you to enable or disable ChanServ fantasy commands (such as !op, !deop). The '''GUARD''' flag must also be enabled for fantasy commands to work.


Line 400: Line 567:
<pre>/msg ChanServ SET #chatspike FANTASY ON</pre>
<pre>/msg ChanServ SET #chatspike FANTASY ON</pre>


=== SET FOUNDER ===
=== FOUNDER ===
The '''SET FOUNDER''' command allows you to set a new founder for the channel. The new founder must confirm the transfer by executing the same command. If the transfer is not confirmed, you can cancel it by specifying your own nickname as the new founder.
The '''SET FOUNDER''' command allows you to set a new founder for the channel. The new founder must confirm the transfer by executing the same command. If the transfer is not confirmed, you can cancel it by specifying your own nickname as the new founder.


Line 410: Line 577:
<pre>/msg ChanServ SET #foo FOUNDER bar</pre>
<pre>/msg ChanServ SET #foo FOUNDER bar</pre>


=== SET GAMESERV ===
=== GAMESERV ===
 
The '''SET GAMESERV''' command allows gaming services to be used in the channel via '''/msg GameServ <command> <channel> <parameters>'''. You can decide who may use GameServ with the following options:
The '''SET GAMESERV''' command allows gaming services to be used in the channel via '''/msg GameServ <command> <channel> <parameters>'''. You can decide who may use GameServ with the following options:
- '''ALL''' - Allow all channel members.
- '''ALL''' - Allow all channel members.
Line 424: Line 592:
'''Example:'''
'''Example:'''
<pre>/msg ChanServ SET #foo GAMESERV VOICE</pre>
<pre>/msg ChanServ SET #foo GAMESERV VOICE</pre>
=== SET GUARD ===
 
'''See also:''' [https://wiki.hybridirc.com/w/GameServ GameServ]
 
=== GUARD ===
The '''SET GUARD''' command allows ChanServ to join your channel.
The '''SET GUARD''' command allows ChanServ to join your channel.


Line 433: Line 604:
<pre>/msg ChanServ SET #atheme GUARD ON</pre>
<pre>/msg ChanServ SET #atheme GUARD ON</pre>


=== SET KEEPTOPIC ===
=== KEEPTOPIC ===
The '''SET KEEPTOPIC''' command enables the restoration of the old topic after the channel becomes empty. It may revert topic changes after netsplits or service outages, so it is not recommended to enable this if your channel rarely empties.
The '''SET KEEPTOPIC''' command enables the restoration of the old topic after the channel becomes empty. It may revert topic changes after netsplits or service outages, so it is not recommended to enable this if your channel rarely empties.


Line 442: Line 613:
<pre>/msg ChanServ SET #foo KEEPTOPIC ON</pre>
<pre>/msg ChanServ SET #foo KEEPTOPIC ON</pre>


=== SET LIMITFLAGS ===
=== LIMITFLAGS ===
The '''SET LIMITFLAGS''' command limits the power of the +f flag. Users with +f who lack +s or +R can only set +b (akick). Users who do not have all of +s and +R cannot set +s, +R, or +f.
The '''SET LIMITFLAGS''' command limits the power of the +f flag. Users with +f who lack +s or +R can only set +b (akick). Users who do not have all of +s and +R cannot set +s, +R, or +f.


Line 451: Line 622:
<pre>/msg ChanServ SET #foo LIMITFLAGS ON</pre>
<pre>/msg ChanServ SET #foo LIMITFLAGS ON</pre>


=== SET MLOCK ===
=== MLOCK ===
The '''SET MLOCK''' (mode lock) command enforces a set of modes on the channel, preventing abuse in cases such as +kl. Be cautious as it can also make it harder to fight bots. Locked modes are visible to anyone recreating the channel (including keys).
The '''SET MLOCK''' (mode lock) command enforces a set of modes on the channel, preventing abuse in cases such as +kl. Be cautious as it can also make it harder to fight bots. Locked modes are visible to anyone recreating the channel (including keys).


Line 465: Line 636:
<pre>/msg ChanServ SET #foo1 MLOCK +ntlL 40 #foo2</pre>
<pre>/msg ChanServ SET #foo1 MLOCK +ntlL 40 #foo2</pre>


=== SET NOSYNC ===
=== NOSYNC ===
The '''SET NOSYNC''' command disables automatic syncing of channel status when it is changed.
The '''SET NOSYNC''' command disables automatic syncing of channel status when it is changed.


Line 474: Line 645:
<pre>/msg ChanServ SET #foo NOSYNC ON</pre>
<pre>/msg ChanServ SET #foo NOSYNC ON</pre>


=== SET PREFIX ===
=== PREFIX ===
The '''SET PREFIX''' command allows you to customize the fantasy trigger for your channel. This is useful if you have bots that conflict with ChanServ's default fantasy prefix. Specifying no prefix (or "DEFAULT") resets the prefix to the network's default.
The '''SET PREFIX''' command allows you to customize the fantasy trigger for your channel. This is useful if you have bots that conflict with ChanServ's default fantasy prefix. Specifying no prefix (or "DEFAULT") resets the prefix to the network's default.


Line 486: Line 657:
<pre>/msg ChanServ SET #c PREFIX default</pre>
<pre>/msg ChanServ SET #c PREFIX default</pre>


=== SET PRIVATE ===
=== PRIVATE ===
The '''SET PRIVATE''' command hides various channel information from other users.
The '''SET PRIVATE''' command hides various channel information from other users.


Line 495: Line 666:
<pre>/msg ChanServ SET #foo PRIVATE ON</pre>
<pre>/msg ChanServ SET #foo PRIVATE ON</pre>


=== SET PROPERTY ===
=== PROPERTY ===
The '''SET PROPERTY''' command manipulates metadata associated with a channel. To delete a metadata entry, specify the name and leave the value blank.
The '''SET PROPERTY''' command manipulates metadata associated with a channel. To delete a metadata entry, specify the name and leave the value blank.


Line 505: Line 676:
<pre>/msg ChanServ SET #meat PROPERTY VEGETABLES</pre>
<pre>/msg ChanServ SET #meat PROPERTY VEGETABLES</pre>


=== SET RESTRICTED ===
=== PUBACL ===
The '''SET PUBACL''' command allows the channel access list to be publicly visible. 
 
'''Syntax:'''
<pre>SET &lt;#channel&gt; PUBACL ON|OFF</pre>
 
'''Example:'''
<pre>/msg ChanServ SET #foo PUBACL ON</pre>
 
=== RESTRICTED ===
The '''SET RESTRICTED''' command designates a channel as restricted access. Users who are not on the channel's access list or who do not have the '''chan:joinstaffonly''' privilege will be kicked and banned from the channel upon joining, removing any ban exceptions. If the channel is +i, no ban will be set, and invite exceptions will be removed.
The '''SET RESTRICTED''' command designates a channel as restricted access. Users who are not on the channel's access list or who do not have the '''chan:joinstaffonly''' privilege will be kicked and banned from the channel upon joining, removing any ban exceptions. If the channel is +i, no ban will be set, and invite exceptions will be removed.


Line 514: Line 694:
<pre>/msg ChanServ SET #snoop RESTRICTED ON</pre>
<pre>/msg ChanServ SET #snoop RESTRICTED ON</pre>


=== SET SECURE ===
=== SECURE ===
The '''SET SECURE''' command prevents anyone not on the channel's access lists from gaining operator or halfop status on the channel. This is useful if you're cautious about unauthorized access.
The '''SET SECURE''' command prevents anyone not on the channel's access lists from gaining operator or halfop status on the channel. This is useful if you're cautious about unauthorized access.


Line 523: Line 703:
<pre>/msg ChanServ SET #foo SECURE ON</pre>
<pre>/msg ChanServ SET #foo SECURE ON</pre>


=== SET TOPICLOCK ===
=== TOPICLOCK ===
The '''SET TOPICLOCK''' command causes ChanServ to revert topic changes by users without the +t flag. Topic changes during netsplits or service outages will always be reverted. TOPICLOCK requires KEEPTOPIC and will automatically enable it. Disabling KEEPTOPIC will disable TOPICLOCK as well.
The '''SET TOPICLOCK''' command causes ChanServ to revert topic changes by users without the +t flag. Topic changes during netsplits or service outages will always be reverted. TOPICLOCK requires KEEPTOPIC and will automatically enable it. Disabling KEEPTOPIC will disable TOPICLOCK as well.


Line 532: Line 712:
<pre>/msg ChanServ SET #foo TOPICLOCK ON</pre>
<pre>/msg ChanServ SET #foo TOPICLOCK ON</pre>


=== SET URL ===
=== URL ===
The '''SET URL''' command allows you to change or set the URL associated with a channel. This URL is shown to users joining the channel.
The '''SET URL''' command allows you to change or set the URL associated with a channel. This URL will be shown to all users joining the channel.


'''Syntax:'''
'''Syntax:'''
Line 539: Line 719:


'''Example:'''
'''Example:'''
<pre>/msg ChanServ SET #chat URL http://slashdot.org</pre>
<pre>/msg ChanServ SET #foo URL http://example.com</pre>


=== SET VERBOSE ===
=== VERBOSE ===
The '''SET VERBOSE''' command sends a notice to the channel when someone makes changes to the access lists. You can also choose to send notifications only to channel operators.
The '''SET VERBOSE ON''' command sends a notice to the channel when someone makes changes to the access lists.
 
The '''SET VERBOSE OPS''' command sends a notice to the channel operators when someone makes changes to the access lists. 
 
Fantasy commands are always executed as if '''SET VERBOSE ON''' is in effect.


'''Syntax:'''
'''Syntax:'''
Line 549: Line 733:
'''Example:'''
'''Example:'''
<pre>/msg ChanServ SET #foo VERBOSE ON</pre>
<pre>/msg ChanServ SET #foo VERBOSE ON</pre>
=== STATUS ===
The '''STATUS''' command returns information about your current state, including your nickname, IRC operator, and SRA status. If a channel parameter is specified, it will show your access to the given channel.
'''Syntax:'''
<pre>STATUS [#channel]</pre>
'''Examples:'''
<pre>/msg ChanServ STATUS</pre>
<pre>/msg ChanServ STATUS #foo</pre>
=== SYNC ===
The '''SYNC''' command forces all channel statuses to flags, giving and removing ops, voice, and so on where necessary. You must have the +R flag to run this command.
'''Syntax:'''
<pre>SYNC &lt;#channel&gt;</pre>
'''Examples:'''
<pre>/msg ChanServ SYNC #bar</pre>
=== TAXONOMY ===
The '''TAXONOMY''' command lists metadata information associated with registered channels.
'''Example:'''
<pre>/msg ChanServ TAXONOMY #atheme</pre>
=== TEMPLATE ===
The '''TEMPLATE''' command allows the definition of sets of flags, simplifying the use of the FLAGS command. Without arguments, network-wide templates are shown. These include at least SOP/AOP/HOP/VOP.
When given only the channel argument, a listing of templates for the channel will be displayed.
'''Syntax:'''
<pre>TEMPLATE</pre>
<pre>TEMPLATE &lt;#channel&gt;</pre>
To modify a template, use the following syntax. You can specify a template name or a flags change (with + or -), optionally preceded by an ! for bulk changes. Templates cannot be empty, and the template system has limitations.
'''Syntax:'''
<pre>TEMPLATE &lt;#channel&gt; [template oldtemplate]</pre>
<pre>TEMPLATE &lt;#channel&gt; [template flag_changes]</pre>
<pre>TEMPLATE &lt;#channel&gt; [template !flag_changes]</pre>
'''Examples:'''
<pre>/msg ChanServ TEMPLATE #foo</pre>
<pre>/msg ChanServ TEMPLATE #foo user VOP</pre>
<pre>/msg ChanServ TEMPLATE #foo user !+A</pre>
<pre>/msg ChanServ TEMPLATE #foo co-founder +*-OH</pre>
<pre>/msg ChanServ TEMPLATE #foo op -*+vVhoti</pre>
<pre>/msg ChanServ TEMPLATE #foo co-founder +*-O</pre>
<pre>/msg ChanServ TEMPLATE #foo obsoletetemplate -*</pre>
=== TOPIC ===
The '''TOPIC''' command allows for the changing of a channel's topic.
'''Syntax:'''
<pre>TOPIC &lt;#channel&gt; &lt;topic&gt;</pre>
'''Examples:'''
<pre>/msg ChanServ TOPIC #foo bar</pre>
=== TOPICAPPEND ===
The '''TOPICAPPEND''' command allows for the addition of a topic to a channel.
'''Syntax:'''
<pre>TOPICAPPEND &lt;#channel&gt; &lt;topic&gt;</pre>
'''Examples:'''
<pre>/msg ChanServ TOPICAPPEND #foo bar</pre>
=== TOPICPREPEND ===
The '''TOPICPREPEND''' command allows for the addition of a topic at the beginning of the channel's topic.
'''Syntax:'''
<pre>TOPICPREPEND &lt;#channel&gt; &lt;topic&gt;</pre>
'''Examples:'''
<pre>/msg ChanServ TOPICPREPEND #foo bar</pre>
=== UNBAN ===
The '''UNBAN''' command allows you to unban a user or hostmask from a channel. If no nickname or hostmask is specified, you will be unbanned.
'''Syntax:'''
<pre>UNBAN &lt;#channel&gt; [nickname|hostmask]</pre>
'''Examples:'''
<pre>/msg ChanServ UNBAN #chat pfish</pre>
<pre>/msg ChanServ UNBAN #chat *!*@*.ucdavis.edu</pre>
=== UNQUIET ===
The '''UNQUIET''' command allows you to unmute a user or hostmask in a channel. If no nickname or hostmask is specified, you will be unquieted.
Affected users will be notified.
'''Syntax:'''
<pre>UNQUIET &lt;#channel&gt; [nickname|hostmask]</pre>
'''Examples:'''
<pre>/msg ChanServ UNQUIET #chat Diablo-D3</pre>
<pre>/msg ChanServ UNQUIET #chat *!*@*.trilug.org</pre>
=== WHY ===
The '''WHY''' command shows the access entries an online user matches.
'''Syntax:'''
<pre>WHY &lt;#channel&gt; [nickname]</pre>
'''Examples:'''
<pre>/msg ChanServ WHY #atheme jilles^</pre>
=== xOP ===
The '''xOP''' commands allow you to maintain channel access lists, which can contain registered accounts or hostmasks. The access levels may differ per network, and the TEMPLATE system is recommended for ease of use.
The privileges required to execute these commands are the same as those for the corresponding FLAGS commands.
'''Syntax:'''
<pre>VOP|AOP|SOP &lt;#channel&gt; ADD|DEL|LIST &lt;nickname|hostmask&gt;</pre>
'''Examples:'''
<pre>/msg ChanServ VOP #foo ADD bar</pre>
<pre>/msg ChanServ VOP #foo ADD foo!*@bar.com</pre>
<pre>/msg ChanServ AOP #foo DEL bar</pre>
<pre>/msg ChanServ SOP #foo LIST</pre>

Latest revision as of 13:20, 26 March 2025

ChanServ is a service on the IRC network that helps manage and protect channels. It allows channel operators to register their channels, set access levels for users, and enforce channel settings like topic protection and bans. ChanServ ensures that the channel settings are maintained even when the channel operator is offline, providing a stable and secure environment for the community

ChanServ Commands

Here is a list of all ChanServ commands:

AKICK BAN CLEAR DEOP DEVOICE
DROP FLAGS GETKEY INFO INVITE
KICK KICKBAN OP QUIET REGISTER
TOPIC UNBAN UNQUIET VOICE
WHY ACCESS AOP BADWORDS BANSEARCH
CALC CLONE COUNT DF EIGHTBALL
DROP FLAGS FORCEXOP HELP LOTTERY
MARK NAMEGEN NWOD RECOVER ROLE
ROLL RPS SOP STATUS SYNC
TAXONOMY TEMPLATE TOPICAPPEND TOPICPREPEND TOPICSWAP
VOP WOD

ChanServ Set Commands

Here is a list of all commands related to SET:

ANTIFLOOD BLOCKBADWORDS BLOCKBADWORDSOPS EMAIL ENTRYMSG
FANTASY GAMESERV GUARD KEEPTOPIC LIMITFLAGS
MLOCK NOSYNC PREFIX PRIVATE PROPERTY
PUBACL RESTRICTED SECURE TOPICLOCK URL
VERBOSE

ACCESS

The ACCESS command manages user roles and access within a channel. This allows channel operators and founders to assign, modify, or remove access levels and permissions for users in the channel.

Syntax: 

ACCESS <#channel> ADD <user> <role>
ACCESS <#channel> DEL <user>
ACCESS <#channel> INFO <user>
ACCESS <#channel> LIST
ACCESS <#channel> SET <user> <role|flags>

Examples: 

/msg ChanServ ACCESS #atheme ADD stitch helpers
/msg ChanServ ACCESS #atheme DEL stitch
/msg ChanServ ACCESS #atheme INFO nenolod
/msg ChanServ ACCESS #atheme LIST
/msg ChanServ ACCESS #atheme SET stitch channel-ops

AKICK

The AKICK command allows you to manage channel ban lists. Users on the AKICK list will be automatically kicked and banned upon joining the channel.

Syntax: 

AKICK <#channel> ADD <nickname|hostmask> [<!P|!T <minutes>] [<reason>]
AKICK <#channel> DEL <nickname|hostmask>
AKICK <#channel> LIST

Examples: 

/msg ChanServ AKICK #foo ADD bar you are annoying
/msg ChanServ AKICK #foo ADD *!*foo@bar.com !T 5d
/msg ChanServ AKICK #foo ADD *!*@bar.com !T 5d you are annoying
/msg ChanServ AKICK #foo DEL bar
/msg ChanServ AKICK #foo LIST

BADWORDS

The BADWORDS command maintains a list of glob strings that every word in a channel will be checked against (if BLOCKBADWORDS is set).

The ACTION parameter can be: KICK, WARN, BAN, KICKBAN, or (if your IRCd supports it) QUIET.

Syntax: 

BADWORDS <#channel> LIST
BADWORDS <#channel> ADD <word> <action>
BADWORDS <#channel> DEL <word>

Examples: 

/msg ChanServ BADWORDS #atheme LIST
/msg ChanServ BADWORDS #sailors ADD f?ck kick
/msg ChanServ BADWORDS #sailors ADD *dam?it* quiet
/msg ChanServ BADWORDS #desensitized DEL f?ck

BAN

The BAN command bans a user or hostmask from joining the channel.

Syntax: 

BAN <#channel> <nickname|hostmask>

Examples: 

/msg ChanServ BAN #chat carnell
/msg ChanServ BAN #chat *!*@*.ipt.aol.com

CLEAR

The CLEAR BANS command removes all bans in a specific channel. It can also remove invite exceptions depending on your server's support.

Syntax: 

CLEAR <#channel> BANS [<types>]

Examples: 

/msg ChanServ CLEAR #support BANS
/msg ChanServ CLEAR #support BANS eI

CLEAR

The CLEAR FLAGS command will remove all flags from users or groups with channel access in the specified channel, except for channel founders.

This command can only be used by channel founders.

Syntax: 

CLEAR <#channel> FLAGS

Examples: 

/msg ChanServ CLEAR #atheme FLAGS

CLEAR

The CLEAR USERS command will kick all users out of the channel, except for you. The channel will be cycled (recreated) if you are not in it.

If a reason is specified, it will be included in the kick message.

Syntax: 

CLEAR <#channel> USERS [<reason>]

Examples: 

/msg ChanServ CLEAR #ChatZone USERS

COUNT

The COUNT command provides a count of entries in each of the channel's xOP lists and how many entries on the access list do not match a xOP value.

The second line shows how many access entries have each flag.

Syntax: 

COUNT <#channel>

Examples: 

/msg ChanServ COUNT #oscn

DROP

The DROP command allows you to "unregister" a channel. Once a channel is dropped, all associated data (access lists, etc.) is removed and cannot be restored.

Refer to the SET FOUNDER and FLAGS help sections for instructions on transferring channel ownership.

Syntax: 

DROP <#channel>

Examples: 

/msg ChanServ DROP #foo

FLAGS

The FLAGS command allows the granting and removal of channel privileges on a more specific level. It supports nicknames, groups, and hostmasks as targets.

When only the channel argument is provided, a listing of permissions granted to users will be displayed.

Syntax: 

FLAGS <#channel>

To modify an access entry, specify either a template name (which sets the access to the template) or a flags change (beginning with + or -). See the TEMPLATE help entry for more information about templates.

If you are not a channel founder, you may only manipulate flags you currently possess. For instance: - +v grants +V - +o grants +O - +r grants +b

If the channel is restricted using the LIMITFLAGS option, only specific flags can be changed. See SET LIMITFLAGS for further details.

If you do not have +f, you may still remove your own access with -*.

Syntax: 

FLAGS <#channel> [nickname|hostmask|group template]
FLAGS <#channel> [nickname|hostmask|group flag_changes]

Permissions:

+v Enables use of the voice/devoice commands. +V Enables automatic voice. +h Enables use of the halfop/dehalfop commands.
+H Enables automatic halfop. +o Enables use of the op/deop commands. +O Enables automatic op.
+a Enables use of the protect/deprotect commands. +q Enables use of the owner/deowner commands. +s Enables use of the set command.
+i Enables use of the invite and getkey commands. +r Enables use of the kick, kickban, ban, and unban commands. +R Enables use of the recover and clear commands.
+f Enables modification of channel access lists. +t Enables use of the topic and topicappend commands. +A Enables viewing of channel access lists.
+S Marks the user as a successor. +F Grants full founder access. +b Enables automatic kickban.
+* Grants all permissions except +b and +F. -* Removes all permissions, including +b and +F.

Examples: 

/msg ChanServ FLAGS #foo
/msg ChanServ FLAGS #foo foo!*@bar.com VOP
/msg ChanServ FLAGS #foo foo!*@bar.com -V+oO
/msg ChanServ FLAGS #foo foo!*@bar.com -*
/msg ChanServ FLAGS #foo foo +oOtsi
/msg ChanServ FLAGS #foo TroubleUser!*@*.troubleisp.net +b
/msg ChanServ FLAGS #foo !baz +*

FORCEXOP

The FORCEXOP command resets all channel access levels to xOP-compatible values. After executing this command, the founder(s) will have all permissions, and all other users with flags will be placed into one of the xOP lists. This command is useful if the definitions of which flags correspond to each xOP level change, and the founder wishes to use only xOP commands.

Only a channel founder can execute this command.

Syntax: 

FORCEXOP <#channel>

See also: SOP, AOP, HOP, VOP

Syntax: 

FTRANSFER <#channel> <founder>

Examples: 

/msg ChanServ FTRANSFER #casual vodkaswirl

GETKEY

The GETKEY command returns the key (password) required to join a channel. The key is used with the /join command.

Syntax: 

GETKEY <#channel>

Examples: 

/msg ChanServ GETKEY #foo

INFO

The INFO command displays channel information such as registration time, flags, and other details.

Syntax: 

INFO <#channel>

Examples: 

/msg ChanServ INFO #foo

INVITE

The INVITE command requests services to invite you to a specified channel. This is useful if the channel has the +i mode enabled.

Syntax: 

INVITE <#channel>

Examples: 

/msg ChanServ INVITE #foo

KICK

The KICK command removes a user from a channel. The user may immediately rejoin. The kicker's nickname is included in the kick reason.

Syntax: 

KICK <#channel> <nick> [reason]

Examples: 

/msg ChanServ KICK #foo abuser
/msg ChanServ KICK #foo abuser please stop

KICKBAN

The KICKBAN command removes a user from a channel while also placing a ban on the user. Any matching ban exceptions will be removed.

Syntax: 

KICKBAN <#channel> <nick> [reason]

Examples: 

/msg ChanServ KICKBAN #foo abuser
/msg ChanServ KICKBAN #foo abuser go away

OP|DEOP|VOICE|DEVOICE

These commands perform status mode changes on a channel. When performing an operation on another user, they will be notified of the action.

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

Syntax: 

OP|DEOP <#channel> [nickname]
VOICE|DEVOICE <#channel> [nickname]

Examples: 

/msg ChanServ OP #foo bar
/msg ChanServ DEVOICE #foo

PROTECT|DEPROTECT

These commands perform status mode changes on a channel. When performing an operation on another user, they will be notified of the action.

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

Syntax: 

PROTECT|DEPROTECT <#channel> [nickname]

Examples: 

/msg ChanServ PROTECT #foo

QUIET

The QUIET command allows you to mute a user or hostmask in a channel. Affected users will be notified that you did it.

Syntax: 

QUIET <#channel> <nickname|hostmask>

Examples: 

/msg ChanServ QUIET #chat AfterDeath
/msg ChanServ QUIET #chat *!*@*.ipt.aol.com

RECOVER

The RECOVER command allows you to regain control of your channel in the event of a takeover. This will deop everyone, clear the channel's limit and key, remove any matching bans, add a ban exception, set the channel to invite-only and moderated, and invite you to the channel. If you are already on the channel, you will be opped without adding a ban exception.

Syntax: 

RECOVER <#channel>

Example: 

/msg ChanServ RECOVER #foo

REGISTER

The REGISTER command allows you to register a channel to gain better control, including maintaining an access list and other functions typically provided by IRC bots.

Syntax: 

REGISTER <#channel>

Examples: 

/msg ChanServ REGISTER #atheme

ROLE ADD

The ROLE ADD command creates a channel role with the given flags. Multiple flags should be separated by a space.

Syntax: 

ROLE <#channel> ADD <role> [flags]

Flags:

+voice Enables use of the voice/devoice commands. +autovoice Enables automatic voice. +halfop Enables use of the halfop/dehalfop commands.
+autohalfop Enables automatic halfop. +op Enables use of the op/deop commands. +autoop Enables automatic op.
+protect Enables use of the protect/deprotect commands. +owner Enables use of the owner/deowner commands. +set Enables use of the set command.
+invite Enables use of the invite and getkey commands. +remove Enables use of the kick, kickban, ban, and unban commands. +recover Enables use of the recover and clear commands.
+acl-change Enables modification of channel access lists. +topic Enables use of the topic and topicappend commands. +acl-view Enables viewing of channel access lists.
+successor Marks the user as a successor. +founder Grants full founder access. +banned Enables automatic kickban.

Examples: 

/msg ChanServ ROLE #atheme ADD helpers topic autovoice

ROLE DEL

The ROLE DEL command deletes a channel-specific role.

Syntax: 

ROLE <#channel> DEL <role>

Examples: 

/msg ChanServ ROLE #atheme DEL helpers

ROLE LIST

The ROLE LIST command lists all channel-specific and network-wide roles and the flags assigned to each role.

Syntax: 

ROLE <#channel> LIST

Examples: 

/msg ChanServ ROLE #baz LIST

ROLE SET

The ROLE SET command allows you to modify the flags of an existing role. All users in that role will receive the effects of the changes. Multiple flags should be separated by a space, with a modifier (+ or -) before each flag.

Syntax: 

ROLE <#channel> SET <role> <flags>

Examples: 

/msg ChanServ ROLE #atheme SET channel-ops +acl-change +set +recover
/msg ChanServ ROLE #atheme SET helpers +invite
/msg ChanServ ROLE #foo SET helpers -topic -invite


STATUS

The STATUS command returns information about your current state, including your nickname, IRC operator, and SRA status. If a channel parameter is specified, it will show your access to the given channel.

Syntax: 

STATUS [#channel]

Examples: 

/msg ChanServ STATUS
/msg ChanServ STATUS #foo

SYNC

The SYNC command forces all channel statuses to flags, giving and removing ops, voice, and so on where necessary. You must have the +R flag to run this command.

Syntax: 

SYNC <#channel>

Examples: 

/msg ChanServ SYNC #bar

TAXONOMY

The TAXONOMY command lists metadata information associated with registered channels.

Example: 

/msg ChanServ TAXONOMY #atheme

TEMPLATE

The TEMPLATE command allows the definition of sets of flags, simplifying the use of the FLAGS command. Without arguments, network-wide templates are shown. These include at least SOP/AOP/HOP/VOP.

When given only the channel argument, a listing of templates for the channel will be displayed.

Syntax: 

TEMPLATE
TEMPLATE <#channel>

To modify a template, use the following syntax. You can specify a template name or a flags change (with + or -), optionally preceded by an ! for bulk changes. Templates cannot be empty, and the template system has limitations.

Syntax: 

TEMPLATE <#channel> [template oldtemplate]
TEMPLATE <#channel> [template flag_changes]
TEMPLATE <#channel> [template !flag_changes]

Examples: 

/msg ChanServ TEMPLATE #foo
/msg ChanServ TEMPLATE #foo user VOP
/msg ChanServ TEMPLATE #foo user !+A
/msg ChanServ TEMPLATE #foo co-founder +*-OH
/msg ChanServ TEMPLATE #foo op -*+vVhoti
/msg ChanServ TEMPLATE #foo co-founder +*-O
/msg ChanServ TEMPLATE #foo obsoletetemplate -*

TOPIC

The TOPIC command allows for the changing of a channel's topic.

Syntax: 

TOPIC <#channel> <topic>

Examples: 

/msg ChanServ TOPIC #foo bar

TOPICAPPEND

The TOPICAPPEND command allows for the addition of a topic to a channel.

Syntax: 

TOPICAPPEND <#channel> <topic>

Examples: 

/msg ChanServ TOPICAPPEND #foo bar

TOPICPREPEND

The TOPICPREPEND command allows for the addition of a topic at the beginning of the channel's topic.

Syntax: 

TOPICPREPEND <#channel> <topic>

Examples: 

/msg ChanServ TOPICPREPEND #foo bar

UNBAN

The UNBAN command allows you to unban a user or hostmask from a channel. If no nickname or hostmask is specified, you will be unbanned.

Syntax: 

UNBAN <#channel> [nickname|hostmask]

Examples: 

/msg ChanServ UNBAN #chat pfish
/msg ChanServ UNBAN #chat *!*@*.ucdavis.edu

UNQUIET

The UNQUIET command allows you to unmute a user or hostmask in a channel. If no nickname or hostmask is specified, you will be unquieted.

Affected users will be notified.

Syntax: 

UNQUIET <#channel> [nickname|hostmask]

Examples: 

/msg ChanServ UNQUIET #chat Diablo-D3
/msg ChanServ UNQUIET #chat *!*@*.trilug.org

WHY

The WHY command shows the access entries an online user matches.

Syntax: 

WHY <#channel> [nickname]

Examples: 

/msg ChanServ WHY #atheme jilles^

xOP

The xOP commands allow you to maintain channel access lists, which can contain registered accounts or hostmasks. The access levels may differ per network, and the TEMPLATE system is recommended for ease of use.

The privileges required to execute these commands are the same as those for the corresponding FLAGS commands.

Syntax: 

VOP|AOP|SOP <#channel> ADD|DEL|LIST <nickname|hostmask>

Examples: 

/msg ChanServ VOP #foo ADD bar
/msg ChanServ VOP #foo ADD foo!*@bar.com
/msg ChanServ AOP #foo DEL bar
/msg ChanServ SOP #foo LIST




ANTIFLOOD

The SET ANTIFLOOD command configures ChanServ flood control settings. The action parameter can be QUIET, KICKBAN, or AKILL.

Flood control can be turned off using the OFF setting and turned on using default settings with the ON setting.

Syntax: 

SET <#channel> ANTIFLOOD <action>
SET <#channel> ANTIFLOOD OFF

Examples: 

/msg ChanServ SET #channel ANTIFLOOD QUIET
/msg ChanServ SET #silence ANTIFLOOD KICKBAN
/msg ChanServ SET #trolls ANTIFLOOD AKILL
/msg ChanServ SET #coders ANTIFLOOD OFF
/msg ChanServ SET #defocus ANTIFLOOD ON

BLOCKBADWORDS

The SET BLOCKBADWORDS command determines whether a channel's messages are checked against the badword list. All users will be affected by this setting.

If you want ops to be exempt from badword checking, use SET BLOCKBADWORDSOPS.

Syntax: 

SET <#channel> BLOCKBADWORDS ON|OFF

Example: 

/msg ChanServ SET #sailors BLOCKBADWORDS ON

BLOCKBADWORDSOPS

The SET BLOCKBADWORDSOPS command determines whether or not ops will be exempt from badword checking on a channel where badword filtering is enabled.

See also: SET BLOCKBADWORDS and BADWORDS

Syntax: 

SET <#channel> BLOCKBADWORDSOPS ON|OFF

Example: 

/msg ChanServ SET #sailors BLOCKBADWORDSOPS ON

EMAIL

The SET EMAIL command allows you to change or set the email address associated with a channel. This email is shown in the channel's INFO output.

Syntax: 

SET <#channel> EMAIL [email]

Example: 

/msg ChanServ SET #chat EMAIL some@email.address

ENTRYMSG

The SET ENTRYMSG command allows you to change or set a message sent to all users joining the channel.

Syntax: 

SET <#channel> ENTRYMSG [message]

Example: 

/msg ChanServ SET #support ENTRYMSG Welcome to #support. Please do not paste more than 5 lines.

FANTASY

The SET FANTASY command allows you to enable or disable ChanServ fantasy commands (such as !op, !deop). The GUARD flag must also be enabled for fantasy commands to work.

Syntax: 

SET <#channel> FANTASY ON|OFF

Example: 

/msg ChanServ SET #chatspike FANTASY ON

FOUNDER

The SET FOUNDER command allows you to set a new founder for the channel. The new founder must confirm the transfer by executing the same command. If the transfer is not confirmed, you can cancel it by specifying your own nickname as the new founder.

Syntax: 

SET <#channel> FOUNDER <newnick>
SET <#channel> FOUNDER <yournick>

Example: 

/msg ChanServ SET #foo FOUNDER bar

GAMESERV

The SET GAMESERV command allows gaming services to be used in the channel via /msg GameServ <command> <channel> <parameters>. You can decide who may use GameServ with the following options: - ALL - Allow all channel members. - VOICE - Allow ops and voiced members. - OP - Allow only ops. - OFF - Allow no one.

For OP and VOICE, both channel status and ChanServ flags apply.

Syntax: 

SET <#channel> GAMESERV ALL|VOICE|OP|OFF

Example: 

/msg ChanServ SET #foo GAMESERV VOICE

See also: GameServ

GUARD

The SET GUARD command allows ChanServ to join your channel.

Syntax: 

SET <#channel> GUARD ON|OFF

Example: 

/msg ChanServ SET #atheme GUARD ON

KEEPTOPIC

The SET KEEPTOPIC command enables the restoration of the old topic after the channel becomes empty. It may revert topic changes after netsplits or service outages, so it is not recommended to enable this if your channel rarely empties.

Syntax: 

SET <#channel> KEEPTOPIC ON|OFF

Example: 

/msg ChanServ SET #foo KEEPTOPIC ON

LIMITFLAGS

The SET LIMITFLAGS command limits the power of the +f flag. Users with +f who lack +s or +R can only set +b (akick). Users who do not have all of +s and +R cannot set +s, +R, or +f.

Syntax: 

SET <#channel> LIMITFLAGS ON|OFF

Example: 

/msg ChanServ SET #foo LIMITFLAGS ON

MLOCK

The SET MLOCK (mode lock) command enforces a set of modes on the channel, preventing abuse in cases such as +kl. Be cautious as it can also make it harder to fight bots. Locked modes are visible to anyone recreating the channel (including keys).

Syntax: 

SET <#channel> MLOCK [modes]

Examples: 

/msg ChanServ SET #foo MLOCK +nt-lk
/msg ChanServ SET #foo MLOCK +inst-kl
/msg ChanServ SET #c MLOCK +ntk c
/msg ChanServ SET #foo MLOCK +ntcjf-kl 2:30 #overflow
/msg ChanServ SET #overflow MLOCK +mntF-kljf
/msg ChanServ SET #foo1 MLOCK +ntlL 40 #foo2

NOSYNC

The SET NOSYNC command disables automatic syncing of channel status when it is changed.

Syntax: 

SET <#channel> NOSYNC ON|OFF

Example: 

/msg ChanServ SET #foo NOSYNC ON

PREFIX

The SET PREFIX command allows you to customize the fantasy trigger for your channel. This is useful if you have bots that conflict with ChanServ's default fantasy prefix. Specifying no prefix (or "DEFAULT") resets the prefix to the network's default.

Syntax: 

SET <#channel> PREFIX [prefix]

Examples: 

/msg ChanServ SET #foo PREFIX
/msg ChanServ SET #foo PREFIX '
/msg ChanServ SET #c PREFIX %
/msg ChanServ SET #c PREFIX default

PRIVATE

The SET PRIVATE command hides various channel information from other users.

Syntax: 

SET <#channel> PRIVATE ON|OFF

Example: 

/msg ChanServ SET #foo PRIVATE ON

PROPERTY

The SET PROPERTY command manipulates metadata associated with a channel. To delete a metadata entry, specify the name and leave the value blank.

Syntax: 

SET <#channel> PROPERTY <name> [value]

Example: 

/msg ChanServ SET #atheme PROPERTY URL http://www.atheme.org/
/msg ChanServ SET #meat PROPERTY VEGETABLES

PUBACL

The SET PUBACL command allows the channel access list to be publicly visible.

Syntax: 

SET <#channel> PUBACL ON|OFF

Example: 

/msg ChanServ SET #foo PUBACL ON

RESTRICTED

The SET RESTRICTED command designates a channel as restricted access. Users who are not on the channel's access list or who do not have the chan:joinstaffonly privilege will be kicked and banned from the channel upon joining, removing any ban exceptions. If the channel is +i, no ban will be set, and invite exceptions will be removed.

Syntax: 

SET <#channel> RESTRICTED ON|OFF

Example: 

/msg ChanServ SET #snoop RESTRICTED ON

SECURE

The SET SECURE command prevents anyone not on the channel's access lists from gaining operator or halfop status on the channel. This is useful if you're cautious about unauthorized access.

Syntax: 

SET <#channel> SECURE ON|OFF

Example: 

/msg ChanServ SET #foo SECURE ON

TOPICLOCK

The SET TOPICLOCK command causes ChanServ to revert topic changes by users without the +t flag. Topic changes during netsplits or service outages will always be reverted. TOPICLOCK requires KEEPTOPIC and will automatically enable it. Disabling KEEPTOPIC will disable TOPICLOCK as well.

Syntax: 

SET <#channel> TOPICLOCK ON|OFF

Example: 

/msg ChanServ SET #foo TOPICLOCK ON

URL

The SET URL command allows you to change or set the URL associated with a channel. This URL will be shown to all users joining the channel.

Syntax: 

SET <#channel> URL [url]

Example: 

/msg ChanServ SET #foo URL http://example.com

VERBOSE

The SET VERBOSE ON command sends a notice to the channel when someone makes changes to the access lists.

The SET VERBOSE OPS command sends a notice to the channel operators when someone makes changes to the access lists.

Fantasy commands are always executed as if SET VERBOSE ON is in effect.

Syntax: 

SET <#channel> VERBOSE ON|OPS|OFF

Example: 

/msg ChanServ SET #foo VERBOSE ON
Retrieved from ‘https://wiki.hybridirc.com/mw/index.php?title=ChanServ&oldid=920’