Files
novafarma/docs/DEMO_TESTING_GUIDE.md
2026-01-20 01:05:17 +01:00

4.5 KiB

🎮 DEMO TESTING GUIDE

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


🚀 HOW TO RUN ENHANCED DEMO:

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