-
-
Notifications
You must be signed in to change notification settings - Fork 0
XP System and Progression Logic
Zangreot edited this page Jul 31, 2025
·
1 revision
This page explains the XP system used across all Cryptic Creations modules.
It defines how XP is earned, processed, and used for levels, achievements, and rewards.
The XP system is designed to:
- Reward user activity (Discord, Twitch, YouTube, Kick)
- Enable weekly XP distribution
- Support leaderboard rankings and level-ups
- Power achievements and special events
| Activity Type | Source | XP Gain | Frequency |
|---|---|---|---|
| 🗨️ Discord Chat | Text Channels | +1–5 XP per msg | Cooldown-based |
| 🎥 Twitch Viewing | OAuth Viewers | +X XP per hour | Weekly batch |
| 📢 Events | Manual / Event | +10–100 XP | On event trigger |
| 🎁 Giveaways | XP Spend | –X XP (entry fee) | On user action |
| 💎 Boosts / Donations | Manual/API | Custom XP bonus | Real-time or scheduled |
All XP values and sources are configurable via the internal Dashboard.
- Each XP source has its own multiplier and cooldown
- Discord messages are rate-limited (e.g. 1 per 30s)
- Twitch viewers must be authenticated via OAuth
- XP is stored in the database per user and source
The current XP progression is non-linear and scales with level:
XP required for Level n: XP(n) = 50 × n² + 150 × n
| Level | Total XP Required |
|---|---|
| 1 | 200 |
| 5 | 1,750 |
| 10 | 6,500 |
| 20 | 22,000 |
| 30 | 48,500 |
This formula can be overridden via configuration or admin tools.
- 🏅 Achievements Bot: Triggers based on XP thresholds or user patterns
- 📊 Dashboard: Shows XP stats, user progress, and history
- 🔐 Role System: Automatically assigns roles based on level
- ⚡ Events: Supports double XP weeks, XP boosts, time-limited multipliers
- XP can be granted or removed manually via bot or dashboard
- Weekly XP distributions can be scheduled automatically
- Custom rules (e.g. VIP bonuses, XP caps) supported
- XP history is logged and auditable per user