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
2. FAZA 1 SPECIFIKACIJA
3. OTOK & OKOLJE
4. LIKI & ZGODBA
5. SISTEMI & MEHANIKE
6. ASSETS POTREBŠČINE
7. 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:

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:

WORLD_W = 10000 px
WORLD_H = 10000 px

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

Island Shape:

VERTEX_COUNT = 40  // detail vertices
JITTER = 50        // edge roughness (px)

Camera:

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:

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

Flashback Effect:

fontSize: '16px'
color: '#888888' (gray)
blur: 2px
typewriterSpeed: 70ms (slower for emphasis)

---

📝 PRODUCTION CHECKLIST

✅ DEMO READY:

• Otok (island) rendering
• Ocean (water) rendering
• Kai walk animation
• Gronk sprite
• 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." 💜