novafarma/nova farma TRAE/dokumentacija/DEMO_FAZA1_MASTER_SPEC.md

# 🎮 DEMO & FAZA 1 - MASTER SPECIFIKACIJA
**MRTVA DOLINA (Krvava Žetev)**

**Verzija:** 2.0 FINAL  
**Datum:** 9. Februar 2026  
**Status:** Production Reference Document

---

## 📋 KAZALO

1. [DEMO SPECIFIKACIJA](#demo-specifikacija)
2. [FAZA 1 SPECIFIKACIJA](#faza-1-specifikacija)
3. [OTOK & OKOLJE](#otok--okolje)
4. [LIKI & ZGODBA](#liki--zgodba)
5. [SISTEMI & MEHANIKE](#sistemi--mehanike)
6. [ASSETS POTREBŠČINE](#assets-potrebščine)
7. [UI & KONTROLE](#ui--kontrole)

---

# DEMO SPECIFIKACIJA

## 🏁 CILJ DEMO-JA
**Preživi 200 dni** → Achievement "Trmasti Preživeli" 🏆

## 🏝️ OKOLJE

### **Otok (Island):**
- **Velikost:** 2560 × 2560 px
- **Tile Grid:** 20 × 20 tiles @ 128px/tile
- **Oblika:** Jagged/nazobčan obod (40 vertices, 50px jitter)
- **Material:** Rjava zemlja (brown ground)
- **Centralna Luknja:** Brez tal v centru (hole)

### **Ocean:**
- **Velikost:** 10000 × 10000 px (veliko večji od otoka)
- **Barva:** #001d3d (Deep Blue)
- **Physics:** Deadly - ne moreš plavati!
- **Camera View:** Vidiš ocean okrog otoka

### **Pozicija:**
- **Island Offset:** X=3720, Y=3720 (center sveta)
- **Physics Bounds:** Samo otok (hard stop na robu)
- **Camera Bounds:** Celoten svet (10000×10000)

## 🎯 MAPA & OBMOČJE

### **Playable Area:**
- **Samo Farma:** 8×8 area na otoku
- **Fog of War:** Vse ostalo zaprto/nevidno
- **Exploration:** 0% (zaklenjeno do Faze 1)

## 🛠️ OMEJITVE

### **Bivanje:**
- ⛺ **Samo ŠOTOR** (tent)
- 🏠 **Hiša:** ZAKLENJENA (unlock v Fazi 1)
- 🔥 **Ogenj:** Campfire (za cooking)

### **Orodja:**
- 🪓 **Samo LESENA (Tier 1)**
  - Lesena Motika (Wooden Hoe)
  - Lesena Sekira (Wooden Axe)
  - Lesena Zalivalka (Wooden Watering Can)
- ⚒️ **Kovinska:** ZAKLENJENA

### **Zombiji:**
- 🧟 **Samo SHAMBLER** (basic zombie)
  - Počasni (slow)
  - Ne evolvirajo
  - Lahko jih udomačiš (Alfa Moč)
  - Max 3 zombiji naenkrat

### **Voda:**
- 💧 **VSA VODA JE STRUPENA!**
  - Reke: Dirty Water (toxic)
  - Jezera: Toxic
  - Ocean: Deadly
- 🌧️ **Čista voda:**
  - Samo deževnica (Rain Catcher)
  - Če piješ dirty water → zastrupitev
  - Če zalivaš z dirty water → mutant rastline (neuporabne za hrano)

## 🌱 KMETOVANJE

### **Posadljive Rastline:**
1. 🌾 **Pšenica (Wheat)** - 3 dni rasti
2. 🥕 **Korenje (Carrot)** - 4 dni rasti

### **Semenski:**
- **Start Inventory:** 10× Pšenica, 5× Korenje
- **Več semen:** Samo iz pridelka (harvest)

## 📦 START INVENTORY

**Kai (14 let) se prebudi z:**
- 👕 Cunje (rags)
- 🍞 Kruh (bread) × 1
- 🍎 Jabolko (apple) × 1
- 🔦 Bakla (torch) × 1
- 🌾 Semena: Pšenica × 10, Korenje × 5
- 🎒 Prazen ruksak (empty slots)

## 🎬 INTRO SEKVENCA

### **20 Polaroid Slik:**
1. "Družina (Pred Virusom)"
2. "Marko v Laboratoriju"
3. "Izbruh (Red Alert)"
4. "Kaos na Ulicah"
5. "Naš Dom (Obkoljen)"
6. "Oče se Bori"
7. "Mama Pada"
8. "Kai Ugriznjen"
9. "Ana Ugrabljena"
10. "Veliki Trol Kralj"
11. "Sam"
12. "Alfa Moč"
13. "Prvi Kontroliran Zombi"
14. "Pobeg"
15. "Potovanje"
16. "Najdena Dolina"
17. "Opuščena Kmetija"
18. "Prvi Semenski"
19. "Twin Bond"
20. "Obljuba"

### **Prebujanje:**
- Kai se prebudi v **spalni vreči** (sleeping bag)
- **Blur Effect:** Vid zamegljen (amnezija)
- **Prvi Memory Fragment:** Razjasni vid
- **Twin Bond Signal:** Čutiš Ano (šibek signal)

## 🧠 AMNEZIJA SISTEM

### **Spomini (Flashbacks):**
- **Trigger:** Bližina spominskih predmetov
- **Effect:** Screen glitch/pulse → Polaroid flash
- **Napredek:** Vsak flashback restore malo spomina

### **Memory Fragments:**
1. "Srečni Časi" (družina)
2. "Očetov Laboratorij" (virus warning)
3. "Zadnji Večerni" (Ana rojstni dan)

---

# FAZA 1 SPECIFIKACIJA

## 🚀 UNLOCK POGOJ
**Preživi 200 dni v DEMO** → Unlock Faza 1

## 🗺️ ODPRTJE SVETA

### **Fog of War:**
- ✅ **Megla se odpre!**
- 🔍 **Raziskovanje:** Aktivno
- 🧟 **Zombi Izvidnik (Scout):** KLJUČNA mehanika!

### **Nove Lokacije:**
- 🏚️ **Ruševine:** Garaža, Rastlinjak, Hlev (popravljaš jih!)
- 🏞️ **Raziskuj:** Forest, Swamp, Desert areas (začetek)
- ⛏️ **Mine:** Majhen rudnik (Baker, Coal)

## 🧟 ZOMBI IZVIDNIK (Scout)

### **Funkcija:**
- **Edini zombi** ki gre v Fog of War!
- **Scavenge:** Išče dele, material, resources
- **Avtomatski:** Pošlješ ga, vrne se čez nekaj časa

### **Najde:**
- 🔧 **Motor Delen** (za motorko)
- ⛓️ **Verige** (za laksarco)
- 🛢️ **Bencin** (fuel za motorko)
- 🪨 **Scrap Metal** (za repair)
- 📦 **Random Items** (tools, seeds)

### **Risk:**
- ⚠️ **10% chance** da ne pride nazaj (lost in fog)
- ⏰ **Čas:** 1-3 in-game days za return

## 🏚️ RUŠEVINE (Repairs, ne Building!)

### **1. Garaža (Garage):**
- **Repair Cost:**
  - 50 Wood
  - 30 Stone
  - 10 Scrap Metal
- **Time:** 2 dni
- **Unlock:** Crafting Delovna Miza (Workbench)
- **Funkcija:** Repair tools, craft vehicles

### **2. Rastlinjak (Greenhouse):**
- **Repair Cost:**
  - 40 Wood
  - 20 Glass (iz scrap)
  - 15 Stone
- **Time:** 2 dni
- **Unlock:** Advanced farming (več crop types)
- **Funkcija:** Faster growth (50% boost)

### **3. Hlev (Barn):**
- **Repair Cost:**
  - 60 Wood
  - 25 Stone
  - 5 Iron
- **Time:** 3 dni
- **Unlock:** Žival housing (prihodnji update)
- **Funkcija:** Storage + animal care

## 🔧 CRAFTING (Novi Recepti)

### **1. Motorka (Motorcycle):**
```
Potrebuješ:
- Motor × 1 (Scout najde)
- Veriga × 1 (Scout najde)
- Ohišje × 1 (Scout najde)
- Bencin × 5L (Scout najde)

Crafting Time: 1 dan
Crafting Location: Garaža

Funkcija:
- Speed boost: 3× hitrejši travel
- Fuel: -1L na 1km
- Durability: 100 uses
```

### **2. Laksarca (Chainsaw):**
```
Potrebuješ:
- Motor × 1
- Glava (Blade) × 1
- Palica (Handle) × 1
- Bencin × 3L

Crafting Time: 6 ur
Crafting Location: Garaža

Funkcija:
- Drevo: 1-shot (instant chop!)
- Fuel: -0.5L per tree
- Durability: 50 trees
```

### **3. Vodni Filter (Water Filter):**
```
Potrebuješ:
- Oglje (Charcoal) × 10
- Pesek (Sand) × 20
- Kamenje (Stone) × 5

Crafting Time: 2 uri
Crafting Location: Campfire

Funkcija:
- Dirty Water → Clean Water
- 1 Filter = 50L čiste vode
- Unlock: Pitje iz reke!
```

## ⛏️ RUDARJENJE (Mining)

### **Dostopno:**
- 🪨 **Baker (Copper):** Common
- 🪵 **Premog (Coal):** Common
- ⚙️ **Železo (Iron):** REDKO (samo iz scavenging!)

### **Zaklennjeno (Faza 2+):**
- 🥈 Silver
- 🥇 Gold
- 💎 Gems

### **Mine Lokacija:**
- **Small Mine:** 5×5 area na edge of island
- **Minecart:** Rail system (unlock v Fazi 2)
- **Danger:** Toxic gas pockets (need mask!)

## 🧟 NOVI ZOMBI TIPI

### **IZVIDNIK (Scout):**
- **HP:** 50
- **Speed:** Fast
- **Function:** Scavenge fog of war
- **Limit:** Max 1 naenkrat

### **KMET (Farmer):**
- **HP:** 30
- **Speed:** Slow
- **Function:** Zaliva, žanje
- **Limit:** Max 3 naenkrat

### **GOZDAR (Lumberjack):**
- **HP:** 40
- **Speed:** Normal
- **Function:** Seka drevesa
- **Limit:** Max 2 naenkrat

### **RUDAR (Miner):**
- **HP:** 60
- **Speed:** Slow
- **Function:** Koplje (Lv 5+ najde Iron!)
- **Limit:** Max 2 naenkrat

## 📦 DROP BOX SISTEM

**Zombiji ne nosijo direktno v tvoje skrinje!**

### **Delovanje:**
1. Zombi naredi delo (tree chop, harvest, mine)
2. Resource gre v **DROP BOX** (poseben zabojnik)
3. **Ti** pobereš iz Drop Box → Inventory
4. **Razlog:** Balance (ne preveč easy)

### **Drop Box Lokacije:**
- Pri Workshopu (1× box)
- Pri Mine Entrance (1× box)
- Pri Farmi (1× box)

---

# OTOK & OKOLJE

## 🏝️ TEHNIČNE SPECIFIKACIJE

### **Island Dimensions:**
```javascript
TILE_SIZE = 128 px
ISLAND_WIDTH_TILES = 20
ISLAND_HEIGHT_TILES = 20

ISLAND_W = 2560 px (20 × 128)
ISLAND_H = 2560 px (20 × 128)
```

### **World Dimensions:**
```javascript
WORLD_W = 10000 px
WORLD_H = 10000 px

ISLAND_X = 3720 px (center offset)
ISLAND_Y = 3720 px (center offset)
```

### **Island Shape:**
```javascript
VERTEX_COUNT = 40  // detail vertices
JITTER = 50        // edge roughness (px)
```

### **Camera:**
```javascript
Default Zoom: 0.8
Zoom Range: 0.2 - 5.0
Background: #001d3d (Deep Blue Ocean)
```

## 🌍 BIOMI (Faza 1 Preview)

### **Dostopno:**
- 🌾 **Grassland:** Otok je grassland biome
- 🌲 **Forest Edge:** Robovi otoka (trees)

### **Vidno v Fog:**
- 🌿 **Swamp:** Vidiš v daljavi (zaklennjeno)
- 🏜️ **Desert:** Vidiš v daljavi (zaklennjeno)
- 🏔️ **Mountain:** Vidiš peak (zaklennjeno)

---

# LIKI & ZGODBA

## 👤 KAI MARKOVIĆ

### **Osnovni Podatki:**
- **Ime:** Kai Marković
- **Starost:** 14 let
- **Status:** Alpha Hybrid (imun na virus)
- **Posebnost:** Zombie Master (kontrolira zombije)

### **Videz:**
- **Lasje:** Pink/Zeleni dreadlocksi
- **Stil:** Dark-Chibi Noir
- **Outfit:** Raztrgane cunje (rags), later unlock wear

### **Sposobnosti:**
- 🧟 **Zombie Control:** Lahko udomači zombije
- 🔗 **Twin Bond:** Telepatska povezava z Ano
- 💪 **Alpha Immunity:** Ne postane zombi

### **Amnezija:**
- **Start:** Ne spomni se vsega!
- **Flashbacki:** Spomini se vračajo skozi igro
- **Memory Pulse:** Screen glitch trigger

## 👧 ANA MARKOVIĆ

### **Osnovni Podatki:**
- **Ime:** Ana Marković
- **Starost:** 14 let
- **Status:** UGRABLJENA! (Troll King)
- **Lokacija:** Černobilski Reaktor

### **Twin Bond:**
- 💜 **Telepatija:** Kai čuti da je živa
- 📡 **Signal:** Random messages (very weak!)
- 🎯 **Main Quest:** Najti jo!

### **Sporočila:**
```
"Kai... čutiš me? Sem ujeta... ampak ŽIVIM."
"Ne obupaj... Twin Bond... deluje..."
"Troll me čuva... ampak nisem sama..."
```

## 👻 STARŠA (Duhovi)

### **Marko Marković (Oče):**
- **Status:** Mrtev (Dan 3)
- **Duh:** Force Ghost (ko zgradiš oltar)
- **Funkcija:** Inženirski nasveti
- **Item:** Inženirska ura (najdi za trigger)

### **Elena Marković (Mama):**
- **Status:** Mrtva (Dan 3)
- **Duh:** Force Ghost (ko zgradiš oltar)
- **Funkcija:** Biološki nasveti (kmetovanje)
- **Item:** Medaljon (najdi za trigger)

### **Družinski Oltar:**
- **Location:** Na kmetiji (8×8 center)
- **Build Cost:** 20 Stone, 10 Wood, 2 Candles
- **Effect:** Duhovi se pojavijo
- **Buff:** "Parental Love" (+10% Energy regen)

## 🧟 GRONK

### **Osnovni Podatki:**
- **Ime:** Gronk
- **Tip:** Zombi (udomačen)
- **Status:** Prvi pomočnik

### **Videz:**
- **Lasje:** Roza dreadlocksi
- **Special:** Vape v ustih (permanent)
- **Stil:** Chill zombie

### **Osebnost:**
- **Vibe:** "Chill stric"
- **Speech:** "Gronk... pomaga... šefu..."
- **Funkcija:** Tutorial NPC + helper

### **Dialogues:**
```
GRONK: "Gronk... pomaga šefu?"
KAI: "Ja, Gronk. Pomagaš mi."
GRONK: "Gronk... dober zombi?"
KAI: "Najboljši zombi."
```

---

# SISTEMI & MEHANIKE

## ⚙️ CORE SISTEMI

### **1. Kmetovanje (Farming):**
- **Plant:** Pritisni E na obdelano zemljo
- **Water:** Vsak dan (ali rastline umrejo!)
- **Harvest:** Ko zraste (pšenice 3 dni, korenje 4 dni)
- **Yield:** 1-3 items per plant

### **2. Zombi Kontrola (Zombie Taming):**
- **Trigger:** Pritisni SPACE blizu zombija
- **Alfa Moč:** Screen flash, zombie podrejen
- **Limit:** Max 3 zombiji v Demo, 8 v Fazi 1
- **Assign Task:** Interact z zombijem → izberi delo

### **3. Crafting:**
- **Location:** Campfire (basic), Garaža (advanced)
- **UI:** Crafting menu (C key)
- **Time:** Real-time crafting (wait!)

### **4. Day/Night Cycle:**
- **Day Length:** 20 real minutes
- **Night:** Zombiji 2× močnejši, več spawn
- **Sleep:** Šotor → skip to morning

### **5. Energy System:**
- **Max Energy:** 100%
- **Drain:** -1% per action
- **Restore:** Sleep, eat, rest
- **Low Energy:** <20% = slow movement

### **6. Twin Bond:**
- **Always Active:** Pasivni sistem
- **Messages:** Random Ana messages (1× per day chance)
- **Visual:** Purple glow na HUD
- **Mechanic:** Čutiš Ano (quest marker later)

## 🎯 QUEST SISTEMI

### **Main Quest:**
```
"NAJDI ANO"
Tvoja sestra je živa. Somewhere.
Twin Bond signal je šibek, ampak present.
Nadaljuj... Ne obupaj.

Progress: 0% (unlock v Fazi 2+)
```

### **Side Quests (Demo):**
```
1. "Prvi Pridelek"
   - Posadi 10 Pšenice
   - Reward: +50 XP, Unlock: Scarecrow

2. "Udomači 3 Zombije"
   - Zombie Workforce
   - Reward: +100 XP, Unlock: Zombie Barracks

3. "Najdi Spomine"
   - Unlock 3 Flashbacks
   - Reward: +200 XP, Partial Vision Restore
```

---

# ASSETS POTREBŠČINE

## 🎨 GRAPHICS ASSETS

### **Characters:**
- ✅ `kai_walk_sheet.png` - 256×256 frames (1024×1024 sheet)
- ✅ `gronk_walk_sheet.png` - 256×256 frames
- ❌ `kai_idle.png` - Idle animation (needed!)
- ❌ `kai_work.png` - Working animation (needed!)

### **Environment:**
- ✅ `ground_base` (trava_osnova.png) - Tile 512×512
- ✅ `water_clean_patch.png`
- ✅ `river_tile_seamless.png`
- ✅ `sotor.png` (tent)
- ✅ `taborni_ogenj.png` (campfire)
- ✅ `spalna_vreca.png` (sleeping bag)
- ❌ `rain_catcher.png` (needed!)

### **Vegetation:**
- ✅ `visoka_trava_v2.png` - 1024×1024
- ✅ `grass_cluster_dense.png`
- ✅ `bush_hiding_spot.png`
- ❌ `crop_wheat_0.png` through `crop_wheat_3.png` (growth stages - needed!)
- ❌ `crop_carrot_0.png` through `crop_carrot_4.png` (growth stages - needed!)

### **Trees:**
- ✅ `tree_adult_0.png` through `tree_adult_5.png` (432px height)
- ✅ `drevo_faza_1.png` (small)
- ✅ `drevo_faza_2.png` (medium)
- ✅ `drevo_veliko.png` (large)

### **UI:**
- ❌ `Trial_Version_Banner.png` (needed!)
- ❌ `heart_full.png` (health UI - needed!)
- ❌ `heart_empty.png` (needed!)
- ❌ `energy_bar_bg.png` (needed!)
- ❌ `energy_bar_fill.png` (needed!)

### **Intro:**
- ❌ **20 Polaroid images** (all needed!)
  - `polaroid_01_family.png`
  - `polaroid_02_lab.png`
  - ... through...
  - `polaroid_20_promise.png`

## 🔊 AUDIO ASSETS

### **Music:**
- ❌ `menu_theme.ogg` (needed!)
- ❌ `day_ambient.ogg` (needed!)
- ❌ `night_ambient.ogg` (needed!)

### **SFX:**
- ❌ `footsteps.ogg` (needed!)
- ❌ `tree_chop.ogg` (needed!)
- ❌ `zombie_groan.ogg` (needed!)
- ❌ `plant_harvest.ogg` (needed!)

---

# UI & KONTROLE

## 🎮 KONTROLE

### **Gibanje:**
- **W** - Gor
- **A** - Levo
- **S** - Dol
- **D** - Desno

### **Akcije:**
- **E** - Interakcija
- **SPACE** - Alfa Moč (udomači zombija)
- **I** - Inventar
- **C** - Crafting Menu
- **M** - Mapa (Faza 1+)
- **ESC** - Pause Menu

### **Camera:**
- **Mouse Wheel** - Zoom (0.2 - 5.0)
- **Middle Mouse** - Pan camera (optional)

## 📊 HUD ELEMENTI

### **Top Left:**
```
TRIAL VERSION - DEMO FAZA 1
```

### **Top Right:**
```
DAN 1 - 06:00
☀️ (day icon)
```

### **Bottom Left:**
```
❤️ ❤️ ❤️ ❤️ ❤️  (5 hearts = 100 HP)
Energija: [████████░░] 85%
```

### **Bottom Right:**
```
[INVENTORY PREVIEW]
Pšenica × 10
Korenje × 5
```

## 💬 DIALOG SISTEM

### **Typewriter Effect:**
```javascript
fontSize: '18px'
fontFamily: 'Press Start 2P'
color: '#ffffff'
stroke: '#000000'
strokeThickness: 4
typewriterSpeed: 50ms per character
```

### **Flashback Effect:**
```javascript
fontSize: '16px'
color: '#888888' (gray)
blur: 2px
typewriterSpeed: 70ms (slower for emphasis)
```

---

# 📝 PRODUCTION CHECKLIST

## ✅ DEMO READY:
- [x] Otok (island) rendering
- [x] Ocean (water) rendering
- [x] Kai walk animation
- [x] Gronk sprite
- [x] Basic grass/trees
- [ ] Start inventory
- [ ] Intro sequence (20 Polaroids)
- [ ] Amnezija blur effect
- [ ] Farming system
- [ ] Zombie taming
- [ ] Day/night cycle
- [ ] Rain Catcher
- [ ] UI (hearts, energy, trial banner)

## ✅ FAZA 1 READY:
- [ ] Fog of War unlock
- [ ] Scout Zombie
- [ ] Ruševine (Garaža, Rastlinjak, Hlev)
- [ ] Crafting: Motorka
- [ ] Crafting: Laksarca
- [ ] Crafting: Vodni Filter
- [ ] Mining system
- [ ] Drop Box system
- [ ] 4 Zombie worker types
- [ ] Expanded map

---

# 🎯 PRIORITETE

## **HIGH PRIORITY (Demo Launch):**
1. ✅ Otok rendering
2. ❌ 20 Polaroid intro images
3. ❌ Farming system (plant/water/harvest)
4. ❌ Zombie taming mechanic
5. ❌ Basic UI (health, energy, trial banner)
6. ❌ Start inventory
7. ❌ Day/night cycle
8. ❌ Amnezija blur effect

## **MEDIUM PRIORITY (Faza 1):**
1. ❌ Scout Zombie system
2. ❌ Crafting recipes (motorka, laksarca, filter)
3. ❌ Ruševine repair system
4. ❌ Mining
5. ❌ Drop Box
6. ❌ Fog of War unlock

## **LOW PRIORITY (Polish):**
1. ❌ Advanced animations
2. ❌ Sound effects
3. ❌ Music
4. ❌ Save/Load system
5. ❌ Settings menu

---

# 📖 KONEC DOKUMENTA

**Status:** ✅ Complete Master Reference  
**Verzija:** 2.0 FINAL  
**Datum:** 9. Februar 2026  

**VSE INFORMACIJE O DEMO & FAZI 1 SO TUKAJ!** 🎮✨

Za dodatne detajle glej:
- `DEMO_FAZA1_NAPISI_DIALOGI.md` - Dialogi
- `HARD_IZPISEK_CLEAN_START.md` - Quick reference
- `GAME_BIBLE_FINAL_2026.md` - Full game spec

---

*"Twin Bond. Zdaj in vedno."* 💜