Aura is a discord bot focused on rewarding user contributions through a point system called karma. It has the following features:

• Give out karma on messages containing thanks, ty, thank you case-insensitive.
  • Several Member Mentions in a message possible.
  • Ignores other Mentions.
  • Ignores bot mentions.
  • Ignores message author mentions.
• Configurable Feedback on karma gain
  • Logging to a channel.
  • Thumbs up reaction to the message.
  • Affirmation Message in same channel as the thank you message.
• Blacklist and Whitelist Members from giving out karma.
  • Blacklisted Members will get a DM specifying who to contact to dispute it.
• Get Karma of one or multiple Members through Mentions, or message author without mentions.
• Karma Profile with the Profile Picture, full name (name + discriminator) or nick, total karma and karma breakdown by top x channels configured, single mention or no mention for message author profile.
• Karma Leaderboard globally or per channel
• provide optional argument of days to get a timed leaderboard
• Members receive a cooldown in a one-way pair (giver-receiver) after giving it out or set the timer to 0, this means that theoretically the initial receiver can thank the giver while the cooldown period is still ticking.
• Reset all Karma of a Member in a guild.
• Delete karma from Members on message delete, reaction clear and reaction remove of the message that gave out karma.
• Change most configuration on the fly by providing keys from the config.yaml.
• Module Model, enable and disable features you don't need or like.
• Karma Help Commands to provide you with all the information on aura and how it works, what configuration parameters mean etc.
• Change Permission of every command but the help command.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

To run this bot you need to manually fill out the following values in the config.yaml.example or create config.yaml with the following fields filled out. If you are filling out the example file, you can use the create_config python file to create a config.yaml out of the example file.

token: <Your Bot Account Token>
prefix: <prefix>
role:
    admin: "<Exact Name of Admin role>"
owner: <id of bot-owner>
everything under the database key

Every other value can be updated by executing <prefix> config <key> or config <key> <key> etc. for the according key in the config yaml with a user that has the configured admin role.

Since this bot has a docker-compose file, all you need to start your own Aura locally is:

docker-compose up --build

or

docker-compose down ; docker-compose build ; docker-compose up

while being in the root directory of aura.

pip install mongomock
python -m pytest tests/ or pytest tests/

• see the requirements file for the python app dependencies
• Docker
• Docker-Compose compatible with 3.7
• MongoDB (tested with version 4.2.5)

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to the project.

This project uses SemVer for versioning. For the versions available, see the tags on this repository.

• Georg Göring - Original Author - arkencl

See also the list of contributors who participated in this project.

This project is licensed under the MIT License - see the LICENSE.md file for details

This README.MD is adapted from the following Template.