# How XP Works in Jogg Mini

**Blog Article | MokingBird**

---

One of the most common questions from parents and curious learners is: *how exactly does Jogg Mini decide how many points I earn?*

It's a fair question. In a lot of apps, the points system is a black box — you answer correctly, a number goes up, but nobody explains the formula. We think transparency matters. If XP drives progression, motivation, and achievement in Jogg Mini, then everyone using the app deserves to understand how it works.

So here it is: the complete, honest explanation of how Jogg Mini calculates XP, Stars, Gems, Levels, and the rest of the reward economy.

---

## The Core Principle

Before the formulas, the philosophy. Jogg Mini's reward system is built on four principles:

1. **Correct answers always earn something.** Wrong answers earn zero XP — but they don't take anything away. There's no punishment for getting something wrong.

2. **Harder work earns more.** A child who wrestles with a Hard question should earn more than one who breezes through an Easy one. Difficulty multipliers make this concrete.

3. **Speed signals mastery.** Answering correctly and quickly suggests genuine understanding rather than slow elimination. Speed bonuses reflect this — but they're bounded, so a slightly slower correct answer isn't heavily penalised.

4. **Hints help learning but reduce reward for that question.** Using a hint is never punished globally — your total XP isn't damaged. But it reduces the reward for that specific question, because the hint changed the difficulty of the problem.

These principles are designed so that correct answers, thoughtful learning, consistency, and challenge all feel rewarding — and that children, parents, teachers, and schools can understand why a reward was earned.

---

## What Currently Influences XP

XP in Jogg Mini is influenced by several factors:

- **Whether the answer is correct** — the primary gate; incorrect answers earn zero XP
- **Question difficulty** — harder questions start with higher base XP
- **Time taken to answer** — faster correct answers earn a speed bonus
- **Whether a hint was used** — reduces the reward for that specific question
- **Daily challenge and event rewards** — fixed bonus XP for completing specific challenges

---

## The XP Formula (Per Question)

### Step 1: Base XP by Difficulty

Every question has a base point value tied to its difficulty level:

| Difficulty | Base XP | Typical Age Group |
|------------|---------|-------------------|
| Easy | 10 XP | Ages 5–8 |
| Medium | 14 XP | Ages 8–12 |
| Hard | 18 XP | Ages 12–15 |
| Smart | 22 XP | Advanced content |
| Genius | 26 XP | Expert-level challenge |

A correct answer on an Easy question starts at 10 XP. A Genius-level correct answer starts at 26 XP.

### Step 2: Speed Bonus (Up to +50%)

If you answer correctly *and* quickly, you earn a speed bonus:

```
Speed Factor  = (Time Limit − Time Spent) / Time Limit
Speed Bonus   = Base XP × Speed Factor × 0.5
```

In plain language: if you used half the available time, you earn a 25% speed bonus. If you answered almost immediately, you earn close to the full 50% bonus.

**Example:**
- Medium question (14 XP base), 30-second time limit
- Answered in 9 seconds (21 seconds remaining)
- Speed Factor = 21 / 30 = 0.70
- Speed Bonus = 14 × 0.70 × 0.5 = 4.9 ≈ **5 XP**
- **Total before hint check: 19 XP**

### Step 3: Hint Penalty (If Used)

If a hint was used on this question, the XP earned for this answer is halved:

```
XP after hint = round(XP × 0.5)
```

This applies only to this one question — it doesn't affect your overall total or any future answers.

**Example continued:**
- Without hint: **19 XP**
- With hint: 19 × 0.5 = 9.5 ≈ **10 XP**

The hint helped learning. The reward is reduced but still positive. That balance is intentional.

### Step 4: Final Range

XP per correct answer is bounded to a range of **1 to 1,000 XP**. In practice, most correct answers earn between **10 and 39 XP** depending on difficulty and speed.

### Wrong Answers

Wrong answers earn **0 XP**. No deduction, no penalty to the overall total. The child sees the correct answer, reads the explanation, and moves on.

---

## The Star Formula

Stars are a separate quality rating earned per correct answer:

| Stars | Criteria |
|-------|---------|
| ⭐⭐⭐ | Correct + fast (≥75% time remaining) + no hint |
| ⭐⭐ | Correct + moderate speed, OR hint used |
| ⭐ | Correct answer only |
| — | Wrong answer |

Stars serve two purposes: they are a **mastery signal** (3-star answers indicate confident, fast, independent knowledge) and a **currency** (5 stars = 1 hint). Managing the star balance is a genuine micro-decision embedded in the learning experience.

Stars also contribute to world completion ratings — each world tracks cumulative stars earned within it. This gives parents and teachers a quick quality view beyond raw question counts.

---

## Gems

Gems are the rare secondary currency, earned through sustained progress:

- **+1 gem per 150 XP earned** (ledger-based — awarded at each 150 XP milestone)
- **Bonus gems on level-up milestones** (every 5 levels)

Gems can be spent:
- **3 gems → 1 hint**
- **5 gems → 1 skip**

Because gems accumulate slowly, spending them is a real decision. Children learn resource management embedded in the learning experience.

---

## Levels and the Progression Curve

XP accumulates into levels. Jogg Mini has 50+ levels across 10 named tiers:

| Tier | Levels | XP Range |
|------|--------|----------|
| Bronze | 1–5 | 0–500 XP |
| Copper | 6–10 | 500–1,500 XP |
| Tin | 11–15 | 1,500–3,000 XP |
| Steel | 16–20 | 3,000–5,000 XP |
| Iron | 21–25 | 5,000–8,000 XP |
| Silver | 26–30 | 8,000–12,000 XP |
| Electrum | 31–35 | 12,000–18,000 XP |
| Platinum | 36–40 | 18,000–25,000 XP |
| Gold | 41–45 | 25,000–35,000 XP |
| Diamond | 46–50 | 35,000–50,000 XP |
| Legendary | 51+ | 50,000+ XP |

The curve is **exponential** — each level requires progressively more XP than the last. Early levels (Bronze, Copper) come quickly, giving beginners a satisfying sense of fast progress. Higher tiers require sustained, months-long commitment.

Level-up milestones every 5 levels include bonus gem and star rewards — a real celebration that marks the achievement.

---

## Streaks

Streaks measure consecutive days of activity. The streak counter increments by 1 each day a user answers at least one question. Missing a day resets the streak to 0.

Streak milestone rewards:

| Streak | Badge |
|--------|-------|
| 3 days | AI Lover |
| 7 days | Week Warrior |
| 14 days | 2-Week Warrior |
| 30 days | Monthly Champion |
| 90 days | 3-Month Master |
| 180 days | 6-Month Hero |
| 365 days | Yearly Legend |

Streaks are one of the strongest motivators in Jogg Mini. The combination of visible progress and the real cost of breaking a streak produces consistent daily engagement — which is the most effective pattern for long-term retention.

---

## Daily Challenge Bonuses

Completing Daily Jogg challenges earns fixed bonus rewards on top of per-question XP:

| Challenge Type | Bonus XP | Bonus Stars |
|----------------|----------|-------------|
| Quiz Count (complete N quizzes) | 50 × N | 5 × N |
| Accuracy Challenge | 200 | 20 |
| Speed Challenge | 250 | 25 |
| Perfect Challenge | 300 | 30 |
| Streak Challenge | 100 | 10 |

These stack on top of the per-question XP earned during the challenge, making Daily Jogg completion consistently more rewarding than equivalent free practice.

---

## Why XP Is Helpful for Parents and Teachers

XP gives adults a useful signal at a glance — it's not a formal grade, but it does reflect:

- How much total learning engagement has happened
- Consistency (did they keep their streak?)
- Challenge level attempted (difficulty affects XP earned)

XP sits alongside accuracy percentage, world completion, and quiz history in the parent dashboard and teacher reports to give a fuller picture of learning engagement and quality.

---

## The Direction We're Building Toward

The current XP system is functional and actively motivating. As the product matures, MokingBird is working toward an even more unified, transparent reward economy — one single calculation model for all reward-generating flows (quiz, arcade, daily challenge, world play), a public-facing "how rewards work" screen in the app, and a fully transparent description of rules that exactly matches the backend logic.

The long-term goal is a reward system that is:
- **Transparent** — children, parents, and teachers can understand why a reward was earned
- **Consistent** — the same rules apply in every mode, every time
- **Fair** — no hidden penalties, no pay-to-win, same rules for everyone
- **Tied to learning quality** — rewards reflect understanding, not just volume

---

## A Real Example: Emma's Saturday Morning

Emma is 10 years old, on a 7-day streak. She opens Jogg Mini and heads to Data Valley (Medium difficulty).

| Q | Difficulty | Result | Time Used | Hint? | XP | Stars |
|---|-----------|--------|-----------|-------|-----|-------|
| 1 | Medium | ✅ | 8s of 30s | No | 14 + 7 = **21** | ⭐⭐⭐ |
| 2 | Medium | ✅ | 15s of 30s | No | 14 + 3 = **17** | ⭐⭐ |
| 3 | Hard | ❌ | 30s of 30s | — | **0** | — |
| 4 | Hard | ✅ | 12s of 30s | Yes | (18+9)×0.5 = **14** | ⭐⭐ |
| 5 | Medium | ✅ | 5s of 30s | No | 14 + 10 = **24** | ⭐⭐⭐ |
| 6 | Medium | ✅ | 22s of 30s | No | 14 + 1 = **15** | ⭐ |
| 7 | Hard | ✅ | 18s of 30s | No | 18 + 7 = **25** | ⭐⭐ |
| 8 | Medium | ✅ | 10s of 30s | No | 14 + 8 = **22** | ⭐⭐⭐ |

**Total XP: 138 | Stars: 15 | Accuracy: 87.5%**

Emma's streak ticks to Day 8. She's 12 XP away from Level 14 (Tin tier). She'll be back tomorrow.

---

## The Bigger Picture

XP in Jogg Mini isn't just about making children feel good. It's designed to reward the specific behaviours that produce real learning: engaging regularly, attempting harder material, thinking quickly and confidently, and persisting through difficulty.

A child who reaches Silver tier in Jogg Mini hasn't just accumulated points. They've answered thousands of questions about AI and machine learning. They've read hundreds of explanations. They've built genuine vocabulary and intuition about one of the most important technologies of their lifetime.

The XP is just the trail they leave behind.

---

*MokingBird — Jogg Mini. Teach AI. One question at a time.*