# 🎮 AVTOMATSKI GENERACIJSKI SISTEM - COMPLETE GUIDE

**Datum:** 2026-01-02  
**Status:** 🔧 READY (čaka na quota approval)  
**Verzija:** V3 - Spritesheet Support

---

## 🎯 SISTEM ZAHTEVE (FIKSANO)

### **✅ 1. STIL: STYLE 32 ZA VSE (razen rastlin)**

**Uporablja se za:**
- Karakterji (Kai, Ana, Gronk, S usi)
- Zombiji in kreature
- Dinozavri
- Živali
- NPCji
- Zgradbe in orodja

**Specifikacije Style 32:**
- ✅ **Debeli črni robovi** (2-3px bold black outlines)
- ✅ **Chibi proporci** (glava = 1/3 višine telesa)
- ✅ **Pastel-gothic barve** (dusty pink, muted purple, cream, soft gray + noir shadows)
- ✅ **Veliki izraziti očki** (1/4 obraza)
- ✅ **Contradiction aesthetic** (cute + dark)

**Style 30 SAMO za:**
- Rastline (sadje, zelenjava, drevesa, rože, ganja)

---

### **✅ 2. ANIMACIJE: COMPLETE SPRITESHEETS**

**Vsaka kreatura dobi:**

**IDLE (2 frames):**
- Mirovanje, rahlo dihanje

**WALK (4 smeri × 4 frames = 16 frames):**
- walk_south (proti kameri)
- walk_north (stran od kamere) 
- walk_east (desno)
- walk_west (levo)

**ATTACK (3 frames):**
- Napadalna animacija

**= 21 frame-ov na kreaturo!**

---

### **✅ 3. STARDEW VALLEY STIL ANIMACIJ**

**Hopping gait:**
- Ne realistično hojenje
- "Hop" stil (skok-ko-rak)
- 4-frame cikel

**Pixel-perfect:**
- Jasne, čiste linije
- Prepoznavne silhuete
- Konsistentne velikosti

---

### **✅ 4. SEAMLESS TILES (za travo/tla)**

**Tiling texture:**
- Robovi 100% poravnani
- Ne vidijo se stiki
- Tile-able pattern

**Uporablja se za:**
- Grass
- Dirt
- Stone floors
- Water
- Lava

---

### **✅ 5. AUTO-SHRANJEVANJE**

**Vsak asset se avtomatsko:**
1. Generira
2. Shrani v pravilno mapo
3. Označi z ✅ v progress file
4. Logira v generation.log

**Mape:**
```
/assets/slike/
  ├── kreature/
  │   ├── zombiji/
  │   ├── dinozavri/
  │   └── zivali/
  ├── npc/
  ├── rastline/
  └── glavni_karakterji/
```

---

## 🔧 GENERATOR VERSIONS

### **V1: Basic Generator** (DEPRECATED)
- Samo posamezne slike
- Basic prompts
- ❌ Ne dela spritesheetov

### **V2: Production Generator** (CURRENT)
- Style 32/30 proper
- Detajlni prompts
- ✅ Dela posamezne slike
- ❌ Še ne podpira animacij

### **V3: Spritesheet Generator** (NEW! 🆕)
- ✅ Full spritesheet support
- ✅ Idle + Walk (4-dir) + Attack
- ✅ Stardew Valley style
- ✅ Style 32 accurate (bold outlines, chibi)
- ✅ Auto-organization
- ⏳ Čaka na quota approval

---

## 📊 PRODUKCIJSKI PLAN

### **Phase 1: Plants** ✅ COMPLETE
- 93 slik (Style 30)
- Sadje, zelenjava, ganja, drevesa, rože

### **Phase 2: Creatures & NPCs** ⏳ IN PROGRESS
- 45 entitet × 21 frames = **945 slik!**
- Zombiji, dinozavri, živali, NPC
- Style 32 spritesheets

### **Phase 3: Main Characters** 🏠 MANUAL
- Kai, Ana, Gronk, Susi
- User bo naredil ročno doma

### **Phase 4: Biomes** ⏳ PENDING
- 21 biomov × 200 assetov = 4,200 slik
- Terrain tiles (seamless)
- Props, vegetation, buildings

### **Phase 5: Items** ⏳ PENDING
- Tools, weapons, consumables
- ~3,000 slik

### **Phase 6: Effects & UI** ⏳ PENDING
- Particle effects
- UI icons, buttons
- ~2,000 slik

**TOTAL TARGET: 14,000+ slik**

---

## 🚀 KO QUOTA BO ODOBRENA

**Run V3 Generator:**
```bash
python3 /Users/davidkotnik/repos/novafarma/scripts/spritesheet_generator_v3.py
```

**Monitor progress:**
```bash
tail -f /Users/davidkotnik/repos/novafarma/spritesheet_generation.log
```

**Check progress file:**
```bash
cat /Users/davidkotnik/repos/novafarma/.spritesheet_progress.json
```

---

## 📋 SPRITESHEET PRIMER

**Zombie Basic - Complete Set:**

```
zombie_basic_idle.png              (2 frames)
zombie_basic_walk_south.png        (4 frames)
zombie_basic_walk_north.png        (4 frames)
zombie_basic_walk_east.png         (4 frames)
zombie_basic_walk_west.png         (4 frames)
zombie_basic_attack.png            (3 frames)
```

**= 21 slik za enega zombija!**

**× 3 zombie variante = 63 slik samo za zombije!**

---

## 🎨 STYLE 32 CHECKPOINT

**Vsaka slika MORA imeti:**
- ☑️ Bold black outlines (2-3px)
- ☑️ Chibi proportions (glava 1/3 telesa)
- ☑️ Pastel-gothic colors
- ☑️ Big expressive eyes
- ☑️ Smooth gradients
- ☑️ Cute + dark contradiction
- ☑️ Chroma green background (#00FF00)

**Če slika nima tega = REGENERATE!**

---

## 📝 NEXT STEPS

**1. POČAKAJ NA QUOTA APPROVAL** ⏳
   - Google pregleduje request
   - 24-48 ur timeline

**2. KO JE APPROVED:**
   - Run V3 generator
   - Generira vse spritesheete
   - Auto-organizes

**3. QUALITY CHECK:**
   - Preveri Style 32 accuracy
   - Preveri animation smoothness
   - Fix any issues

**4. COMMIT:**
   - Git add vse nove slike
   - Commit z opisom
   - Push to repo

---

## 🔥 PRODUCTION RATE (po approval)

**S povečano quota (1000/min):**
- ~500 slik na uro
- ~12,000 slik na dan
- **VSE 14k slik v 2-3 dneh!** 🚀

**Brez povečanja (60/min):**
- ~30 slik na uro
- ~720 slik na dan
- 14k slik v ~20 dneh

---

**STATUS: Vse je ready, čakamo samo na Google quota approval!** ⏳🎮