Badges & Battle Pass
Achievements, seasonal progression, rewards and quests.
What Are Badges
Badges are visual achievements displayed on member profiles. Each badge has: • Name and description • Emoji or image • Auto-award trigger (optional) • Holder limit (optional) • Hidden (isHidden) — not visible until earned Setup: Dashboard → Badges or /admin → Badges.
Automatic Triggers
Badges can be awarded automatically when conditions are met: • DUELS_WON — N duel wins • DUELS_PLAYED — N duels played • TRADES_COMPLETED — N completed trades • LEVEL_REACHED — reaching level N • DISPUTES_RESOLVED — N resolved disputes • APPEALS_UPHELD — N upheld appeals • CORPORATION_OWNER — corporation owner • GUARANTOR_STATUS — guarantor status • ACCOUNT_AGE_DAYS — account age N days • REFERRALS_COUNT — N referrals • MANUAL — awarded manually by admin Checks happen automatically on stats update.
Manual Award/Revoke
Admins can award or revoke badges manually. On award, checks: • Is the badge active • Does the member already have it • Is the holder limit reached Badges can grant a reward on receipt: currency or role.
Showcase
Badges are displayed on the profile card (/profile). Slot count: • Free — 5 badges • User Premium — 10 badges Members choose which badges to display.
Battle Pass — Overview
Seasonal progression system with rewards at each level. Two tracks: • Free — free rewards • Premium — paid track (purchased with server currency) Reward types: currency, role, badge, XP.
Seasons
Each season has: • Name and description • Start and end dates • Maximum level • XP per level • Premium track price • Rewards per level Ended seasons are archived. Statuses: SCHEDULED → ACTIVE → ENDED → ARCHIVED.
XP Sources
Battle Pass XP is earned through: • Messages (xpFromMessages) • Voice channels (xpFromVoice) • Quests (daily, weekly, seasonal) Quests have types and triggers (MESSAGE_SEND, VOICE_JOIN, DUEL_WIN, etc.).
Configuration
Dashboard → Battle Pass: • Create seasons • Configure levels and rewards • Quest templates • Member progress stats
Onboard new members safely with verification gates and personalized welcome flows.