Referrals
The referral system lets players earn currency rewards by inviting new members to the Discord server. Each player can generate a unique permanent Discord invite link; when someone joins via that link and later claims a dzbot account, the referrer is automatically credited.
How it works
- A player with the
profile.generate_referralaccess right generates their personal referral link on the Profile page. - dzbot creates a permanent Discord invite for the first available text channel in the guild and stores it.
- When a new user joins the Discord server using that invite, dzbot records the join against the referral.
- When the new user later claims their in-game account through the bot, dzbot credits the referrer's balance with the configured reward amount.
Each join is credited at most once. If the new user's account was already claimed before they joined, or if there is no unclaimed join for them at claim time, no reward is issued.
Configuration
The reward amount is controlled by a single server setting:
| Setting | Location | Default |
|---|---|---|
| Referral reward amount | Admin → Economy settings | 0 (disabled) |
Setting the reward amount to 0 disables the referral feature entirely. Players will not see the referral card on their profile when the reward is zero.
Player experience
Players visit Profile and, if the feature is enabled and they have the required access right, a Referral Link card is shown. The card displays:
- The configured reward per referral.
- A Generate referral link button (shown before a link exists).
- The generated invite URL with a copy button (shown once generated).
- Statistics: total Discord joins via the link and how many resulted in a paid reward.
Access rights
| Access right | Who needs it |
|---|---|
profile.access | View the profile page |
profile.generate_referral | Generate and view a referral link |
Admins grant these rights through the access control system. See Access control.