# 🎮 Kids Learning Games

Browser-based learning games for children — no installation needed, play directly in your browser!

## 🎯 Games

### ⚔️ **Tristan's Quest Academy** (Grade 7)
A Roblox-style fantasy RPG with quests, boss battles, and an XP/leveling system.

**Features:**
- 5 learning zones (Deutsch, English, Math, Science, Geography)
- Multiple-choice quests based on real curriculum
- Boss battles with dramatic questions
- XP-based leveling system (Level 1-50)
- Automatic save with localStorage
- Works offline!

👉 **[Play Tristan's Quest Academy](./tristan-quest-academy.html)**

### 🏡 **Annabel's Lerndorf** (Grade 5)
A colorful Toca-Boca-style village game with mini-games — no pressure, pure fun!

**Features:**
- 5 houses with different mini-games
- Drag-and-drop word sorting (German)
- Fraction puzzles (Math)
- Vocabulary matching (English)
- Animal cards (Natural Sciences)
- Countries quiz (Geography)
- Star collection system (positive reinforcement)
- Completely stress-free learning

👉 **[Play Annabel's Lerndorf](./annabel-lerndorf.html)**

## 🚀 How to Play

### Option 1: Direct from GitHub (Recommended for Cloudflare Pages)
Simply click the game links above or open the `.html` files directly in your browser.

### Option 2: Local Download
1. Download the `.html` files
2. Double-click to open in your browser
3. Enjoy! 🎉

## 💾 Save Game Data

Both games use browser `localStorage` to automatically save progress:
- **Tristan's Game:** Saves level, XP, and completed quests
- **Annabel's Game:** Saves collected stars

**No account needed!** Data is stored locally on your device.

## 📱 Compatibility

- ✅ Chrome, Safari, Firefox, Edge
- ✅ Desktop, Tablet, Mobile
- ✅ Completely offline (except Google Fonts fallback)
- ❌ Internet Explorer (outdated)

## 🛠 Technical Details

- **Framework:** Pure HTML5 + CSS3 + Vanilla JavaScript
- **Dependencies:** Google Fonts (fallback fonts included)
- **Storage:** Browser localStorage
- **Size:** ~30KB per game
- **License:** Educational use

## 📚 Curriculum

Games are based on German curriculum (RLP):
- **Grade 5 (Annabel):** Basic vocabulary, fractions, grammar, animals, geography
- **Grade 7 (Tristan):** Advanced grammar, tenses, passive voice, argumentation

## 🎨 Design Philosophy

- **Tristan:** Roblox-style visuals, motivating XP system, challenge-focused
- **Annabel:** Toca-Boca-style visuals, stress-free, playful exploration

## 💡 For Parents

### Tristan's Game
- **Duration:** 20-30 min per session
- **Best for:** Daily learning with progression tracking
- **Motivation:** Visible level-up system

### Annabel's Game
- **Duration:** 5-10 min per session
- **Best for:** Fun breaks during homework
- **Motivation:** Star collection, zero pressure

## 📖 Full Documentation

See [README-Spiele.md](./README-Spiele.md) for detailed instructions in German.

## 🆘 Troubleshooting

**Game won't load?**
- Refresh browser (F5)
- Check JavaScript is enabled
- Try a different browser

**Save data lost?**
- Private browsing mode prevents saving — disable it
- Check browser storage limits

**Offline not working?**
- Games are 100% offline, but Google Fonts load online
- Fonts will fall back if offline

## 🚀 Deployment

Deployed on **Cloudflare Pages** — fast, reliable, global CDN.

## 📝 License

Created for educational purposes. Free to use and distribute.

---

**Last Updated:** 2026-04-18  
**Version:** 1.0

Enjoy learning! 🎮✨