This commit is contained in:
2026-01-19 16:49:32 +01:00
parent 8631958ade
commit 517e6b6b92
3 changed files with 478 additions and 0 deletions

183
COLLECTORS_ALBUM_SYSTEM.md Normal file
View File

@@ -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!).

View File

@@ -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)!

View File

@@ -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!