Files
novafarma/docs/DOLINA_SMRTI_DEMO_MASTER_PLAN.md
2026-01-20 01:05:17 +01:00

13 KiB
Raw Permalink Blame History

🎮 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:

  1. Generate Base upgrades (12 frames)
  2. Generate Campfire (4 frames)
  3. Generate Zombie grave system (8 frames)

Integration:

  1. Organize all assets into Phaser 3 spritesheets
  2. Implement day/night cycle logic
  3. Test zombie sleep/wake mechanic
  4. 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! 🌱