ChanServ

From Slacked

This page documents the various functions of ChanServ and gives information about how to use them.

AKICK

/ChanServ AKICK #channel ADD|DEL|LIST nickname|hostmask

The AKICK command allows you to maintain channel ban lists. Users on the AKICK list will be automatically kickbanned when they join the channel, removing any matching ban exceptions first. Users with the +r flag are exempt.

You may also specify a hostmask (nick!user@host) for the AKICK list. Removing an entry from the AKICK list will not remove any channel bans placed by it.

HOP/AOP/SOP/VOP

/ChanServ VOP|HOP|AOP|SOP #channel ADD|DEL|LIST nickname

The xOP commands allow you to maintain channel access lists. Channel access lists can contain registered accounts or hostmasks (nick!user@host). VOP stands for VoiceOP People, HOP stands for HalfOP, AOP stands for AutoOP, SOP stands for SuperOP.

Not all channel access entries can be edited with these commands, see the FLAGS and FORCEXOP help entries for details. Note that use of FORCEXOP can destroy a lot of information. The TEMPLATE system can provide most of the ease of use of these commands without the restrictions.

BAN

/ChanServ BAN #channel nickname|hostmask

The BAN command allows you to ban a user or hostmask from a channel.

CLEAR

CLEAR BANS

/ChanServ CLEAR #channel bans

Clear bans will remove all bans found in a specific channel. If your ircd supports other lists associated with a channel (e.g. ban exceptions), you can clear these by specifying the mode letters. Specify an asterisk to clear all lists.

CLEAR USERS

/ChanServ CLEAR #channel users [reason]

Clear users will kick all users out of the channel, except you. The channel will be cycled (recreated) if you are not on it.

CLOSE

/ChanServ CLOSE #channel ON|OFF [reason]

CLOSE prevents a channel from being used. Anyone who enters is immediately kickbanned. The channel cannot be dropped and foundership cannot be transferred.

Enabling CLOSE will immediately kick all users from the channel. Use CLOSE OFF to reopen a channel. While closed, channels will still expire.

COUNT

/ChanServ COUNT #channel

This will give a count of how many entries are in each of the channel's xOP lists and how many entries on the access list do not match a xOP value (except the founder). The second line shows how many access entries have each flag.

DROP

/ChanServ DROP #channel

DROP allows you to "unregister" a registered channel. Once you DROP a channel all of the data associated with it (access lists, etc) are removed and cannot be restored.

FORCEXOP

/ChanServ FORCEXOP #channel

FORCEXOP resets all channel access levels to xOP compatible values. That is, after the operation, the founder will have all permissions and autoop and everyone else on with flags will be on one of the xOP lists. This command is useful if the definitions for which flags each xOP level gives change and the founder wishes to use xOP commands only. Only the founder can execute this command.

FTRANSFER

/ChanServ FTRANSFER #channel founder

FTRANSFER forcefully transfers foundership of a channel.

GETKEY

/ChanServ GETKEY #channel

GETKEY returns the key (+k, password to be allowed in) of the specified channel: /join #channel key

INFO

/ChanServ INFO #channel

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

INVITE

/ChanServ INVITE #channel

INVITE requests services to invite you to the specified channel. This is useful if you use the +i channel mode.

KICK

/ChanServ KICK #channel nick [reason]

The KICK command allows for the removal of a user from a channel. The user can immediately rejoin. Your nick will be added to the kick reason.

KICKBAN

/ChanServ KICKBAN #channel nick [reason]

The KICKBAN command allows for the removal of a user from a channel while placing a ban on the user. Any matching ban exceptions will be removed.

OP/DEOP/VOICE/DEVOICE

/ChanServ OP|DEOP|VOICE|DEVOICE #channel nickname

These commands perform status mode changes on a channel. If you perform an operation on another user, they will be notified that you did it.

RECOVER

/ChanServ RECOVER #channel

RECOVER allows you to regain control of your channel in the event of a takeover.

More precisely, everyone will be deopped, limit and key will be cleared, all bans matching you are removed, a ban exception matching you is added (in case of bans services can't see), the channel is set invite-only and moderated and you are invited.

If you are on channel, you will be opped and no ban exception will be added.

REGISTER

/ChanServ REGISTER #channel

Registers a channel in the database. In order to use this command, you must first be a channel operator on the channel you're trying to register and have registered your nickname and identified yourself to NickServ.

When you register a channel, you are recorded as the "founder" of that channel. The channel founder is allowed to change all of the channel settings for the channel and will be given founder channel-operator privileges when s/he enters the channel.

SET

EMAIL

/ChanServ SET #channel email

Allows you to change or set the Email address associated with a channel.

FANTASY

/ChanServ SET #channel FANTASY ON|OFF

Allows you to enable or disable ChanServ fantasy commands (!op, !deop, etc.) on your channel.

FOUNDER

/ChanServ SET #channel FOUNDER nickname

Allows you to set a new founder of the channel. The new founder has to execute the same command to confirm the transfer.

GUARD

/ChanServ SET #channel GUARD ON|OFF

Toggles ChanServ joining or not joining your channel. Useful if you want modes, bans, and topic to hold after 0 users, and for using fantasy commands.

KEEPTOPIC

/ChanServ SET #channel KEEPTOPIC ON|OFF

Enables restoration of the old topic after the channel has become empty. In some cases, it may revert topic changes after netsplits or services outages, so it is not recommended to turn this on if your channel tends to never empty.

MLOCK

/ChanServ SET #channel MLOCK ON|OFF

Allows you to enforce a set of modes on a channel. This can prevent abuse in cases such as +kl. It can also make it harder to fight evil bots, be careful. Locked modes can be seen by anyone recreating the channel (this includes keys).

SECURE

/ChanServ SET #channel SECURE ON|OFF

Prevents anyone that's not on the channel's access lists from gaining operator or halfop status on the channel. This is useful if you're paranoid.

STAFFONLY

/ChanServ SET #channel STAFFONLY ON|OFF

Designates a channel as staff-only. Users who are not XOP are kickbanned from the channel, removing any ban exceptions matching them first.

TOPICLOCK

/ChanServ SET #channel TOPICLOCK ON|OFF

Causes ChanServ to revert topic changes by users without the +t flag. Topic changes during netsplits or services outages will always be reverted. TOPICLOCK requires KEEPTOPIC and will automatically enable it; disabling KEEPTOPIC will disable TOPICLOCK also.

URL

/ChanServ SET #channel URL url

Allows you to change or set the URL associated with a channel. This is shown to all users joining the channel. Specify an <url> of NONE to clear the URL.

VERBOSE

/ChanServ SET #channel VERBOSE ON|OFF

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

STATUS

/ChanServ STATUS #channel

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

TOPIC

/ChanServ TOPIC #channel topic

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

TOPICAPPEND

/ChanServ TOPICAPPEND #channel topic

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

UNBAN

/ChanServ UNBAN #channel nick|hostmask

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