Files
novafarma/FAZA_2_CHECKLIST.md

234 lines
5.5 KiB
Markdown

# FAZA 2: Igralec in Gibanje - Checklist
**Status:** ✅ PRIPRAVLJEN ZA TESTIRANJE
**Datum:** 2025-12-06
---
## ✅ Opravila (Developer)
- [x] Kreacija TextureGenerator (proceduralni pixel art)
- [x] Generacija player sprite (32x32px)
- [x] Implementacija Player entitete
- [x] WASD gibanje (grid-based)
- [x] Smooth movement (tween animacija)
- [x] Walking animacija (4 frame-i)
- [x] Depth sorting za igralca
- [x] Kolizija z robovi mape
- [x] Camera follow igralcu
- [x] Posodobitev GameScene za player support
- [x] Posodobitev UI (naslov, kontrole)
- [x] Debug info (player pozicija)
**VSE OPRAVILA ZAKLJUČENA**
---
## 🧪 Ročno testiranje (Naročnik)
### Test 1: Player Spawn
**Ukaz:** `npm start` → pritisni SPACE v menu
**Pričakovani rezultat:**
- [ ] Igralec se pojavi na sredini mape (grid 50,50)
- [ ] Igralec je pixel art karakter (farmer s klobukom)
- [ ] Barve: Bež klobuk, zelena srajca, rjave hlače
- [ ] Velikost: 32x32px
- [ ] Igralec je viden NA terenu (ne za terenom)
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 2: WASD Gibanje
**Ukazi:** W (gor), A (levo), S (dol), D (desno)
**Pričakovani rezultat:**
- [ ] W - igralec se premakne "north-west" (isometric)
- [ ] S - igralec se premakne "south-east" (isometric)
- [ ] A - igralec se premakne "south-west" (isometric)
- [ ] D - igralec se premakne "north-east" (isometric)
- [ ] Gibanje je smooth (tween animacija ~200ms)
- [ ] En pritisk = en tile premik
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 3: Walking Animacija
**Ukaz:** Drži WASD tipko
**Pričakovani rezultat:**
- [ ] Med gibanjem se predvaja walking animacija
- [ ] Animacija ima 4 frame-e
- [ ] Noge se gibljejo (leva, desna)
- [ ] Ko se ustavi, se vrne v idle pose (frame 0)
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 4: Depth Sorting
**Ukaz:** Premi igralca po različnih delih mape
**Pričakovani rezultat:**
- [ ] Igralec je vedno narisan PRED tile-i pod njim
- [ ] Igralec je vedno narisan ZA tile-i pred njim
- [ ] Pri gibanju se depth pravilno posodablja
- [ ] Nobenih graphical glitch-ov
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 5: Kolizija z Robovi
**Ukaz:** Premi igralca do robov mape
**Pričakovani rezultat:**
- [ ] Igralec ne more iti preko severnega roba (grid y = 0)
- [ ] Igralec ne more iti preko južnega roba (grid y = 99)
- [ ] Igralec ne more iti preko zahodnega roba (grid x = 0)
- [ ] Igralec ne more iti preko vzhodnega roba (grid x = 99)
- [ ] Ko pritisne W/A/S/D pri robu, se NE premakne
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 6: Camera Follow
**Pričakovani rezultat:**
- [ ] Kamera sledi igralcu
- [ ] Smooth camera movement (ne trga)
- [ ] Igralec je vedno v centru pogleda
- [ ] Ko se igralec premakne, se kamera prilagodi
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 7: Zoom Kontrole
**Ukazi:** Q (zoom in), E (zoom out), Mouse Wheel
**Pričakovani rezultat:**
- [ ] Q povečuje zoom (igralec postane večji)
- [ ] E zmanjšuje zoom (igralec postane manjši)
- [ ] Mouse wheel deluje enako
- [ ] Zoom range: 0.3x - 2.0x
- [ ] Camera follow še vedno deluje pri zoom-u
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 8: UI in Debug Info
**Pričakovani rezultat:**
- [ ] Naslov: "FAZA 2: Igralec in Gibanje" (zelena, zgoraj)
- [ ] Kontrole info (desno zgoraj):
- "WASD - Gibanje igralca"
- "Q/E - Zoom"
- "Mouse Wheel - Zoom"
- [ ] Debug info (levo zgoraj):
- Zoom vrednost
- Player Grid pozicija (50, 50 na začetku)
- Player Screen pozicija
- [ ] FPS counter (spodaj levo) ~ 60 FPS
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 9: Performance
**Pričakovani rezultat:**
- [ ] FPS: 55-60 pri počitku
- [ ] FPS: 50+ med gibanjem
- [ ] Smooth gibanje brez stutterja
- [ ] Walking animacija smooth
- [ ] Brez lag-a pri depth sorting
**Status:** ⏳ ČAKA NA TESTIRANJE
---
### Test 10: Vizualna Kvaliteta Igralca
**Pričakovani rezultat:**
- [ ] Pixel art je čist (brez blurringa)
- [ ] Klobuk, srajca, hlače so jasno vidni
- [ ] Črne outlines so vidne
- [ ] Oči so vidne (2 črni piksli)
- [ ] Roke so vidne (ob straneh)
- [ ] Noge so vidne (2 ločeni)
**Status:** ⏳ ČAKA NA TESTIRANJE
---
## 📋 Potrditev Naročnika
```
FAZA 2: [STATUS]
- Testirano: [DA/NE]
- Datum testiranja: ___________
- Opombe:
- Test 1: [✅/❌]
- Test 2: [✅/❌]
- Test 3: [✅/❌]
- Test 4: [✅/❌]
- Test 5: [✅/❌]
- Test 6: [✅/❌]
- Test 7: [✅/❌]
- Test 8: [✅/❌]
- Test 9: [✅/❌]
- Test 10: [✅/❌]
ODOBRENO ZA FAZO 3: [DA/NE]
Podpis naročnika: _____________
```
---
## 🚨 V primeru težav
### Težava: Igralec se ne prikaže
**Rešitev:**
- Preveri konzolo (F12) za error-je
- Če vidiš "TextureGenerator is not defined", reload (Ctrl+R)
- Preveri da je igralec na správnem depth-u (ne za terenom)
### Težava: WASD ne deluje
**Rešitev:**
- Preveri da ima okno focus
- Poskusi klikniti v igro pred pritiskom WASD
- Preveri da kamera follow ne blokira input-a
### Težava: Walking animacija ne deluje
**Rešitev:**
- To je normalno - animacija je zelo subtilna (pixel art)
- Preveri FPS - če je nizek, animacija morda ne deluje
### Težava: Igralec gre skozi robove
**Rešitev:**
- To je bug - javi v konzoli grid pozicijo igralca
- Check bi moral biti: gridX >= 0 && gridX < 100
### Težava: FPS prenizek
**Rešitev:**
- S 10,000 tile-ov + player je FPS lahko 40-50
- To je sprejemljivo za testiranje
---
## ➡️ Naslednji koraki (po odobritvi)
Ko naročnik potrdi FAZO 2, se začne:
**FAZA 3: NPC-ji in Dekoracije**
- NPC entitete (3 NPC-ji)
- Random walk AI
- Okrasni elementi (rože, grmičevje)
- Parallax dekoracije (oblaki, ptice)