novafarma/DEMO_TESTING_GUIDE.md

🎮 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! 🎮