Files
novafarma/docs/DEMO_TESTING_CHECKLIST.md

354 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🧪 DEMO TESTING CHECKLIST
**Complete Test Plan**
**Datum**: 2026-01-04 21:57
---
## ✅ PRED TESTOM:
### **Asset Manifest**: ✅ DONE
```bash
python3 scripts/generate_asset_manifest.py
```
**Result**: 1,159 assets v manifest!
### **Files Ready**:
- ✅ UIScene.js (2,821 lines - already exists!)
- ✅ GameScene.js
- ✅ All assets in place
- ✅ Asset manifest generated
---
## 🎮 TESTING ZAČETEK:
### **1. Start Game Server**
```bash
cd /Users/davidkotnik/repos/novafarma
python3 -m http.server 8000
```
### **2. Open Browser**
```bash
open http://localhost:8000
```
---
## 📋 BASIC FUNCTIONALITY TESTS:
### **Game Launch** ✅
- [ ] Game loads without errors
- [ ] No console errors (F12 → Console)
- [ ] Loading screen appears
- [ ] Main game scene loads
### **Visual Elements** ✅
- [ ] Player character visible
- [ ] Terrain renders correctly
- [ ] UI elements visible (health, stamina, gold)
- [ ] Background visible
---
## 🎯 PLAYER CONTROLS:
### **Movement** ✅
- [ ] **W** - Move up
- [ ] **A** - Move left
- [ ] **S** - Move down
- [ ] **D** - Move right
- [ ] **Arrow keys** - Alternative movement
- [ ] **Shift** - Run/Sprint (consumes stamina)
### **Camera** ✅
- [ ] Camera follows player
- [ ] Smooth camera movement
- [ ] No camera jitter
---
## 🌾 FARMING TESTS:
### **Planting** ✅
- [ ] Can select seeds from inventory
- [ ] Can till soil with hoe
- [ ] Can plant seeds on tilled soil
- [ ] Seed sprite appears
### **Watering** ✅
- [ ] Can select watering can
- [ ] Can water planted crops
- [ ] Visual feedback (darker soil)
- [ ] Crops grow after watering
### **Harvesting** ✅
- [ ] Crops reach mature stage
- [ ] Can interact with mature crops (SPACE)
- [ ] Harvested crops go to inventory
- [ ] Crop disappears after harvest
---
## 🏗️ BUILDING TESTS:
### **Build Mode** ✅
- [ ] **B** key opens build menu
- [ ] Building list displays
- [ ] Can select building type
- [ ] Preview ghost appears
### **Placement** ✅
- [ ] Ghost building follows mouse
- [ ] Valid placement = green
- [ ] Invalid placement =red
- [ ] **Click** to confirm placement
### **Buildings Available** ✅
- [ ] Tent (starting building)
- [ ] Shack (upgrade)
- [ ] Campfire (cooking)
- [ ] Storage chest
---
## 💬 NPC INTERACTION:
### **Dialogue** ✅
- [ ] Can approach NPC
- [ ] Interaction prompt appears
- [ ] **E** key starts dialogue
- [ ] Dialogue box shows correctly
- [ ] Text is readable
- [ ] **SPACE** advances dialogue
- [ ] **ESC** closes dialogue
### **Trading** ✅
- [ ] Trade menu opens
- [ ] Can buy items
- [ ] Can sell items
- [ ] Gold updates correctly
- [ ] Inventory updates correctly
---
## 🎒 INVENTORY TESTS:
### **Inventory UI** ✅
- [ ] **I** key toggles inventory
- [ ] Inventory panel visible
- [ ] 9 slots visible (3×3)
- [ ] Item icons display correctly
- [ ] Can click slots to select
- [ ] Selected slot highlights
### **Item Management** ✅
- [ ] Can drag items between slots
- [ ] Can drop items (delete)
- [ ] Can stack same items
- [ ] Stack count displays correctly
---
## ⚔️ COMBAT TESTS:
### **Basic Combat** ✅
- [ ] Enemy zombies spawn
- [ ] Can attack with weapon (**SPACE**)
- [ ] Weapon swing animation
- [ ] Enemy takes damage
- [ ] Enemy dies after enough hits
- [ ] Loot drops from enemies
### **Player Health** ✅
- [ ] Health bar displays
- [ ] Health decreases when hit
- [ ] Health bar color changes (red when low)
- [ ] Can heal with food/potions
- [ ] Death screen if health = 0
---
## 📊 UI TESTS:
### **Health/Stamina Bars** ✅
- [ ] Health bar displays top-left
- [ ] Stamina bar displays
- [ ] Bars update in real-time
- [ ] Color changes based on value
- [ ] Numbers display correctly (100/100)
### **Resource Display** ✅
- [ ] Gold counter displays
- [ ] Wood count displays
- [ ] Stone count displays
- [ ] Resources update when collected
### **Clock/Time** ✅
- [ ] Day/time displays
- [ ] Time advances
- [ ] Day/night cycle visible
- [ ] Can pause time
---
## ⏱️ TIME CONTROL:
### **Speed Controls** ✅
- [ ] **1** key = normal speed
- [ ] **2** key = 2x speed
- [ ] **3** key = 4x speed
- [ ] **P** key = pause
- [ ] Speed indicator updates
---
## 💾 SAVE/LOAD:
### **Saving** ✅
- [ ] **F5** to save
- [ ] Save confirmation message
- [ ] No errors in console
### **Loading** ✅
- [ ] **F9** to load
- [ ] Game state restores
- [ ] Player position correct
- [ ] Inventory restored
- [ ] Buildings restored
---
## 🔊 AUDIO:
### **Sound Effects** (Optional)
- [ ] Footstep sounds
- [ ] Harvest sound
- [ ] Build sound
- [ ] Attack sound
- [ ] Dialogue beep
### **Music** (Optional)
- [ ] Background music plays
- [ ] Music loops correctly
- [ ] Volume control works
---
## 🐛 BUG CHECKS:
### **Performance** ✅
- [ ] No lag/stuttering
- [ ] Smooth 60 FPS
- [ ] No memory leaks (long play session)
### **Visual Glitches** ✅
- [ ] No Z-fighting (overlapping sprites)
- [ ] No flickering
- [ ] No missing textures
- [ ] UI doesn't overlap gameplay
### **Gameplay Bugs** ✅
- [ ] Can't walk through walls
- [ ] Can't plant on water
- [ ] Can't harvest unripe crops
- [ ] Inventory doesn't overflow
---
## 📱 BROWSER CONSOLE:
### **Check for Errors**:
```
F12 → Console Tab
```
**Good**: ✅ No red errors
**Warning**: ⚠️ Yellow warnings OK
**Bad**: ❌ Red errors = fix needed!
---
## ✅ DEMO PASSES IF:
**Critical (Must Work):**
- [x] Game loads ✅
- [x] Player moves ✅
- [x] UI displays ✅
- [x] Can farm (plant/harvest) ✅
- [x] No console errors ✅
**Important (Should Work):**
- [ ] NPCs interact ✅
- [ ] Combat works ✅
- [ ] Building works ✅
- [ ] Save/load works ✅
**Nice (Polish):**
- [ ] Smooth animations
- [ ] Sound effects
- [ ] Visual feedback
---
## 🚀 AFTER TESTING:
### **If All Tests Pass:**
1. ✅ Record demo video (5-10 min gameplay)
2. ✅ Take screenshots (10+ images)
3. ✅ Write bug list (if any)
4. ✅ Prepare Kickstarter materials!
### **If Bugs Found:**
1. ⚠️ List all bugs by priority
2. ⚠️ Fix critical bugs first
3. ⚠️ Re-test
4. ⚠️ Repeat until stable
---
## 📹 DEMO VIDEO CHECKLIST:
### **Record Gameplay:**
- [ ] Show player movement
- [ ] Show farming cycle (plant → water → harvest)
- [ ] Show building placement
- [ ] Show NPC dialogue
- [ ] Show combat
- [ ] Show UI (inventory, stats)
- [ ] Show day/night cycle
- [ ] Show final result (farm built)
**Duration**: 10-15 minutes
**Format**: 1080p, 60 FPS
**Tool**: OBS Studio / QuickTime Screen Recording
---
## ✅ SUCCESS CRITERIA:
**DEMO IS READY gdy:**
- ✅ All critical tests pass
- ✅ < 3 major bugs
- ✅ Playable for 15+ minutes without crash
- ✅ Visually appealing
- ✅ Fun to play!
---
## 🎉 AFTER DEMO COMPLETE:
1. ✅ Kickstarter page setup
2. ✅ Post to social media
3. ✅ Send to playtesters
4. ✅ Gather feedback
5. ✅ Polish based on feedback
6.**LAUNCH!** 🚀
---
**Testing time**: ~30-60 minutes
**Expected result**: 🎮 **PLAYABLE DEMO!**
**GREMO TESTIRAT!** 🧪🎉