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.
| Command | Help |
|---|---|
| clear | Karma clear [<channel>] [<name>] Resets the karma of <name> to 0. If <name> is not given, resets everything. |
| dump | Karma 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 | Karma 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 | Karma 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 | Karma 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. |