📚 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! 🚀
2026-01-19 15:40:39 +01:00
parent de089e5b01
commit 8631958ade
20 changed files with 17529 additions and 33 deletions
--- a/DRUG_EMPIRE_SYSTEM_COMPLETE.md
+++ b/DRUG_EMPIRE_SYSTEM_COMPLETE.md
@@ -0,0 +1,406 @@
+# 🌿 DRUG EMPIRE SYSTEM - Complete Documentation
+**Datum:** 19. Januar 2026
+**Faza:** Unlocked across Faza 1-4
+**System:** Underground Economy + Zombie Dealers
+
+---
+
+# 🎯 KONCEPT
+
+**"Zgradi dilersko imperij... z zombie dilerji."**
+
+Build a drug empire using zombie workers as dealers while managing legal vs illegal trade, police raids, and black market operations.
+
+---
+
+# 📋 SYSTEM OVERVIEW
+
+## **Faza 1: Cannabis (Demo → Faza 1)**
+
+### Starting Capital Strategy:
+- **Demo Chest:** 3-5 Cannabis Seeds 🌿
+- **Growth Time:** 3-4 in-game days
+- **Sell Price:** 50 Zoombucks-100 per harvest (HIGH VALUE)
+- **Risk:** NONE (Guard Post inactive in Demo)
+
+### Demo Economy Loop:
+1. Plant cannabis seeds (from starting chest)
+2. Wait 3-4 days
+3. Harvest → Sell in town vendor
+4. Reinvest in more seeds
+5. **Result:** By unlock time you're a marijuana millionaire! 💰
+
+### Full Game Unlock:
+- All money/crops carry over
+- Can now buy better tools, explore
+- Cannabis farm = instant advantage
+
+---
+
+## **Faza 2: Guard Post & Licensing System**
+
+### ⚠️ **KDAJ SE AKTIVIRA (When Unlocks):**
+
+**DEMO:**
+- ❌ No Guard Post
+- ❌ No Mayor
+- ❌ No Town Access
+- ✅ Cannabis farming LEGAL (no consequences)
+- **Result:** Farm freely, no risk!
+
+**FAZA 1:**
+- ❌ Still no Town
+- ❌ Police/Mayor inactive
+- ✅ Can sell to basic vendor only
+- **Result:** Low-key underground economy
+
+**FAZA 2 (Town Restoration):**
+- ✅ **Town UNLOCKS**
+- ✅ **Mayor (Župan) moves in** (Town Hall)
+- ✅ **Guard Captain Luka arrives** (Guard Post built)
+- ✅ **Police system activates**
+- **TRIGGER:** Completing "Rebuild Town Hall" quest
+
+### Guard Captain Luka:
+**Activation:** Only in **Faza 2+** (when Town is restored)
+**Location:** Town Guard Post
+**Role:** Police enforcement
+
+### Mechanic:
+- **Trigger:** Harvest >10 units of Cannabis
+- **Guard Post activates** - Luka becomes aware
+
+### Two Paths:
+
+#### **A) Legal Operation (Licensed):**
+- **Cost:** 50 Zoombucks License
+- **Benefits:**
+  - +20% Sell Price
+  - NO Raids
+  - Legal protection
+- **Best For:** Long-term farming
+
+#### **B) Illegal Operation (Unlicensed):**
+- **Risk:** 10% Raid Chance per harvest
+- **Consequences:**
+  - Fine: 30 Zoombucks
+  - OR Bribe: 100 Zoombucks
+  - Confiscation possible
+- **Best For:** Risk-takers, higher margins
+
+---
+
+## **Faza 3: Zombie Dealers** 🧟
+
+### Training System:
+
+**Zombie Progression:**
+```
+Runner → Dealer → Kingpin
+```
+
+### **1. Capture Zombies:**
+- Use **Basement Level 1** (Zombie Containment Cell)
+- Train zombies in dealing mechanics
+
+### **2. Train as Dealers:**
+- **Time:** 2 in-game days
+- **Cost:** 20 Zoombucks training fee
+- **Skill:** Basic sales (NPC interaction)
+
+### **3. Upgrade to Kingpin:**
+- **Time:** 5 in-game days
+- **Cost:** 50 Zoombucks upgrade
+- **Skill:** Advanced routes, multiple customers
+
+### Passive Income:
+- **Dealers:** 10 Zoombucks-20/day (passive)
+- **Kingpins:** 50 Zoombucks-80/day (passive)
+- **Risk:** 5% chance zombie gets caught (lose inventory)
+
+### Management:
+- Assign territories (Forest, Town, Desert, etc.)
+- Equip with product (Cannabis, Mushrooms, Opium)
+- Monitor sales in Zombie Management UI
+- Collect profits daily
+
+---
+
+## **Faza 4: Opium & Black Market**
+
+### New Crop: **Opium Poppy** 🌺
+
+#### Growth:
+- **Stages:** 7 (seed → mature flower)
+- **Time:** 6-7 days
+- **Yield:** 3-5 units per harvest
+
+### Two Sales Paths:
+
+#### **A) Medical Path (Legal):**
+- **Buyer:** Doctor Petra (Town Clinic)
+- **Price:** 50 Zoombucks/unit
+- **Benefits:**
+  - Legal
+  - No raids
+  - Reputation bonus
+- **Requirements:**
+  - Medical certificate (100 Zoombucks)
+  - Weekly inspections
+
+#### **B) Black Market (Illegal):**
+- **Buyer:** Basement Dealer (Underground)
+- **Price:** 80 Zoombucks/unit (+60% profit!)
+- **Location:** Hidden basement (Town alley, behind dumpster)
+- **Password:** **"Purple Haze"**
+- **Risks:**
+  - 15% raid chance
+  - Heavy fines (200 Zoombucks)
+  - Jail time (lose 3 days)
+
+---
+
+# 🏗️ BUILDINGS & INFRASTRUCTURE
+
+## **Basement Level 1: Zombie Containment**
+**Unlock:** Faza 1
+**Cost:** 50 Zoombucks0
+
+### Features:
+- 5 zombie cells
+- Training facility
+- Basic containment
+- Zombie upgrade station
+
+---
+
+## **Basement Level 2: Grow Room** 🌿
+**Unlock:** Faza 2
+**Cost:** 1,000 Zoombucks
+
+### Features:
+- **Indoor Cannabis Farm** (12 plots)
+- **Magic Mushroom Farm** (8 plots)
+- Climate control (faster growth)
+- Hidden from Guard inspections
+- 24/7 growth (no seasons affect)
+
+### Crops (Indoor Only):
+- Cannabis (all year)
+- Magic Mushrooms 🍄 (hallucination effects)
+- Psychedelic varieties
+
+---
+
+## **Basement Level 3: Laboratory** ⚗️
+**Unlock:** Faza 4
+**Cost:** 2,500 Zoombucks
+
+### Features:
+- Opium processing
+- Drug synthesis station
+- Quality enhancement (+30% value)
+- Packaging equipment
+- Chemistry workstation
+
+### Products:
+- Processed Opium
+- Cannabis extracts (concentrates)
+- Psychedelic compounds
+- "Special Mixes" (rare, high value)
+
+---
+
+# 🍄 MAGIC MUSHROOMS
+
+## Growth & Harvest:
+- **Location:** Basement Grow Room OR Mushroom Forest biome
+- **Stages:** 5 (spore → mature cap)
+- **Time:** 4 days
+- **Yield:** 2-4 mushrooms
+
+## Effects (When Consumed):
+- **Hallucination Mode** (10 minutes)
+- Screen distortion
+- Color shifts
+- NPCs appear as creatures
+- Enhanced perception (find hidden items)
+
+## Sales:
+- **Town Herbalist:** 30 Zoombucks/unit (legal, medicinal)
+- **Black Market:** 60 Zoombucks/unit (illegal, recreational)
+- **Zombie Dealers:** Can sell to "party" NPCs
+
+---
+
+# 🧟 ZOMBIE DEALER MANAGEMENT
+
+## Training Progression:
+
+### **Tier 1: Runner** (Basic)
+- **Sales:** 10 Zoombucks-15/day
+- **Range:** 1 biome
+- **Risk:** 10% caught
+
+### **Tier 2: Dealer** (Intermediate)
+- **Sales:** 30 Zoombucks-50/day
+- **Range:** 3 biomes
+- **Risk:** 5% caught
+- **Unlock:** 10 successful sales
+
+### **Tier 3: Kingpin** (Advanced)
+- **Sales:** 80 Zoombucks-120/day
+- **Range:** All unlocked biomes
+- **Risk:** 2% caught
+- **Unlock:** 50 successful sales
+- **Special:** Can recruit sub-dealers (zombie network!)
+
+## Dealer UI:
+```
+┌─────────────────────────────┐
+│  ZOMBIE DEALER MANAGEMENT   │
+├─────────────────────────────┤
+│ Dealer #1: "Groaner Gary"   │
+│ Tier: Kingpin ⭐⭐⭐        │
+│ Territory: Forest + Swamp   │
+│ Inventory: 12 Cannabis      │
+│ Sales Today: €93            │
+│ Status: Active 🟢          │
+└─────────────────────────────┘
+```
+
+---
+
+# ⚠️ RISK & CONSEQUENCES
+
+## Police Raids:
+
+### **Light Raid:**
+- 30 Zoombucks fine
+- Confiscate 10% inventory
+- Warning issued
+
+### **Heavy Raid:**
+- 200 Zoombucks fine
+- Confiscate 50% inventory
+- 3-day jail (lose game time)
+- License revoked
+
+### **Avoid Raids:**
+1. Buy license (legal path)
+2. Bribe Guard Captain (100 Zoombucks/month)
+3. Use Zombie Dealers (they take the fall)
+4. Basement operations (harder to detect)
+
+## Zombie Dealer Caught:
+
+### Consequences:
+- Zombie confiscated (lose worker)
+- Inventory lost (all drugs on zombie)
+- 50 Zoombucks fine
+- Attention from Guards (+5% raid chance)
+
+### Prevention:
+- Upgrade to Kingpin (lower risk)
+- Assign safe territories
+- Reduce inventory per dealer
+
+---
+
+# 💰 PROFIT COMPARISON
+
+| Product | Legal Price | Black Market | Growth Time | Risk |
+|---------|-------------|--------------|-------------|------|
+| **Cannabis** | 50 Zoombucks | 70 Zoombucks | 3-4 days | Low |
+| **Mushrooms** | 30 Zoombucks | 60 Zoombucks | 4 days | Medium |
+| **Opium** | 50 Zoombucks | 80 Zoombucks | 6-7 days | High |
+| **Processed Opium** | 100 Zoombucks | 150 Zoombucks | +2 days | Very High |
+
+**Most Profitable:** Processed Opium (Black Market)
+**Safest:** Cannabis (Licensed)
+**Fastest:** Mushrooms (Basement)
+
+---
+
+# 🗺️ GDZIE KJE (Where Is Everything?)
+
+## **KLET (Basement):**
+**Location:** Your Farm (upgradeable building)
+**Access:** Hidden trapdoor behind barn
+
+### Levels:
+1. **Lvl 1:** Zombie Containment (Faza 1)
+2. **Lvl 2:** Grow Room (Faza 2)
+3. **Lvl 3:** Laboratory (Faza 4)
+
+---
+
+## **BLACK MARKET DEALER:**
+**Location:** Town Alley (behind Bakery)
+**Access:** Hidden door (behind dumpster)
+**Password:** "Purple Haze"
+**Hours:** 22:00 - 04:00 (night only)
+
+---
+
+## **ZOMBIE DILERJI (Dealers):**
+**HQ:** Basement Level 1
+**Territories:** Any unlocked biome
+**Management:** Zombie Management UI (Tab key)
+
+---
+
+# 🎮 GAMEPLAY LOOP
+
+## Early Game (Demo → Faza 1):
+1. Plant 3-5 Cannabis seeds (from chest)
+2. Harvest after 3-4 days
+3. Sell to Town Vendor (50 Zoombucks-100)
+4. Buy more seeds + tools
+5. **Result:** 50 Zoombucks0-1000 capital by Faza 1 unlock
+
+## Mid Game (Faza 2-3):
+1. Build Basement Lvl 1 + 2
+2. Indoor Cannabis farm (12 plots)
+3. Train 3-5 Zombie Dealers
+4. Get License OR go underground
+5. **Result:** 200 Zoombucks-500/day passive income
+
+## Late Game (Faza 4+):
+1. Unlock Opium + Laboratory
+2. Process drugs for +30% value
+3. Upgrade Dealers to Kingpins
+4. Black Market operations
+5. **Result:** 100 Zoombucks0+/day empire
+
+---
+
+# ✅ SUMMARY
+
+**System Unlocks:**
+- Faza 1: Cannabis farming
+- Faza 2: Guard Post, Licensing, Basement Grow Room
+- Faza 3: Zombie Dealers
+- Faza 4: Opium, Black Market, Laboratory
+
+**Key NPCs:**
+- Guard Captain Luka (Police)
+- Doctor Petra (Legal buyer)
+- Basement Dealer (Black Market - password: "Purple Haze")
+
+**Buildings:**
+- Basement Lvl 1: Zombie Containment
+- Basement Lvl 2: Grow Room (Cannabis + Mushrooms)
+- Basement Lvl 3: Laboratory (Processing)
+
+**Profitability:**
+- Cannabis: 50 Zoombucks-70/unit
+- Mushrooms: 30 Zoombucks-60/unit
+- Opium: 50 Zoombucks-150/unit (processed)
+
+**je to kar si iskat! 🌿🧟💰
+
+---
+
+**Status:** ✅ FULLY DOCUMENTED
+**Last Updated:** 19. Januar 2026