📚 MASTER DOCUMENTATION UPDATE - Complete Game Bible & Production Guides

## New Master Documents (16 files):

### Game Content:
- GAME_BIBLE_FINAL_2026.md (5703 lines - Ultimate master bible)
- GAME_BIBLE_2026_ULTIMATE.md (All specs + systems)
- GAME_BIBLE_2026_MASTER.md (Overview)
- BIOMES_ALL_20_COMPLETE.md (All 20 biomes detailed)
- STORY_COMPLETE_MASTER.md (Complete story + dialogues)

### Production & Phases:
- PRODUCTION_10_FAZAS_FINAL.md (10-phase release roadmap)
- DEMO_FAZA1_FAZA2_COMPLETE_GUIDE.md (Assets, NPCs, progression)
- DEMO_FAZA1_FAZA2_FINAL.md (Asset counts breakdown)

### Game Systems:
- DRUG_EMPIRE_SYSTEM_COMPLETE.md (Cannabis, mushrooms, zombie dealers)
- DRUG_SYSTEM_DEMO_F1_F2.md (Phase comparison + BUILD-TO-SPAWN)

### Identity & Features:
- HIPODEVIL666_TRADEMARK.md (Brand signature, philosophy)
- WHY_SPECIAL.md (10 unique selling points)
- ACCESSIBILITY_SLOVENIAN.md (Accessibility + language support)

### Technical:
- ELECTRON_STATUS_COMPLETE.md (Desktop app status)
- GLASBA_LICENCE_SUMMARY.md (Music + voiceover licenses)

### Session Log:
- SESSION_DNEVNIK_JAN_18_2026.md (Development diary)

## Key Highlights:

 20 biomes fully documented
 10-phase release strategy locked
 Drug empire system complete (BUILD-TO-SPAWN mechanics)
 HIPODEVIL666CITY confirmed (town name)
 Accessibility features documented (one-handed mode, color blind)
 Full Slovenian voiceover (21 tracks)
 Electron desktop app status
 Zoombucks currency (replaced €)
 Kevin MacLeod music (CC BY 3.0) + attribution

## Total Documentation:
- 16 new master files
- ~15,000+ lines of documentation
- Complete production roadmap
- All game systems documented

Ready for production! 🚀
This commit is contained in:
2026-01-19 15:40:39 +01:00
parent de089e5b01
commit 8631958ade
20 changed files with 17529 additions and 33 deletions

View File

@@ -0,0 +1,407 @@
# 🎮 DEMO, FAZA 1, FAZA 2 - COMPLETE GUIDE
**Datum:** 19. Januar 2026
**Verzija:** FINAL
---
# 📊 QUICK STATS
| Item | DEMO | FAZA 1 | FAZA 2 |
|------|------|--------|--------|
| **Assets (Slike)** | 252 | 925 | 450 |
| **NPCs** | 0 | 3 | 8 |
| **Town Name** | - | - | **HIPODEVIL666CITY** (Main Settlement) |
| **Gronk** | First 20 buyers ONLY | ✅ (if purchased in first 20) | ✅ |
| **Zombie Statistician** | ❌ | ❌ | ✅ |
| **Valuta** | Zoombucks 💰 | Zoombucks 💰 | Zoombucks 💰 |
---
# 🆓 DEMO - Free Trial
## 🏁 Kako Začne (Starting Sequence):
### 1. **Wake Up:**
- Kai se zbudi na farmi (small plot, 8x8 tiles)
- Brief intro dialogue (amnesia theme)
- "Where am I? What happened?"
### 2. **Starting Chest:**
Player najde **Starting Chest** z:
**📦 Vsebina:**
- **Seeds:**
- 2x Wheat seeds 🌾
- 2x Carrot seeds 🥕
- **3-5x Cannabis seeds** 🌿 (BONUS! Starting capital strategy)
- **Tools (Wooden Tier):**
- Wooden Hoe
- Wooden Watering Can
- Wooden Axe
- Wooden Pickaxe
- **Survival:**
- 1x Sleeping Bag (spawn point)
- 1x Bread (food)
- 1x Apple (food)
- 1x Torch (night)
- **Starting Money:** 10 Zoombucks
### 3. **Tutorial:**
- Basic farming tutorial (plant, water, harvest cycle)
- "Cannabis is valuable - sell it for profit!"
- Save system explanation
## 📊 Demo Assets:
### **Slike Needed: 252 total**
**✅ Complete (141):**
- Kai animations: 21 sprites
- Ana animations: 10 sprites
- Gronk animations: 10 sprites (LOCKED for most players)
- Susi animations: 12 sprites
- Zombies (3 types): 45 sprites
- Grassland assets: 27 references
- Tools: 8 sprites
- Crops (Wheat, Carrot): 10 sprites
- UI Elements: 28 sprites
**❌ Missing (111):**
- Grassland production tiles: 58
- 3 more crops (Tomato, Potato, Corn): 20 sprites
- Cannabis (7 stages): 7 sprites
- Animation polish: 26 sprites
## 👥 NPCs v Demo:
**Total: 0 NPCs** (samo Kai playable)
**Gronk:**
-**First 20 Buyers ONLY**
- Unlock: Automatic on first login (if early supporter)
- Special badge: "🏆 Early Supporter"
## 🌿 Cannabis Strategy:
1. Plant 3-5 seeds (from chest)
2. Wait 3-4 in-game days
3. Harvest
4. Sell to basic vendor: **50-100 Zoombucks**
5. Reinvest in seeds
6. **Goal:** 500-1000 Zoombucks capital by Faza 1 unlock
## 🎯 Demo Objective:
✅ Learn farming mechanics
✅ Build starting capital
**Get hooked** (buy Faza 1!)
**ZERO RISK** - no police, no consequences
---
# 🔥 FAZA 1 - Early Access (10 Zoombucks real €)
## 🏁 Kako Začne (If Demo Was Purchased):
### 1. **Seamless Transition:**
-**All progress carries over** (money, crops, saves)
- No reset, no restart
- "Thank you for purchasing! Content unlocked!"
### 2. **What Unlocks IMMEDIATELY:**
- ✅ Basement Level 1 (can build for 500 Zoombucks)
- ✅ 4 Biomes (Grassland, Forest, Desert, Swamp)
- ✅ 80 Crops total (full farming system)
- ✅ Stone/Iron tools (upgrade tiers)
- ✅ 3 Basic NPCs spawn
### 3. **New Starting (If Fresh Install Without Demo):**
**Fresh Faza 1 Start:**
- Kai wakes up on farm
- **Starting Chest (Enhanced):**
- 5x Wheat seeds
- 5x Carrot seeds
- **10x Cannabis seeds** (more capital)
- Wooden tools (hoe, can, axe, pickaxe)
- **Stone Hoe** (bonus!)
- 2x Bread, 2x Apple
- **50 Zoombucks** (starting money)
## 📊 Faza 1 Assets:
### **Slike Needed: 925 total**
**From Demo: 141** (keep all)
**New Assets (784):**
- Character combat animations: 36
- 3 Additional Biomes (Forest, Desert, Swamp): 135
- Forest: 60 assets
- Desert: 35 assets
- Swamp: 40 assets
- Tools & Weapons (3 tiers): 27
- Enemies (Skeleton, Rat, Boar, Mutants): 80 sprites
- All 80 Crops (full growth): 400 sprites
- UI Complete: 100 elements
- Basement Level 1: 6 assets
## 👥 NPCs v Fazi 1:
**Total: 3 NPCs**
1. **Basic Vendor** (Town outskirts)
- Sells: Seeds, tools
- Buys: Crops (including cannabis)
- Location: Small shack
2. **Blacksmith Ivan**
- Unlocks: Stone/Iron tools
- Location: Forest edge
3. **Ana (Memory Echo)**
- Appears in flashbacks (when finding her items)
- NOT physical NPC
**Gronk:**
- ✅ Available for ALL Faza 1 players (standard unlock)
- Quest: "Find the Trapped Troll" (Forest biome)
- Reward: Gronk joins as companion
## 🏗️ Basement Level 1:
**Cost:** 500 Zoombucks + 200 Wood + 100 Stone
**Features:**
- Zombie Containment Cell (5 cells)
- Training facility (basic)
- Zombie upgrade station
- **Prepares for Faza 2** (dealers system)
## 🌍 Exploration:
**4 Biomes unlocked:**
1. **Grassland** (home base)
2. **Forest** 🌲 (lumber, Gronk quest)
3. **Desert** 🏜️ (sand, cacti, scorpions)
4. **Swamp** 🌿 (toxic, herbs, frogs)
## 🎯 Faza 1 Objective:
✅ Explore 4 biomes
✅ Upgrade tools (Stone → Iron)
✅ Find Gronk (companion unlock)
✅ Build Basement Lvl 1
✅ Prepare zombie dealers
✅ Build capital (€200-500/day possible)
**Still NO Town, NO Police** (safe farming continues!)
---
# ⚡ FAZA 2 - Town Restoration
## 🏁 Kako Začne:
### 1. **Quest Trigger:**
- Complete Faza 1 objectives
- "A New Hope" quest appears
- "Rumors of survivors in a nearby settlement..."
### 2. **Town Discovery:**
- Travel 5km north from farm
- Find **HIPODEVIL666CITY** (ruined, empty)
- Mayor's Note: "Help us rebuild..."
### 3. **BUILD-TO-SPAWN Unlock:**
- Town Hall quest begins
- "Rebuild the settlement, one building at a time"
## 📊 Faza 2 Assets:
### **Slike Needed: 450 total**
**New Assets:**
- NPC sprites (8 NPCs × 11 sprites): 88
- Building variations (9 buildings × 5 stages): 45
- Town infrastructure: 250
- Roads, lamp posts, benches
- Market stalls, fountains
- Town square, gates
- Multiplayer UI: 15
- Basement Level 2: 12 assets
- Zombie Statistician: 11 sprites
- Population Board: 3 variants
## 👥 NPCs v Fazi 2:
**Total: 8 Town NPCs** (BUILD-TO-SPAWN)
### **How It Works:**
Build a building → NPC spawns automatically
### **NPCs List:**
1. **Mayor (Župan)** 🏛️
- Build: Town Hall (1,000 Zoombucks + materials)
- Role: Governance, quests, enables ORDER
- Unlocks: Laws, taxes, permits
2. **Guard Captain Luka (Sheriff)** 👮
- Build: Police Station (500 Zoombucks + materials)
- Role: Police enforcement
- **ACTIVATES Drug System Risk** (raids, licenses)
3. **Pek (Baker)** 🥖
- Build: Bakery (300 Zoombucks + materials)
- Sells: Bread, pastries
- Daily breakfast quest
4. **Teacher** 📚
- Build: School (400 Zoombucks + materials)
- Role: Skill training, library
5. **Blacksmith Ivan** (moves to town) 🔨
- Build: Smithy (500 Zoombucks + materials)
- Upgrades: Better tools/weapons
6. **Electrician**
- Build: Generator (600 Zoombucks + materials)
- Salary: 2 Zoombucks/day
- Role: Power grid maintenance
7. **Doctor Petra** 🏥
- Build: Clinic (800 Zoombucks + materials)
- Buys: Opium (medical path, legal)
- Heals: Injuries
8. **Zombie Statistician** 📊🧟
- Build: Population Board (200 Zoombucks + materials)
- Salary: 1 Zoombuck/day (CHEAPEST!)
- Role: Updates population counter on big board
- Daily: Walks to board, writes numbers with chalk
- Dialogue: "*Grumble* Numbers... always changing..."
## 🏙️ Ime Mesta:
**Official Name:** **"HIPODEVIL666CITY"** (Main Settlement)
**Alternative:** "HIPODEVIL666CITY" (New Village) - player can rename?
**Location:** Central Slovenia, Valley of Death region
**Population:** Starts at 0, grows with NPCs
## 📊 Zombie Statistician (Special NPC):
### **Kako Deluje:**
1. **Build Population Board** (Town Square)
- Big neon board with categories
- Shows: Humans, Zombies, Animals, Total
2. **Zombie Statistician spawns**
- Office zombie (suit, tie, glasses)
- Name tag: "Z. STATISTICIAN"
- Clipboard always in hand
3. **Hire for 1 Zoombuck/day**
- Cheapest NPC worker!
- Updates board daily at 10 AM
4. **Daily Routine:**
- Walks to Population Board
- Looks at clipboard
- Writes new numbers with chalk
- Updates: Humans, Zombies, Animals, Total
- Grumbles about work
- Returns to office
### **Dialogue:**
- "*Grumble* 47 humans... 12 zombies... *sigh*"
- "Numbers keep changing. I hate my job."
- "Why do I have to count the living AND the dead?"
- "Population: increasing. My patience: decreasing."
## 🏗️ Basement Level 2 (Grow Room):
**Cost:** 1,000 Zoombucks + 300 Wood + 200 Stone
**Features:**
- **12 Cannabis plots** (indoor, climate controlled)
- **8 Magic Mushroom plots** 🍄
- 24/7 growth (no seasons affect)
- **Hidden from Guard inspections** (underground)
- Faster growth (+20% speed)
## 🧟 Zombie Dealers ACTIVATE:
**Training System:**
1. **Capture zombies** (Basement Lvl 1)
2. **Train as Runner** (2 days, 20 Zoombucks)
3. **Upgrade to Dealer** (5 days, 50 Zoombucks)
4. **Upgrade to Kingpin** (10 days, 100 Zoombucks)
**Passive Income:**
- Runner: 10-20 Zoombucks/day
- Dealer: 30-50 Zoombucks/day
- Kingpin: 80-120 Zoombucks/day
## ⚠️ Police System (NEW):
**Activates ONLY when Police Station is built!**
### **Two Paths:**
**A) LEGAL (Licensed):**
- Cost: 50 Zoombucks License
- Benefits: +20% sell price, NO raids
- Safe operations
**B) ILLEGAL (Unlicensed):**
- Risk: 10% raid per harvest
- Fine: 30-200 Zoombucks
- Higher profits (black market)
**Until Police Station is built:** Cannabis = 100% LEGAL! ✅
## 🎯 Faza 2 Objective:
✅ Rebuild HIPODEVIL666CITY (9 buildings)
✅ Populate with 8 NPCs
✅ Build Basement Lvl 2 (Grow Room)
✅ Activate Zombie Dealers (passive income)
✅ Choose: Legal vs Illegal cannabis path
✅ Build empire (200-500 Zoombucks/day possible)
---
# 📊 GRAND TOTALS
| Category | Count |
|----------|-------|
| **Total Assets (Demo + F1 + F2)** | **1,627 slik** |
| **Total NPCs (all fazas)** | **11 NPCs** |
| **Biomes** | **4** (Grassland, Forest, Desert, Swamp) |
| **Gronk Unlock** | First 20 buyers (Demo) / Quest (Faza 1) |
| **Town Name** | **HIPODEVIL666CITY** (HIPODEVIL666CITY alternative) |
| **Zombie Statistician** | Faza 2, 1 Zoombuck/day |
| **Valuta** | **Zoombucks** 💰🧟 |
---
# 🎮 PLAYER PROGRESSION SUMMARY
## **DEMO → FAZA 1 Transition:**
✅ All progress carries over
✅ Money, crops, saves preserved
✅ Seamless unlock (no restart)
**Gronk** unlocks (if first 20 buyer OR quest in F1)
## **FAZA 1 → FAZA 2 Transition:**
✅ All progress carries over
✅ "A New Hope" quest triggers
✅ HIPODEVIL666CITY discovery
✅ BUILD-TO-SPAWN system begins
**Drug empire evolves** (legal vs illegal choice)
---
**Last Updated:** 19. Januar 2026
🎮📊✅