# 🎮 DOLINASMRTI - PRODUCTION GAME BIBLE v2.0

**Created:** 06.01.2026 21:30 CET  
**Last Updated:** 07.01.2026 22:30 CET  
**Source:** Merged from `generate_assets_full.py` + GAME_BIBLE v1  
**Version:** Alpha 2.1 - Production Active + Asset Generation  
**Status:** 🔥 MASTER VERSION - 13,500+ Assets, 20 Biomes, 109 Creatures, Full Systems! | **+180 NEW ASSETS JAN 7!**

---

## 📋 PRODUCTION STATUS LEGEND

| Symbol | Status | Phase |
|--------|--------|-------|
| ✅ | **DONE** - Fully implemented | All Phases |
| 🔄 | **IN PROGRESS** - Partially complete | Phase 1/2 |
| ❌ | **NOT STARTED** - Planned but not implemented | Phase 3+ |
| 🎯 | **DEMO PRIORITY** - Required for Kickstarter demo | Demo Phase |
| 🔥 | **PHASE 1 CRITICAL** - Must have for Alpha 1 | Phase 1 |
| ⚡ | **PHASE 2 ESSENTIAL** - Must have for Alpha 2 | Phase 2 |

---

## 📖 TABLE OF CONTENTS

1. [📚 Story & Setting](#-story--setting) - 🔥 **PHASE 1 CRITICAL**
2. [👥 Main Characters](#-main-characters) - ✅ **DONE** (References Generated!)
3. [🏘️ NPCs & Factions](#️-npcs--factions) - ✅ **166/166 DONE!**
4. [🐾 Creatures & Bosses](#-creatures--bosses) - 🔄 **22/109 Generated**
5. [🌍 Biomes & Locations](#-biomes--locations) - ✅ **20/20 Defined**
6. [🌾 Crops & Agriculture](#-crops--agriculture) - 🔄 **Partial**
7. [⚔️ Items & Equipment](#️-items--equipment) - ❌ **Not Started**
8. [🏛️ Buildings & Structures](#️-buildings--structures) - 🔄 **Partial**
9. [⚙️ Game Systems & Mechanics](#️-game-systems--mechanics) - 🔄 **In Development**
10. [🎨 Art & Audio](#-art--audio) - ✅ **Style Guide Done**
11. [📊 Production Summary](#-production-summary)

---

## 📚 STORY & SETTING
**Status:** 🔥 **PHASE 1 CRITICAL** | ✅ **LOCKED & APPROVED**

### **Title:** Krvava Žetev (DolinaSmrti / Bloody Harvest)

### **Genre:** 
- Survival RPG
- Farming Simulator  
- Post-Apocalyptic Adventure
- Story-Driven Exploration

### **Platform:** PC (Web-based, JavaScript/Phaser 3)

### **Target Audience:** 
- Age: 16+ (mature themes)
- Players who enjoy: Stardew Valley, Don't Starve, Project Zomboid
- Story-driven gameplay with emotional depth

### **Unique Selling Points:**
1. **Emotional Twin Bond Story** - Find your lost sister Ana
2. **Zombie Worker Management** - Control zombies, don't fight them all
3. **Gritty Noir Art Style** - Dark, hand-drawn, mature aesthetic
4. **Micro to Macro Farm** - Start with 8×8 plot, grow to empire
5. **180+ NPCs** with deep personalities and quests
6. **20 Biomes** to explore across post-apocalyptic Slovenia
7. **Multiple Endings** based on player choices

---

## 📚 STORY & SETTING

### **Opening (The Truth Kai Doesn't Remember):**
> "My name is... I don't know. I woke up here. I don't remember anything. But something inside me... a feeling... tells me I'm searching for someone."

### **The REAL Incident (Day 0 - What Actually Happened):**
- **2084** - Slovenia, Happy Family Farm
- Kai & Ana Marković - 14-year-old **TWIN SISTERS** (yes, both girls!)
- Living peaceful life with parents Marko & Elena
- **Day 3:** Zombie outbreak begins
- **Day 7:** **Giant Troll King** attacks their farm
  - Parents sacrifice themselves protecting twins
  - Troll King kidnaps Ana, drags her through portal
  - Kai fights back, gets **MASSIVE HEAD TRAUMA** when thrown into wall
  - **FULL AMNESIA** - Kai remembers NOTHING!

### **Present Day (Game Start - Day 7, Hours Later):**

**KAI'S PERSPECTIVE:**
- Wakes up in basement ruins, disoriented
- Severe headache, bloodstain on wall
- **NO MEMORY** of who she is
- Finds ID card: "Kai Marković, Age: 14"
- Finds photos on wall (herself + unknown girl + adults)
- Feels strange pull in chest (Twin Bond - damaged but present)
- **Doesn't know:**
  - She has a twin sister named Ana
  - Parents are dead
  - What happened 3 days ago
  - Why she feels this inexplicable emptiness

**ANA'S PERSPECTIVE** (If playing Ana's Story):
- Wakes up in **Chernobyl Reactor Core - Level 7** (prison cell!)
- **FULL MEMORY** of abduction (traumatic but clear!)
- Remembers:
  - Parents dying to save them
  - Giant Troll King grabbing her
  - Kai's unconscious body (last image before portal closed)
  - **Twin Bond feels weak/damaged** (Kai's amnesia blocking it!)
- **Mission:** Survive captivity, send signals to Kai, prepare escape

### **Twin Bond Mechanic (Both Perspectives):**

**KAI (Amnesia = Broken Bond):**
- Starts with vague "pull" sensation (direction unknown)
- Finding Ana's belongings → **Flashback cutscenes** (memory fragments!)
- Each memory restored → Twin Bond strengthens
- **50/50 memories** unlocked → Full Bond restored!
- Then can sense Ana's exact location

**ANA (Full Memory = One-Way Bond):**
- Can SEND signals to Kai (telepathic beacons)
- Feels when Kai gets close to her items
- Heartbreak: Kai doesn't respond (amnesia!)
- Keeps trying anyway (hope!)

### **Main Antagonist:**
- **Dr. Viktor Krnić** - Mad scientist who **INTENTIONALLY** released virus!
- Orchestrated Giant Troll King attack
- Wants Ana's blood (contains cure component!)
- Holding Ana prisoner in Chernobyl
- **NOT** Viktor's first attempt (hinted he's done this to other families!)

### **GIANT TROLL KING** (FINAL BOSS):
- **NOT Zmaj Volk** - Zmaj Volk is CUT from game! ❌
- Giant Troll King = **Separate entity**
- 5m tall, incredibly powerful
- Under Viktor's control (via dark magic/tech)
- Kidnapped Ana on Day 7
- **Final Battle:** Chernobyl Reactor Core (3-phase boss fight!)
- Can be killed OR freed from control (endings!)

### **The World:**
- **Slovenia Post-Apocalypse** (Valley of Death = Dolina Smrti)
- **20 diverse biomes:**
  - 9 Normal: Grassland, Forest, Swamp, Desert, Mountain, Snow, Wasteland, Tropical, Radioactive
  - 11 Magical: Dino Valley, Mythical Highlands, Endless Forest, Loch Ness, Catacombs, Egyptian Desert, Amazon, Atlantis, Chernobyl, **Mexican Cenotes, Witch Forest**
- **27 explorable towns** (1 per train station!)
- **Scattered biomes** (150km apart!) - Must travel to discover!
- Mix of realistic Slovenia + fantasy anomalies

---

## 👥 MAIN CHARACTERS
**Status:** ✅ **DONE** | 🎯 **DEMO READY** | 🔥 **PHASE 1 COMPLETE**

| Character | Master Reference | Sprites | Status | Phase |
|-----------|-----------------|---------|--------|-------|
| Kai Marković | ✅ Generated | ❌ Not Started | 🔄 Partial | 🎯 DEMO |
| Ana Marković | ✅ Generated | ❌ Not Started | 🔄 Partial | 🎯 DEMO |
| Gronk (Troll) | ✅ Generated | ❌ Not Started | 🔄 Partial | 🎯 DEMO |
| Susi (Dog) | ✅ Generated | ❌ Not Started | 🔄 Partial | 🎯 DEMO |
| Dr. Viktor Krnić | ❌ Not Generated | ❌ Not Started | ❌ Planned | ⚡ Phase 2 |

---

### **1. Kai Marković** (Playable Character - Kai's Story)
**Age:** 14 (NOT 17!)  
**Gender:** FEMALE (twin sister to Ana!)  
**Role:** Protagonist, Alpha Hybrid, Farmer, Memory-Lost Twin  

**Appearance:**
- **Pink and green dreadlocks** (signature look)
- **Stretched ear gauges** with multiple piercings
- Facial piercings (nose, lip, eyebrow)
- **Katana** strapped to back (main weapon)
- Post-apocalyptic clothing (torn jacket, ripped jeans)
- Dark combat boots
- Brown survival backpack
- Athletic, wiry build

**Visual Reference:** `/references/kai/`
- Style 32 Dark-Chibi Noir
- Red eyes with dark pupils (human, NOT zombie)
- Confused/determined expression (amnesia!)

**Personality (Before Amnesia):**
- Protective of Ana
- Brave, sometimes reckless
- Creative problem-solver
- Loved farming with parents

**Personality (After Amnesia - Game Start):**
- **COMPLETELY LOST** - doesn't know who she is!
- Driven by instinct (Twin Bond pull)
- Slowly rebuilds identity through memories
- Desperate to understand the emptiness inside

**Abilities:**
- **Alpha Hybrid Power:** Control zombies telepathically
- Farming skills (muscle memory intact!)
- Combat (learns as game progresses)
- Crafting & building
- Twin Bond (damaged, restores with memories!)

**Character Arc:**
- **Day 7:** Wakes with NO memory, confused
- **Week 1-10:** Finds 1-20 memories (fragments of childhood)
- **Week 11-30:** Finds 21-40 memories (remembers Ana's face!)
- **Week 31-50:** Finds 41-49 memories (remembers parents' death)
- **Memory 50/50:** Full memory restored - **EMOTIONAL BREAKDOWN**
- **Endgame:** Storms Chernobyl to save Ana

---

### **2. Ana Marković** (Dual Protagonist)
**Age:** 14 (Kai's twin sister!)  
**Gender:** FEMALE  
**Role:** Dual Protagonist (playable!) / Captive Scientist / Cure Key  

**Appearance:**
- **Light blonde hair** (short, practical cut)
- **Blue eyes WITH pupils** (friendly NPC style)
- Style 32 Dark-Chibi Noir aesthetic
- Scientist aesthetic (lab coat over survival clothes)
- Research backpack with supplies

**Status in Kai's Story:** 
- **Missing** (kidnapped by Giant Troll King)
- **Alive** (held captive in Chernobyl Reactor Level 7)
- Her 50 belongings scattered across world

**Ana's Story Gameplay:**
- **Playable character** in "Ana's Story" mode!
- Start: Prison cell, Day 7
- **Full memory** (knows everything!)
- Must survive, research, plan escape
- Write 50 diary pages (same ones Kai finds!)
- Send Twin Bond signals to Kai

---

### **3. Gronk** (Companion)
**Role:** Kai's friend, Tamed Troll, Comic Relief  

**Appearance:**
- MASSIVE green troll (3m tall)
- **Pink dreadlocks** (signature style)
- **Stretched ear gauges** with piercings
- **Vape** always in hand (essential accessory)
- Black t-shirt: "TROLL SABBATH" (purple text)
- Torn baggy black skater pants
- Pink sneakers

**Personality:**
- Gentle giant despite size
- Loves vaping (various flavors)
- Loyal to Kai after being saved
- ADHD-coded (short attention, impulsive)

**Abilities:**
- Incredible strength (lifts boulders)
- Tank/defender in combat
- Can break through walls
- Special "Earthquake Slam" ability

---

### **4. Susi** (Dog Companion)
**Breed:** Dachshund - Brown with darker spots, long body, floppy ears, cute  
**Abilities:**
- Finds hidden items
- Warns of danger
- Loyal companion

---

### **5. Dr. Viktor Krnić** (Main Antagonist)
**Role:** Mad scientist villain  
**Goal:** Extract cure from Ana's blood (will kill her)  
**Controls:** Giant Troll King, mutant army  
**Final Boss:** Chernobyl reactor showdown

---

## 📊 MASTER ASSET COUNTS

| Category | Count | Status |
|----------|-------|--------|
| **NPCs & Characters** | ~200+ | From script registry |
| **Livestock Animals** | ~150 | From script registry |
| **Wildlife** | ~200 | From script registry |
| **Monsters & Mutants** | ~500 | From script registry |
| **Bosses** | 25 | From script registry |
| **Crops & Plants** | ~500 | With growth stages |
| **Items & Tools** | ~2000 | Multi-tier materials |
| **Buildings** | ~300 | Farm + Town + Special |
| **Biomes** | 20 | 9 Normal + 11 Magical |
| **Environment** | ~800 | Terrain, nature, weather |
| **UI Elements** | ~200 | Buttons, icons, frames |
| **Workstations** | ~100 | Crafting stations |
| **TOTAL ASSETS** | **~13,500+** | Complete production target |

---

## 🏘️ NPCs & FACTIONS
**Status:** ✅ **166/166 BIOME NPCs DONE!** | 🔥 **PHASE 1 COMPLETE** | Generated: 06.01.2026

| NPC Category | Count | Master Refs | Sprites | Status | Phase |
|--------------|-------|-------------|---------|--------|-------|
| **Main Characters** | 4 | ✅ 4/4 | ❌ 0/4 | 🔄 Refs Done | 🎯 DEMO |
| **Verified NPCs** | 11 | ✅ 11/11 | ❌ 0/11 | 🔄 Refs Done | 🔥 Phase 1 |
| **Biome NPCs (20 biomes)** | 166 | ✅ 166/166 | ❌ 0/166 | ✅ **100% REFS** | 🔥 Phase 1 |
| **Town NPCs** | ~190 | ❌ 0/190 | ❌ 0/190 | ❌ Not Started | ⚡ Phase 2 |
| **Zombi Skavt (5 stages)** | 5 | ❌ 0/5 | ❌ 0/5 | ❌ Not Started | ⚡ Phase 2 |
| **Nomad Raiders (12 types)** | 12 | ❌ 0/12 | ❌ 0/12 | ❌ Not Started | ⚡ Phase 2 |
| **TOTAL NPCs** | **~388** | **✅ 181/388** | **❌ 0/388** | **🔄 47% Refs** | Multiple |

---

### Main Characters (4)

1. **Kai Marković** - Young farmer with pink/green dreadlocks, ear gauges, piercings, katana on back, torn jacket, athletic build, red eyes with pupils
2. **Ana Marković** - Kai's twin sister, blonde hair, blue eyes with dark pupils, scientist explorer outfit, research backpack
3. **Gronk Alpha Troll** - MASSIVE green troll, pink dreadlocks, ear gauges, nose ring, vape in hand, 'TROLL SABBATH' t-shirt, torn pants, pink sneakers
4. **Susi the Dachshund** - Brown with darker spots, long body, floppy ears, cute companion

### Verified NPCs (11)

From `/references/npcs/` with master_reference.png:

1. **Ivan Kovač** (Blacksmith) - Muscular build, protective goggles on forehead, blacksmith apron soot-covered, red eyes with pupils, friendly NPC
2. **Mayor/Župan** (Town Administrator) - Serious authoritative, long green coat with official sash, old tablet computer, red eyes with pupils, friendly NPC
3. **Kustos** (Museum Curator) - Wise old scholar, glasses, notebook, examining artifacts, red eyes with pupils, friendly NPC
4. **Pek** (Baker) - Warm smile, chef's apron, flour-dusted, holding fresh bread, red eyes with pupils, friendly NPC
5. **Šivilja** (Tailor) - Elegant dress, measuring tape around neck, scissors in hand, fabric samples, red eyes with pupils, friendly NPC
6. **Tehnik** (Engineer) - Work coveralls, tool belt, goggles, tech gadgets, mechanical hands, red eyes with pupils, friendly NPC
7. **Teacher** (Educator) - Glasses, books in arms, kind expression, patient demeanor, red eyes with pupils, friendly NPC
8. **Priest Jakob** (Church) - Religious robes, holy book, peaceful expression, ceremonial cross, red eyes with pupils, friendly NPC
9. **Miro Pravnik** (Lawyer) - Older man 50s-60s, wrinkled brown office suit, rusty briefcase, tired weathered expression, red eyes with pupils, friendly NPC
10. **Arborist/Gozdar** (Tree Planter) - Work clothes green/brown, gardening gloves, seed bags, dirt-stained, calm patient expression, red eyes with pupils, friendly NPC
11. **Glavni Smetar** (Main Garbage Collector) - Work uniform, reflective vest, trash equipment, weathered hands, hardworking expression, red eyes with pupils, friendly NPC

### Companions

**Zombi Skavt** - 5 Evolution Stages (Lv 1-20):
- **Base (Lv1-4)**: Friendly zombie with RED or BLUE bandana, small backpack, red eyes WITH dark pupils, chibi zombie, helpful pose
- **Lantern (Lv5-9)**: Gains glowing lantern, bandana, backpack, red eyes with pupils, friendly zombie scout
- **Armored (Lv10-14)**: Light armor plates added, bandana, backpack, lantern, red eyes with pupils, stronger scout
- **Winged (Lv15-19)**: Small wings for flying/scouting, armor, lantern, bandana, red eyes with pupils, advanced scout
- **Legendary (Lv20)**: Glowing purple aura, all upgrades, wings, armor, lantern, bandana, red eyes with pupils, ultimate scout

### Enemies - Nomad Raiders (12 variants)

**4 types × 3 variants each:**

**Desert Nomads** (Medium threat):
- Warrior: Tan robes, scimitar, turban, desert gear, hostile expression
- Archer: Tan robes, bow and arrows, turban, desert gear, ranged enemy
- Brute: Tan robes, heavy club, turban, muscular, desert gear, tank enemy

**Frost Bandits** (High threat):
- Warrior: Fur armor, ice axe, frost gear, white/blue palette, aggressive
- Archer: Fur armor, ice bow, frost gear, white/blue palette, ranged enemy
- Brute: Heavy fur armor, ice hammer, frost gear, massive build, very aggressive

**Jungle Marauders** (Very high threat):
- Warrior: Tribal mask, poison darts, jungle gear, green/brown palette, dangerous
- Archer: Tribal mask, blowgun, poison darts, jungle gear, stealthy
- Brute: Tribal mask, massive club, jungle gear, intimidating build, very dangerous

**Tech Scavengers** (Extreme threat):
- Warrior: Cyberpunk gear, laser sword, neon-themed, menacing
- Archer: Cyberpunk gear, laser rifle, neon-themed, high-tech
- Brute: Heavy cyberpunk armor, plasma cannon, neon-themed, massive tech enemy

### Zombies (4 types)

1. **Basic Zombie** - Slow shambling, torn clothes, white eyes no pupils, weak enemy
2. **Runner Zombie** - Fast aggressive, athletic build, red eyes no pupils, dangerous
3. **Bloater Zombie** - Large swollen, about to explode, toxic green, tank enemy
4. **Worker Zombie** - Controllable by Kai, basic laborer, white eyes no pupils, friendly when controlled

### Species - Trolls

1. **Troll Male Friendly** - Similar build to Gronk, gray or blue skin, work clothes, friendly expression, red eyes with pupils, town inhabitant
2. **Troll Female Friendly** - Slightly smaller than male, different color palette, town clothing, welcoming expression, red eyes with pupils
3. **Troll Wild Enemy** - Hostile variant, ragged clothing, aggressive pose, NO pupils in eyes, enemy variant

### Species - Elves & Fairies

**Vilinci (Elf)** - Specialty crafting, pointed ears, elegant clothes, working on enchantment, magical aura, red eyes with pupils

**Vile (Fairy)** - Tiny fairy with wings, caring for plants, magical sparkles, instant growth ability, red eyes with pupils

### Generic Citizens (6 base templates × 18 biome recolors = 108)

1. **Citizen Male Worker** - Laborer clothing, neutral expression, red eyes with pupils, BASE for biome recolors
2. **Citizen Male Merchant** - Vest trader outfit, friendly expression, red eyes with pupils, BASE for biome recolors
3. **Citizen Female Farmer** - Work dress apron, kind expression, red eyes with pupils, BASE for biome recolors
4. **Citizen Female Shopkeeper** - Professional clothing, welcoming expression, red eyes with pupils, BASE for biome recolors
5. **Citizen Child** - Simple clothes energetic, playful expression, red eyes with pupils, BASE for biome recolors
6. **Citizen Elder** - Simple robes walking stick, wise expression, red eyes with pupils, BASE for biome recolors

---

## 🐾 ANIMALS & CREATURES (109 TOTAL! - COMPLETE CATALOG)
**Status:** 🔄 **99/109 Generated (91%)** | 🔥 **PHASE 1 IN PROGRESS** | Updated: **Jan 8, 2026 01:56 CET**

**Missing:** 10 creatures (7 Chernobyl Mutants, 2 Wild Animals, 1 Farm Animal)

| Category | Total | Generated | Missing | Notes |
|--------------------|-------|-----------|---------|----------|
| **Chernobyl Mutants** | 10 | 3/10 | 7 | 🔥 Phase 1 |
| **Farm Animals** | 10 | 9/10 | 1 | 🔥 Phase 1 |
| **Wild Animals** | 15 | 13/15 | 2 | 🔥 Phase 1 |
| **Dinosaurs** | 15 | 14/15 | 1 | ⚡ Phase 2 |
| **Mythical** | 39 | 39/39 | 0 | ✅ COMPLETE |
| **Bosses** | 24 | 24/24 | 0 | ✅ COMPLETE |

**Next Steps:**
- 🔥 **Phase 1:** Complete Chernobyl Mutants (7 remaining)
- ⚡ **Phase 2:** Start Dinosaurs (15 total)

---

### **1. CHERNOBYL MUTANTS (10 species)** ☢️

**Common Mutants:**
1. **Mutant Wolf** - Pack hunter, 150 HP, glowing green patches
2. **Giant Rat** - Swarms of 10-20, 80 HP, cat-sized!
3. **Mutant Crow** - Flying, 3 eyes, 40 HP
4. **Radiation Spider** - Dog-sized, poison attacks, 100 HP

**Rare Mutants:**
5. **Two-Headed Dog** - Attacks 2 targets, 200 HP, can be tamed!
6. **Radioactive Boar** - Charge attack, 180 HP, produces rad milk if captured
7. **Glowing Deer** - Bioluminescent, 120 HP, beautiful drops!
8. **Mutant Fish** - 3-eyed, catchable, radiation essence drops

**Boss-Tier:**
9. **Mutant Bear** - 500 HP, devastating attacks, LEGENDARY drops!
10. **Radioactive Cow** - 300 HP, CAPTURE for daily rad milk! (10,000g DNA sample!)

---

### **2. FARM ANIMALS (10 species)** 🐄🐔

**Core Livestock:**
1. **Chicken** - Eggs, feathers | Mutant: Three-Headed Chicken (3× eggs!)
2. **Cow** - Milk, beef | Mutant: Extra udders (2× milk!)
3. **Pig** - Truffles, ham | Mutant: Giant Pig (rideable!)
4. **Sheep** - Wool, milk | Mutant: Fire Sheep (fire wool!)
5. **Horse** - Transportation, 35 km/h | Legendary: Undead Horse!

**Additional Livestock:**
6. **Goat** - Milk, cheese, 1,000g
7. **Duck** - Eggs, feathers, water fowl
8. **Rabbit** - Meat, fur, fast breeders!
9. **Donkey** - Cargo carrier, 100km range!
10. **Llama/Alpaca** - Caravan animals (6-animal trains!), wool

---

### **3. WILD ANIMALS (15 species)** 🦊🐻

**Forest Animals:**
1. **Wolf** - Pack predator, 100 HP, can tame babies!
2. **Bear** - Tank, 300 HP, powerful attacks
3. **Wild Boar** - Charge attack, 120 HP
4. **Deer** - Fast, 80 HP, peaceful
5. **Fox** - Quick, 60 HP, sneaky
6. **Squirrel** - Tiny, collectible
7. **Badger** - Underground, aggressive
8. **Hedgehog** - Defensive spines

**Mountain/Sky:**
9. **Eagle** - Flying scout, 70 HP
10. **Owl** - Night hunter, 50 HP
11. **Bat** - Cave dweller, swarm
12. **Lynx** - Stealth predator, 90 HP
13. **Elk** - Large herbivore, 150 HP

**Wetland:**
14. **Frog** - Small, catchable
15. **Snake** - Various types, some venomous

---

### **4. DINOSAURS (15 species - Dino Valley)** 🦖

**Large Carnivores:**
1. **T-Rex** - BOSS! 1,000 HP, king of dinosaurs!
2. **Spinosaurus** - Semi-aquatic, 800 HP
3. **Allosaurus** - Pack hunter, 600 HP
4. **Carnotaurus** - Fast predator, 500 HP

**Medium Carnivores:**
5. **Velociraptor** - Pack, intelligent, 200 HP, tameable!
6. **Dilophosaurus** - Poison spit, 250 HP
7. **Compsognathus** - Tiny! Swarms, 30 HP

**Herbivores:**
8. **Triceratops** - Tank, 700 HP, charging attacks
9. **Stegosaurus** - Tail spikes, 600 HP
10. **Ankylosaurus** - Armored, club tail, 650 HP
11. **Brachiosaurus** - HUGE! 900 HP, gentle giant
12. **Parasaurolophus** - Herd animal, 400 HP
13. **Pachycephalosaurus** - Head-butt attack, 300 HP

**Flying:**
14. **Pterodactyl** - Sky hunter, 150 HP, mountable!

**Babies:**
15. **Baby Dinos** - Cute versions, tameable! (all species)

---

### **5. MYTHICAL CREATURES (39 species)** ✨🐉

#### **MYTHICAL HIGHLANDS (6):**
1. **Dragon** - Fire/Ice/Storm variants, 800 HP, ULTIMATE mount!
2. **Unicorn** - Healing aura, 300 HP, rare!
3. **Pegasus** - Flying horse, 250 HP
4. **Griffin** - Lion/eagle hybrid, 400 HP
5. **Phoenix** - Revives you 1×/day! 300 HP
6. **Yeti** - Mountain giant, 500 HP

#### **ENDLESS FOREST CRYPTIDS (3):**
7. **Bigfoot** - Gentle giant, 400 HP, peaceful
8. **Wendigo** - Hostile spirit, 350 HP, night hunter
9. **Werewolf** - Full moon only! 300 HP, silver weakness

#### **LOCH NESS & CELTIC (6):**
10. **Nessie** - BOSS! Lake monster, 900 HP
11. **Kelpie** - Water horse, 200 HP, shapeshifter
12. **Selkie** - Seal-human, peaceful, trader
13. **Leprechaun** - Gold hoarder, 50 HP, trickster
14. **Banshee** - Wailing spirit, 150 HP, fear attack
15. **Brownie** - House spirit, farm helper

#### **ATLANTIS (4):**
16. **Mermaid** - Male + Female, 150 HP, underwater
17. **Kraken** - BOSS! 1,200 HP, tentacle attacks!
18. **Sea Serpent** - 600 HP, ocean predator
19. **Sea Dragon** - 700 HP, underwater mount

#### **EGYPTIAN DESERT (4):**
20. **Sphinx** - BOSS! 800 HP, riddle giver
21. **Mummy** - Undead, 200 HP, curse attacks
22. **Giant Scarab** - 400 HP, underground
23. **Anubis Guardian** - 500 HP, temple protector

#### **WITCH FOREST (4):**
24. **Baba Yaga** - BOSS! Witch, 700 HP, flying mortar!
25. **Witch** - Various types, 150 HP
26. **Black Cat** - Familiar, 30 HP, magic
27. **Raven** - Magical, 40 HP, scout

#### **MEXICAN CENOTES (2):**
28. **Quetzalcoatl** - BOSS! Feathered serpent, 850 HP
29. **Axolotl** - 6 variants! Tameable, adorable!

#### **AMAZON RAINFOREST (6):**
30. **Giant Anaconda** - BOSS! 50m long! 900 HP
31. **Jaguar** - Apex predator, 250 HP
32. **Piranha** - Swarms, 20 HP each
33. **Poison Dart Frog** - Tiny, deadly, 10 HP
34. **Sloth** - Slow, peaceful, 80 HP
35. **Toucan** - Colorful, 40 HP
36. **Capybara** - Largest rodent, 100 HP, friendly!

#### **🦎 CHUPACABRA (3 VARIANTS!) - ADDED 06.01.2026:**

**37. Mexican Chupacabra** 🇲🇽
- **Location:** Mexican Cenotes biome
- **Appearance:** Reptilian, spines on back, red eyes, gray skin
- **HP:** 250
- **Attack:** Blood drain (life steal!)
- **Behavior:** Night hunter, attacks livestock!
- **Drops:** Chupacabra Fang, Blood Essence
- **Origin:** Original Latin American cryptid

**38. Mutant Chupacabra** ☢️
- **Location:** Chernobyl/Wasteland
- **Appearance:** Hairless, glowing eyes, radiation scars, GREEN drool!
- **HP:** 300
- **Attack:** Blood drain + radiation damage
- **Behavior:** Radioactive predator
- **Drops:** Radioactive Fang, Mutant DNA
- **Origin:** Radiation-mutated variant

**39. Cryptid Chupacabra** 🌲
- **Location:** Endless Forest
- **Appearance:** Mystery cryptid, rarely seen, shadowy
- **HP:** 280
- **Attack:** Stealth blood drain
- **Behavior:** Stealth predator, VERY rare spawn (1% chance!)
- **Drops:** Pure Blood Essence (LEGENDARY!), Cryptid Fur
- **Origin:** Classic cryptozoology version

**Total Mythical Creatures:** 39 (was 36, +3 Chupacabra!)

---

### **6. WORKER CREATURES (6 types)** 🧚⚒️

**1. Vilinci (Elves)**
- Specialty: Crafting
- Auto-crafting, enchanting

**2. Gnomi (Gnomes)**
- Specialty: Mining
- Ore detection, garden help

**3. Vile (Fairies)**
- Specialty: Plant care
- Instant growth, blessings

**4. Bigfoot/Yeti**
- Specialty: Gathering
- Forest/Snow operations

**5. Golem**
- Specialty: Labor
- Construction, defense

**6. Zmaj (Dragon)**
- Specialty: ULTIMATE
- Mount, fire breath, treasure finder

---

### **📊 CREATURE SUMMARY:**

| Category | Count | Tameable? | Notes |
|----------|-------|-----------|-------|
| Chernobyl Mutants | 10 | Some babies | Radioactive, dangerous |
| Farm Animals | 10 | Yes | Breeding, production |
| Wild Animals | 15 | Babies only | Natural ecosystem |
| Dinosaurs | 15 | Babies only | Dino Valley exclusive |
| Mythical Creatures | 39 | Some | Magical, rare (includes 3 Chupacabra!) |
| Worker Creatures | 6 | Yes | Farm helpers |
| Chupacabra Variants | 3 | NO | Blood-drainers, cryptids |
| **TOTAL** | **109** | **Varies** | **Complete bestiary!** |

**NOT INCLUDING BOSSES** (separate section!)

---

## 🏘️ NPCs & FACTIONS

**Basic Farm Animals:**
- **Cows (3)**: Normal (Holstein pattern), Brown, Highland (shaggy hair)
- **Sheep (3)**: Normal (white wool), Black, Merino (extra fluffy)
- **Chickens (3)**: White, Brown, Rooster
- **Pigs (3)**: Normal (pink), Spotted, Wild boar variant
- **Horses (3)**: Brown, White, Black
- **Goats (2)**: Normal, Angora
- **Ducks (2)**: White, Mallard
- **Other (6)**: Goose, Turkey, Farm Rabbit, Llama, Alpaca, Donkey

**Mutant/Magic Variants:**
- Golden Cow, Fire Sheep, Ice Sheep, Golden Fleece Sheep
- Phoenix Chicken, Rainbow Chicken, Three-Headed Chicken
- Giant Pig (rideable), Undead Horse, Unicorn, Pegasus, Golden Goose

### Wildlife (~200 assets)

**Forest Animals:**
Fox (red, arctic), Deer (normal, doe, fawn), Rabbit (wild, arctic), Hedgehog, Squirrel (red, grey), Raccoon, Skunk, Opossum, Beaver, River Otter, Badger, Porcupine, Bears (brown, black, polar), Wolves (grey, white, black), Moose, Elk, Wild Boar

**Birds:**
Owls (barn, great horned, snowy), Eagles (bald, golden), Hawk, Falcon, Crow, Raven, Sparrow, Robin, Bluebird, Cardinal, Woodpecker, Hummingbird, Peacock, Swans (white, black), Pelican, Flamingo, Parrots (green, macaw)

**Insects & Small:**
Butterflies (monarch, blue, yellow), Bees (honey, bumblebee), Dragonfly, Firefly, Ladybug, Grasshopper, Cricket, Caterpillar, Snail, Slug, Worm, Frogs (green, red), Toad, Turtles (box, snapping), Snakes (garden, rattlesnake), Lizard, Gecko

**Aquatic:**
Fish (bass, trout, salmon, tuna, cod, mackerel, carp, catfish, pike, perch, goldfish, koi, clownfish, angelfish, pufferfish, swordfish, golden), Sharks (great white, hammerhead, whale shark), Rays (manta, stingray), Jellyfish (normal, lion's mane), Octopus, Squid, Crabs (red, blue), Lobster, Shrimp, Starfish, Seahorse, Whales (blue, orca), Dolphin, Seal, Walrus, Penguins (emperor, little)

---

## 👹 MONSTERS & MUTANTS (~500 assets)

### Slimes (12 types)
Green, Blue, Red, Yellow, Purple, Black, White, Rainbow, Metal, Gold, King Slime (BOSS), Queen Slime

### Undead
**Zombies (8)**: Farmer, Miner, Villager, Soldier, Knight, Giant, Dog, Crow
**Skeletons (5)**: Basic, Warrior, Archer, Mage, King (BOSS)
**Ghosts (5)**: Basic, Lantern, Wraith, Banshee, Poltergeist

### Humanoid Monsters
**Goblins (4)**: Basic, Warrior, Shaman, Chief
**Orcs (4)**: Basic, Warrior, Shaman, Warlord (BOSS)
**Trolls (4)**: Forest, Cave, Ice, Fire

### Creatures
**Spiders (4)**: Basic, Venomous, Cave, Queen (BOSS)
**Bats (4)**: Normal, Vampire, Fire, Giant
**Elementals (6)**: Fire, Water, Earth, Air, Ice, Lightning
**Golems (6)**: Stone, Iron, Crystal, Wood, Mud, Gold
**Demons (4)**: Imp, Fire, Shadow, Lord (BOSS)
**Dragons (6)**: Baby, Fire, Ice, Earth, Shadow, Ancient (BOSS)

### Mythical
Mimic, Basilisk, Cockatrice, Manticore, Chimera, Hydra, Phoenix, Griffin, Hippogriff, Centaur, Minotaur, Harpy, Siren, Medusa, Cyclops, Kraken (BOSS), Leviathan (BOSS), Werewolf, Vampire, Mummy, Lich, Treant, Will-o-wisp, Mushroom Monster, Plant Monster, Shadow Creature

---

## 👑 BOSSES (25 total)

1. Zombie King
2. Slime Emperor
3. Ancient Tree
4. Elder Dragon
5. Ice Titan
6. Lava Lord
7. Shadow Master
8. Crystal Guardian
9. Spider Empress
10. Kraken
11. Demon Prince
12. Lich King
13. Werewolf Alpha
14. Vampire Lord
15. Mummy Pharaoh
16. Minotaur King
17. Hydra
18. Chimera
19. Giant Troll
20. Orc Warlord
21. Goblin King
22. Elemental Titan
23. Golem Prime
24. Ancient Phoenix
25. Leviathan

---

## 🌍 BIOMES & LOCATIONS (20 Total - COMPLETE!)
**Status:** ✅ **20/20 DEFINED!** | 🔄 **Assets In Progress** | 🔥 **PHASE 1 PRIORITY**

| Biome Category | Count | Design | Assets | Status | Phase |
|----------------|-------|--------|--------|--------|-------|
| **Normal Biomes** | 9 | ✅ 9/9 | 🔄 Partial | 🔄 Design Done | 🔥 Phase 1 |
| **Magical Biomes** | 11 | ✅ 11/11 | ❌ None | 🔄 Design Done | ⚡ Phase 2 |
| **TOTAL BIOMES** | **20** | **✅ 20/20** | **🔄 Partial** | **✅ 100% Designed** | Multiple |

**Production Priority:**
1. 🎯 **DEMO:** Grassland (Tutorial zone) - ❌ **CRITICAL**
2. 🔥 **Phase 1:** Forest, Desert, Swamp
3. ⚡ **Phase 2:** Dino Valley, Mythical Highlands, Mexican Cenotes, Witch Forest
4. ⚡ **Phase 2:** Chernobyl (Final Boss Zone!)

---

### NORMAL BIOMES (9) - 🔥 **PHASE 1**

**1. Grassland (Travnik)** - Home base
- Ground: Lush green grass, Style 32, smooth vector
- Props: Grass variants, flower patches, small rocks

**2. Forest (Gozd)** - Dense trees
- Ground: Dark green grass with moss
- Props: Moss patches, mushrooms (red/brown), dense bushes, fallen logs

**3. Desert** - Sandy wasteland
- Ground: Golden yellow sand
- Props: Sand dunes, cacti (small/large), brown rocks, bleached skulls

**4. Mountain** - Rocky peaks
- Ground: Grey stone
- Props: Large boulders, sharp rock formations, snow patches

**5. Swamp (Močvirje)** - Foggy wetlands
- Ground: Dark brown murky mud
- Props: Murky water puddles, dead trees, hanging vines, fog effects

**6. Snow (Frozen Tundra/Arktika)** - Ice and blizzards
- Ground: Pristine white snow
- Props: Ice tiles, frozen trees, snowdrifts, icicles

**7. Wasteland** - Ruins and rubble
- Ground: Cracked grey earth
- Props: Rubble piles, scrap metal, broken machinery

**8. Tropical (Beach)** - Palm trees, coconuts
- Ground: Light golden beach sand
- Props: Palm trees, coconuts, seashells, clear blue water

**9. Radioactive Zone** - Glowing toxic
- Ground: Sickly green glow
- Props: Glowing rocks, mutant plants, barrels (toxic waste symbol), toxic puddles

### ANOMALOUS BIOMES (9) - Portal-locked

**10. Dino Valley** - Prehistoric
- Ground: Ancient green grass
- Props: Prehistoric cycad trees, large ferns, dinosaur footprints, fossils, cracked eggs

**11. Mythical Highlands** - Magical
- Ground: Purple mystic grass
- Props: Magical trees (glowing leaves), blue crystals, floating rocks with runes, rainbows

**12. Endless Forest (WITCH FOREST!)** - Cryptids
- Ground: Dark mysterious grass
- Props: Ancient massive trees, thick mystery fog, cryptid footprints, hidden trail markers

**13. Loch Ness** - Scottish highlands
- Ground: Heather moorland
- Props: Scottish pine trees, purple heather flowers, dark loch water, castle ruins

**14. Catacombs** - Underground undead
- Ground: Ancient stone floor
- Props: Scattered bones, stone tombs, skulls, dusty urns

**15. Egyptian Desert** - Pyramids
- Ground: Golden sand
- Props: Massive sand dunes, hieroglyph carved stones, golden scarabs, pyramid stone blocks

**16. Amazon Rainforest** - Piranhas & AXOLOTLS!
- Ground: Dense jungle undergrowth
- Props: Massive jungle trees, thick hanging vines, exotic pink flowers, tribal totem poles, piranha-filled rivers, pink axolotls

**17. Atlantis** - Underwater & AXOLOTLS!
- Ground: Ocean floor sand
- Props: Colorful coral reefs, ancient ruins (columns), giant pearls in oysters, flowing seaweed, rising bubble streams, blue glowing axolotls

**18. Chernobyl (FINAL ZONE!)** - Nuclear
- Ground: Contaminated grey earth
- Props: Reactor ruins, abandoned buildings (broken windows), radioactive waste barrels, Soviet propaganda posters (faded), hazmat warning signs

**19. Mexican Cenotes 🇲🇽** - Mayan underwater caves
- Ground: Limestone cave floor, crystal clear water
- Props: Mayan pyramid (small), temple ruins, stone altars, underground passages, jade deposits, cenote water (pure), axolotls (6 color variants!), stalactites/stalagmites
- NPCs (8-12): Mayan Priest, Villagers (5), Archaeologists (2), Diver, Cenote Guide, Shaman, Jade Merchant
- Boss: **Quetzalcoatl** (flying feathered serpent god!)
- Features: Crystal clear cenote diving, axolotl sanctuary, Mayan culture, ancient secrets

**20. Witch Forest 🧙** - Dark magic forest
- Ground: Cursed earth, dark grass
- Props: Witch huts (5), **Baba Yaga's Hut (walking on chicken legs!)**, dark altars (2), hanging cages, cauldron areas, ritual circles, dark herbs (5 types), cursed gems (3), poison mushrooms (6 types)
- NPCs (6-10): **Baba Yaga (BOSS!)**, Witches (3 types: hostile/neutral), Black Cat (familiar NPC - talks!), Cursed Knight, Lost Child (ghost), Potion Seller, Herbalist
- Boss: **Baba Yaga** (flies in mortar, magic attacks!)
- Special: **Baba Yaga's walking chicken-leg hut!**, Dark atmosphere, cursed areas, poison swamps, magical fog
- Reward: **Broomstick** (magical flight!) from defeating Baba Yaga

---

## 🌾 CROPS & PLANTS (~500 assets with growth stages)
**Status:** 🔄 **80/80 HARVESTED COMPLETE** | ✅ **Jan 7, 2026**

### Basic Crops (80 types) - ✅ **HARVESTED VERSIONS DONE!**

Each crop will have:
- 1 seed packet (❌ TODO)
- 4 growth stages: sprout, growing, maturing, ready (❌ TODO)
- 1 harvested product ✅ **DONE - 80/80!**

**Grains (6)**: Wheat, Corn, Rice, Barley, Oats, Rye

**Root Vegetables (7)**: Potato, Carrot, Onion, Garlic, Turnip, Radish, Beet

**Fruiting Vegetables (7)**: Tomato, Pepper, Eggplant, Cucumber, Zucchini, Pumpkin, Squash

**Leafy Greens (6)**: Lettuce, Cabbage, Spinach, Kale, Broccoli, Cauliflower

**Berries (7)**: Strawberry, Blueberry, Raspberry, Blackberry, Grape, Melon, Watermelon

**Flowers (8)**: Sunflower, Tulip, Rose, Lily, Daisy, Lavender, Poppy

**Industrial (7)**: Cotton, Flax, Hemp, Tobacco, Coffee, Tea, Cocoa

**Tree Fruits (8)**: Apple, Orange, Lemon, Peach, Pear, Cherry, Plum, Banana

**Tropical (6)**: Pineapple, Coconut, Mango, Papaya, Kiwi, Avocado

**Spices (6)**: Hop, Ginger, Turmeric, Vanilla, Cinnamon, Black Pepper

**Hot Peppers (4)**: Chili, Jalapeno, Habanero, Ghost Pepper

**Herbs (8)**: Basil, Mint, Oregano, Thyme, Rosemary, Sage, Parsley, Cilantro

**Mushrooms (4)**: Button, Shiitake, Oyster, Truffle

### Trees (23/44 done - 52%)

**Base Species (11):** Oak, Maple, Pine, Birch, Willow, Cherry Blossom, Apple, Orange, Lemon, Palm, Bamboo  
**Status:** ✅ **11 Base + 12 Variants = 23 TOTAL** | Generated: Jan 7, 2026

**Still Needed:** 21 seasonal variants (each tree needs 4 seasons total)

---

## ⚔️ ITEMS & TOOLS (~2000 assets)

### Tools (9 types × 9 materials = 81)

**Types**: Axe, Pickaxe, Hoe, Shovel, Scythe, Hammer, Sickle, Saw, Chisel
**Materials**: Wood, Stone, Copper, Iron, Steel, Gold, Diamond, Mythril, Adamantine

### Weapons (10 types × 9 materials = 90)

**Types**: Sword, Dagger, Spear, Battle Axe, Mace, War Hammer, Bow, Crossbow, Staff, Wand
**Materials**: Wood, Stone, Copper, Iron, Steel, Gold, Diamond, Mythril, Adamantine

### Armor (6 pieces × 7 materials = 42)

**Pieces**: Helmet, Chestplate, Leggings, Boots, Gloves, Shield
**Materials**: Leather, Chainmail, Iron, Steel, Gold, Diamond, Dragon

### Arrows (10 types)

Normal, Fire, Ice, Lightning, Poison, Explosive, Healing, Silver, Gold, Diamond

### Potions (19 types)

Health (Small/Medium/Large), Mana (Small/Medium/Large), Stamina, Speed, Strength, Defense, Invisibility, Fire Resistance, Cold Resistance, Poison Cure, Regeneration, Luck, Night Vision, Water Breathing, Slow Fall

### Gems & Minerals (12 types × 2 = 24)

Ruby, Emerald, Sapphire, Diamond, Amethyst, Topaz, Opal, Pearl, Jade, Onyx, Quartz, Obsidian
(Each as gem + ore)

### Metals (8 types × 2 = 16)

Copper, Iron, Gold, Silver, Platinum, Mythril, Adamantine, Titanium
(Each as ore + bar)

### Food (29 prepared items)

Bread, Cheese, Butter, Milk, Egg, Bacon, Sausage, Apple Pie, Cherry Pie, Pumpkin Pie, Fish Cooked, Meat Cooked, Salad, Soup, Stew, Sandwich, Pizza, Cake, Cookie, Strawberry Jam, Blueberry Jam, Red Wine, White Wine, Beer, Juice, Honey, Sugar, Flour, Salt, Pepper, Oil

### Crafting Materials (26 types)

Wood Plank, Wood Stick, Stone Brick, Clay, Glass, Leather, Cloth, Rope, String, Nail, Screw, Gear, Spring, Chain, Feather, Bone, Horn, Fur, Scale, Slime Gel, Ectoplasm, Magic Dust, Fairy Dust, Dragon Scale, Unicorn Hair, Phoenix Feather

---

## 🏛️ BUILDINGS & STRUCTURES (~300 assets)
**Status:** 🔄 **6 Farm Buildings Complete** | ✅ **Jan 7, 2026**

### Farm Buildings (11) - ✅ **6/11 MASTER REFERENCES DONE!**

**COMPLETED:** Farmhouse (gothic cottage), Barn (weathered red), Silo (rusted metal), Shed (dark wood), Well (stone with bucket), Windmill (broken blades)

### Production Buildings (9)

Blacksmith, Carpenter Shop, Tailor Shop, Bakery, Butcher, Brewery, Winery, Apothecary, Jewelry Shop

### Town Buildings (15)

House (Small/Medium/Large), Inn, Tavern, General Store, Town Hall, Church, School, Library, Museum, Hospital, Bank, Barracks, Watchtower

### Decorative (10)

Well (Stone/Wood), Fountain, Hero Statue, Goddess Statue, Gazebo, Bridge (Wood/Stone), Dock, Lighthouse

### Fences & Gates (6)

Wooden Fence, Stone Wall, Iron Fence, Hedge Fence, Wooden Gate, Iron Gate

### Storage (6)

Wooden Chest, Iron Chest, Gold Chest, Barrel, Crate, Cabinet

---

## 🌲 ENVIRONMENT & TERRAIN (~800 assets)

### Ground Tiles (16)

Grass (light, dark, dry, snow), Dirt (path, tilled), Stone path, Cobblestone, Sand, Gravel, Mud, Snow, Ice, Water (shallow, deep), Lava

### Nature Objects (13)

Rocks (small, medium, large, moss), Fallen log, Old stump, Bushes (green, berry, flower), Tall grass, Reeds, Cattails, Lily pad, Coral, Seaweed

### Flowers (8 colors)

Red, Blue, Yellow, Purple, White, Pink, Orange, Mixed patch

### Mushrooms (6 types)

Red (spotted), Brown (edible), Blue (magic), Purple (poisonous), Glowing (bioluminescent), Giant

### Cave Elements (6)

Stalactite, Stalagmite, Blue Crystal, Red Crystal, Green Crystal, Cave Moss (glowing)

### Weather/Sky (10)

White Cloud, Rain Cloud, Storm Cloud, Rainbow, Sun, Full Moon, Crescent Moon, Stars

---

## 👔 CLOTHING & ARMOR (~100 assets)
**Status:** ✅ **6 Worker Clothing Complete** | ✅ **Jan 7, 2026**

### Worker Clothing (6) - ✅ **MASTER REFERENCES DONE!**

**COMPLETED:**
- Farmer shirt (torn, patched, gothic)
- Farmer pants (weathered, holes)
- Work boots (muddy, heavy)
- Straw hat (worn, dark)
- Leather gloves (stitched)
- Work apron (stained, pockets)

**TODO:**
- Armor sets (light, medium, heavy)
- Weather-specific clothing
- Biome-specific outfits
- Accessories (scarves, belts, badges)

---

## 🖥️ UI ELEMENTS (~200 assets)

### Buttons (12)

Play, Pause, Stop, Menu, Settings, Close, Confirm, Cancel, Arrow (Left/Right/Up/Down)

### Icons (12)

Health (red heart), Mana (blue orb), Stamina (lightning), Gold (coin stack), Inventory (bag), Map (scroll), Quest (exclamation), Achievement (star), Mail (envelope), Settings (gear), Save (floppy), Load (folder)

### Status Effects (6)

Poison (green skull), Burn (flames), Freeze (snowflake), Stun (stars), Buff (arrow up), Debuff (arrow down)

### Frames & Panels (5)

Frame (Wood/Stone/Gold), Panel (Wood/Parchment)

### Cursors (6)

Normal (pointer), Interact (hand), Attack (sword), Dig (shovel), Plant (seed), Water (droplet)

---

## 🎨 ART STYLE & VISUAL IDENTITY
**Status:** ✅ **LOCKED & APPROVED** | 🔥 **CRITICAL FOR ALL ASSETS**

### 📐 **MASTER STYLE: "Style 32 (Dark-Chibi Noir)"**

**Official Style Name:** Dark-Chibi Noir  
**Style Code:** Style 32  
**Influence:** Gothic + Chibi + Post-Apocalyptic + Punk  
**Lock Date:** 30.12.2025  
**Status:** ✅ **100% LOCKED - NO CHANGES ALLOWED!**

---

### 🎯 **CORE STYLE ELEMENTS** (From Master References)

**Analyzed from uploaded reference + 18 generated master references**

#### **1. CHARACTER PROPORTIONS (Chibi)**
- ✅ **Head-to-body ratio:** 1:1.5 to 1:2 (large head, small body)
- ✅ **Body:** Short, stubby limbs (2-3 head heights total)
- ✅ **Eyes:** HUGE, expressive (1/3 of face!)
- ✅ **Hands/Feet:** Small, simplified (3-4 fingers visible)
- ✅ **Overall:** Cute but DARK aesthetic

**Reference:** Ana character shows perfect chibi proportions!

#### **2. LINE ART & OUTLINING**
- ✅ **Outline thickness:** 3-4px black outlines (THICK!)
- ✅ **Line quality:** Clean vector-style lines (smooth, no rough edges)
- ✅ **Line color:** Pure black (#000000)
- ✅ **Interior lines:** 1-2px for details (thinner than outline)
- ✅ **Consistency:** ALL characters must have same line weight

#### **3. COLOR PALETTE (Gothic + Noir)**

**Primary Colors:**
- ✅ **Dark blues:** #2C3E50, #34495E (clothing, shadows)
- ✅ **Grays:** #7F8C8D, #95A5A6 (metals, stone)
- ✅ **Deep reds:** #C0392B, #E74C3C (eyes, accents!)
- ✅ **Muted greens:** #27AE60, #16A085 (nature, hair)
- ✅ **Blacks:** #2C2C2C, #1C1C1C (outlines, shadows)

**Gothic Elements:**
- ✅ **Purple accents:** #8E44AD, #9B59B6 (magic, special items)
- ✅ **Blood red:** #8B0000 (danger, horror elements)
- ✅ **Bone white:** #F5F5DC (skulls, undead)
- ✅ **Midnight black:** #0A0A0A (night scenes, void)

**Lighting Style:**
- ✅ High contrast (dark shadows + bright highlights)
- ✅ Rim lighting (light edge around characters)
- ✅ Dramatic lighting (from above or side, not flat)

#### **4. EYE STYLE (CRITICAL!)**

**Human/Friendly NPCs:**
- ✅ **Red eyes with DARK PUPILS** (Kai, Ana, NPCs)
- ✅ Pupils visible and centered
- ✅ White sclera (eye whites)
- ✅ Highlights in eyes (2-3 white dots)
- ✅ Expression: Friendly, alive, human

**Zombies/Enemies:**
- ✅ **White eyes NO pupils** (pure white or yellow)
- ✅ OR **Red eyes NO pupils** (hostile zombies)
- ✅ No highlights (dead, soulless look)
- ✅ Expression: Empty, dead, hostile

**Controlled Zombies:**
- ✅ **Eyes CHANGE when controlled:** White → Red WITH pupils!
- ✅ Visual feedback for player!

#### **5. CLOTHING & TEXTURE**

**Post-Apocalyptic Details:**
- ✅ **TORN CLOTHING:** Rips, holes, patches visible
- ✅ **WEATHERED:** Dirt stains, wear marks
- ✅ **PRACTICAL:** Backpacks, pockets, utility
- ✅ **PUNK ELEMENTS:** Piercings, gauges, patches

**Gothic Details:**
- ✅ **Stitches:** Visible on patches (Frankenstein-style)
- ✅ **Straps & Buckles:** Leather, metal clasps
- ✅ **Crosses & Symbols:** Subtle gothic iconography
- ✅ **Cloaks & Hoods:** Dramatic flowing fabric

**Texture Style:**
- ✅ Cell-shaded (flat colors with sharp shadow edges)
- ✅ NO gradients (or very minimal)
- ✅ Patterns: Hatching for shadows, NOT soft gradients

#### **6. FACIAL FEATURES (Gothic-Punk)**

**Piercings & Modifications:**
- ✅ **Ear gauges** (Kai, Gronk - signature!)
- ✅ **Facial piercings** (eyebrow, nose, lip)
- ✅ **Tattoos** (optional, minimal)

**Hair Styles:**
- ✅ **Dreadlocks** (Kai, Gronk - chunky, stylized!)
- ✅ **Messy/Spiked** (post-apocalyptic, not perfect)
- ✅ **Unnatural colors** OK! (green, pink, purple)

**Expression:**
- ✅ Exaggerated anime-style emotions
- ✅ Large mouth (1/4 of face when open)
- ✅ Eyebrows expressive (thick, dramatic)

#### **7. BACKGROUND & ENVIRONMENT**

**Biome Aesthetic:**
- ✅ **Dark atmosphere** (low light, shadows everywhere)
- ✅ **Decay & Ruins** (broken buildings, overgrown)
- ✅ **Muted colors** (desaturated compared to characters)
- ✅ **Depth:** 3 layers (foreground, mid, background)

**Gothic Architecture:**
- ✅ **Pointed arches** (churches, castles)
- ✅ **Crumbling stone** (weathered, ancient)
- ✅ **Overgrown** (vines, moss, nature reclaiming)
- ✅ **Tombstones & Crosses** (graveyard aesthetic)

#### **8. SPECIAL EFFECTS**

**Magic/Energy:**
- ✅ **Glowing effects:** Purple, blue, green auras
- ✅ **Particle effects:** Sparkles, dust motes
- ✅ **Fire:** Stylized, cartoon flames (NOT realistic)

**Blood/Gore:**
- ✅ **Stylized blood:** Dark red, NOT realistic
- ✅ **Minimal gore:** Suggest violence, don't show graphic detail
- ✅ **16+ Rating:** Dark but not gratuitous

---

### 📸 **GENERATED MASTER REFERENCES (246 TOTAL PNG FILES! 🔥)**

**Status:** ✅ 246 reference images generated across all categories!

**Last Count:** 06.01.2026 22:14 CET

---

#### **📊 BREAKDOWN BY CATEGORY:**

| Category | Count | Location | Status |
|----------|-------|----------|--------|
| **Biome NPCs (Total)** | **166** | `assets/references/npcs/[biome]/` | ✅ 100% Complete! |
| **Wild Animals** | 13 | `assets/references/creatures/wild_animals/` | 🔄 87% (13/15) |
| **Farm Animals** | 6 | `assets/references/creatures/farm_animals/` | 🔄 60% (6/10) |
| **Chernobyl Mutants** | 3 | `assets/references/creatures/chernobyl_mutants/` | 🔄 30% (3/10) |
| **Nomad Raiders** | 8 | `assets/references/enemies/nomad_raiders/` | 🔄 67% (8/12) |
| **Zombies** | 2 | `assets/references/enemies/zombies/` | 🔄 50% (2/4) |
| **Main Characters** | 3 | `assets/references/main_characters/` | ✅ 75% (3/4) |
| **Companions** | 4 | `assets/references/companions/` | ✅ 100% (4/4) |
| **Species** | 6 | `assets/references/species/` | ✅ 100% (6/6) |
| **Trees** | 11 | `assets/references/trees/` | 🔄 Partial |
| **Buildings** | 8 | `assets/references/buildings/` | 🔄 Partial |
| **Approved NPCs** | 11 | `assets/references/npcs/npc_style_approved/` | ✅ 11/11 |
| **Bugs** | 2 | `assets/references/bugs/` | ✅ 2 bugs |
| **OTHER** | 3 | Root directory | Misc |
| **TOTAL PNG FILES** | **246** | Full `assets/references/` tree | **🔥 MASSIVE!** |

---

#### **🏘️ BIOME NPC BREAKDOWN (166 total!):**

| Biome | NPCs Generated | Status |
|-------|----------------|--------|
| **Atlantis** | 17 | ✅ Complete |
| **Loch Ness** | 15 | ✅ Complete |
| **Mythical Highlands** | 12 | ✅ Complete |
| **Egyptian Desert** | 12 | ✅ Complete |
| **Amazon Rainforest** | 12 | ✅ Complete |
| **Tropical** | 10 | ✅ Complete |
| **Mexican Cenotes** | 10 | ✅ Complete |
| **Witch Forest** | 8 | ✅ Complete |
| **Dino Valley** | 8 | ✅ Complete |
| **Desert** | 8 | ✅ Complete |
| **Chernobyl** | 8 | ✅ Complete |
| **Grassland** | 7 | ✅ Complete |
| **Mountain** | 6 | ✅ Complete |
| **Forest** | 6 | ✅ Complete |
| **Catacombs** | 6 | ✅ Complete |
| **Snow/Arctic** | 5 | ✅ Complete |
| **Endless Forest** | 5 | ✅ Complete |
| **Wasteland** | 4 | ✅ Complete |
| **Swamp** | 4 | ✅ Complete |
| **Radioactive** | 3 | ✅ Complete |
| **TOTAL BIOME NPCs** | **166** | ✅ **100% DONE!** |

---

#### **✅ MAIN CHARACTERS (3/4 - 75%):**

1. ✅ **Kai Marković** (`assets/references/main_characters/kai/master_reference.png`) - **FOUND!** 🎉
2. ✅ **Ana Marković** (`assets/references/main_characters/ana/`) - 2 files
3. ✅ **Gronk Alpha Troll** (`assets/references/main_characters/gronk/`) - 2 files
4. ❌ **Susi (promoted to main!)** - Is in companions!

**Status:** Main 3 characters DONE! ✅

---

#### **✅ VERIFIED NPCs (11/11 - 100%):**

1. ✅ Ivan Kovač (Blacksmith) - `npcs/ivan_kovac/`
2. ✅ Mayor/Župan - `npcs/mayor/`
3. ✅ Kustos (Museum) - `npcs/kustos/`
4. ✅ Pek (Baker) - `npcs/pek/`
5. ✅ Šivilja (Tailor) - `npcs/sivilja/`
6. ✅ Tehnik (Engineer) - `npcs/tehnik/`
7. ✅ Teacher - `npcs/teacher/`
8. ✅ Priest Jakob - `npcs/priest/`
9. ✅ Miro Pravnik (Lawyer) - `npcs/miro_pravnik/`
10. ✅ Arborist/Gozdar - `npcs/arborist/`
11. ✅ Glavni Smetar - `npcs/glavni_smetar/`

**Status:** ALL verified NPCs generated! ✅

---

### 🎉 **INCREDIBLE PROGRESS!**

**246 PNG FILES = 246 MASTER REFERENCES!**

This is **1.8% of total 13,500 target** BUT represents:
- ✅ **100% of ALL 166 Biome NPCs!** (MASSIVE!)
- ✅ **11/11 Core NPCs** (100%)
- ✅ **22/109 Creatures** (20%)
- ✅ **Trees, buildings, species** started!

**Estimated Value:** 246 images × $0.012 = **~$2.95 generated!**  
**Google Quota Used:** 246 of daily 1000 limit

---

### 🖌️ **GOTHIC STYLE ENHANCEMENTS** (Optional Layer)

**When to Use Gothic Elements:**

1. **✅ Witch Forest Biome:**
   - Baba Yaga's hut (walking on chicken legs!)
   - Dark altars, ritual circles
   - Cursed gems, poison mushrooms
   - Black cats, ravens (familiars)

2. **✅ Catacombs Biome:**
   - Skulls, bones, tombs
   - Gothic arches, crumbling stone
   - Candlelight, lanterns
   - Mummies, ancient undead

3. **✅ Chernobyl (Final Zone):**
   - Soviet gothic architecture
   - Abandoned reactor (industrial gothic)
   - Hazmat suits (modern horror)
   - Radiation glow (green eerie light)

4. **✅ Bosses:**
   - Giant Troll King (gothic armor, dark crown)
   - Baba Yaga (flying mortar, witch aesthetic)
   - Dr. Krnić (mad scientist, gothic lab)

**Gothic Textures to Add:**
- ✅ Stone carvings (gargoyles, faces)
- ✅ Wrought iron (fences, gates)
- ✅ Stained glass (broken, colorful)
- ✅ Candlelight (flickering, warm)
- ✅ Cobwebs (corners, abandoned areas)

---

### 🎮 **STYLE CONSISTENCY RULES**

**MANDATORY for ALL assets:**

1. ✅ **Thick black outlines** (3-4px)
2. ✅ **Chibi proportions** (1:1.5 to 1:2)
3. ✅ **Red eyes with pupils** (friendly) OR **White/Red eyes no pupils** (enemies)
4. ✅ **Cell-shaded coloring** (flat with hard shadows)
5. ✅ **Dark-Chibi Noir palette** (muted, gothic colors)
6. ✅ **Post-apocalyptic details** (torn clothes, wear, dirt)
7. ✅ **Gothic accents** (when appropriate for biome/character)
8. ✅ **512x512px PNG** with alpha transparency
9. ✅ **Front-facing** for master references
10. ✅ **Centered** with 10px margin

**❌ FORBIDDEN:**
- ❌ Realistic art style (NO photorealism!)
- ❌ Soft gradients (keep sharp shadows!)
- ❌ Thin outlines (must be THICK!)
- ❌ Bright pastel colors (keep it DARK!)
- ❌ Perfect/clean characters (must show wear!)

---

### 📋 **GENERATION PROMPT TEMPLATE**

**For NPCs:**
```
[Character Name], [role], Style 32 Dark-Chibi Noir, 
chibi proportions, thick black outlines, red eyes with dark pupils,
post-apocalyptic clothing (torn, weathered), 
[specific details: piercings, hair, outfit],
gothic accents, dark atmosphere,
512x512px PNG, front-facing, alpha transparency
```

**For Enemies:**
```
[Enemy Name], Style 32 Dark-Chibi Noir,
chibi proportions, thick black outlines, white eyes NO pupils,
hostile pose, [specific features],
dark colors, gothic horror elements,
512x512px PNG, front-facing, alpha transparency
```

---

**Status:** ✅ Style guide LOCKED and MANDATORY for all future assets!

---

## ⚒️ WORKSTATIONS (~100 assets)

Anvil, Forge, Furnace, Kiln, Loom, Spinning Wheel, Workbench, Crafting Table, Alchemy Table, Enchanting Table, Cooking Pot, Oven, Wine Press, Oil Press, Flour Mill, Sawmill, Tanning Rack, Drying Rack, Fermenter, Distiller, Beehive, Butter Churn, Cheese Press, Seed Maker, Recycler

---

## 📊 PRODUCTION SUMMARY
**Last Updated:** 06.01.2026 22:50 CET

### 📈 OVERALL PROGRESS (Updated Jan 8, 04:00 CET)

| Category | Total | Complete | In Progress | Not Started | % Done |
|----------|-------|----------|-------------|-------------|--------|
| **Master References** | 13,500 | ~246 | 0 | ~13,254 | 1.8% |
| **NPCs** | 388 | 181 | 0 | 207 | 46.6% |
| **Creatures** | 109 | 99 | 0 | 10 | 90.8% |
| **Bosses** | 24 | 0 | 0 | 24 | 0% |
| **Biomes (Design)** | 20 | 20 | 0 | 0 | 100% ✅ |
| **Biomes (Assets)** | 20 | 0 | 0 | 20 | 0% |
| **Character Animations** | 52 | 52 | 0 | 0 | 100% ✅ |
| **Demo Assets** | 292 | 157 | 0 | 135 | 54% |
| **Sprites (All Phases)** | ~50,000 | ~300 | 0 | ~49,700 | 0.6% |

**🎉 CHARACTER ANIMATIONS COMPLETE! (Jan 8, 2026)**
- Kai: 20/20 frames (idle, walk, dig, swing)
- Ana: 10/10 frames (idle, walk)
- Gronk: 10/10 frames (idle, walk)
- Susi: 12/12 frames (idle, run, bark)

**Note:** Master References include duplicates (_nobg versions). Will be cleaned tomorrow to ~120-130 unique files.

---

### ⚙️ GAME SYSTEMS & MECHANICS

#### ✅ **IMPLEMENTED SYSTEMS** (🔥 Phase 1 DONE)

| System | Status | Phase | Notes |
|--------|--------|-------|-------|
| **Story Engine** | ✅ Done | 🎯 Demo | Twin Bond, Amnesia, Flashbacks |
| **Character System** | ✅ Done | 🎯 Demo | Kai, Ana, Gronk, Susi |
| **NPC Registry** | ✅ Done | 🔥 Phase 1 | 166 Biome NPCs generated |
| **Biome System** | ✅ Done | 🔥 Phase 1 | All 20 biomes designed |
| **Art Style Guide** | ✅ Done | 🎯 Demo | Style 32 Dark-Chibi Noir locked |
| **Wind & Foliage System** | ✅ Done | 🔥 Phase 1 | Perlin noise, particle leaves, hair animation |
| **Master Weather System** | ✅ Done | 🔥 Phase 1 | Rain, snow, fire, water, wind - Jan 8, 2026 |
| **Water Physics System** | ✅ Done | 🔥 Phase 1 | Buoyancy, drag, hair floating - Jan 8, 2026 |
| **Water Ripples System** | ✅ Done | 🔥 Phase 1 | Footsteps, splash, rain ripples - Jan 8, 2026 |
| **Quest System v2.1** | ✅ Done | 🔥 Phase 1 | Manifest + Voice Integration - Jan 8, 2026 |
| **Character Animations** | ✅ Done | 🎯 Demo | 52/52 frames complete - Jan 8, 2026 |

#### 🔄 **IN PROGRESS SYSTEMS** (🔥 Phase 1 / ⚡ Phase 2)

| System | Status | Phase | Progress |
|--------|--------|-------|----------|
| **Creature System** | 🔄 91% | 🔥 Phase 1 | 99/109 creatures generated |
| **Combat System** | 🔄 Design | 🔥 Phase 1 | Mechanics defined, needs implementation |
| **Farming System** | 🔄 Design | 🎯 Demo | Core mechanics defined |
| **Building System** | 🔄 Partial | ⚡ Phase 2 | Some assets exist |
| **Dialogue System** | 🔄 Partial | 🔥 Phase 1 | Portrait automation done |

#### ❌ **NOT STARTED SYSTEMS** (⚡ Phase 2+)

| System | Status | Phase | Priority |
|--------|--------|-------|----------|
| **Crafting System** | ❌ | ⚡ Phase 2 | High |
| **Town Restoration** | ❌ | ⚡ Phase 2 | Medium |
| **Railway System** | ❌ | ⚡ Phase 2 | Medium |
| **Zoo & Breeding** | ❌ | ⚡ Phase 2 | Medium |
| **Museum System** | ❌ | ⚡ Phase 2 | Low |
| **School System** | ❌ | ⚡ Phase 2 | Low |
| **Capital City** | ❌ | Phase 3 | Low |
| **Politics System** | ❌ | Phase 3 | Low |

---

### 🛠️ TECHNOLOGIES & TOOLS

#### ✅ **CONFIRMED TECHNOLOGIES**

| Technology | Purpose | Status |
|------------|---------|--------|
| **Phaser 3** | Game Engine | ✅ Implemented |
| **JavaScript** | Core Language | ✅ In Use |
| **Tiled** | Map Editor | ✅ In Use |
| **Google Imagen 3** | Asset Generation | ✅ Active (Quota: 1000/day) |
| **ComfyUI** | Image Processing | ✅ Ready (Local) |
| **Edge TTS** | Voice Generation | ✅ Ready |
| **Python** | Automation Scripts | ✅ In Use |
| **Flask** | Asset Manager Backend | ✅ Implemented |
| **Electron** | Desktop App | ✅ Implemented |

#### 🎨 **ART & AUDIO PIPELINE**

| Tool/Process | Purpose | Status |
|--------------|---------|--------|
| **Style 32 (Dark-Chibi Noir)** | Master Art Style | ✅ Locked |
| **Master Reference Pipeline** | Character consistency | ✅ Active |
| **Dialogue Portrait Automation** | Auto-crop portraits | ✅ Done (Python) |
| **Background Removal** | Transparency processing | ✅ Ready |
| **Asset Manager App** | Asset organization | ✅ v1.0 Complete |
| **Placeholder Audio** | Sound FX placeholder | ✅ Python script ready |
| **Localized TTS** | Multi-language voice | ✅ Edge TTS ready |

---

### 🎯 PHASE BREAKDOWN

#### **🎯 DEMO PHASE** (Kickstarter Demo - Vertical Slice)
**Target:** Showcase core gameplay loop + emotional story hook  
**Duration:** 10-15 minutes of gameplay  
**Goal:** Convince backers this game is REAL and AMAZING!

---

### 🎬 **DEMO FLOW (Step-by-Step)**

#### **1. OPENING SCENE** (30 seconds)
- ✅ Kai wakes up in ruined basement (amnesia!)
- ✅ Finds ID card: "Kai Marković, Age: 14"
- ✅ Sees blood on wall, feels headache
- ✅ "I don't remember anything... but I need to survive."

#### **2. TUTORIAL: ZOMBIE CONTROL** (2-3 minutes)
**CORE MECHANIC SHOWCASE:**

- 🎯 **Step 1:** Meet first zombie (Basic Zombie, wandering)
- 🎯 **Step 2:** Press [E] to "Control" zombie (Alpha Hybrid power!)
- 🎯 **Step 3:** Zombie eyes change (white → red with pupils = controlled!)
- 🎯 **Step 4:** Give first command: "DIG" on soil patch
- 🎯 **Step 5:** Zombie digs slowly, finds buried item (Ana's bracelet!)
- 🎯 **Step 6:** "This feels... familiar. But I can't remember why."

**ASSETS NEEDED:**
- ✅ Kai (idle, walk) - 10 sprites
- ❌ Basic Zombie (idle, walk, dig) - 15 sprites 🔴
- ❌ Soil patch tile + dug version - 2 assets 🔴
- ❌ Ana's bracelet (item sprite) - 1 asset 🔴

---

#### **3. FIRST MEMORY FLASHBACK** (45 seconds)
**EMOTIONAL STORY HOOK:**

- 🎯 Screen fades to sepia/flashback filter
- 🎯 **MEMORY 1/50 UNLOCKED:** "Ana's Birthday"
- 🎯 Flashback scene: Young Kai (age 8) gives bracelet to Ana
- 🎯 Ana: "I'll never take it off, I promise!"
- 🎯 Kai (present): "Ana... who is Ana? Why does this hurt so much?"
- 🎯 Twin Bond UI appears (damaged, 1/50 bars filled)

**ASSETS NEEDED:**
- ❌ Flashback background (farm, daytime, happy) - 1 asset 🔴
- ✅ Young Kai (chibi, age 8) - Can generate 1 sprite 🔴
- ✅ Young Ana (chibi, age 8, blonde) - Can generate 1 sprite 🔴
- ❌ Twin Bond UI (damaged heart, 1/50) - 1 UI element 🔴

---

#### **4. TOWN DISCOVERY** (2 minutes)
**TOWN SYSTEM INTRO:**

- 🎯 Kai walks to nearby ruined town (Tutorial Town)
- 🎯 Sign: "Tutorial Town - Population: 0" (wooden sign, faded paint)
- 🎯 Empty streets, broken buildings
- 🎯 Find "Town Hall" (small, run-down building)
- 🎯 Inside: Population Board (shows "0 Citizens")
- 🎯 "This place is dead... but maybe I can bring it back to life?"

**ASSETS NEEDED:**
- ❌ Tutorial Town entrance (ruined gate) - 1 asset 🔴
- ❌ Population Sign (wooden, "Population: 0") - 1 asset 🔴
- ❌ Town Hall (exterior, small, ruined) - 1 building 🔴
- ❌ Town Hall (interior, 1 room) - 1 interior tileset 🔴
- ❌ Population Board (wooden board, "0" written) - 1 UI/prop 🔴

---

#### **5. FIRST SURVIVOR ARRIVES** (2 minutes)
**POPULATION TRACKING SHOWCASE:**

- 🎯 Kai explores, finds NPC hiding (Bеk - Baker NPC)
- 🎯 Dialogue: "You're... not a zombie? Are you real?"
- 🎯 Pek: "I saw you control that zombie... are you the Alpha?"
- 🎯 Kai: "Alpha? I don't know what that means..."
- 🎯 **CHOICE:** Convince Pek to join town (simple dialogue tree)
- 🎯 Pek agrees: "Okay, I'll give this town a chance."
- 🎯 **AUTO-WALK:** Pek walks to Town Hall
- 🎯 **VISUAL FEEDBACK:** Population Board updates: **0 → 1** 🎉
- 🎯 Achievement pop-up: "First Citizen!" (+10 XP)

**ASSETS NEEDED:**
- ✅ Pek NPC (master ref exists!) - Need sprites (idle, walk) = 10 sprites 🔴
- ❌ Dialogue UI (portrait frame, text box) - 1 UI set 🔴
- ❌ Population Board (updated, "1" written) - 1 asset 🔴
- ❌ Achievement pop-up UI - 1 UI element 🔴

---

#### **6. ENDING HOOK** (30 seconds)
**LEAVE THEM WANTING MORE:**

- 🎯 Pek: "Hey, I heard rumors... there's a place called Chernobyl. They say people disappear there."
- 🎯 Kai feels Twin Bond pulse (UI flashes!)
- 🎯 Kai: "Chernobyl... I need to go there. But first, I need to rebuild this town."
- 🎯 **DEMO END SCREEN:**
  - "MEMORY: 1/50"
  - "POPULATION: 1"
  - "ANA'S LOCATION: ??"
  - "Continue in FULL GAME - Kickstarter 2026!"

**ASSETS NEEDED:**
- ❌ Twin Bond pulse VFX - 1 animation 🔴
- ❌ Demo end screen UI - 1 asset 🔴

---

### 📊 **DEMO ASSET BUDGET (REVISED)**

| Category | Assets | Status | Priority |
|----------|--------|--------|----------|
| **Kai Sprites** | 10 | ❌ Not Started | 🔴 CRITICAL |
| **Zombie Sprites** | 15 | ❌ Not Started | 🔴 CRITICAL |
| **Pek NPC Sprites** | 10 | ❌ Not Started | 🔴 CRITICAL |
| **Young Kai/Ana (Flashback)** | 2 | ❌ Not Started | 🔴 CRITICAL |
| **Town Buildings** | 3 | ❌ Not Started | 🔴 CRITICAL |
| **UI Elements** | 8 | ❌ Not Started | 🔴 CRITICAL |
| **Props/Items** | 6 | ❌ Not Started | 🟡 High |
| **Biome Tiles (minimal)** | 20 | ❌ Not Started | 🟡 High |
| **VFX/Animations** | 3 | ❌ Not Started | 🟢 Medium |
| **TOTAL DEMO ASSETS** | **77** | **❌ 0/77** | **URGENT!** |

**DEMO vs ORIGINAL ESTIMATE:**
- ❌ ~~242 assets~~ (too ambitious!)
- ✅ **77 core assets** (laser-focused vertical slice!)

---

### 🎯 **DEMO SUCCESS METRICS**

**What backers will experience:**
1. ✅ **Zombie Control** - Unique core mechanic (10/10 hook!)
2. ✅ **Emotional Story** - Memory system + Twin Bond (instant feels!)
3. ✅ **Town Building** - Population tracking (satisfying progress!)
4. ✅ **Beautiful Art** - Style 32 Dark-Chibi Noir (visual WOW!)
5. ✅ **Mystery** - "Where is Ana?" (leaves them wanting MORE!)

**Estimated Kickstarter Conversion:** 30-40% of demo players → backers

---

### 🚨 **DEMO PRODUCTION PRIORITY**

**WEEK 1 (Jan 7-13):**
1. Generate Kai sprites (10) - Day 1-2
2. Generate Zombie sprites (15) - Day 2-3
3. Generate Pek sprites (10) - Day 3-4

**WEEK 2 (Jan 14-20):**
4. Generate Young Kai/Ana flashback (2) - Day 1
5. Generate Town buildings (3) - Day 2-3
6. Generate UI elements (8) - Day 4-5

**WEEK 3 (Jan 21-27):**
7. Generate Props/Items (6) - Day 1-2
8. Generate minimal Biome tiles (20) - Day 3-5

**WEEK 4 (Jan 28 - Feb 3):**
9. Generate VFX/Animations (3) - Day 1-2
10. Polish & integrate all assets - Day 3-7

**DEMO LAUNCH TARGET:** February 10, 2026 🎯

---

**Status:** 🔴 **BLOCKED** - Need to start asset generation NOW!

---

## 🚀 RELEASE STRATEGY - EPISODIC DEPLOYMENT

**Model:** Early Access / Episodic Releases  
**Goal:** Release content incrementally, build community, fund development  
**Platform:** Steam Early Access / Itch.io

---

### 📅 **RELEASE TIMELINE & CONTENT**

#### **RELEASE 0: KICKSTARTER DEMO** 🎯
**Date:** February 10, 2026  
**Price:** FREE (demo)  
**Duration:** 10-15 minutes  
**Purpose:** Prove concept, attract backers

**Content:**
- ✅ Tutorial (Zombie Control)
- ✅ First Memory (1/50)
- ✅ Town Discovery
- ✅ First Survivor (Population: 0 → 1)
- ✅ Chernobyl hook

**Goal:** Kickstarter funding + Community building

---

#### **RELEASE 1: EARLY ACCESS - ALPHA 1** 🔥
**Date:** Q2 2026 (April-June)  
**Price:** $9.99 (Early Access Discount - 50% off final price!)  
**Duration:** ~5-8 hours gameplay  
**Status:** Production starts after Demo

**Content:**
- ✅ **Story:** Prologue + First 10 Memories (10/50)
- ✅ **Biomes:** 4 Normal Biomes (Grassland, Forest, Desert, Swamp)
- ✅ **NPCs:** 40 Biome NPCs + 20 Town NPCs (60 total)
- ✅ **Creatures:** Wild Animals (15), Farm Animals (10), Chernobyl Mutants (10) = 35 creatures
- ✅ **Town System:** 1 Town (Tutorial Town) - Population cap: 50
- ✅ **Farming:** 20 crops, basic farming cycle
- ✅ **Combat:** Basic melee + 3 weapon types
- ✅ **Quests:** 20 main quests + 15 side quests
- ✅ **Crafting:** 50 basic recipes
- ✅ **Buildings:** 10 farm buildings, 8 town buildings

**What Players Get:**
- Full zombie control mechanics
- Town restoration (first town only)
- Memory collection (first 10)
- Basic farming & combat
- Foundation for future content

**Early Access Note:** "This is ALPHA 1 - expect bugs, missing features. Your feedback shapes the game!"

---

#### **RELEASE 2: EARLY ACCESS - ALPHA 2** ⚡
**Date:** Q4 2026 (October-December)  
**Price:** $14.99 (Early Access - still discounted!)  
**or:** FREE UPDATE for Alpha 1 buyers! 🎁  
**Duration:** +10-15 hours (total: 15-23 hours)

**New Content:**
- ✅ **Story:** Memories 11-25 (25/50 total) + Ana's Story DLC starts!
- ✅ **Biomes:** +4 Normal (Mountain, Snow, Wasteland, Tropical) + 2 Magical (Dino Valley, Mythical Highlands)
- ✅ **NPCs:** +80 Biome NPCs, +50 Town NPCs (190 NPCs total)
- ✅ **Creatures:** Dinosaurs (15), Mythical Creatures (20), Worker Creatures (6) = +41 creatures
- ✅ **Bosses:** First 6 bosses (T-Rex, Dragon, Nessie, etc.)
- ✅ **Town System:** 2 more towns (3 total) - Population cap: 150
- ✅ **Railway System:** 10 stations unlocked
- ✅ **Zoo & Breeding:** Basic breeding for 30 species
- ✅ **Museum:** Collectibles system (100 items)
- ✅ **Advanced Crafting:** +150 recipes (200 total)
- ✅ **Quests:** +40 quests (75 total)

**What's New:**
- Dinosaurs! (Dino Valley unlocked)
- Dragons & Mythical Creatures
- Boss fights (6 bosses)
- Railway fast travel
- Animal breeding
- Ana's Story begins (separate campaign!)

---

#### **RELEASE 3: EPISODE 1 - "THE SEARCH"** 🗺️
**Date:** Q2 2027 (6 months after Alpha 2)  
**Price:** $19.99 (Full Episode)  
**or:** FREE UPDATE for Early Access supporters! 🎁  
**Duration:** +15-20 hours (total: 30-43 hours)

**New Content:**
- ✅ **Story:** Memories 26-40 (40/50) - Kai remembers Ana fully!
- ✅ **Biomes:** +6 Magical (Loch Ness, Catacombs, Egyptian Desert, Amazon, Mexican Cenotes, Witch Forest)
- ✅ **NPCs:** +100 NPCs (290 total)
- ✅ **Creatures:** Mythical Creatures (remaining 19), Chupacabra (3), Aquatic (20) = +42 creatures
- ✅ **Bosses:** +10 bosses (Sphinx, Kraken, Quetzalcoatl, Baba Yaga, etc.) = 16 total
- ✅ **Towns:** +10 towns (13 total) - Population cap: 500
- ✅ **Railway:** All 27 stations unlocked!
- ✅ **School System:** Unlocked (teach NPCs skills)
- ✅ **Capital City:** Discovered (not yet accessible)
- ✅ **Quests:** +50 quests (125 total)

**Major Features:**
- All 6 new magical biomes!
- Underwater exploration (Atlantis preview)
- Mythical creature taming
- School system (NPC education)
- Boss rush mode unlocked

---

#### **RELEASE 4: EPISODE 2 - "THE TRUTH"** 🔍
**Date:** Q4 2027 (6 months after Episode 1)  
**Price:** $24.99 (Full Episode)  
**or:** FREE UPDATE for Early Access supporters! 🎁  
**Duration:** +15-20 hours (total: 45-63 hours)

**New Content:**
- ✅ **Story:** Memories 41-50 (50/50) - **FULL MEMORY RESTORED!**
- ✅ **Biomes:** Atlantis (full unlock) + Chernobyl (accessible but not final area)
- ✅ **NPCs:** +90 NPCs (380 total) - Almost all!
- ✅ **Bosses:** +6 bosses (Sea Serpent, Leviathan, etc.) = 22 total
- ✅ **Towns:** +14 towns (27 total - ALL TOWNS!) - Population cap: 1000
- ✅ **Ana's Story:** Fully playable! (15 hours campaign)
- ✅ **Capital City:** Unlocked!
- ✅ **Politics System:** Unlocked (town governance)
- ✅ **Nomad Raiders:** Enemy faction introduced
- ✅ **Quests:** +75 quests (200 total)

**Major Features:**
- Full memory restored! (Emotional climax!)
- Ana's Story complete!
- Capital City unlocked
- Politics & governance
- Preparation for final battle

---

#### **RELEASE 5: FINAL EPISODE - "THE RESCUE"** 🔥
**Date:** Q2 2028 (6 months after Episode 2)  
**Price:** $29.99 (Complete Edition)  
**or:** FREE UPDATE for ALL previous buyers! 🎁  
**Duration:** +10-15 hours (total: 55-78 hours)

**Final Content:**
- ✅ **Story:** ENDGAME - Storm Chernobyl, save Ana, confront Dr. Krnić
- ✅ **Chernobyl Reactor Level 7:** Final dungeon (7 floors!)
- ✅ **Final Bosses:** Giant Troll King (3 phases), Dr. Krnić (final form)
- ✅ **ALL 109 Creatures:** Complete bestiary!
- ✅ **ALL 24 Bosses:** Complete boss collection!
- ✅ **ALL 388 NPCs:** Every single NPC generated!
- ✅ **Multiple Endings:** 5 different endings based on choices!
- ✅ **New Game+:** Replay with all powers unlocked!
- ✅ **Endgame Content:** Boss Rush, Arena Mode, Speedrun Mode
- ✅ **Achievements:** 100 achievements to unlock

**COMPLETE GAME:**
- Full story (all 50 memories)
- All 20 biomes
- All 27 towns
- All systems unlocked
- 5 different endings
- 55-78 hours main story
- 100+ hours completionist

---

### 💰 **PRICING MODEL**

| Purchase Timing | Price | What You Get |
|-----------------|-------|--------------|
| **Kickstarter Backer** | $15 (Early Bird) | ALL future updates FREE forever! 🎁 |
| **Early Access (Alpha 1)** | $9.99 | ALL future updates FREE! 🎁 |
| **Early Access (Alpha 2)** | $14.99 | ALL future updates FREE! 🎁 |
| **Episode 1** | $19.99 | Episode 1 + All future updates FREE! 🎁 |
| **Episode 2** | $24.99 | Episode 2 + Final Episode FREE! 🎁 |
| **Final Episode (v1.0)** | $29.99 | Complete game |
| **Complete Edition (Lateral)** | $39.99 | Buy any time after v1.0 |

**Early Supporter Benefit:** Buy EARLY, get EVERYTHING! 🎉

---

### 📊 **CONTENT PROGRESSION**

| Release | Biomes | NPCs | Creatures | Bosses | Hours | Price |
|---------|--------|------|-----------|--------|-------|-------|
| **Demo** | 1 | 2 | 1 | 0 | 0.25 | FREE |
| **Alpha 1** | 4 | 60 | 35 | 0 | 5-8 | $9.99 |
| **Alpha 2** | 10 | 190 | 76 | 6 | 15-23 | $14.99 |
| **Episode 1** | 16 | 290 | 118 | 16 | 30-43 | $19.99 |
| **Episode 2** | 18 | 380 | 124 | 22 | 45-63 | $24.99 |
| **Final** | 20 | 388 | 109 | 24 | 55-78 | $29.99 |

---

### 🎯 **DEVELOPMENT STRATEGY**

**Why Episodic?**
1. ✅ **Funding:** Each release funds next development
2. ✅ **Feedback:** Community shapes the game
3. ✅ **Quality:** More time per episode = better quality
4. ✅ **Hype:** Regular releases keep momentum
5. ✅ **Testing:** Catch bugs early, fix before final
6. ✅ **Loyalty:** Early supporters get lifetime value

**Release Cadence:** New content every 6 months  
**Total Dev Time:** ~2.5 years (Feb 2026 - Q2 2028)  
**Community Involvement:** Discord, Reddit, Surveys between releases

---

### 🔐 **COMMITMENT TO EARLY SUPPORTERS**

**Promise:** Anyone who buys during Early Access (Alpha 1 or Alpha 2) gets **ALL FUTURE UPDATES FREE FOREVER!**

This means:
- Buy for $9.99 in Alpha 1
- Get $29.99 worth of content by Final Episode
- **LIFETIME SAVINGS: $20!** 🎁

**Why?** Because you believed in us when we had nothing! ❤️

---

**Status:** ✅ Release strategy defined and locked!

---

#### **🔥 PHASE 1** (Alpha 1 - Core Gameplay)
**Target:** Playable first 10 hours  
**Includes:**
- ✅ 166 Biome NPCs (DONE!)
- 🔄 Wild Animals (87% done - 13/15)
- 🔄 Farm Animals (60% done - 6/10)
- 🔄 Chernobyl Mutants (30% done - 3/10)
- ❌ 4 Normal Biomes (Grassland, Forest, Desert, Swamp)
- ❌ Basic combat, farming, building
- ❌ First 20 quests

**Status:** 🟡 **IN PROGRESS** - 20% complete

#### **⚡ PHASE 2** (Alpha 2 - Content Expansion)
**Target:** 50+ hours gameplay  
**Includes:**
- ❌ All 190 Town NPCs
- ❌ Dinosaurs (15 species)
- ❌ Mythical Creatures (39 species)
- ❌ Bosses (24 total)  
- ❌ 9 Normal + 8 Magical Biomes
- ❌ Railway, Zoo, Museum, School
- ❌ 100+ quests
- ❌ Town Restoration
- ❌ Ana's Story (playable!)

**Status:** 🔴 **NOT STARTED**

---

### 📋 CRITICAL PATH TO DEMO

**IMMEDIATE BLOCKERS (🚨 URGENT!):**

1. **Grassland Biome Assets** 🔴
   - Ground tiles (grass, dirt, stone path)
   - Trees (Oak, Pine) - 4 seasons each
   - Props (rocks, bushes, flowers)
   - Farm plot tiles
   - **Estimated:** 150 assets

2. **Character Sprite Sheets** 🔴  
   - Kai (idle, walk, dig, swing) - 20 sprites minimum
   - Ana (idle, walk) - 10 sprites minimum
   - Gronk (idle, walk) - 10 sprites minimum  
   - Susi (idle, walk, run) - 12 sprites minimum
   - **Estimated:** 52 sprites

3. **Basic Zombie** 🔴
   - Idle, walk, attack animations
   - **Estimated:** 15 sprites

4. **Farm Objects** 🔴
   - Farmhouse (small)
   - Barn (small)  
   - Fence sections
   - Crop plots (tilled soil)
   - **Estimated:** 25 assets

**TOTAL FOR DEMO:** ~242 assets (out of 13,500!)

---

### 🔐 DATA INTEGRITY

**Sources Merged:**
- ✅ `scripts/generate_assets_full.py` - Complete 13,500+ asset registry
- ✅ `docs/game_design/GAME_BIBLE.md` v1 - Story, mechanics, systems
- ✅ `SESSION_REPORT_2026_01_06` - Latest generation status
- ✅ `BIOME_MASTER_SPREADSHEET.md` - Biome breakdown
- ✅ `NPC_GENERATION_LIST.md` - Complete NPC registry

**Confirmations:**
- ✅ **Cyclops** - Present in mythical creatures
- ✅ **Minotaur** - Present in mythical creatures
- ✅ **Giant Troll** - Present as boss #19
- ✅ **Zmaj Volk** - Removed from game ❌
- ✅ **Kai & Ana** - 14 years old (NOT 17!)
- ✅ **Giant Troll King** - Final boss ✓
- ✅ **20 Biomes** - Mexican Cenotes + Witch Forest added
- ✅ **109 Creatures** - Including 3 Chupacabra variants

---

## 🔒 **STATUS: ZABETONIRAN!**

**Git Commit:** `268177cf`  
**Date:** 06.01.2026 21:41 CET  
**Backup:** `GAME_BIBLE_2_BACKUP_06_01_2026.md` ✅

**This is the MASTER game bible**. Use this for all future development!

All data is locked, tracked, and version-controlled. Nothing will be lost! 💪

---

**END OF PRODUCTION GAME BIBLE v2.0**