# 🎮 DEMO TESTING GUIDE

**Date:** 3. Januar 2026 @ 19:37  
**Status:** ✅ READY TO TEST

---

## 🚀 HOW TO RUN ENHANCED DEMO:

### Option 1: Change Boot Scene (Recommended)
1. Open: `src/scenes/BootScene.js`
2. Find line: `this.scene.start('GameScene');`
3. Change to: `this.scene.start('DemoSceneEnhanced');`
4. Refresh Electron app (or type `rs` in terminal)

### Option 2: Console Command
1. Open browser console (F12)
2. Type: `game.scene.start('DemoSceneEnhanced');`
3. Press Enter

---

## ✨ NEW FEATURES IN ENHANCED DEMO:

### 1. 💎 LOCKET MEMORY TRIGGER
- **Location:** Near player spawn (glowing in grass)
- **Action:** Walk over it to pick up
- **Effect:** 
  - Screen flash
  - Memory flashback overlay
  - Story text about mama
  - Added to inventory

### 2. 🌾 4-STAGE WHEAT GROWTH
- **Style 30:** Proper botanical style with gradients!
- **Stages:**
  1. Seeds in soil (brown)
  2. Young sprout (green)
  3. Growing plant (larger)
  4. Ready to harvest! (golden, glowing)
- **Growth Time:** 10 seconds per stage
- **Total:** 30 seconds to full maturity

### 3. 💬 GRONK DIALOGUE SYSTEM
- Talk to Gronk (green NPC near barn)
- He gives quest: "Plant 5 wheat"
- Shows vape emoji 💨
- Rewards 100 gold on completion

### 4. ✅ QUEST TRACKING
- UI shows progress: "0/5 planted"
- Updates in real-time
- Completion message
- Stats screen at end

### 5. 🎉 DEMO COMPLETE SCREEN
- Shows final stats
- Wheat planted/harvested
- Gold earned
- Locket found status
- Kickstarter CTA

---

## 🎮 CONTROLS:

```
WASD     - Move player
E        - Interact / Talk / Close dialogue
1        - Select Hoe tool
2        - Select Seeds tool
MOUSE    - Use selected tool (click to plant)
```

---

## 📋 DEMO FLOW (Test Checklist):

1. ✅ **START** - Player spawns near farm plot
2. ✅ **LOCKET** - Find glowing locket, walk over it
3. ✅ **MEMORY** - Watch flashback, press E to close
4. ✅ **GRONK** - Walk to Gronk (green NPC), press E
5. ✅ **QUEST** - Get farming quest (5 wheat)
6. ✅ **TOOLS** - Press 1 (hoe), then 2 (seeds)
7. ✅ **PLANT** - Click on farm plot 5 times
8. ✅ **GROW** - Watch wheat grow (4 stages, 30s total)
9. ✅ **HARVEST** - Press E on golden wheat
10. ✅ **COMPLETE** - Return to Gronk, get reward
11. ✅ **END** - Demo complete screen!

---

## 🎨 VISUAL FEATURES:

- **Locket:** Glowing pulse animation
- **Wheat Stage 1-3:** Progressive growth
- **Wheat Stage 4:** Golden glow, ready indicator
- **Gronk:** Name label with vape emoji
- **UI:** Clean inventory, quest tracker, tool selector
- **Dialogue:** Professional dialogue boxes
- **Complete Screen:** Stats and thank you message

---

## 🐛 KNOWN ISSUES:

- Player/Gronk sprites are placeholders (colored circles)
- World is basic graphics (will add Tiled map later)
- No zombie interactions yet (they're decorative)
- No sound effects yet
- Camera zoom might need adjustment

---

## 📊 ASSETS USED:

**Demo folder (`assets/demo 🔴/`):**
- `item_locket_silver_1767464385940.png`
- `tool_hoe_rusty_1767464400663.png`
- `tool_bucket_old_1767464414881.png`
- `tool_watering_can_1767464429022.png`
- `wheat_s30_stage1_seed_1767464954800.png`
- `wheat_s30_stage2_sprout_1767464969122.png`
- `wheat_s30_stage3_growing_1767464984588.png`
- `wheat_s30_stage4_harvest_1767465000017.png`

**All Style 30 correct!** ✅

---

## 🔧 TROUBLESHOOTING:

**Problem:** Scene doesn't load
- **Fix:** Check console for errors, verify file paths

**Problem:** Assets not showing
- **Fix:** Check preload() paths match actual files

**Problem:** Wheat doesn't grow
- **Fix:** Wait 10 seconds per stage (30s total)

**Problem:** Can't pick up locket
- **Fix:** Walk directly over it (collision radius)

---

## 📝 CODE FILES:

1. `src/scenes/DemoSceneEnhanced.js` - Main demo scene
2. `index.html` - Script tag added
3. `src/game.js` - Scene registered
4. `src/scenes/BootScene.js` - Change start scene here

---

## ✅ TESTING OUTCOMES:

After testing, we should verify:
- [ ] Locket memory trigger works
- [ ] Wheat grows through all 4 stages
- [ ] Gronk dialogue flows correctly
- [ ] Quest tracking updates
- [ ] Harvest mechanic works
- [ ] Demo complete screen shows
- [ ] All UI elements visible
- [ ] No console errors

---

## 🚀 NEXT STEPS AFTER TESTING:

1. **If works:** Record demo video for Kickstarter!
2. **If bugs:** Fix and iterate
3. **Polish:** Add sound effects, better sprites
4. **Enhance:** Time system, sleep mechanics, family tree UI

---

**⏰ API RESET:** ~3 minutes (19:40)  
**Electron:** ✅ Running  
**Demo:** ✅ Ready to test!

**PRESS PLAY! 🎮**