📚 GAME BIBLE UPDATE - Jan 04 Systems Expansion

Added comprehensive documentation for 5 major new systems:

1. 🏠 Home Upgrade System:
   - 3-tier sleep system (sleeping bag → wooden → king-size)
   - Crafting tables (small → large for expeditions)
   - House extensions (kitchen + basement w/ alchemy lab)
   - Home customization & furniture placement

2. 🏪 New Town Buildings:
   - Bakery (food shop, gifts, baking competitions)
   - Barber Shop (hairstyles, piercings, dreadlocks, zombie makeover)
   - Lawyer Office (divorce mechanics, 50k cost, 25% money loss)

3. ⛏️ Functional Mines:
   - 100 levels deep with difficulty scaling
   - Zombie miner automation (auto-collect ore)
   - Mine machines (elevators, crushers, ventilation)
   - Boss at level 100 (The Deep One)

4. 🏘️ Town Growth:
   - Dynamic town sign (auto-updates population count)
   - NPC limit system (starts 4, expands to 20)
   - Small villages scattered across map (2-3 houses each)

5. 🔒 NPC Privacy & Decoration:
   - Hobby-based auto-decoration (fisherman, baker, barber themes)
   - Heart-locked doors (bedroom requires 5+ hearts)
   - Visit tracking & relationship effects

Documentation files:
- GAME_BIBLE_COMPLETE.md (updated)
- GAME_SYSTEMS_JAN_04_EXPANSION.md (new)
- GAME_SYSTEMS_EXPANSION_PLAN.md (implementation plan)

Total new content: ~400 lines of game mechanics
Asset requirements: ~170 interior PNG sprites

GAME_BIBLE_COMPLETE.md

@@ -327,6 +327,150 @@ Each anomalous biome has 1-2 bosses that guard story clues.
 
 ---
 
+## 🏠 HOME UPGRADE & CUSTOMIZATION SYSTEM
+**Added:** January 4, 2026
+
+### **Sleep System (3-Tier Progression)**
+
+**Level 1: Sleeping Bag**
+- Cost: 500g (available from start)
+- Energy Regeneration: 30%
+- Sleep Duration: 3 seconds (fast sleep)
+- Capacity: 1 person
+- Mood Effect: None
+- Asset: `interior_bed_sleepingbag.png`
+
+**Level 2: Wooden Bed**
+- Cost: 2,000g
+- Requirements: Carpenter unlocked
+- Energy Regeneration: 70%
+- Sleep Duration: 5 seconds
+- Capacity: 1 person
+- Mood Effect: +5 (well-rested)
+- Asset: `interior_bed_wooden.png`
+
+**Level 3: King-Size Bed**
+- Cost: 10,000g
+- Requirements: Married status OR high relationship
+- Energy Regeneration: 100%
+- Sleep Duration: 7 seconds (includes romantic scene)
+- Capacity: 2 persons (Kai + Ana or Kai + Gronk)
+- Mood Effect: +15 (very well-rested) + relationship bonus
+- Special: Unlocks "Morning Together" random events
+- Asset: `interior_bed_kingsize.png`
+
+**Mechanics:**
+- Sleeping advances time to next morning (6am)
+- Can only sleep when tired (energy <40%) or at night
+- Romance partner joins if hearts ≥10 and married
+- Dreams may contain story hints or nightmares (zombie attacks)
+
+---
+
+### **Crafting Tables (2-Tier System)**
+
+**Small Crafting Table**
+- Cost: 1,000g
+- Available: From start
+- Recipes Unlocked: 50 basic items
+  - Tools (wooden tier)
+  - Simple repairs (locket cleaning)
+  - Basic food (sandwiches, salads)
+  - Beginner potions
+- Max Crafting Speed: 1x
+- Asset: `interior_table_small.png`
+
+**Large Planning Table**
+- Cost: 5,000g
+- Requirements: Meet Gronk + complete "Builder's Vision" quest
+- Recipes Unlocked: 100+ advanced items
+  - Expedition planning (maps, supplies)
+  - Complex mechanisms (automated tools)
+  - Advanced weapons
+  - Gronk's special equipment
+- Max Crafting Speed: 1.5x (efficiency bonus)
+- Special: Required for Gronk's Expedition System
+- Asset: `interior_table_large.png`
+
+**Crafting Interface:**
+- Grid-based recipe book
+- Ingredient checking (shows what you have vs. need)
+- Favorite recipes system
+- "Craft All" button for bulk production
+
+---
+
+### **House Extensions (2 Major Additions)**
+
+**Kitchen Extension**
+- Cost: 5,000g + 50 Wood + 25 Stone
+- Requirements: Farmhouse Level 2
+- Space Added: 3x4 grid (12 tiles)
+- Features:
+  - Advanced Cooking Stove (5 pots simultaneously)
+  - Refrigerator (extends food freshness by 200%)
+  - Dishwasher (aesthetic, no function)
+  - Recipe Book shelf (displays unlocked recipes)
+- Unlocks: 200+ advanced cooking recipes
+- Special Mechanics:
+  - Batch cooking (make 10 meals at once)
+  - Meal prep (cook Sunday, eat all week)
+  - Cooking with Ana/Gronk (bonus relationship)
+- Assets: `interior_kitchen_stove.png`, `interior_kitchen_counter.png`, `interior_kitchen_fridge.png`
+
+**Basement Extension** 
+- Cost: 10,000g + 100 Stone + 50 Iron
+- Requirements: Farmhouse Level 3 + Meet Grok
+- Space Added: Full underground floor (8x8 grid)
+- Features:
+  - Alchemy Laboratory (purple glowing setup)
+  - Memory Storage Vault (special items, Ana's belongings)
+  - Secret Passage (to Chernobyl Bunker - unlocked late game)
+  - Dark Ritual Circle (occult mechanics)
+- Unlocks:
+  - Advanced potion crafting
+  - Dark magic rituals
+  - Memory quest items storage
+  - Fast travel to bunker
+- Special: Required for "Finding Ana" questline
+- Assets: `interior_stairs_down.png`, `interior_alchemy_setup.png`, `interior_secret_passage.png`
+
+**Extension Mechanics:**
+- Visual upgrade to exterior (chimney for kitchen, basement window)
+- New interior map layout
+- NPC reactions (Gronk: "Wow, fancy kitchen dude!")
+- Property value increases (if selling ever implemented)
+
+---
+
+### **Home Customization System**
+
+**Furniture Placement:**
+- Grid-based system (32x32 tiles)
+- Drag-and-drop from inventory
+- Rotate furniture (0°, 90°, 180°, 270°)
+- Wall detection (some items only on walls)
+- Collision (can't place on occupied tiles)
+
+**Decorative Items (50+ total):**
+- Rugs, paintings, plants, candles
+- Ana's photos (unlocked through story)
+- Trophies (boss kills, achievements)
+- Seasonal decorations (Halloween, Christmas)
+
+**Functional Items:**
+- Wardrobes (100 outfit system storage)
+- Bookshelves (lore books, recipes)
+- Chests (extra item storage +50 slots each)
+- Lighting (lanterns, candles - affect mood)
+
+**Mood System:**
+- Well-decorated home: +10 mood daily
+- Messy home: -5 mood
+- Partner's preferences (Ana likes tidy, Gronk tolerates chaos)
+
+---
+
 ## 🏗️ BUILDINGS & STRUCTURES
 
 ### **Farm Buildings:**
@@ -374,13 +518,170 @@ Each anomalous biome has 1-2 bosses that guard story clues.
 
 ### **Town Buildings:**
 
-**Services:**
+**Core Services:**
 - General Store (buy seeds, tools)
 - Blacksmith (buy/upgrade weapons)
 - Clinic (healing, medicine)
 - Carpenter Shop (building construction)
 - Tavern (socialize, quests)
 
+---
+
+### **NEW TOWN BUILDINGS** ⭐
+**Added:** January 4, 2026
+
+**🥖 BAKERY (Pekarna)**
+
+**Unlock Requirements:**
+- Restore Town Square (Phase 1)
+- Complete "First Bread" quest
+- Cost: 8,000g + 100 Wood + 50 Wheat
+
+**NPC:** Baker (friendly middle-aged woman
+
+, flour on apron)
+
+**Services:**
+1. **Food Shop**
+   - Fresh Bread (50g) - Restores 20 energy
+   - Cake (200g) - Restores 50 energy, +5 hearts gift
+   - Pie (150g) - Restores 40 energy, +3 hearts gift
+   - Cookies (25g) - Restores 10 energy, +1 heart gift
+   - Croissants (75g) - Restores 25 energy, fancy!
+
+2. **Gift System**
+   - Baked goods are BEST gifts for NPCs
+   - Different NPCs have favorite pastries
+   - Buying in bulk gives discount (10 items = -20%)
+
+3. **Special Events**
+   - Weekly Baking Competition (mini-game)
+   - Birthday cakes for NPCs (auto-order system)
+   - Holiday specials (pumpkin pie, gingerbread)
+
+**Interior Design:**
+- Large brick ovens (2, glowing warm orange - noir contrast)
+- Counter with glass display cases
+- Bread shelves (stocked based on time of day)
+- Flour sacks in corner
+- "Warm bread smell" particle effect
+
+**Assets:**
+- `building_bakery_exterior.png` ✅
+- `interior_bakery_oven.png`
+- `interior_bakery_counter.png`
+- `interior_bakery_shelf.png`
+- `npc_baker.png`
+
+---
+
+**💇 BARBER SHOP (Frizeraj)**
+
+**Unlock Requirements:**
+- Town population ≥ 3 NPCs
+- Complete "Style Matters" quest
+- Cost: 6,000g + 75 Wood + 25 Iron
+
+**NPC:** Barber (punk-style character, piercings, colorful hair)
+
+**Services:**
+1. **Hairstyle Changes**
+   - Dreadlocks (Pink & Green - Kai's signature) - 500g
+   - Mohawk (Blue, Purple, Red) - 300g
+   - Long Hair (various colors) - 400g
+   - Ponytail - 250g
+   - Bald - 100g (FREE to reverse!)
+
+2. **Piercings & Body Mods**
+   - Ear Gauges (Kai's trademark) - 200g
+   - Nose Ring - 150g
+   - Eyebrow Piercing - 100g
+   - Lip Ring - 150g
+   - Multiple Ear Piercings - 50g each
+
+3. **Special Services**
+   - Zombie Makeover - 1,000g (make zombies look fancy!)
+   - NPC Customization - 500g (change other characters' looks)
+   - Dye Service - 200g (change clothing colors)
+
+**Mechanics:**
+- Opens character customization UI
+- Real-time preview before confirming
+- Can save 5 "favorite looks" for quick switching
+- Discounts for repeat customers (-10% after 5 visits)
+
+**Interior Design:**
+- 2 barber chairs (gothic style,
+
+ skull decorations)
+- Large ornate mirror
+- Piercing tools display
+- Hair dye bottles (rainbow colors)
+- Scissors, razors hanging on wall
+
+**Assets:**
+- `building_barbershop_exterior.png`
+- `interior_barber_chair.png`
+- `interior_barber_mirror.png`
+- `interior_piercing_tools.png`
+- `npc_barber.png`
+
+---
+
+**⚖️ LAWYER OFFICE (Ločitvena pisarna)**
+
+**Unlock Requirements:**
+- Married to Ana OR Gronk
+- Relationship hearts ≤ 3 (marriage in trouble)
+- Complete "Till Death Do Us Part?" quest
+- Cost: 15,000g (automatically built when needed)
+
+**NPC:** Lawyer (cold, professional, suit and tie - noir aesthetic)
+
+**Services:**
+1. **Divorce Processing**
+   - Cost: 50,000g (EXPENSIVE!)
+   - Consequences:
+     - Lose 25% of ALL remaining money
+     - Reset spouse relationship to 0 hearts
+     - Spouse moves out of farmhouse
+     - Lose "married" status benefits
+     - King-size bed reverts to single use
+   
+2. **Prenup System** (preventive)
+   - Buy before marriage: 10,000g
+   - Reduces divorce money loss to 10% instead of 25%
+   - Available ONLY before getting married
+
+3. **Marriage Counseling** (alternative)
+   - Cost: 5,000g
+   - Mini-quest: Fix relationship (3 tasks)
+   - Success: +5 hearts restored, avoid divorce
+   - Failure: Relationship worsens, divorce likely
+
+**Quest Triggers:**
+- "Single Again" - After divorce, rebuilding life
+- "Learning from Mistakes" - Unlocks new romance options
+- "The Cost of Love" - Story about relationships
+
+**Interior Design:**
+- Single desk with harsh overhead lamp (film noir vibe)
+- Bookshelves with legal texts
+- Cold, unwelcoming atmosphere
+- Gray/black color palette
+- Minimal decoration
+
+**Dialogue:**
+Lawyer: "Marriage is a contract. Divorce is... expensive."
+
+**Assets:**
+- `building_lawyer_office.png`
+- `interior_lawyer_desk.png`
+- `interior_lawyer_lamp.png`
+- `npc_lawyer.png`
+
+---
+
 **Rebuilding System:**
 - Town starts destroyed
 - Collect materials → Rebuild structures