← Back to Docs

Tokens & Rewards

Reward members with tokens for showing up to voice events, and let them spend tokens in a redemption shop.

The token system rewards members for participating in voice events and lets them spend what they earn in a redemption shop.

How earning works

  1. Enable the system on the Tokens tab (or run /config-tokens settings enable:true).
  2. Set two rates: tokens for the first hour, and tokens for each hour after.
  3. When you create a time event, pick a voice channel (the voice_channel option on /event create, or the Events tab).
  4. While the event is running, the bot tracks who is in that voice channel. When the event ends, each member's total time is rounded to the nearest whole hour and converted to tokens.

Example (first hour = 100, each later hour = 50):

| Time in voice | Rounded | Tokens | |---|---|---| | 25 min | 0 h | 0 | | 45 min | 1 h | 100 | | 1 h 40 m | 2 h | 150 | | 2 h 30 m | 3 h | 200 |

Anything under 30 minutes rounds to zero, so brief drop-ins don't earn. A per-session cap (default 12 h) guards against a session left open by accident.

Spending tokens

Admins build a catalog of rewards on the Tokens tab or with /config-tokens reward add. A reward can be:

  • A Discord role — granted automatically the moment a member redeems it.
  • A custom reward — anything you fulfill by hand; it lands in a pending queue.

Members browse with /tokens shop and claim with /tokens redeem. Custom redemptions post to your chosen redemption channel; clear them with /config-tokens redemptions fulfill or deny (denials refund the tokens). Optional stock limits cap how many times a reward can be claimed.

Member commands

  • /tokens balance — your balance and lifetime earned/spent
  • /tokens leaderboard — top earners
  • /tokens shop — available rewards
  • /tokens redeem — redeem a reward
  • /tokens history — your recent token activity

Admin commands

  • /config-tokens settings — enable, rates, session cap, currency name, redemption channel
  • /config-tokens reward add | edit | remove | list — manage the catalog
  • /config-tokens adjust — manually grant or deduct tokens
  • /config-tokens redemptions list | fulfill | deny — manage the pending queue