Limnoria/plugins/Karma
Valentin Lorentz 63eb6672ea Revert generic 'The Limnoria Contributors' in copyright notices
This commit reverts db7ef3f025
(though it keeps the year updates)

After discussion with several people, it seems better to mention
copyright owners explicitly. eg. https://reuse.software/faq/#vcs-copyright
explains the issue of using VCSs to track copyright.

As db7ef3f025 only replaced mentions
of my name with 'The Limnoria Contributors', this commit only needs
to undo that + add one person who contributed to setup.py.
2021-10-17 09:57:55 +02:00
..
locales Fix msgfmt warnings. 2020-03-26 22:10:28 +01:00
__init__.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
config.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
messages.pot Squashed commit of the following: 2014-12-20 14:37:27 +01:00
plugin.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
README.rst all plugins: regenerate READMEs 2021-04-22 00:29:15 +02:00
test.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00

Documentation for the Karma plugin for Supybot

Purpose

Plugin for keeping track of Karma for users and things in a channel.

Usage

Provides a simple tracker for setting Karma (thing++, thing--). If config plugins.karma.allowUnaddressedKarma is set to True (default since 2014.05.07), saying boats++ will give 1 karma to boats, and ships-- will subtract 1 karma from ships.

However, if you use this in a sentence, like That deserves a ++. Kevin++, 1 karma will be added to That deserves a ++. Kevin, so you should only add or subtract karma in a line that doesn't have anything else in it. Alternatively, you can restrict karma tracking to nicks in the current channel by setting config plugins.Karma.onlyNicks to True.

If config plugins.karma.allowUnaddressedKarma` is set to `False, you must address the bot with nick or prefix to add or subtract karma.

Commands

clear [<channel>] [<name>]

Resets the karma of <name> to 0. If <name> is not given, resets everything.

dump [<channel>] <filename>

Dumps the Karma database for <channel> to <filename> in the bot's data directory. <channel> is only necessary if the message isn't sent in the channel itself.

karma [<channel>] [<thing> ...]

Returns the karma of <thing>. If <thing> is not given, returns the top N karmas, where N is determined by the config variable supybot.plugins.Karma.rankingDisplay. If one <thing> is given, returns the details of its karma; if more than one <thing> is given, returns the total karma of each of the things. <channel> is only necessary if the message isn't sent on the channel itself.

load [<channel>] <filename>

Loads the Karma database for <channel> from <filename> in the bot's data directory. <channel> is only necessary if the message isn't sent in the channel itself.

most [<channel>] {increased,decreased,active}

Returns the most increased, the most decreased, or the most active (the sum of increased and decreased) karma things. <channel> is only necessary if the message isn't sent in the channel itself.

Configuration

supybot.plugins.Karma.allowSelfRating

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

Determines whether users can adjust the karma of their nick.

supybot.plugins.Karma.allowUnaddressedKarma

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

Determines whether the bot will increase/decrease karma without being addressed.

supybot.plugins.Karma.decrementChars

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

A space separated list of characters to decrease karma.

supybot.plugins.Karma.incrementChars

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

A space separated list of characters to increase karma.

supybot.plugins.Karma.mostDisplay

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

Determines how many karma things are shown when the most command is called.

supybot.plugins.Karma.onlyNicks

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

Determines whether the bot will only increase/decrease karma for nicks in the current channel.

supybot.plugins.Karma.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.Karma.rankingDisplay

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

Determines how many highest/lowest karma things are shown when karma is called with no arguments.

supybot.plugins.Karma.response

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

Determines whether the bot will reply with a success message when something's karma is increased or decreased.

supybot.plugins.Karma.simpleOutput

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

Determines whether the bot will output shorter versions of the karma output when requesting a single thing's karma.