// Guide
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. It's administered from the Tokens tab on your
guild dashboard (its own tab, next to Events) or with /config-tokensadmin
in Discord.
The Tokens tab at a glance
| Reward | Cost | Grants | Stock |
|---|---|---|---|
| Veteran role | 500 | @Veteran | — |
| Custom ship paint | 1,200 | Custom | 10 |
| Priority event slot | 300 | Custom | — |
Setup
- 1Open the Tokens tab on your guild dashboard and toggle the token system on. (Bot equivalent:
/config-tokens settings enable:true.) - 2Set your earn rates: tokens for the first hour and tokens for each hour after. Optionally rename the currency and adjust the session cap.
- 3Pick a redemption channel so custom-reward claims have somewhere to land for you to fulfill.
- 4Build the reward catalog under Reward Catalog — name, cost, and either a Discord role or Custom, then Add. (Bot equivalent:
/config-tokens reward add.) - 5Create events with a voice channel so members have something to earn from — see the Events guide.
How earning works
When you create a time event, give it a voice channel — either pick one with the
voice_channel option on /event create, or check "Auto-create a temporary voice
channel" so the bot makes (and later deletes) one for you. The
auto-voice section of the Events guide
covers both routes.
While the event is running, the bot tracks who is in that voice channel. When the event ends, each member's total time is converted to tokens prorated by the minute: a full 60 minutes pays the whole hourly amount, and less than that pays the matching fraction, to one decimal place.
Example (first hour = 100, each later hour = 50):
| Time in voice | Hours | Tokens | |---|---|---| | 10 min | 0.17 h | 16.7 | | 25 min | 0.42 h | 41.7 | | 45 min | 0.75 h | 75 | | 1 h | 1 h | 100 | | 1 h 40 m | 1.67 h | 133.3 | | 2 h 30 m | 2.5 h | 175 |
The first hour accrues at the first-hour rate and everything beyond it at the later-hour rate, so turning up early is still worth more per minute than joining late. A per-session cap (default 12 h) guards against a session left open by accident.
Earning used to round to the nearest whole hour, which meant anything under 30 minutes earned nothing while 31 minutes earned a full hour's worth. Time is now prorated, so a 20-minute appearance is credited as 20 minutes.
Sitting in a voice channel outside a live event occurrence earns nothing — crediting happens when an event occurrence completes, for time spent in that event's channel.
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.
tokens shopMember 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
Related
- Events guide — creating time events with voice channels (including auto-created temporary channels), which is how tokens are earned.
- Command reference — full argument details for
/tokensand/config-tokens.