Overview

Welcome to the Absinthe Discord Bot! This bot is designed to help organizations manage and distribute loyalty points within their Discord communities. It’s a powerful tool for engaging members and rewarding participation.

The Absinthe Discord Bot is part of a larger loyalty points campaign system provided by Absinthe. Here’s a quick overview of how it works:

  1. Projects create an account on the Absinthe dashboard (or contact the team if you don’t have a dashboard yet)

  2. They add the Absinthe bot to their Discord server.

  3. The bot facilitates point distribution and management within the community

Roles in the Discord Bot

We’ve currently only released the Server Owner and Champion Role. The other roles, while available in the bot are not currently supported!

The bot recognizes different user roles, each with its own set of permissions:

  1. Server Owner: Has full control over the bot and its settings.

  2. Community Managers: Have extensive permissions for managing points and users, including viewing any user’s points, logs, and wallet information.

  3. Champions: Have elevated permissions to issue and revoke points.

  4. General Users: Can receive points and access basic bot features.

The permission hierarchy is as follows: Server Owner > Community Managers > Champions > General Users

Server Setup Guide

Follow this step-by-step guide to start using the Absinthe Points Bot to reward points for emoji reactions.

Obtain your Absinthe API Key

Visit the Absinthe dashboard and generate a new API key for your Discord Community. If you don’t have access to a dashboard yet, contact the Absinthe Team to obtain the API key. This API key will later be registered with your Absinthe Bot.

Register points issuing events

This step is not necessary if you’re only using the bot to reward points for emoji reactions

Use the Absinthe Dashboard to register events for use within the Discord Bot. This will enable your Champions to reward points to your community under these event names. This feature is currently in beta and only accessible to certain projects

Add the Discord Bot to your server

Now its time to configure the Discord bot for your server! Click the link below to add the Absinthe Bot to your Discord Server

Paste in your API key to setup the Bot

Once you’ve added the bot to your server, navigate to its chat, and paste in your API key when prompted

Configure roles for Champion

Now that your bot is set up, we want to be able to allow all members with a designated role to be able to award points by reacting to users messages with specific emojis. We designate this role as the Champion. In order to select this role use the set_champion_roles command. Then select the role that should have Champion permissions.

The server owner is a Champion by default

Prevent Enabling Beta Features

There are certain features of the discord bot that should not be enabled unless you’ve confirmed with the Absinthe Team. In order to prevent accidentally points from being given out. Please execute the following commands

Use the command: /set_max_per_issue_per_champion 0

  • This sets the total number of points a Champion can distribute via the /issue command to 0. This will disable any champion from giving out or tipping points to your community.

  • You can enable this feature later

Impose a limit on the number of points each Champion can give out

  • Use the command: /set_max_point_perchampion <number>

  • This sets the total number of points a Champion can distribute.

  • If you increase this number later, it will affect the cap of all champions. If you decrease this number later then if any champion has already exceeded this limit, they will stop being able to issue points.

Configure Points per Emoji Reaction

Configure how many points you want to issue per emoji react.

  • Use the command: /set_emoji_points "emoji:points, emoji:points"

  • This assigns point values to specific emoji reactions.

And thats it! You can now issue points to users based on emoji reactions!

Please note the enabled emojis and their respective points values. This will not be accessible later. You can always overwrite the enabled emojis via the same command.

Helpful Commands

For a user to see all the points they’ve been issued on discord, user can user /my_discord_points

To see all the points issued by you (champion) use /issued_points