184 lines
4.5 KiB
Markdown
184 lines
4.5 KiB
Markdown
# 🎮 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! 🎮**
|