ok

2026-01-20 01:05:17 +01:00
parent e4d01bc480
commit cbb2b64f92
5846 changed files with 1687 additions and 4494 deletions
--- a/docs/DOLINA_SMRTI_DEMO_MASTER_PLAN.md
+++ b/docs/DOLINA_SMRTI_DEMO_MASTER_PLAN.md
@@ -0,0 +1,544 @@
+# 🎮 DOLINA SMRTI - DEMO MASTER PLAN
+## (Finalna Specifikacija za Google Antigravity)
+
+**Stil:** Style 32 (Dark-Chibi Noir)  
+**Optimizacija:** ADHD-Optimized Gameplay  
+**Cilj:** Prvi igralni demo s popolnoma doslednim vizualnim stilom  
+**Status:** ✅ Character References LOCKED | 🚧 Production Active  
+
+---
+
+## I. GLOBALNE SISTEMSKE NAVODILA ZA AGENTA
+
+### 🎨 STYLE 32: DARK-CHIBI NOIR (VIZUALNI ZAKON)
+
+**Agent, to je tvoj ZAVEZUJOČI stil za VSE generacije. Če asset ne ustreza tem kriterijem, ga zavrzi in regeneriraj!**
+
+#### **Obvezne Specifikacije:**
+
+1. **OBROBA (4-5px):**
+   - Debel, trden črn rob okoli VSEGA
+   - Brez tankih, mehkih ali nepopolnih linij
+   - Konsistentna debelina po celotnem objektu
+
+2. **PROPORCI (Chibi):**
+   - Glave so **40-50% višine telesa**
+   - Telesa majhna, kompaktna
+   - Izrazita ušesa (za antropomorfne like)
+   - Roke/noge kratke, zaobljene
+
+3. **BARVE (Flat/Noir):**
+   - **SAMO ravne ploskve barv**
+   - PREPOVEDANO: soft senčenje, gradienti, kompleksni prelivi
+   - Sence so **ostre, temne noir bloke** (črne/temno vijolične)
+   - Jasno definirane svetlobe/sence
+
+4. **OČI (Natančno določene):**
+   - **Živi Liki** (Kai, Gronk, NPC-ji):
+     - Velike oči z **IZRAZITIMI ČRNIMI ZENICAMI**
+     - Izgledajo živo, imajo osebnost
+   - **Zombiji:**
+     - Oči **BREZ ZENIC** (prazne)
+     - **V Temi/Noči:** Svetleče BELE oči
+     - **Na Svetlobi/Dnevi:** Svetleče RDEČE oči
+
+5. **OZADJE:**
+   - Vedno **CHROMA GREEN (#00FF00)**
+   - Omogoča enostavno izrezovanje
+
+6. **DREADLOCKS (Pri Kai-u in Gronku):**
+   - **Kai:** Pink in green dreadlocks
+   - **Gronk:** Pink dreadlocks
+   - **Fizika:** Bounse gor pri skoku, dol pri pristanku
+   - Gentle sway pri idle animaciji
+
+---
+
+## II. ANIMACIJSKI PROTOKOL (Stardew Valley Standard)
+
+### **Za Vsakega NPC-ja/Kreaturo:**
+
+1. **4-Smerni 'Hop' Premik:**
+   - Down, Up, Left, Right
+   - Stardew Valley stil bounce
+   - 8 frames per direction
+
+2. **Idle Animacija:**
+   - 6 frames za breathing/swaying
+   - Dreadlocks gentle movement
+   - Loop seamlessly
+
+3. **Akcija:**
+   - Napad/Interakcija/Spanje
+   - 6-8 frames odvisno od akcije
+   - Wind-up → Action → Recovery
+
+### **Po Končanem Paketu:**
+- Shrani v ustrezen folder
+- Dodaj zeleno kljukico ✅ v checklist
+- Git commit: "✅ [Character/Asset Name] COMPLETE"
+
+---
+
+## III. 🔒 LOCKED CHARACTER REFERENCES
+
+**Lokacija:** `/assets/MASTER_REFS/`
+
+| Character | File | Details |
+|-----------|------|---------|
+| **Kai** | `ref_kai.png` | Pink + green dreadlocks, piercings, gauges, RED eyes WITH pupils |
+| **Gronk** | `ref_gronk.png` | Pink dreadlocks, piercings, **BOX-MOD VAPE**, gauges, tactical gear |
+| **Ana** | `ref_ana.png` | Pink/magenta hair, tactical vest, **Kai's twin sister** |
+| **Susi** | `ref_susi.png` | Baby dino, pink collar, cute features |
+| **Zombie** | `ref_zombie.png` | Base za VSE zombie variante, matted dreads, NO pupils |
+
+**PRAVILO:** Agent **NE SME** generirati novih obrazov - samo premikaj okončine teh odobrenih modelov!
+
+---
+
+## IV. ELEMENTI DEMOJA (Ukazi za Generacijo)
+
+### 🧑 **A. GLAVNI LIK: KAI**
+
+**Lokacija:** `assets/animations/kai/`
+
+**Animacije:**
+- ✅ Idle (3 frames: down, up, right) - DONE
+- ✅ Walk (12 frames: 4 per direction) - DONE
+- ✅ Work Actions (9 frames: axe, pickaxe, hoe) - DONE
+- **Portraits:** 5 emocij (neutral, happy, sad, angry, surprised)
+
+**Style:** Style 32, z zenicami, pink/green dreads
+
+---
+
+### 🧟 **B. ZOMBIJI (Modularni Sistem)**
+
+**Base Zombie:** `assets/animations/zombies/base/`
+- ✅ Idle (3 frames: down, up, right) - DONE
+- ✅ Walk (4 frames: down) - DONE  
+- ✅ Dig (4 frames) - DONE
+- ✅ Transform (1 frame - "poof" pose) - DONE
+
+**Worker Roles:** 4 × 10 frames vsak
+
+1. **GARDENER (Vrtnar):** ✅ DONE
+   - Dirty apron, gardening gloves, small shovel
+   - Plant, water, harvest animations
+   - Lokacija: `assets/animations/zombies/gardener/`
+
+2. **MINER (Rudar):** ✅ DONE
+   - Hard hat with light, dusty overalls, pickaxe
+   - Swing, carry ore, deposit animations
+   - Lokacija: `assets/animations/zombies/miner/`
+
+3. **LUMBERJACK (Drvar):** ✅ DONE
+   - Flannel shirt, suspenders, axe
+   - Chop, carry log, drop animations
+   - Lokacija: `assets/animations/zombies/lumberjack/`
+
+4. **SCAVENGER (Iskalec):** ✅ DONE
+   - Hooded jacket, backpack, scavenging tools
+   - Search, collect, empty backpack animations
+   - Lokacija: `assets/animations/zombies/scavenger/`
+
+**Transformation Mechanic:**
+- "Poof" effect (3 frames pastel smoke)
+- Instant costume change (same body/face)
+- Keeps ref_zombie.png base
+
+---
+
+### 🏠 **C. OSNOVNA BAZA (Progresivna Nadgradnja)**
+
+**Lokacija:** `assets/slike/objekti/baza/`
+
+**3 Nivoji:**
+
+1. **baza_L1_sotor.png**
+   - Improviziran šotor
+   - Zakrpan, spalna vreča vidna
+   - Revščina aesthetic
+
+2. **baza_L2_utica.png**
+   - Lesena utica (cabin)
+   - Osnovna skrinja
+   - Dimnik
+
+3. **baza_L3_koca.png**
+   - Zidana koča
+   - Močna vrata z ključavnico
+   - Okna
+
+**Shaking Animation:**
+- 3 frames "shake" za vsakega levela
+- Ko Kai spi (prikazuje časovni preskok)
+
+---
+
+### 🔥 **D. TABORNO OGNJIŠČE**
+
+**Lokacija:** `assets/slike/objekti/ognjisce/`
+
+**Elementi:**
+- Kamnit krog
+- Gorenje drv (center)
+- 3 frames plapolanja ognja (animated)
+
+**Funkcija:**
+- Segrevanje (temperatura mechanic)
+- Kuhanje (later)
+- Social hub point
+
+---
+
+### ⚰️ **E. ZOMBI GROB IN SPANJE**
+
+**Lokacija:** `assets/slike/kreature/zombiji/grob/`
+
+**Asseti:**
+
+1. **zombi_grob.png**
+   - Nagrobnik "RIP"
+   - Lesen križ
+   - Rahlo razkopana zemlja
+
+2. **zombi_spi.png**
+   - Zombie leži v grobu
+   - Zzz efekti (3 frames)
+   - Oči BELE (svetijo v temi)
+
+3. **zombi_prebujanje.png** (4 frames)
+   - Frame 1: Grob se trese
+   - Frame 2: Roka izleze
+   - Frame 3: Zombie se dvigne
+   - Frame 4: Oči postanejo RDEČE (na svetlobi)
+
+---
+
+### 👨‍🦲 **F. GRONK (NPC/Trader)**
+
+**Lokacija:** `assets/animations/gronk/`
+
+**Animacije:**
+- ✅ Idle (3 frames) - DONE
+- ✅ Walk (12 frames) - DONE
+- ✅ Vape (4 frames - inhale/exhale) - DONE
+- Portraits (5 emocij)
+
+**Detajli:**
+- BOX-MOD vape (velik, pravokoten)
+- Pink dreadlocks
+- Tribal tattoos
+- Piercings, gauges
+
+---
+
+### 🌿 **G. RASTLINA GANJE (Farming System)**
+
+**Lokacija:** `assets/slike/rastline/ganja/`
+
+**3 Faze Rasti:**
+
+1. **ganja_seme.png**
+   - Tiny sprout
+   - Razpokla zemlja
+
+2. **ganja_mlada.png**
+   - 2-4 listi
+   - Rastlina ~25% size
+
+3. **ganja_zrela.png**
+   - Polna rastlina
+   - Vidni cvetovi (buds)
+   - Ready za harvest
+
+**Style:** Style 30 (Garden Story botanical)
+
+---
+
+### 🦖 **H. ANA (Story Character)**
+
+**Lokacija:** `assets/animations/ana/`
+
+**Animacije:**
+- ✅ Idle (3 frames) - DONE
+- ✅ Portraits (6 emocij: neutral, happy, sad, surprised, angry, scared) - DONE
+
+**Pomembno:**
+- **Kai's twin sister**
+- Similar facial features
+- Pink/magenta hair
+- Tactical vest + gear
+
+---
+
+### 🦕 **I. SUSI (Baby Dinosaur Companion)**
+
+**Lokacija:** `assets/animations/susi/`
+
+**Animacije:**
+- ✅ Idle (2 frames: side, front) - DONE
+- ✅ Walk (4 frames side) - DONE
+- ✅ Happy (4 frames - wag/hop) - DONE
+- ✅ Sleep, Eat, Sit, Run (4 frames) - DONE
+
+**Detajli:**
+- Cute chibi proportions
+- Pink collar with tag
+- Big expressive eyes WITH pupils
+- Tiny dino tail wag
+
+---
+
+## V. DEMO FUNKCIONALNOST (ADHD Flow)
+
+### 🌙 **DAN/NOČ CIKEL**
+
+#### **DAN (Day):**
+- **Normalna svetloba**
+- **Zombiji SPIJO** v grobovih
+  - Oči BELE (svetijo v temi groba)
+  - Pasivni, ne napadajo
+- **Kai lahko:**
+  - Raziskuje svet
+  - Farma rastline
+  - Gathering resources
+  - Pogovarja z NPC-ji
+
+#### **NOČ (Night):**
+- **Barvna paleta:** Temno modre/vijolične noir tones
+- **Zombiji SE PREBUDIJO:**
+  - Izlezejo iz grobov (animation)
+  - Oči postanejo RDEČE
+  - Aktivno lovijo Kai-a
+- **Kai mora:**
+  - Skrivat se v bazi
+  - ALI: Spat (preskočit noč)
+
+---
+
+### 😴 **SPANJE (Kai)**
+
+**Ko Kai spi v:**
+- **Šotor (L1):** Basic recovery
+- **Utica (L2):** Better recovery + storage
+- **Koča (L3):** Full recovery + crafting access
+
+**Efekt:**
+- Energija se napolni
+- Zdravje regeneracija
+- Čas se hitro prevrti čez noč (time-skip animation)
+- **Stratešk izbor:** Skip dangerous nights!
+
+---
+
+### 🔥 **OGNJIŠČE MEHANIKA**
+
+**Funkcije:**
+- **Segrevanje:** Temperature mechanic (za hladne biome)
+- **Kuhanje:** Craft food items (later)
+- **Social hub:** NPC-ji se zbirajo tu (later)
+- **Save point:** Safe zone marker
+
+---
+
+### 🏗️ **UPGRADE BAZE**
+
+**Progression:**
+
+1. **Šotor → Utica:**
+   - Cost: 50× wood, 20× stone
+   - Unlocks: Storage chest (10 slots)
+
+2. **Utica → Koča:**
+   - Cost: 100× wood, 50× stone, 10× iron
+   - Unlocks: Crafting bench, bed (better sleep)
+
+**Benefits:**
+- Več prostora za shranjevanje
+- Varnost pred zombiji
+- Crafting možnosti
+- Status symbol!
+
+---
+
+### 🌱 **FARMING SISTEM**
+
+**Ganja Lifecycle:**
+
+1. **Plant:** Use hoe → till soil → place seed
+2. **Water:** Daily watering can usage
+3. **Growth:** 3 days (seme → mlada → zrela)
+4. **Harvest:** E to interact → collect buds
+
+**Uses:**
+- **Zdravljenje:** +20 HP
+- **Trgovanje:** Trade z Gronkom za items
+- **Krepitev:** Temporary stat boost
+
+---
+
+## VI. 📂 FOLDER ORGANIZATION
+
+```
+/assets/
+├── MASTER_REFS/              ✅ LOCKED
+│   ├── ref_kai.png
+│   ├── ref_gronk.png
+│   ├── ref_ana.png
+│   ├── ref_susi.png
+│   ├── ref_zombie.png
+│   └── README.md
+│
+├── animations/
+│   ├── kai/                  ✅ 25 frames DONE
+│   │   ├── idle/
+│   │   ├── walk/
+│   │   └── work/
+│   │
+│   ├── gronk/                ✅ 20 frames DONE
+│   │   ├── idle/
+│   │   ├── walk/
+│   │   └── vape/
+│   │
+│   ├── ana/                  ✅ 9 frames DONE
+│   │   ├── idle/
+│   │   └── portraits/
+│   │
+│   ├── susi/                 ✅ 14 frames DONE
+│   │   ├── idle/
+│   │   ├── walk/
+│   │   ├── happy/
+│   │   └── actions/
+│   │
+│   └── zombies/
+│       ├── base/             ✅ 12 frames DONE
+│       ├── gardener/         ✅ 10 frames DONE
+│       ├── miner/            ✅ 10 frames DONE
+│       ├── lumberjack/       ✅ 10 frames DONE
+│       └── scavenger/        ✅ 10 frames DONE
+│
+├── slike/
+│   ├── objekti/
+│   │   ├── baza/             ⏳ PENDING (3 levels + shaking)
+│   │   └── ognjisce/         ⏳ PENDING (3 flame frames)
+│   │
+│   ├── kreature/
+│   │   └── zombiji/
+│   │       └── grob/         ⏳ PENDING (grob + sleep + wake)
+│   │
+│   └── rastline/
+│       └── ganja/            ⏳ PENDING (3 growth stages)
+│
+└── vfx/
+    └── poof/                 ⏳ PENDING (transformation effect)
+```
+
+---
+
+## VII. ✅ PRODUCTION CHECKLIST
+
+### **🎨 CHARACTER ANIMATIONS:**
+- ✅ Kai (25 frames) - €0.30
+- ✅ Gronk (20 frames) - €0.24
+- ✅ Ana (9 frames) - €0.11
+- ✅ Susi (14 frames) - €0.17
+- ✅ Zombie Base (12 frames) - €0.14
+- ✅ Zombie Gardener (10 frames) - €0.12
+- ✅ Zombie Miner (10 frames) - €0.12
+- ✅ Zombie Lumberjack (10 frames) - €0.12
+- ✅ Zombie Scavenger (10 frames) - €0.12
+
+**Subtotal:** 120 frames = **€1.44**
+
+---
+
+### **🌱 ENVIRONMENT & OBJECTS:**
+- ⏳ **Plants (15 frames):**
+  - Ganja (3 growth stages × 5 angles)
+  - Tomato (3 stages)
+  - Wheat (3 stages)
+  - **Cost:** €0.18
+
+- ⏳ **Base Upgrades (12 frames):**
+  - Šotor (1 + 3 shake)
+  - Utica (1 + 3 shake)
+  - Koča (1 + 3 shake)
+  - **Cost:** €0.14
+
+- ⏳ **Campfire (4 frames):**
+  - Base (1) + flames (3)
+  - **Cost:** €0.05
+
+- ⏳ **Zombie Grave (8 frames):**
+  - Grob (1), sleep (1), wake (4), sleep zzz (2)
+  - **Cost:** €0.10
+
+---
+
+### **✨ VFX:**
+- ⏳ **Poof Effect (3 frames):**
+  - Transformation smoke
+  - **Cost:** €0.04
+
+---
+
+## VIII. 📊 BUDGET TRACKING
+
+| Category | Frames | Cost @ €0.012 | Status |
+|----------|--------|---------------|--------|
+| Characters | 120 | €1.44 | ✅ DONE |
+| Plants | 15 | €0.18 | ⏳ NEXT |
+| Base Objects | 12 | €0.14 | ⏳ TODO |
+| Campfire | 4 | €0.05 | ⏳ TODO |
+| Zombie Grave | 8 | €0.10 | ⏳ TODO |
+| VFX Poof | 3 | €0.04 | ⏳ TODO |
+| **DEMO TOTAL** | **162** | **€1.94** | **74% DONE** |
+
+**Budget Remaining:** €166.06 (94,000+ images!)
+
+---
+
+## IX. 🚀 NEXT STEPS
+
+### **Immediate (Today):**
+1. ✅ Complete remaining character animations - **DONE!**
+2. ⏳ Generate Plant animations (15 frames)
+3. ⏳ Generate Poof effect (3 frames)
+
+### **Tomorrow:**
+4. Generate Base upgrades (12 frames)
+5. Generate Campfire (4 frames)
+6. Generate Zombie grave system (8 frames)
+
+### **Integration:**
+7. Organize all assets into Phaser 3 spritesheets
+8. Implement day/night cycle logic
+9. Test zombie sleep/wake mechanic
+10. Record demo gameplay footage
+
+---
+
+## X. 🎯 SUCCESS CRITERIA
+
+**Demo je uspešen, ko:**
+
+✅ **Visual Consistency:** VSE assets Style 32  
+✅ **Smooth Animations:** 60 FPS feel, no jank  
+✅ **Core Loop Works:** Farm → Fight → Sleep → Repeat  
+✅ **Dopamine Moments:**
+  - Satisfying combat impacts
+  - Plant growth time-lapse
+  - Level-up celebration
+  - Story hook reveal
+
+✅ **ADHD-Optimized:**
+  - Clear visual feedback
+  - Instant gratification cycles
+  - No boring waiting periods
+  - Always "next thing" visible
+
+---
+
+**🔥 GREMO NAPREJ! PLANTS NEXT! 🌱**