How Ranks & Leagues Work: Your Complete Guide to HSpark Progression
π₯ How Ranks & Leagues Work: Your Complete Guide
HSpark uses two parallel progression systems to keep you motivated and competitive. Understanding both will help you maximize your growth and compete effectively.
π Two Systems, Two Purposes
π Total Score (Lifetime Progress)
- What it is: Your all-time achievement points
- Never resets: Accumulates forever
- Shown: On your profile, badges, and overall stats
- Purpose: Measure your total dedication and unlock permanent ranks
π₯ Season Points (Monthly Competition)
- What it is: Your competitive score for the current month
- Resets: Every 1st of the month at midnight UTC
- Shown: In leagues leaderboard only
- Purpose: Compete for monthly rewards within your rank tier
β The 7 Ranks: Your Permanent Journey
Ranks are permanent achievements that represent your overall growth. Once earned, they never reset.
β¨ Spark (Starting Rank)
- Requirements: Automatic (new users start here)
- Unlock Bonus: None
- Scientific Fact: Every journey begins with a single spark of energy!
πΈ Ember (Beginner)
- Requirements:
- 7+ days in the system
- 10+ total check-ins
- 3+ day best streak
- Unlock Bonus: +100 π
- Scientific Fact: Embers are the foundation of any sustainable flame.
π₯ Flame (Intermediate)
- Requirements:
- 30+ days in the system
- 50+ total check-ins
- 7+ day best streak
- Unlock Bonus: +300 π
- Scientific Fact: A consistent flame requires steady oxygen and fuel.
πΆ Blaze (Advanced)
- Requirements:
- 90+ days in the system
- 200+ total check-ins
- 14+ day best streak
- Unlock Bonus: +500 π
- Scientific Fact: Blazes generate intense heat through sustained chemical reactions.
π¦ Torch (Expert)
- Requirements:
- 180+ days in the system
- 500+ total check-ins
- 30+ day best streak
- Unlock Bonus: +1,000 π
- Scientific Fact: Torches have illuminated human progress for thousands of years.
π Beacon (Master)
- Requirements:
- 365+ days in the system (1 full year!)
- 1,000+ total check-ins
- 66+ day best streak
- Unlock Bonus: +2,000 π
- Scientific Fact: Beacons guide others through the darkness with unwavering light.
βοΈ Sun (Legend)
- Requirements:
- 730+ days in the system (2 full years!)
- 2,000+ total check-ins
- 100+ day best streak
- Unlock Bonus: +5,000 π
- Scientific Fact: The Sun is the ultimate source of energy for all life on Earth!
π How Rank Advancement Works
Automatic Detection
- The system checks your stats every time you complete a habit
- If you meet ALL requirements for a higher rank, you upgrade instantly
- No manual actions neededβjust keep building habits!
All Requirements Must Be Met
You need to satisfy all three criteria to advance:
1. Days in system (time since account creation)
2. Total check-ins (lifetime habit completions)
3. Best streak (longest consecutive days)
Example: To reach π₯ Flame, you need:
- β
30+ days registered AND
- β
50+ check-ins AND
- β
7+ day best streak
Bonus Points
- When you unlock a new rank, you receive π bonus points added to your Total Score
- These points are permanent and never reset
- Bonuses range from 100 (Ember) to 5,000 (Sun)
π League System: Monthly Competition
What Are Leagues?
- Each rank has its own league (Spark League, Ember League, etc.)
- You compete only with people at your same rank
- Fair competitionβeveryone has similar experience levels
How League Points Work
Your π₯ Season Points are calculated from your current month’s activity:
Season Points = (check-ins Γ 10) + (best_streak Γ 5) + (challenges_won Γ 50)
Example:
- 20 check-ins this month = 200 points
- 15-day streak this month = 75 points
- 2 challenges won = 100 points
- Total: 375 π₯ Season Points
Monthly Rewards
At the end of each month, the Top 3 in your league receive rewards:
- π₯ 1st Place: +500 π Total Score
- π₯ 2nd Place: +300 π Total Score
- π₯ 3rd Place: +200 π Total Score
Then, all Season Points reset to 0 for everyone on the 1st of the next month.
βοΈ What Happens When You Rank Up Mid-Season?
Automatic League Transfer
- When you unlock a new rank, you’re instantly moved to the higher league
- Your Season Points carry over to the new league
- You continue competing for the current month’s rewards
Example:
- You’re in Ember League with 400 π₯ Season Points
- You unlock π₯ Flame rank on January 15th
- You move to Flame League with your 400 points
- You compete in Flame League for the rest of January
Why This Is Fair
- Higher leagues have tougher competition (more experienced users)
- Your points carry over, so you don’t lose progress
- You earn the rank bonus (π Total Score) immediately
π‘ Pro Tips
For Ranks (Permanent Progress)
- Focus on streaks: Best streak is often the hardest requirement
- Log in daily: Even small check-ins count toward total check-ins
- Be patient: Ranks unlock automaticallyβjust stay consistent
- Celebrate milestones: Each rank unlocks significant π bonuses
For Leagues (Monthly Competition)
- Start strong: Early check-ins set the pace for the month
- Maintain streaks: Streaks add 5 points per day to your season score
- Join challenges: Challenge wins give +50 points each (huge boost!)
- Watch the leaderboard: See how you stack up against your peers
- Don’t burn out: It’s a marathon, not a sprintβfocus on consistency
For Total Score (π Lifetime)
- Rank bonuses are huge: Reaching Sun (βοΈ) gives you 8,900 π in bonuses alone
- League rewards add up: Finishing Top 3 monthly can net thousands of points over time
- Consistency wins: Daily check-ins compound over months and years
β Frequently Asked Questions
Q: Can I lose my rank?
A: No! Ranks are permanent. Once you reach a rank, it’s yours forever.
Q: Can I drop in the league leaderboard?
A: Yes, leagues reset monthly. You start each month at 0 π₯ Season Points.
Q: What if I rank up on the last day of the month?
A: You still move to the higher league, and your Season Points carry over. You compete in the new league for any remaining time in the month.
Q: Do I compete with ALL users in leagues?
A: No, you only compete with users at your same rank. This keeps competition fair and motivating.
Q: How do I earn Total Score (π)?
A: Three ways:
1. Rank unlock bonuses (100 to 5,000 π)
2. Top 3 monthly league rewards (200 to 500 π)
3. Other achievements and milestones
Q: Can I see my progress toward the next rank?
A: Yes! Check the Ranks screen in the app to see your current stats vs. next rank requirements.
Q: What happens if two people tie in a league?
A: Ties are broken by who reached that score first (earliest timestamp wins).
Q: Do Season Points count toward my Total Score?
A: No. Season Points (π₯) are separate from Total Score (π). Only league rewards add to your Total Score.
Q: Can I compete in multiple leagues at once?
A: No. You’re always in exactly one league based on your current rank.
Q: Is there a reward for reaching Sun rank?
A: Yes! You receive a massive +5,000 π bonus, plus you join the most elite league in HSpark.
π― Summary
| Feature | Ranks (Permanent) | Leagues (Monthly) |
|---|---|---|
| Icon | π Total Score | π₯ Season Points |
| Resets | Never | Every month |
| Purpose | Long-term growth | Short-term competition |
| Tiers | 7 ranks (Spark β Sun) | 7 leagues (by rank) |
| Rewards | 100-5,000 π on unlock | 200-500 π for Top 3 |
| Requirements | Days + Check-ins + Streak | Monthly activity only |
| Competition | vs. Yourself | vs. Same-rank peers |
Keep sparking, stay consistent, and watch both your rank and league standings climb! π₯β¨
Need help? Contact us at habitspark.coach@gmail.com or use in-app support.