.. _plugin-Owner: Documentation for the Owner plugin for Supybot ============================================== Purpose ------- Provides commands useful to the owner of the bot; the commands here require their caller to have the 'owner' capability. This plugin is loaded by default. Usage ----- Owner-only commands for core Supybot. This is a core Supybot module that should not be removed! Commands -------- announce Sends to all channels the bot is currently on and not lobotomized in. defaultcapability {add|remove} Adds or removes (according to the first argument) from the default capabilities given to users (the configuration variable supybot.capabilities stores these). defaultplugin [--remove] [] Sets the default plugin for to . If --remove is given, removes the current default plugin for . If no plugin is given, returns the current default plugin set for . See also, supybot.commands.defaultPlugins.importantPlugins. disable [] Disables the command for all users (including the owners). If is given, only disables the from . If you want to disable a command for most users but not for yourself, set a default capability of -plugin.command or -command (if you want to disable the command in all plugins). enable [] Enables the command for all users. If if given, only enables the from . This command is the inverse of disable. flush takes no arguments Runs all the periodic flushers in world.flushers. This includes flushing all logs and all configuration changes to disk. ircquote Sends the raw string given to the server. load [--deprecated] Loads the plugin from any of the directories in conf.supybot.directories.plugins; usually this includes the main installed directory and 'plugins' in the current directory. --deprecated is necessary if you wish to load deprecated plugins. logmark Logs to the global Supybot log at critical priority. Useful for marking logfiles for later searching. quit [] Exits the bot with the QUIT message . If is not given, the default quit message (supybot.plugins.Owner.quitMsg) will be used. If there is no default quitMsg set, your nick will be used. The standard substitutions ($version, $nick, etc.) are all handled appropriately. reload Unloads and subsequently reloads the plugin by name; use the 'list' command to see a list of the currently loaded plugins. reloadlocale takes no argument Reloads the locale of the bot. rename Renames in to the . unload Unloads the callback by name; use the 'list' command to see a list of the currently loaded plugins. Obviously, the Owner plugin can't be unloaded. unrename Removes all renames in . The plugin will be reloaded after this command is run. upkeep [] Runs the standard upkeep stuff (flushes and gc.collects()). If given a level, runs that level of upkeep (currently, the only supported level is "high", which causes the bot to flush a lot of caches as well as do normal upkeep stuff). Configuration ------------- supybot.plugins.Owner.announceFormat This config variable defaults to "Announcement from my owner ($owner): $text", is not network-specific, and is not channel-specific. Determines the format of messages sent by the 'announce' command. $owner may be used for the username of the owner calling this command, and $text for the announcement being made. supybot.plugins.Owner.public This config variable defaults to "True", is not network-specific, and is not channel-specific. Determines whether this plugin is publicly visible. supybot.plugins.Owner.quitMsg This config variable defaults to "Limnoria $version", is not network-specific, and is not channel-specific. Determines what quit message will be used by default. If the quit command is called without a quit message, this will be used. If this value is empty, the nick of the person giving the quit command will be used. The standard substitutions ($version, $nick, etc.) are all handled appropriately.