diff --git a/COLLECTORS_ALBUM_SYSTEM.md b/COLLECTORS_ALBUM_SYSTEM.md new file mode 100644 index 000000000..ac16a4b33 --- /dev/null +++ b/COLLECTORS_ALBUM_SYSTEM.md @@ -0,0 +1,183 @@ +# 📖 COLLECTOR'S ALBUM (Zbirateljski Album) +**Status:** ✅ IMPLEMENTED via `AlbumCollectionSystem.js` + +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 ALBUMA (Kategorije) + +Album je razdeljen na zavihke: + +### **🌱 CROPS & PLANTS (Rastline)** +- **Vsebuje:** Pšenica, Korenje, Jagode, Konoplja, Gobe... +- **Info:** + - Ime in Slika + - Growth Time (čas rasti) + - Season (sezona) + - **Lokacija:** Kje najti semena? + - **Sell Price:** Koliko stane? + +### **🐟 FISH (Ribe)** +- **Vsebuje:** Postrv, Som, Mutant Fish... +- **Info:** + - Lokacija (Reka, Jezero, Morje) + - Time (Dan/Noč) + - Weather (Sončno/Dež) + - "Record Size" (tvoja največja ujeta riba) + +### **💎 MINERALS & ARTIFACTS** +- **Vsebuje:** Zlato, Diamanti, Ancient Coins, Dinosaur Bones... +- **Info:** + - Lokacija (Rudnik level) + - Rarity (Common, Rare, Legendary) + - **Museum Status:** "Donated" ✅ ali "Missing" ❌ + +### **👥 NPC & FRIENDS** +- **Vsebuje:** Vsi NPCji (Župan, Luka, Pek, Zombi Statističar...) +- **Info:** + - **Hearts:** ❤️❤️❤️🤍🤍 (Prijateljstvo) + - **Birthday:** Kdaj imajo rojstni dan? + - **Loves:** Kaj imajo radi? (Darila) + - **Hates:** Česa ne marajo? + - **Schedule:** Kje so ob kateri uri? + +### **🦋 INSECTS (Žuželke)** +- **Vsebuje:** Metulji, Kobilice, Hrošči, Čebele, Kresničke... +- **Info:** + - Lokacija (Travnik, Gozd) + - Time (Dan/Noč) + - Season (Poletje/Jesen) + - **Rarity:** Nekateri so zelo redki! + +### **🐾 ANIMALS (Živali - Fauna)** +- **Domestic:** Krave, Kokoši, Svinje... +- **Wild:** Veverice, Lisice, Zajci, Netopirji... +- **Info:** + - **Status:** Tamed ✅ ali Wild ❌ + - **Favorite Food:** Kaj jedo? + - **Produce:** Kaj proizvajajo (Mleko, Jajca)? + +### **👹 BESTIARY (Pošasti)** +- **Vsebuje:** Zombiji (vse vrste), Mutanti, Bossi... +- **Info:** + - **Kill Count:** Koliko si jih premagal? + - **Drops:** Kaj mečejo (Gold, Bones)? + - **Weakness:** Česa se bojijo? (Ogenj, Led) + +### **⚔️ EQUIPMENT & OUTFITS** +- **Vsebuje:** Vsa orodja, orožja, kape, oblačila. +- **Info:** + - Stats (Damage, Defense) + - **Set Bonus:** Če nosiš cel set. + +### **🍽️ RECIPES (Recepti)** +- **Vsebuje:** Kuharski in Crafting recepti. +- **Info:** + - Sestavine + - Učinek (Health/Stamina) + +--- + +# 3. NAGRADE (Stars & Hearts) + +### **⭐ ZVEDICE (Collection Stars):** +Za vsak **Completed Page** (npr. vse ribe) dobiš nagrado: +- **10 Stars:** 500 Zoombucks +- **50 Stars:** Rare Scarecrow +- **100 Stars:** **Stardrop Fruit** (Max Energy up!) + +### **❤️ SRČKA (NPC Hearts):** +Spremljaš napredek z NPCji. +- **2 Hearts:** Lahko vstopiš v njihovo sobo. +- **4 Hearts:** Dobiš recept. +- **8 Hearts:** Dobiš specialno darilo. +- **10 Hearts:** Lahko se poročiš (če so samski)! + +--- + +# 4. LOKACIJA & INFO + +To je najbolj uporabna funkcija! +Če pozabiš, kje dobiti "Copper Ore": +1. Odpri Album. +2. Klikni na Copper Ore. +3. Poglej **"Location"**: *"Found in Caves (Levels 1-20)"*. + +To je tvoj **in-game Wiki**! 📚✨ + +--- + +# 5. 🏛️ MUSEUM DONATION SYSTEM (Animal Crossing Style) + +To je povezava med Albumom in Muzejem v mestu. + +### **Kako Deluje?** +1. **Najdi:** Ujameš redko žuželko, ribo ali najdeš fosil. +2. **Doniraj:** Neseš Kustosu v Muzej. +3. **Razstava:** Tvoj item se **FIZIČNO RAZSTAVI** v muzeju! + - Ribice plavajo v akvariju. + - Žuželke so v terarijih. + - Fosili so sestavljeni v okostja (T-Rex!). + +### **Nagrade (The Owl Delivery):** +Ko doniraš določeno število stvari ali zaključiš zbirko (npr. "All Butterflies"): +1. Kustos se ti zahvali. +2. **Naslednje jutro pride SOVA (Quest Owl)!** 🦉 +3. Prinese ti posebno darilo (Rare furniture, Golden Tool recept, Unique outfit). + +**Cilj:** Napolniti celoten muzej in ga narediti za glavno atrakcijo mesta! + +### **⚠️ MUSEUM CAPACITY & ALARM QUEST** + +Muzej ni takoj velik! Začneš z **MAJHNIM** šotorom/sobo. + +**Ko zmanjka prostora:** +1. Ne moreš več donirati (Kustos zavrne: *"No room!"*). +2. **🚨 ALARMANTNI QUEST SE SPROŽI!** + - **Alarm:** Kustos teče k tebi ali Sova panično kroži. + - **Quest:** "EMERGENCY EXPANSION!" + - **Cilj:** Zbrati materiale TAKOJ (npr. 500 Stone, 2000 Zoombucks). + +**Ko nadgradiš:** +- ✅ Odklene se novo krilo (Aquarium, Insect Hall, Fossil Room). +- ✅ Dobiš **Huge Reward** od Sove. +- ✅ Lahko spet doniraš! + +To te prisili v nadgradnjo mesta! + +--- + +# 6. 🧠 MEMORIES (Spomini - Glavna Zgodba) + +**Najpomembnejša stran v albumu!** + +Kai ima AMNEZIJO. Ta stran je na začetku prazna (polna "????"). +Ko najdeš spomin, se slika zbistri in Kai se spomni dela preteklosti. + +### **Kako Najdeš Spomin? (TWIN PULSE Mehanika)** +Ko si blizu skritega spomina (npr. Stara igrača, Slika staršev): + +1. 💓 **CONTROLLER VIBRATION:** Kontroler začne vibrirati ("na hard"!). Bolj ko si blizu, močneje trese (Haptic Feedback). +2. 🔊 **HEARTBEAT AUDIO:** Slišiš utripanje srca (Twin Bond). +3. 👁️ **VISUAL CUE:** Na ekranu začne utripati ikona srca ali robovi ekrana sijejo (Cyan/Pink). + +### **Vsebina Memory Strani:** +- **50 Spominov** (Puzzle pieces). +- Ko klikneš na spomin: + - **Flashback Cutscene:** Vidiš kratek video iz preteklosti. + - **Dialogue:** Kai pove kaj o Ana ali starših. + - **Stat Boost:** Vsak spomin ti permanentno poveča HP ali Stamina! + +**Final Reward:** +Ko zbereš vseh 50 spominov → **TRUE ENDING UNLOCKED** (Veš točno kje je Ana!). + diff --git a/FAZA2_NPC_SYSTEM_DETAILED.md b/FAZA2_NPC_SYSTEM_DETAILED.md new file mode 100644 index 000000000..e135d4b76 --- /dev/null +++ b/FAZA2_NPC_SYSTEM_DETAILED.md @@ -0,0 +1,170 @@ +# 👥 FAZA 2 NPC SISTEM: ŽIVI vs MRTVI +**Datum:** 19. Januar 2026 +**Lokacija:** HIPODEVIL666CITY (Faza 2) + +--- + +# ❓ KAKO DELUJE POPULACIJA? + +## 📍 LOKACIJA & TRANSPORT 🛹 + +**Oddaljenost Mesta:** + HIPODEVIL666CITY ni takoj zraven farme! +- **Peš (Walking):** 1 in-game dan hoje (nevarno ponoči!). +- **Longboard 🛹:** 4-6 ur (hitreje, stamina cost). +- **Popravljen Skuter 🛵:** 1-2 uri (najhitreje, rabi bencin/bio-fuel). + +**Zakaj je to pomembno?** +Planirati moraš pot! Ne moreš kar skočiti v mesto po sol. To je ekspedicija! + +--- + +V Fazi 2 se mesto deli na DVE vrsti prebivalcev: + +1. **ŽIVI NPCji (Named Characters)** = Glavni liki, Quest Givers, Trgovci. +2. **MRTVI NPCji (Background Population)** = Prebivalci brez dialoga, ki polnijo mesto in delajo "gužvo". + +--- + +# 1. 🌟 ŽIVI NPCji (Quest Givers) +**Kdo so:** Specifični liki z imenom, osebnostjo in trgovino. +**Kako pridejo:** **BUILD-TO-SPAWN** (Moraš zgraditi njihovo hišo/posel). + +| NPC Ime | Zgradba (Pogoj) | Vloga | +|---|---|---| +| **Župan (Mayor)** 🏛️ | Town Hall | Daje glavne queste, davke, zakone. | +| **Guard Captain Luka** 👮 | Police Station | Aktivira Drug System (raids), prodaja Licence. | +| **Pek (Baker)** 🥖 | Bakery | Kupuje moko, prodaja kruh. Daje "Daily Bread" quest. | +| **Učitelj (Teacher)** 📚 | School | Uči skille, prodaja knjige. | +| **Kovač Ivan** 🔨 | Smithy | Nadgrajuje orodje (Stone → Iron). | +| **Zdravnica Petra** 🏥 | Clinic | Kupuje Opium (medicinski), zdravi HP. | +| **Električar** ⚡ | Big Generator | Vzdržuje elektriko (potrebuje gorivo). | +| **Zombi Statističar** 📊 | Population Board | Upravlja Immigration Board (glej spodaj). | + +**Opomba:** Vsak od teh ima svoj dialog, quest linijo in urnik. + +--- + +# 2. 👻 MRTVI NPCji (Populacija / Background) +**Kdo so:** Generični prebivalci (Ljudje, Elfi, Gnomi...). Nimajo dialoga (samo "Hm!", "Hello!"), nimajo questov. +**Namen:** Da mesto izgleda živo (hodijo naokoli, sedijo na klopeh, gredo v trgovino). + +### **Kako Pridejo? (IMMIGRATION BOARD MEHANIKA)** + +To upravlja **Zombi Statističar** na **Population Board** (na trgu). + +**Postopek:** +1. Pristopiš do **Immigration Table**. +2. Vidiš "Housing Requests" (Questi za materiale). +3. **Primer Questa:** "Need 500 Wood + 50 Bread for New Housing Block". +4. Dostaviš materiale. +5. 🏗️ **Housing Block se zgradi** (avtomatično ali čez noč). +6. 🚌 **Avtobus/Karavana pripelje nove "Mrtve NPCje".** +7. Populacija na tabli se poveča (+5 prebivalcev). + +--- + +# 3. 🌍 BIOME RACES (Nove Rase) + +Ko odkleeš nove biome, se na Immigration Tabli pojavijo zahteve za **Drugačne Rase**. + +| Odklenjen Biom | Nova Rasa v Mestu | Pogoj na Tabli | +|---|---|---| +| **Grassland** (Start) | **Ljudje (Survivors)** | 50 Bread, 100 Wood | +| **Forest** 🌲 | **Elfi (Wood Elves)** | 50 Bows, 100 Hardwood | +| **Desert** 🏜️ | **Nomadi (Desert Folk)** | 50 Cactus Water, 100 Sandstone | +| **Swamp** 🐸 | **Axolotls (Humanoid)** | 50 Pearls, 100 Moss | +| **Caves** ⛏️ | **Gnomi / Dwarves** | 50 Gold Ore, 100 Stone | + +**Rezultat:** +Bolj ko raziskuješ svet (Faza 3+), bolj **pisano in raznoliko** postaja tvoje mesto! +Na začetku so samo ljudje. Na koncu imaš Elfe, Gnomes in Axolotls ki hodijo po HIPODEVIL666CITY! + +--- + +# 4. 🏙️ KAJ SMO DODALI V IZGRADNJO MESTA? + +Poleg glavnih zgradb (Town Hall, Police, Bakery...), smo dodali **DEKORATVNE in INFRASTRUKTURNE** elemente za Fazo 2: + +### **Infrastruktura (Za Mrtve NPCje):** +- **Housing Blocks (A, B, C):** Stanovanjski bloki za populacijo. + - *Tier 1:* Šotori (Tents) + - *Tier 2:* Lesene hiške (Wooden Shacks) + - *Tier 3:* Opečne hiše (Brick Houses) +- **Klopi (Benches):** Kjer mrtvi NPCji sedijo in počivajo. +- **Parki:** Kjer se "sprehajajo". +- **Tržnica (Stalls):** Kjer "navidezno" kupujejo stvari. + +### **Posebni Dodatki (Hipodevil666 Style):** +- **Graffiti Wall:** Zombiji včasih čečkajo grafite (Worker Zombie - Sanitation jih čisti). +- **Vending Machines:** Prodajajo pijačo. +- **Neon Znaki:** Za nočno vzdušje (Electrician mora vzdrževati Generator!). +- **Statue of the Founder:** (Lahko zgradiš svoj kip kasneje). + +--- + +# 🎯 POVZETEK FAZA 2 SISTEMA + +1. Zgradiš **Town Hall** → Pride **Župan** (Daje main queste). +2. Zgradiš **Population Board** → Pride **Zombi Statističar**. +3. Preveriš **Immigration Tablo**: "Rrabim 100 lesa za hiše". +4. Dostaviš les → Zgradi se **Housing** → Pride **5 Generic NPCjev (Mrtvih)**. +5. Mesto izgleda bolj živo. +6. Ponavljaš za nove rase (Elfi, Gnomi) ko odkleneš biome. + +To je **"SIM CITY"** element v tvoji RPG igri! 🏗️🌆 + +--- + +# 5. 🦇 NOČNI GLASNIKI (Mail & Rewards) + +Ker je mesto oddaljeno (1 dan hoje), so NPCji našli način komunikacije: + +### **1. POŠTAR NETOPIR (Mail Bat) 🦇** +- **Vloga:** Dostavlja pisma, novice, in quest items (Majhne pakete). +- **Kdaj pride:** Ponoči (ob 20:00). +- **Animacija:** Prileti v tvoj nabiralnik, odvrže pismo, visi na glavo za trenutek. +- **Lore:** Trenirani mutirani netopirji iz jam. + +### **2. NAGRADNA SOVA (Quest Owl) 🦉** +- **Vloga:** Dostavlja nagrade za opravljene queste (Coins, Rare Seeds). +- **Kdaj pride:** Ob zori (06:00) ali ko zaključiš quest na daljavo. +- **Animacija:** Tiho pristane na ograji, "Hoo-Hoo!", odvrže vrečko. +- **Lore:** Modra sova, simbol modrosti (in loot-a). + +**Zakaj?** +Da ne rabiš hoditi v mesto (1 dan) samo da prebereš pismo od Župana! + +--- + +# 6. 🏛️ MUZEJ & KULTURA + +V mestu (HIPODEVIL666CITY) se nahaja tudi **MUZEJ**. + +### **Kustos (Curator) NPC:** +- **Zgradba:** Museum (Build Cost: 1000 Zoombucks) +- **Vloga:** Zbira artefakte, fosile, in redke predmete. +- **Mehanika:** + - Prineseš mu "Ancient Coin" ali "T-Rex Bone". + - On to razstavi. + - Več eksponatov = Več turistov (Mrtvih NPCjev) = Več denarja za mesto! + +--- + +# 7. 👻 GHOST TOWNS (Manjša Naselja) + +Po celotni mapi (v drugih biomih) so raztresena **MANJŠA NASELJA**. + +**Značilnosti:** +- **Ni Živih NPCjev:** Vsi so pobegnili ali umrli. +- **Mrtvi NPCji (Zombiji):** Večinoma zombiji, ki "oživljajo" stare rutine. +- **Side Questi:** Najdeš "Old Diary" ali "Lost Locket", ki sproži quest. +- **Loot:** Tu najdeš redke recepte in materiale (Old Gears, Blueprints). + +**Primeri:** +- **Forest Village:** Zapuščene lesene koče, zombi drvarji. +- **Desert Outpost:** Trgovska postojanka, zombi trgovci (napadalni). +- **Swamp Shacks:** Ribiči (zombiji), strupeni plini. + +**Cilj:** +Očistiš Ghost Town → Lahko postane **Outpost** za tvoje Zombie Workerje (rudnik, gozdarska postaja)! diff --git a/ZOMBIE_JOBS_AND_TOWN_BOARD.md b/ZOMBIE_JOBS_AND_TOWN_BOARD.md new file mode 100644 index 000000000..4e6cd931c --- /dev/null +++ b/ZOMBIE_JOBS_AND_TOWN_BOARD.md @@ -0,0 +1,125 @@ +# 🧟 ZOMBIE JOBS & TOWN REQUESTS (Faza 2 Systems) +**Status:** ✅ DETAILED DESIGN + +--- + +# 1. 🧟 IZPOSOJA ZOMBIJEV (Zombie Renting System) + +V mestu so **NPC MOJSTRI** (Masters), ki potrebujejo delovno silo. +Ti dobiš **POVPRAŠEVANJE NA DOM** (preko Netopirja 🦇), da potrebujejo specifične zombije. + +### **⚡ ELEKTRIČAR (NPC Mojster)** +- **Kdo je:** Živi NPC v mestu, skrbi za elektriko. +- **Request:** *"Hej, generator rabi pogon! Imaš kakega zombija z veliko kondicijo?"* +- **Tvoja Naloga:** Pošlješ mu **"Runner Zombie"** (visoka Stamina). +- **Delo Zombija:** Teka na "Hamster Wheel" generatorju. +- **Zaslužek:** Dnevna najemnina + nižji račun za elektriko. + +### **🧹 GLAVNI SMETAR (Sanitation Chief NPC)** +- **Kdo je:** Živi NPC, obseden s čistočo. +- **Request:** *"Mesto je umazano! Rabim čistilce!"* +- **Tvoja Naloga:** Pošlješ mu **"Basic Zombies"**. +- **Delo Zombija:** Pobirajo smeti, čistijo grafite. +- **Zaslužek:** Zoombucks + najdeni itemi v smeteh (Recycling Loot). + +### **🏗️ VODJA GRADBIŠČA (Foreman NPC)** +- **Kdo je:** Živi NPC, gradi nove hiše. +- **Request:** *"Zidamo novo krilo muzeja! Rabim močne roke!"* +- **Tvoja Naloga:** Pošlješ mu **"Tank/Strong Zombies"** (visoka Moč). +- **Delo Zombija:** Nosijo težke kamne, mešajo beton. +- **Zaslužek:** Veliko denarja + hitrejša gradnja mesta. + +**Povpraševanje (Mail Request):** +Pismo pride v tvoj nabiralnik: +> *"NAROČILO: 3x Strong Zombie za 5 dni. Plačilo: 500 Zoombucks. Sprejmeš?"* + +--- + +# 2. 📋 TOWN BOARD (Sezonske Zahteve & Hrana) + +Na trgu stoji velika **OGLASNA DESKA** (Town Board). +Tu NPCji pišejo, kaj potrebujejo iz tvoje farme (Sezonska hrana!). + +### **Sezonske Zahteve (Seasonal Food Requests):** +- **🎃 HALLOWEEN (Jesen):** + - *"Pek rabi 50 Buč (Pumpkins) za pite!"* + - **Nagrada:** Denar + Pumpkin Pie Recept. + +- **❄️ ZIMA:** + - *"Župan rabi 50 Krompirja in 20 Zelja za Juho za brezdomce."* + - **Nagrada:** Winter Coat + Reputation Boost. + +- **🍓 POLETJE:** + - *"Trgovina rabi 100 Jagod in 50 Lubenic za Smoothije!"* + - **Nagrada:** Rare Summer Hat + Sprinkler. + +### **Gradbene Zahteve:** +- *"Town Wall Repair: Need 500 Stone."* +- *"New Bridge: Need 200 Hardwood."* + +--- + +# 3. 🏃 ZOMBIE COURIER (Kurirska Služba) + +Ker je mesto oddaljeno **1 dan hoje**, se ti ne da vedno hoditi tja samo zato, da oddaš 50 Buč Pecu. + +**Rešitev:** Pošlješ svojega Zombija! + +### **Kako Deluje:** +1. Imaš "Runner Zombija" (hiter, nahrbtnik). +2. Doma mu napolniš nahrbtnik z robo (npr. 50 Buč). +3. **Ukaz:** *"Go to Bakery!"* +4. **Akcija:** + - Zombi teče v mesto (samostojno). + - Odda paket Pecu. + - Prevzame plačilo. + - Teče nazaj na farmo. + +**Rizik:** +- Če zombija napadejo banditi/divji zombiji, lahko izgubi tovor! +- Moraš ga opremiti z orožjem ali poslati spremstvo (Bodyguard Zombie). + +**Benefit:** +Ti delaš na farmi, zombi pa opravlja logistiko! + +--- + +# 4. 🏰 OBZIDJE & STRAŽNI STOLPI (Defense System) + +HIPODEVIL666CITY potrebuje zaščito pred nočnimi hordami! + +### **A) MESTNO OBZIDJE (Walls):** +Mesto je ranljivo, dokler ne zgradiš zidu. +- **Tier 1: Lesena Palisada (Wooden Palisade)** + - *Cost:* 500 Wood. + - *HP:* Low. Zombiji jo ponoči prebijejo. +- **Tier 2: Kamniti Zid (Stone Wall)** + - *Cost:* 1000 Stone + 100 Iron. + - *HP:* High. Zdrži večino napadov. +- **Tier 3: Armiran Beton (Reinforced Concrete)** + - *Cost:* 200 Steel + 500 Concrete. + - *HP:* Indestructible. Popolna varnost. + +**Vrata (City Gates):** +- Odprejo se ob 06:00 (Zora). +- Zaprejo se ob 20:00 (Mrak). +- Če ostaneš zunaj... srečno! + +### **B) STRAŽNI STOLPI (Watchtowers):** +Postaviš jih na vogalih obzidja. + +- **Funkcija:** Avtomatsko streljanje na sovražnike v dosegu. +- **Posadka (Crew):** + 1. **Guard NPC:** Mestna straža (Mrtvi NPCji s sulicami). + 2. **Zombie Sniper (Tvoj Zombi):** + - Če imaš **Licenco**, lahko postaviš svojega zombija z lokom/puško! + - Zombiji NIKOLI ne zgrešijo! + - Benefit: Tvoj zombi dobi Combat XP. + +- **Upgrades:** + - **Reflektorji (Spotlights):** Osvetlijo napadalce in jih upočasnijo. + - **Alarm:** Opozori igralca, če so vrata napadena. + +**Rezultat:** +Tvoje mesto postane **TRDNJAVA**. Ponoči lahko mirno spiš (ali delaš v kleti), medtem ko tvoji zombi ostrostrelci branijo mesto! +