Karma Reborn Documentation

Installation

Invite Karma Reborn to your server.
Karma Reborn should not ask for any special permissions. In fact, be wary of bots that request Administrator!
Once added, Karma Reborn will initially only have access to channels accessible to the @everyone role. Depending on how you have your server set up, you may have a Welcome channel where new users go and need to hit a reaction or fill out a membership application before they gain a special role that lets them access the rest of the Discord and removes their access to the Welcome channel. You may have a special Bot role so that all the Bots do not sit in the Welcome channel unless they need to. Go ahead and assign your Bot role to Karma Reborn if so.
Create a channel where you want users to be able to issue commands and view the results. Typically this is a#rate-your-trade channel.
Grant Karma Reborn permissions to your #rate-your-trade channel:
- View Channel
- Send Messages
Grant your users, or if you prefer, one or more role(s), access your #rate-your-trade channel. The permissions required are:
- View Channel
- Send Messages
- View Message History
- Use Application Commands

Command Reference

/k @user: Retrieve the current karma of a user
/k @user karma ++: Give positive karma to a user
/k @user karma --: Give negative karma to a user
/kp @user: Give positive karma to a user (added 11/8/22)
/kn @user: Give negative karma to a user (added 11/8/22)
/km restrict mod @moderator: Allow a role to use moderator commands¹
/klb: View the leaderboard²
/km restrict lb @donors @patrons: Restrict leaderboard command to one or two roles³
/km set @user points 0: Reset a user's karma to zero³
/km received @user: View all karma received by a user³
/km given @user: View all karma given by a user³
/km delete 917871186195834310: Delete all karma given by Discord ID 917871186195834310³⁴
/km move: Move all karma from one Discord ID to another³⁴
/km backup: Back up your data to .csv or .json format

¹Can only be run by the server owner.
²Limited trial for all users, full access to Patreons and beta testers.
³Restricted to early adopters, Patreons and beta testers.
⁴Discord ID is used rather than @mention as the user may no longer be on the server.

Error Messages

For the most part the error messages you may encounter are self-explanatory. However, here are a few that need explanation:

The application did not respond: On rare occasions the cold start and execution time of the serverless application may exceed Discord's arbitrary 3 second limit. Try your command again.
Data token has expired: The list of records you were about to perform an action on has changed while you were thinking about proceeding. Try again later when your users are not adding new records. If this continues, join the Support Server and report this as a bug.
You are not authorized to use this command: The server owner may need to use /km restrict mod to allow your role to run moderator-only commands.
Only the server owner may use that command: If you are the server owner and are getting this error, it may be due to a change in the server's ownership. Karma Reborn records the owner of the Discord upon installation, but to reduce load on the Discord API, it does not continuously check the current owner. Please join our Support Server and a moderator can update the owner ID.