Files
novafarma/docs/planning/FAZA_2_CHECKLIST.md
2025-12-12 13:48:49 +01:00

5.5 KiB

FAZA 2: Igralec in Gibanje - Checklist

Status: PRIPRAVLJEN ZA TESTIRANJE

Datum: 2025-12-06


Opravila (Developer)

  • Kreacija TextureGenerator (proceduralni pixel art)
  • Generacija player sprite (32x32px)
  • Implementacija Player entitete
  • WASD gibanje (grid-based)
  • Smooth movement (tween animacija)
  • Walking animacija (4 frame-i)
  • Depth sorting za igralca
  • Kolizija z robovi mape
  • Camera follow igralcu
  • Posodobitev GameScene za player support
  • Posodobitev UI (naslov, kontrole)
  • 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)