<h1>Get Started</h1>
To get started invite the bot to your server.<br>
Use the command <i>+karma config server upvote default</i> to let the bot upload a custom upvote emoji and set that emoji as the upvote emoji for the server.<br>
Use the command <i>+karma config server downvote default</i> to let the bot upload a custom downvote emoji and set that emoji as the downvote emoji for the server.<br>
Alternatively you can type a custom server emoji instead of <i>default</i> to mark that emoji the up/downvote emoji for the server.

<h1>Features</h1>
<ul>
  <li>React with upvote emoji to message to increase authors karma by one</li>
  <li>React with downvote emoji to message to decrease authors karma by one</li>
  <li>Custom voting emojis can be set by the admins of the server</li>
  <li>Default emojis can be added via simple command</li>
  <li>Commands to show karma in server or globally</li>
  <li>Commands to show different rankings</li>
  <li>Commands to show top lists</li>
  <li>Recording history of various stats</li>
  <li>Ability for users to disable themselves completely or to disable specific servers, so they dont get publically shown</li>
  <li><a href="https://thetxt.io">Website</a> to view global top lists, history and more documentation</li>
  <li>(Coming soon) Log in to the website with your Discord Account to view personal history and statistics</li>
</ul>

<h1>List of commands</h1>
You can get help directly in Discord through the +karma help command

<h3>Top level commands</h3>
<ul>
<li>+karma show: show karma of single user</li>
<li>+karma rank: show rank of single user</li>
<li>+karma top: show top lists</li>
<li>+karma config: configure your (servers) experience</li>
</ul>
<h3>Show</h3>
<ul>
<li>+karma show: Show your global karma</li>
<li>+karma show @mention: Show global karma of mentioned user</li>
<li>+karma show server: Show your server karma</li>
<li>+karma show server @mention: Show server karma of mentioned user</li>
<li>+karma show server total: Show karma of server</li>
</ul>
<h3>Rank</h3>
<ul>
<li>+karma rank: Show your global rank</li>
<li>+karma rank @mention: Show global rank of mentioned user</li>
<li>+karma rank server: Show your rank in the current server</li>
<li>+karma rank server @mention: Show rank in the current server of mentioned user</li>
<li>+karma rank server global: Show your rank in the current server based on your global karma</li>
<li>+karma rank server global @mention: Show rank in the current server based on global karma of mentioned user</li>
<li>+karma rank server total: Show rank of the current server</li>
</ul>
<h3>Top</h3>
<ul>
<li>+karma top: Show top 10 users in current server</li>
<li>+karma top global: Show top 10 users in current server based on global karma</li>
</ul>
<h3>Config</h3>

<h4>User config</h4>
<ul>
<li>+karma config disable/enable: Disables/Enables you, this will stop counting your karma and displaying you in any output</li>
<li>+karma config disable/enable server: Disables/Enables you in the current server, this will stop counting your karma in the server and stop displaying you in any output specific to this server</li>
</ul>
<h4>Server config</h4>
<ul>
These commands can only be sent by someone with the administrator permission
<li>+karma config server disable/enable: Disables/Enables the current server, this will stop showing any output specific to this server.</li>
<li>+karma config server upvote _your custom emoji here_: Sets the server specific upvote emoji. You can also write default instead of a custom emoji. This will add a custom emoji to your server. React to messages with this emoji to upvote them.</li>
<li>+karma config server downvote _your custom emoji here_: Sets the server specific downvote emoji. You can also write default instead of a custom emoji. This will add a custom emoji to your server. React to messages with this emoji to downvote them.</li>
</ul>

<b>For more detailed information + API docs check out the <a href="https://wiki.thetxt.io/karmabot">wiki</a></b>

TxT's Karmabot

Discord bot to add a karma system similar to Reddit to your Discord server implemented with reactions

Stemmen voor TxT's Karmabot

Wil je ons ondersteunen?