## ⛏️ FUNCTIONAL MINES & AUTOMATION SYSTEM
**Added:** January 4, 2026

### **Mine Structure (100 Levels Deep)**

**Level Progression:**
- Levels 1-20: COPPER ZONE (weak enemies, basic ore)
- Levels 21-50: IRON ZONE (moderate enemies, better ore)
- Levels 51-80: GOLD ZONE (strong enemies, valuable ore)
- Levels 81-100: DIAMOND ZONE (boss-tier enemies, rare gems)

**Depth Mechanics:**
- Each 10 levels = difficulty spike
- Lighting gets darker (need torches/lanterns)
- Temperature drops (hypothermia risk at level 80+)
- Oxygen decreases (need air supply below level 60)

---

### **Zombie Miner System**

**How It Works:**
1. Assign zombie worker to mine entrance
2. Zombie descends to assigned level
3. Auto-mines ore based on level depth
4. Ore teleports to your storage chests
5. Zombie continues 24/7 (never sleeps!)

**Efficiency Factors:**
- Zombie quality (Level 1-5 zombies)
- Tools equipped (better pickaxe = faster)
- Level depth (deeper = slower but rarer ore)
- Number of zombies (max 5 per mine)

**Ore Generation Rates:**
- Level 1-20: 5 copper/hour per zombie
- Level 21-50: 3 iron/hour per zombie
- Level 51-80: 1 gold/hour per zombie
- Level 81-100: 0.5 diamond/hour per zombie

---

### **Mine Machines & Upgrades**

**Elevator System:**
- **Manual Ladder:** Free, slow, dangerous
- **Rope Elevator:** 5,000g - Faster, safer
- **Steam Elevator:** 15,000g - Instant travel, automatic
- **Teleporter:** 50,000g - Teleport to ANY level instantly

**Stone Crusher:**
- Cost: 10,000g + 50 Iron + 25 Gears
- Function: Processes raw ore 2x faster
- Bonus: 10% chance for extra ore
- Placement: Near mine entrance

**Automated Carts:**
- Cost: 8,000g + 30 Iron + Track Rails
- Function: Move ore from deep levels to surface
- Capacity: 100 ore per trip
- Speed: 1 trip every 5 minutes

**Ventilation System:**
- Cost: 12,000g + 40 Iron Pipes
- Function: Allows safe descent to level 100
- Without it: Suffocation damage below level 60

---

### **Mine Exploration (Player)**

**Manual Mining:**
- Descend yourself for adventure
- Fight enemies for XP and loot
- Find secret rooms (treasure chests)
- Discover gemstone veins (instant harvest)

**Combat Challenges:**
- Cave Spiders (levels 1-30)
- Rock Golems (levels 31-60)
- Lava Elementals (levels 61-80)
- Shadow Demons (levels 81-100)
- **Boss:** The Deep One (level 100 - guards ancient treasure)

**Rewards:**
- Rare ores (iridium, platinum, obsidian)
- Ancient artifacts (museum donations)
- Mining skill XP
- Secret passages (shortcuts between levels)

---

## 🏘️ TOWN GROWTH & SIGNAGE SYSTEM
**Added:** January 4, 2026

### **Town Sign (Dynamic Counter)**

**Creation:**
- Appears automatically when first building is constructed
- Placed at town entrance
- Updates in real-time

**Display:**
```
╔═══════════════════╗
║  DOLINA SMRTI     ║
║  Population: 4    ║
║  Status: Growing  ║
╚═══════════════════╝
```

**Mechanics:**
- NPC count updates instantly on move-in
- "Status" changes based on happiness
  - Thriving (avg happiness >80%)
  - Growing (avg happiness 50-80%)
  - Struggling (avg happiness <50%)
- Celebration effects at milestone populations (5, 10, 15, 20)

---

### **NPC Population System**

**Initial Limit: 4 NPCs**
- Blacksmith, Trader, Doctor, Carpenter (essential services)

**Expansion Requirements:**
- Build Marketplace → +4 NPC slots (total 8)
- Build Town Hall → +4 NPC slots (total 12)
- Build Cathedral → +8 NPC slots (total 20)

**Max Population: 20 NPCs** (keeps town intimate)

---

### **Small Villages (Scattered World)**

**Auto-Generation:**
- 5-10 small villages spawn across map
- Each has 2-3 houses
- Purpose: Trade outposts, rest stops

**Village Types:**
- Farming Hamlet (sells crops, seeds)
- Fishing Village (near water, sells fish)
- Hunter's Lodge (sells meat, furs)
- Hermit Camp (single house, unique NPC with rare items)

**Inhabitants:**
- 1-3 NPCs per village
- Cannot recruit to your town
- Unique dialogue about local area
- Sell regional items

---

## 🔒 NPC PRIVACY & HOME DECORATION SYSTEM
**Added:** January 4, 2026

### **Hobby-Based Home Decoration**

**Automatic Interior Generation:**
When NPC moves in, house decorates based on their hobby/profession:

**Fisherman:**
- Fishing nets on walls
- Fish smell particle effect
- Tackle boxes scattered
- Mounted fish trophies
- Blue/aqua color scheme

**Baker:**
- Ovens and baking tools
- Bread smell particle effect
- Flour bags stacked
- Rolling pins, mixing bowls
- Warm orange lighting

**Barber:**
- Mirrors and styling chairs
- Scissors, razors displayed
- Hair dye bottles
- Piercing tools
- Rainbow color accents

**Zombie Worker:**
- Chains hanging from ceiling
- Brain jar on shelf
- Dark candles (purple flame)
- Blood stains (cosmetic)
- Cold, dark atmosphere

**Farmers, Blacksmiths, Doctors:** Each get unique themed interiors

---

### **Door Lock System (Heart-Based)**

**Main Room Access:**
- NPC must be HOME (in town)
- If not home: "Nobody's here right now."
- If home: Door is unlocked, enter freely

**Bedroom Access:**
- **Locked by default**
- Requires ≥5 hearts with NPC
- If <5 hearts: NPC dialogue
  - Friendly: "Sorry, that's my private space!"
  - Neutral: "I'd rather you didn't go in there."
  - Upset: "Get out of my house!"

**Special Rooms:**
- Basement/Attic: Requires ≥10 hearts (best friends)
- Unlock special quest items or secrets

---

### **NPC Home Visits Mechanics**

**Tracking:**
- System logs every time you enter NPC home
- Frequency affects relationship
  - 1st visit: +2 hearts ("You came to visit!")
  - Daily visits: +0.5 hearts (friendly neighbor)
  - Too many visits (>5/day): -1 heart (stalker vibes!)

**Time-of-Day:**
- Morning (6am-12pm): NPC might still be sleeping (bedroom locked)
- Afternoon (12pm-6pm): NPC usually at work/out
- Evening (6pm-10pm): BEST time to visit (NPC home, relaxed)
- Night (10pm-6am): Knocking on door wakes them up (-2 hearts!)

**Gifts at Home:**
- Bringing gift during visit: +3 hearts (extra bonus)
- Leaving gift on doorstep when not home: +1 heart (still nice)

---

## 🎯 SESSION JAN 04, 2026 - GAME SYSTEMS EXPANSION
**Updated:** 11:44 CET

### **Systems Added Today:**

1. ✅ Home Upgrade System (Sleep, Crafting, Extensions)
2. ✅ New Town Buildings (Bakery, Barber, Lawyer)
3. ✅ Functional Mines (100 levels, zombie workers)
4. ✅ Town Growth (Dynamic sign, NPC limits)
5. ✅ NPC Privacy (Locked doors, hobby decoration)

### **Assets Required:**
- Interior Objects: ~170 PNGs
- New Buildings: 3 exteriors
- Mine Equipment: 15 sprites
- Town Signs: 5 variants

### **Next Steps:**
- Generate HIGH PRIORITY interior sprites
- Code Sleep System prototype
- Test bakery shop interface

---

*Last Updated: January 4, 2026 @ 11:44 CET*