Files
novafarma/docs/COLLECTORS_ALBUM_SYSTEM.md

211 lines
7.2 KiB
Markdown

# 📖 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 - Faza 1 Limit)**
- **Vsebuje (6 Species):**
1. **Postrv (Trout):** Reka, podnevi. (Common)
2. **Brancin (Bass):** Jezero/Ribnik. (Common)
3. **Losos (Salmon):** Reka, ko dežuje. (Rare)
4. **Zlata Ribica (Golden Fish):** Zelo redka! (Legendary - Muzej item)
5. **Som (Catfish):** Samo ponoči (Night). (Uncommon)
6. **Mutant Riba (Radioactive Fish):** Zelena, sveti. Daje sevanje! (Unique)
- **Info:**
- Lokacija (Reka, Jezero)
- Time (Dan/Noč)
- "Record Size" (tvoja največja ujeta riba)
- **Uporaba (Usage):**
- **🍽️ Hrana:** Pečenje na ognju (Energy +20).
- **💰 Prodaja:** Dobiš Zlatnike.
- **🏛️ Muzej:** Doniraj za akvarij (Public Aquarium).
- **🏠 Doma: **
- **Mali Akvarij (Furniture):** Postaviš na polico za okras.
- **Veliki Akvarij (Luxury Tank - Late Game):** Samostoječ kos pohištva (3x1 tile), osvetljen, za več rib hkrati!
- **Ribnik (Fish Pond - Faza 2):** Zgradiš ribnik in gojiš ribe (se razmnožujejo + kaviar!).
### **💎 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 & SMALL CREATURES (Žuželke & Golazen)**
- **Vsebuje:**
- **Leteče:** Beli Metulj, Čebela, Muha, Krvoločni Komar (agresiven!).
- **Lezeče:** Deževnik (po dežju), Polž (po dežju), Mravlja (kolone), Zlati Hrošč, Pikapolonica.
- **Info:**
- **Lokacija:** Travnik, kompost, drevesa.
- **Orodje:** **MREŽA ZA ŽUŽELKE (Bug Net)** - *Craftable!*
- **Shranjevanje:** Ko jih uloviš, gredo avtomatsko v **PLASTIČEN TERARIJ (Item)** v tvojem inventarju. (Ne moreš jih nositi v žepu!).
### **🍯 ČEBELNJAK (Beehive Progression)**
- **Faza 1 (Divji panj):** Najdeš na drevesu. Nevarno! Dobiš malo medu.
- **Faza 2 (Domači panj):** Zgradiš leseno škatlo. Rabiš uloviti "Queen Bee".
---
### **🛠️ ORODJE - DELI & SESTAVLJANJE (Scrap Crafting)**
Napredna orodja (Motorka, Laksarca) **NE MOREŠ KUPITI**.
Moraš jih **SESTAVITI** iz rezervnih delov, ki jih najdeš v smeteh/mestu:
- **Motorna Žaga (Chainsaw):** Rabiš *Motor*, *Verigo*, *Ohišje*.
- **Laksarca (Trimmer):** Rabiš *Motor*, *Glava z nitko*, *Palica*.
- **Gorivo:** Obe orodji rabita Bio-Gorivo ali Bencin!
### **🐾 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!).