novafarma/docs/DOLINA_SMRTI_DEMO_MASTER_PLAN.md

# 🎮 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! 🌱**