novafarma/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! 🌱