Files
novafarma/docs/COLLECTORS_ALBUM_SYSTEM.md
2026-01-20 01:05:17 +01:00

184 lines
5.5 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)**
- **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!).