# Easy like/dislike reactions (Karma system) by DMF
![GitHub last commit (branch)](https://img.shields.io/github/last-commit/rc4l/discordkarmabot/main?logo=github&label=latest%20update&color=blue)
![GitHub tag (with filter)](https://img.shields.io/github/v/tag/rc4l/DiscordKarmaBot?label=release&color=orange) [![Deployments](https://github.com/rc4l/DiscordKarmaBot/actions/workflows/publish-auto-versioning.yaml/badge.svg?branch=)](https://github.com/rc4l/DiscordKarmaBot/actions/workflows/publish-auto-versioning.yaml)

![Logo](https://i.imgur.com/zhJpAC5.png)

![Examples](https://i.imgur.com/adNBjV0.png)

This bot originally started as a tool for my own discord for the various art, video, meme, etc, channels where they're attachment heavy. The main point is to automatically add like/dislikes to all types of media posted on a discord server so nobody has to manually do it.

[Click here to add the bot to your discord server](https://discord.com/api/oauth2/authorize?client_id=750646677219573770&permissions=292058115136&scope=bot)

[Click here to join the support server](https://discord.gg/jyCCFGJa6F)

## How to start the bot

Simply run `/setupserver` once to activate the bot with default settings. 
`/help` will also show you some examples of commands I run on my server.

## Commands and options

Note: You will need to be an admin of the server (basically have manage server permissions) to run any of these commands.

### Global commands
`/setupserver` This registers your server with the bot so that it can actually work. It comes with the following options:
- `like-reaction`: You can override the default "like" emoji with another one here. The emoji must be from the same server; you can just directly use the emoji when you run the command.
- `dislike-reaction`: You can override the default "dislike" emoji with another one here. The emoji must be from the same server; you can just directly use the emoji when you run the command.
- `allow-embed-reactions`: This has several options, any of the `allow` options will make the bot automatically add like/dislike reactions to messages that contain links which have embeds.
    - `Ignore`: The bot won't add likes/dislikes to embeds
    - `Allow all`: The bot will add likes/dislikes to everything that has an embed
    - `Allow only for videos that can be played in discord (such as youtube videos)`: The bot will only add likes/dislikes to linked videos that can be played through discord (eg youtube). Any video link that requires you to open an app or browser to play won't have likes/dislikes added
    - `Allow only if it has an image or video to show`: If the embedded link has any sort of image or preview, then the bot will automatically add likes/dislikes

### Channel commands
`/setupchannel` You don't have to run this at all unless you want some channel-specific goodies. Such as:
- `forbid-text`: This makes it so any message inside the channel this command was ran on will be deleted if it didn't contain any content. So for example a post containing an image/video won't be deleted but someone just saying "lol" will get deleted automatically.
    - `Allow anything to be posted`: Nothing will be automatically deleted
    - `Messages must contain content`: Messages that aren't normally reactable will be deleted automatically. So attachments such as videos, images, etc are allowed along with embeds depending on what was configured within `allow-embed-reactions` won't be deleted. However plain messages such as just replying with "lol" will be automatically deleted.
- `allow-embed-reactions`: This is the exact same thing from Global commands, `/setupserver allow-embed-reactions`, that you can override in a specific channel. For example, if you globally have embed reactions off but want them on specifically in a channel then this is for you.
    - `Follow rules from /setupserver`: Will follow rules defined in `/setupserver` instead
    - `Ignore`: The bot won't add likes/dislikes to embeds
    - `Allow all`: The bot will add likes/dislikes to everything that has an embed
    - `Allow only for videos that can be played in discord (such as youtube videos)`: The bot will only add likes/dislikes to linked videos that can be played through discord (eg youtube). Any video link that requires you to open an app or browser to play won't have likes/dislikes added
    - `Allow only if it has an image or video to show`: If the embedded link has any sort of image or preview, then the bot will automatically add likes/dislikes

### ♻️
If there are any messages that don't have the like/dislike emojis, you can react to a message yourself with the ♻️ (recycle) emoji and the bot will attempt to add the like/dislike emoji back in and remove the ♻️.

Easy Like/Dislike by DMF

Easy like and dislike reactions (Media reactions + Karma system) by DMF

Stemmen voor Easy Like/Dislike by DMF

Wil je ons ondersteunen?