docs: Faza 1 & 2 Production Plan - 1,152 sprites ready

This commit is contained in:
2026-01-04 22:10:51 +01:00
parent bdb57588ed
commit 98fc9fdce9
4 changed files with 2201 additions and 1030 deletions

View File

@@ -0,0 +1,353 @@
# 🧪 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!** 🧪🎉