Skip to content
vektorDocumentation

Referrals

Invite friends and earn rewards. Command: /referral.

How Referrals Work

A member creates a unique 8-digit referral code. The invitee enters the code, and after verification both receive rewards. Referral statuses: PENDING → VERIFIED → COMPLETED. Bonus is awarded at COMPLETED. Access: /referral or /menu → Referrals.

Multi-Tier Rewards

Rewards for reaching a certain number of invites: • Reward types: CURRENCY, ROLE, ACTIVITY_POINTS, COMBINED • Example: 5 referrals → 1000 coins, 10 → special role, 25 → combined reward Each tier is configurable: count, reward type, amount, currency/role. Setup: Dashboard → Referrals.

Referral Contests

Competition: who invites the most in a period. • Start and end dates • Prizes by place (currency) • Option: verified referrals only Contests cannot overlap. Auto-finalization. Create: Dashboard → Referrals → Contests.

Anti-Fraud

Protection against abuse: • Account age check for invitees • Referrer responsibility: if invitee gets banned/warned — referral is cancelled, rewards clawed back • Triggers: WARN, BAN → cancelReferral Violations affect referrer reputation.

Leaderboard

Top referrers by invite count and total rewards. Access: /referral → Leaderboard.

Configuration

Dashboard → Referrals: • Module toggle • Reward per referral (amount, currency) • Multi-tier rewards • Contests • Statistics

For Invitees

Invited members can also receive a bonus for signing up with a referral code. Bonus is admin-configurable. Enter code: /referral → Enter Code.