Limnoria/plugins/Admin/README.rst

Documentation for the Admin plugin for Supybot

Purpose

These are commands useful for administrating the bot; they all require their caller to have the 'admin' capability. This plugin is loaded by default.

Usage

This plugin provides access to administrative commands, such as adding capabilities, managing ignore lists, and joining channels. This is a core Supybot plugin that should not be removed!

Commands

acmd <command> [<arg> ...]

Perform <command> (with associated <arg>s on all channels on current network.

capability add <name|hostmask> <capability>

Gives the user specified by <name> (or the user to whom <hostmask> currently maps) the specified capability <capability>

capability remove <name|hostmask> <capability>

Takes from the user specified by <name> (or the user to whom <hostmask> currently maps) the specified capability <capability>

channels takes no arguments

Returns the channels the bot is on.

clearq takes no arguments

Clears the current send queue for this network.

ignore add <hostmask|nick> [<expires>]

This will set a persistent ignore on <hostmask> or the hostmask currently associated with <nick>. <expires> is an optional argument specifying when (in "seconds from now") the ignore will expire; if it isn't given, the ignore will never automatically expire.

ignore list takes no arguments

Lists the hostmasks that the bot is ignoring.

ignore remove <hostmask|nick>

This will remove the persistent ignore on <hostmask> or the hostmask currently associated with <nick>.

join <channel> [<key>]

Tell the bot to join the given channel. If <key> is given, it is used when attempting to join the channel.

nick [<nick>] [<network>]

Changes the bot's nick to <nick>. If no nick is given, returns the bot's current nick.

Configuration

supybot.plugins.Admin.public

This config variable defaults to "True", is not network-specific, and is not channel-specific.

Determines whether this plugin is publicly visible.