Docs: Clean Start cleanup & Hard Izpisek (Demo/Faza1 definition)

This commit is contained in:
2026-01-30 15:24:43 +01:00
parent 9cd7115989
commit 01d042fd50
12 changed files with 8277 additions and 194 deletions

View File

@@ -1,89 +0,0 @@
# 📖 COLLECTOR'S ALBUM (Zbirateljski Album)
**Status:** ✅ IMPLEMENTED via `AlbumCollectionSystem.js`
**Roadmap:** Igra bo imela **10 FAZ**. Trenutno smo v Demo / Faza 1.
To je tvoja glavna enciklopedija in zbirka v igri. Vse kar najdeš, se zabeleži tukaj!
---
# 1. KAKO DELUJE?
Ko **PRVIČ** pobereš nek item (npr. Jagodo, Zlato, Ribo) ali srečaš NPCja:
1.**"New Entry!"** notification.
2. Item se odklene v Albumu (prej je bil "???").
3. Dobiš **XP** in **Zvezdico (Star)**.
---
# 2. VSEBINA PO FAZAH (Progression)
### 🟢 DEMO (The Hook)
*Omejeno na Farmo (8x8) in osnovno preživetje.*
* **🌱 CROPS (Rastline):**
* **Pomlad:** Pšenica, Korenje.
* **Zima (Hard Mode):** Zimski Krompir, Zimska Pšenica.
* **Special:** Konoplja (Cannabis Sativa - Začetni kapital).
* **🛠️ TOOLS (Orodja):**
* Lesena Orodja (Tier 1).
* **Obleka:** Survivor Rags.
* **🧟 ZOMBIEPEDIA:**
* **Shambler:** Osnovni zombi (edini v Demu).
* **💎 MINERALS:**
* Kamen, Les.
### 🟡 FAZA 1 (Early Access)
*Odklepanje Sveta (4 Biomi), Crafting in Golazen.*
* **🌱 CROPS (Nove):**
* 80+ vrst (odvisno od bioma: Travnik, Gozd, Puščava, Močvirje).
* **🐟 FISHING (Ribolov - NOVO):**
* **Postrv (Trout):** Pogosta.
* **Brancin (Bass):** Redek.
* **Som (Catfish):** Nočni (Night only).
* **Losos (Salmon):** Samo med dežjem.
* **Zlata Ribica (Gold):** Ultra redka (za Muzej).
* **Mutant Fish:** Toksična voda (zelena).
* **🦋 INSECTS (Insekti - NOVO):**
* **Čebela (Aviator):** Navadna delavka.
* **Matica (Queen Bee):** REDKA! (Nujna za Domači Čebelnjak).
* **Metulj (Noir):** Dnevni.
* **Kresnička:** Nočna.
* **Deževnik, Polž:** Vaba za ribe.
* **Komar, Gad:** Agresivni (Faza 1 nevarnosti).
* **🛠️ TOOLS (Scrap Crafting):**
* **Motorka (Chainsaw):** Motor + Veriga + Ohišje.
* **Laksarca (Trimmer):** Motor + Glava + Palica.
* **Domači Čebelnjak:** Les + Satje + Matica.
* **🧟 ZOMBIEPEDIA (Evolucija):**
* **Scout:** Izvidnik (odpira meglo).
* **Zombie Farmer:** Mutiran kmet (produkt megle).
* **Zombie Miner:** V rudniku (Specializacija za Železo!).
* **💎 MINERALS (Rudnik Level 1):**
* Premog, Baker (Copper).
* **Železo (Iron):** NE NAJDEŠ GA SAM! (Samo Zombie Miner Lv 5+).
* **Steklo:** Mivka + Premog (za Terarije in Rastlinjak).
### 🔵 FAZA 2 - 10 (Future Roadmap)
*Napredne mehanike, Nove regije, Zgodba.*
* **Faza 2:** Ribnik, Napredni Stroji.
* **Faza 3:** Elektrika, Avtomatizacija.
* **Faza 4-10:** *Coming Soon...*
---
# 3. NAGRADE (Rewards)
Ko zapolniš celotno kategorijo (npr. ulovil si vse Ribe v Fazi 1):
* **Nagrada:** Poseben Item ali Buff.
* **Primer:**
* Vse Ribe -> **"Master Rod"** (Ribja palica, ki ne porablja energije).
* Vsi Insekti -> **"Beekeeper Hat"** (Čebele te ne pičijo).
* Vse Rastline -> **"Green Thumb"** (Hitrejša rast).
---
# 4. MUZEJ (Museum Donation)
* **Lokacija:** V Mestu (Town), vodi ga **Sova (The Owl)** - *Odklenjeno v Fazi 1*.
* **Mehanika:** Redke stvari (Artefakte, Zlate Hrošče, Legendarno Ribo) lahko DONIRAŠ muzeju.
* **Nagrada:** Sova ti prinese darila (Dan) ali Netopir račune (Noč).

View File

@@ -1,130 +0,0 @@
# Game Design Ideas & Mechanics
## 1. DEMO (Brezplačna preizkusna verzija)
**Cilj:** Igralca "navleči" na igro s kmetovanjem in zombi mehanikami, vendar omejiti napredek, da kupi polno igro.
**Trajanje:** Neomejeno (brez časovne omejitve), vendar omejeno na kmetijo.
### Omejitve & Struktura (The "Hook")
* **Mapa:** Samo **Farma** (8x8 tiles). Igralec vidi mesto in druge biome v daljavi (Fog of War), a ne more do njih.
* **Začetek:**
* **Amnezija:** Kai se zbudi z amnezijo (brez spominov).
* **Začetna skrinja (Starting Chest):**
* **Orodja:** Lesena (Tier 1).
* **Obleka:** Survivor Rags (Cunje).
* **Preživetje:** Kruh, Jabolko, Bakla.
* **Semena:** Pomlad: 3x Pšenica, 3x Korenje. (Zima Hard Mode: 3x Zimski Krompir, 3x Zimska Pšenica).
* **Kapital:** 3-5x Semena Konoplje.
* **Omejitve napredka:**
* **Orodja:** Samo **lesena** (Tier 1). Nadgradnje so zaklenjene.
* **Zgradbe:** Samo **šotor (Tent)**. Gradnja hiše ni mogoča (Lesena hiša je ZAKLENJENA).
* **NPC-ji:** Samo 1 trgovec na robu mape (za prodajo pridelkov).
* **Zombiji:** Samo osnovni **"Shambler"** zombi (ponoči). Ne evolvirajo.
* **Zgodba:** Ni napredka v zgodbi.
* **Logika Dneva:**
* **Radio (V Šotoru):** Igra Synthwave/Dark Country. Napoveduje Vreme ("Dež jutri") in SOS signale (Questi).
* **Spanje:** Moraš spati do 02:00.
* **Pass Out:** Omedliš -> Izguba energije in denarja.
* **Energija:** Šotor povrne 70%, Hiša 100%.
* **Hoarding Trap:** Ker ni časovne omejitve, igralci kopičijo na tisoče surovin. Ko kupijo igro, obdržijo vse!
* **Achievements (Steam):**
* **"Stubborn Survivor" (Trmasti preživeli):** Preživi 200 dni v demo verziji.
* **Nagrada:** Unikaten **Zlati Kip** v polni igri.
* **Launch Reward:** Prvih 20 kupcev (+ Streamerji) dobi **Gronka** takoj.
* **Scenarij:** Gronk se preseli direktno na tvojo farmo (zgradi si mini kolibo).
* **Benefit:** Pomaga pri VSEM (zalivanje, sekanje, obramba) in ima "Master Shop" s popustom.
* **OPOMBA:** To je ogromna prednost, ker Gronk sicer živi daleč v gozdu.
---
## 2. FAZA 1 (Early Access - Polna Igra)
**Cilj:** Odklepanje sveta, napredno kmetovanje, zombi pomočniki in obnova mesta.
### 🌍 Svet in Biomi (Discovery)
1. **Travnik (Grassland):** Tvoja baza.
2. **Gozd (Forest):** Vir lesa, lov, gobe. Dom **Gronka** (Troll NPC).
3. **Puščava (Desert):** Pesek, kaktusi, škorpijoni.
4. **Močvirje (Swamp):** Zelišča, strupene žabe.
5. **Megla (Fog of War):** Svet je zakrit.
* **Odkrivanje:** Sami ali s pošiljanjem **Zombi Izvidnika**.
* **Najdi & Popravi (Ruševine):** Ne gradiš na novo, ampak najdeš ruševino v megli in jo popraviš (npr. Garaža, Rastlinjak, Hlev).
### 🧟 Zombi Sistem (Strategija)
* **Bivališče:** Spijo v **GROBOVIH** (Najdi Blueprint).
* **Leveling:** Nabirajo XP (Lv 1-10). Boljši level = hitrejše delo.
* **Vloge:**
* **Kmet (Farmer):** Zaliva, žanje.
* **Gozdar (Lumberjack):** Seka drevesa.
* **Rudar (Miner):** Koplje v rudniku.
* **SPECIALIZACIJA (Železo):** Železo (Iron) ni prosto dostopno. Samo **Zombi Rudar z Levelom 5+** (Specializacija: "Deep Dig") lahko najde Železno rudo. Igralec sam najde samo Baker in Premog.
* **Zombi Izvidnik (Scout):** Edini, ki odpira meglo in išče bencin/dele za stroje.
* **Drop Box:** Zombiji odlagajo nabrano v poseben zabojnik.
### 🛠️ Orodja in Crafting (Tier 1-3 + Scrap)
* **Osnovna:** Lesena -> Kamnita -> Železna.
* **Scrap Crafting (Motorna Orodja):**
* **Motorka (Chainsaw):** Za hitro sečnjo. Sestaviš iz delov (Motor + Veriga + Ohišje - najde Izvidnik).
* **Laksarca (Trimmer):** Za košnjo trave (AOE). Sestaviš iz delov (Motor + Glava + Palica).
* **Gorivo:**
* **Bio-Olje:** Sončnice -> Stiskalnica (za Generator).
* **Bencin:** Najde Izvidnik (za Motorko).
* **Delovna Miza (Workbench):** Smart Inventory (vidi vse skrinje). Craftaš Čebelnjak, Strašilo, Škropilnike.
### 🐝 Čebelarstvo (Beekeeping System)
* **Domači Čebelnjak (Beehive):**
* **Crafting:** Les + Satje (Honeycomb).
* **Aktivacija:** Moraš vstaviti **Matico (Queen Bee)**, ki jo ujameš v naravi (redka!).
* **Produkt:** Med (Honey) in Vosek (Wax).
* **Bonus:** Čebele oprašujejo rože v bližini -> hitrejša rast pridelkov (Pollination Boost).
* **Divji Panj:** Najdeš ga na drevesih v gozdu. Če ga podreš, dobiš Satje in morda Matico (če imaš srečo).
### 🏘️ Zgradbe na Farmi
* **Lesena Hiša:** Odklene **Klet** (Storage, Grow Room za indoor konopljo/gobe).
* **Garaža (Workshop):** Skladišče za Bencin/Olje, miza za sestavljanje strojev.
* **Rastlinjak:** Popraviš s steklom (Pesek + Peč). Omogoča kmetovanje pozimi.
* **Kontejner za Smeti (Dumpster):** Za odlaganje smeti. Tu brska Rakun.
* **Strašilo:** Odganja Vrano.
### 👥 Ključni NPC-ji & Živali
* **Gronk (Troll):** Mentor in trgovec v gozdu.
* **Susi (Jazbečarka):** Gronkova izgubljena psička (Quest: "Find Susi").
* **Živali (Sistem):**
* **Nakup:** Kura, Krava, Prašič (pride v škatli na rob farme).
* **Divje (Škodljivci):** Vrana (krade semena), Rakun (brska po smeteh), Volk (napada v gozdu).
* **Gozdni Kurirji:**
* **Sova (Owl):** Prinese Quest nagrade in darila Albuma (Dan).
* **Netopir (Bat):** Prinese Pošto in Račune (Noč).
### 💎 Zbirateljstvo (Collector's Album)
* **Album:** Beleži vse najdbe (Ribe, Insekti, Rude).
* **Muzej:** Doniraj redke stvari.
* **Ribe:** 6 vrst v Fazi 1 (Postrv, Brancin, Som...).
* **Insekti:** Lovljenje z mrežo (Metulji, Hrošči...).
### 🌿 Kmetovanje (Faza 1)
* **Pridelki:** 80+ vrst (od Korenja do **Konoplje** - legalno/ilegalno).
* **Avtomatizacija:** Zombi delavci + Škropilniki (Tier 1-2).
* **Živali:** Krave, Kure, Prašiči (in mutirane verzije).
### ⚙️ Tehnični Podatki
* **Engine:** Phaser 3 (Web-based).
* **Maps:** Tiled (.tmx), Tile size 32x32px.
* **Art Style:**
* **Style 32 (Dark-Chibi Noir):** Glavni stil za like in predmete. Temne linije, luškani a mračni.
* **Vektor (Cult of the Lamb stil):** Za UI in določene sprite.
* **Save System:** LocalStorage (avtomatsko shranjevanje).
* **Jezik:** Slovenski (primarni) + Angleški.
---
## 3. Environmental Hazards: Toxic Fog (Strupena Megla)
* **Vizualno:** Roza (toksično) in Zeleno (radiacija) sijoča megla (Screen blend mode).
* **Mehanika:** Širi se čez čas, povzroča dušenje (damage).
* **Rešitev:** Senzorji in filtracijski sistemi.
* **Zombi Sinergija (Transformacija):**
* **Zombi -> Kmet:** Megla povzroča mutacije. Če so zombiji predolgo v megli (še posebej zeleni), se transformirajo iz **Navadnih Zombijev** v **Zombi Kmete**.
* **Lore:** To pojasni, zakaj imamo "Zombi Kmete" - to so bivši zombiji, ki jih je megla "pozdravila" ali pa jim dala kmetijske nagone.
## 4. UI Enhancements
* **Day Cycle:** "Day X" napis na sredini zaslona.
* **Trial Badge:** "Trial Version" značka v Demo verziji.

View File

@@ -1,64 +0,0 @@
# Seznam Promptov za Generiranje Slik
Ta datoteka vsebuje natančne "prompte" (opise), ki se uporabljajo za generiranje grafičnih elementov v stilu "Dark Chibi Noir / Farm Survival".
## 1. Paket: UI in Okolje (Dolina Smrti)
### UI - Nakup Igre (Badge)
> **Prompt:** `A detailed golden vector game UI badge, ornate shield shape. A skull wearing a royal crown sits on top. Bold majestic text inside reads "PURCHASE FULL GAME". Dark outlines, cel shaded, shiny gold texture, premium rpg style, white background.`
### VFX - Strupena Megla (Explozija)
> **Prompt:** `A cartoon explosion cloud of toxic gas, purple and pink colors, billowing smoke shapes. Thick black comic book outlines, vector style, flat colors, 2d game asset, isolated on white.`
### UI - Merilnik Zdravja (Critical)
> **Prompt:** `A steampunk rusty metal circular gauge, labeled "HEALTH GAUGE". The glass cover is cracked and shattered. The red needle is pointing to "CRITICAL". Dirty textures, oil stains, thick dark outlines, 2d game ui asset.`
### Okolje - Vhod v Rudnik (Dolina Smrti)
> **Prompt:** `A dark spooky mine entrance built into a rock face. Supported by old rotting wooden beams. A wooden sign above the entrance says "DOLINA SMRTI" in rough hand-carved letters. Dark moody atmosphere, thick lines, vector style.`
### Okolje - Trnje (Ovira)
> **Prompt:** `A dense bush of twisted, sharp black thorns and brambles. Spiky, dangerous looking, dark purple and black tones. 2d game obstacle asset, white background, thick outlines.`
---
## 2. Paket: Znaki in Predmeti
### Znak - Nevarnost (Danger)
> **Prompt:** `A rusty square metal sign nailed to a wooden post. On the sign is a black skull and crossbones symbol and the word "DANGER" in bold black letters. Barbed wire wrapped around the post. Weathered, gritty cartoon style.`
### Predmet - Kolut Žice
> **Prompt:** `A spool of silver industrial wire. Brown plastic reel. A sticker on the side reads "HIGH VOLTAGE". clean vector art, isometric view, game inventory item.`
### Znak - Smerokaz (Mesto/Gozd)
> **Prompt:** `A wooden crossroads signpost. One arrow points left saying "TOWN", one arrow points right saying "FOREST". Moss growing at the base. Cartoon style, thick dark outlines, pleasant wood texture.`
### Znak - Viseča Tabla (Prazna)
> **Prompt:** `A rectangular wooden board hanging by two metal chains. Empty space in the middle for text. A small cute skull icon pinned to the top left corner. Vector game asset, clean lines.`
### UI - Trial Version (Badge)
> **Prompt:** `A dark wooden plank sign with a red ribbon banner at the bottom. A skull with bat wings sits on top. Glowing white text in the center reads "TRIAL VERSION". Gothic rpg ui style, vector, isolated.`
---
## 3. Paket: Kmetija, Gradnja in Nagrade
### Objekt - Gnoj/Kompost (Kup)
> **Prompt:** `A pile of manure and compost. Steaming, flies buzzing around. Mix of brown soil, green plant waste, and animal droppings. Dark Chibi Noir style, gritty farm survival game asset. Thick outlines, flat vector art, white background.`
### Objekt - Kontejner za Smeti
> **Prompt:** `A rusty metal trash dumpster. Green or blue industrial container, slightly overflowing with trash bags and debris. Weathered texture, scratches, isometric view. Dark Chibi Noir style, survival game asset. Thick outlines, white background.`
### Objekt - Strašilo (Creepy)
> **Prompt:** `A creepy scarecrow on a wooden cross. Wearing tattered farmer clothes and a burlap sack hood with stitched eyes. Spooky but cute chibi style. Dark survival atmosphere. Thick black outlines, vector art, isolated on white.`
### Gradnja - Temelj/Zombiji
> **Prompt:** `Construction site foundation. A dug rectangular hole in the ground with a fresh grey concrete slab poured at the bottom. Wooden stakes and string marking the edges. Construction or blueprint phase for a building. Dark Chibi Noir style, isometric view, survival game asset. Thick outlines, white background.`
### Objekt - Kompostnik (Lesen)
> **Prompt:** `A wooden compost bin structure. Slatted wood sides, filled with soil and organic waste. Farm functionality. Dark Chibi Noir style, detailed wood texture, gritty but cute. Isometric view, thick outlines, white background.`
### Objekt - Grob (Zombi Postelja)
> **Prompt:** `An open grave hole dug in the ground, looking like a resting spot or bed. Brown dirt pile on the side. A simple wooden headstone or memorial plaque at the head. Empty inside, ready for a zombie to sleep. Dark Chibi Noir style, isometric view, thick outlines, white background.`
### Nagrada - Kip (200 Dni)
> **Prompt:** `A stone statue reward for a game. A chibi survivor character made of grey stone, leaning tiredly on a shovel but looking proud. Standing on a pedestal with the text '200 DAYS' engraved in gold. Moss growing slightly on the stone. Dark Chibi Noir style, isometric view, thick outlines, white background.`

View File

@@ -1,64 +0,0 @@
# 📝 SESSION DIARY: 25. JAN 2026 - ASSET MARATHON
**Datum:** 25. Januar 2026
**Ura:** 02:26 AM
**Tema:** Generiranje Assetov, Game Design Faza 1, Referenčna Mapa
---
## 🚀 POVZETEK (Executive Summary)
V tej maratonski seji (do 02:30 zjutraj!) smo definirali in vizualno opremili **skoraj celotno vsebino Faze 1**. Fokus je bil na **"Dark-Chibi Noir"** stillu za žuželke, orodja, ribe in strukture.
---
## 🎨 GENERIRANI ASSETI (Referenčna Mapa)
V mapi `assets/referencne_slike` (in `referencne_slike 2`) so zdaj shranjeni ključni vizuali:
### 1. 🦋 Žuželke & Golazen (Insects & Fauna)
- **Komplet:** Čebela (Aviator style) + Matica (Queen), Metulj (Noir), Hrošči, Kresničke.
- **Novi dodatki:** Deževnik (Worm), Polž (Snail), Komar (Aggressive), Kača, Gad.
- **Predmeti:** Mreža za lovljenje, Plastični/Stekleni Terariji.
### 2. 🐟 Ribe (Fish System)
- **6 Vrst:** Postrv, Brancin, Som (Nočni), Losos (Dež), Zlata (Rare), Mutant (Radioactive).
- **Uporaba:** Hrana, Prodaja, Akvarij (Mali/Veliki), Ribnik (Faza 2).
### 3. 🛠️ Orodja in Stroji (Tools & Machines)
- **Crafting Orodja:** Motorka in Laksarca (prikazani ločeni deli: motor, veriga, ohišje).
- **Peč (Furnace):** Dve stanji (Clean/Broken). Za taljenje Rude in Stekla.
- **Čebelnjaki:** Divji panj (na drevesu) in Domači panj (Phase 2).
### 4. 🏗️ Strukture (Buildings)
- **Kokošnjal (Tier 1):** Osnovni, lesen, za 6 kur.
- **Delavnica (Garage):** Lesena lopa za stroje.
- **Zombie Drop Box:** Zabojnik, kamor zombiji odlagajo nabrane resource.
- **Skriti Nasad (Basement):** Referenca za Grow Room in Lab.
---
## 📜 GAME BIBLE POSODOBITVE (Mechanics)
Posodobili smo `GAME_BIBLE_FINAL_2026.md` in `COLLECTORS_ALBUM_SYSTEM.md`:
1. **Crafting Chain:**
* **Mivka (Sand) + Premog (Coal) = Steklo (Glass)** v Peči.
* Steklo se rabi za popravilo Rastlinjaka in Terarije.
2. **Rudnik (Mine):**
* Faza 1 limit: Samo Premog in Baker.
* Železo (Iron) je redko -> dobiš ga s "Scavenging" (Zombiji).
3. **Ogrevanje:** Peč deluje na Les (hitro gori) ali Premog (učinkovito).
4. **Skriti Klet (Secret Basement):** Ilegalni nasad in laboratorij (Late Game).
---
## 📂 STATUS DATOTEK
- **Rename:** Večina datotek v `assets/referencne_slike` je urejenih ali pa čaka na ročni rename (po "Detektivskem Seznamu").
- **Varnost:** Mape se ne brišejo in ne premikajo.
---
## 🔮 NASLEDNJI KORAKI (Next Steps)
1. **Kodiranje:** Implementacija animacij živali (Cow Walk, Chicken Peck).
2. **Item System:** Vnos vseh teh novih itemov (Fish, Insects, Tools) v kodo/database.
3. **Crafting Menu:** Izdelava UI za sestavljanje orodij in taljenje.
*"Faza 1 is looking GOOD. Dark, Dirty, and Detailed."* 💀🌱