diff --git a/docs/game_design/GAME_BIBLE_2.md b/docs/game_design/GAME_BIBLE_2.md index 3839bf4e4..58772f803 100644 --- a/docs/game_design/GAME_BIBLE_2.md +++ b/docs/game_design/GAME_BIBLE_2.md @@ -1,45 +1,50 @@ -# ๐ŸŽฎ DOLINASMRTI - COMPLETE GAME BIBLE v2.0 +# ๐ŸŽฎ DOLINASMRTI - PRODUCTION GAME BIBLE v2.0 **Created:** 06.01.2026 21:30 CET -**Last Updated:** 06.01.2026 21:33 CET -**Source:** Merged from `generate_assets_full.py` (MASTER) + GAME_BIBLE v1 -**Version:** Alpha 2.0 - Complete Asset Registry + Full Story -**Status:** ๐Ÿ”ฅ MASTER VERSION - 13,500+ Assets, 20 Biomes, 109 Creatures, Full Game Systems! +**Last Updated:** 06.01.2026 22:00 CET +**Source:** Merged from `generate_assets_full.py` + GAME_BIBLE v1 +**Version:** Alpha 2.0 - Complete Asset Registry + Production Tracking +**Status:** ๐Ÿ”ฅ MASTER VERSION - 13,500+ Assets, 20 Biomes, 109 Creatures, Full Systems! --- -## ๐Ÿ“‹ DOCUMENT STATUS +## ๐Ÿ“‹ PRODUCTION STATUS LEGEND -**This document merges:** -- `scripts/generate_assets_full.py` - Complete 13,500+ asset registry -- `docs/game_design/GAME_BIBLE.md` v1 - Story, mechanics, quest systems, additional biomes - -All asset counts, descriptions, and specifications are accurate and synchronized. +| 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. [Game Overview](#game-overview) -2. [Story & Setting](#story--setting) -3. [Main Characters](#main-characters) -4. [NPCs & Factions](#npcs--factions) -5. [Enemies & Bosses](#enemies--bosses) -6. [Animals & Creatures](#animals--creatures) -7. [Gameplay Systems](#gameplay-systems) -8. [World & Locations](#world--locations) -9. [Items & Crafting](#items--crafting) -10. [Art Style & Visuals](#art-style--visuals) +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) --- -## ๐ŸŽฎ GAME OVERVIEW +## ๐Ÿ“š STORY & SETTING +**Status:** ๐Ÿ”ฅ **PHASE 1 CRITICAL** | โœ… **LOCKED & APPROVED** ### **Title:** Krvava ลฝetev (DolinaSmrti / Bloody Harvest) ### **Genre:** - Survival RPG -- Farming Simulator +- Farming Simulator - Post-Apocalyptic Adventure - Story-Driven Exploration @@ -145,6 +150,17 @@ All asset counts, descriptions, and specifications are accurate and synchronized --- ## ๐Ÿ‘ฅ 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!) @@ -285,7 +301,20 @@ All asset counts, descriptions, and specifications are accurate and synchronized --- -## ๐Ÿ‘ฅ CHARACTERS & NPCs +## ๐Ÿ˜๏ธ 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) @@ -374,8 +403,24 @@ From `/references/npcs/` with master_reference.png: --- ## ๐Ÿพ ANIMALS & CREATURES (109 TOTAL! - COMPLETE CATALOG) +**Status:** ๐Ÿ”„ **22/109 Generated** | ๐Ÿ”ฅ **PHASE 1 IN PROGRESS** | Updated: 06.01.2026 21:35 CET -**Updated:** 06.01.2026 21:35 CET - Complete creature catalog across all 20 biomes! +| Creature Category | Count | Master Refs | Sprites | Status | Phase | +|-------------------|-------|-------------|---------|--------|-------| +| **Chernobyl Mutants** | 10 | โœ… 3/10 | โŒ 0/10 | ๐Ÿ”„ 30% Refs | ๐Ÿ”ฅ Phase 1 | +| **Farm Animals** | 10 | โœ… 6/10 | โŒ 0/10 | ๐Ÿ”„ 60% Refs | ๐ŸŽฏ DEMO | +| **Wild Animals** | 15 | โœ… 13/15 | โŒ 0/15 | ๐Ÿ”„ 87% Refs | ๐Ÿ”ฅ Phase 1 | +| **Dinosaurs** | 15 | โŒ 0/15 | โŒ 0/15 | โŒ Not Started | โšก Phase 2 | +| **Mythical Creatures** | 39 | โŒ 0/39 | โŒ 0/39 | โŒ Not Started | โšก Phase 2 | +| **Worker Creatures** | 6 | โŒ 0/6 | โŒ 0/6 | โŒ Not Started | โšก Phase 2 | +| **Chupacabra Variants** | 3 | โŒ 0/3 | โŒ 0/3 | โŒ Not Started | โšก Phase 2 | +| **Bosses** |24 | โŒ 0/24 | โŒ 0/24 | โŒ Not Started | โšก Phase 2 | +| **TOTAL CREATURES** | **109** | **โœ… 22/109** | **โŒ 0/109** | **๐Ÿ”„ 20% Refs** | Multiple | + +**Next Steps:** +- ๐ŸŽฏ **Immediate:** Finish Wild Animals (2 remaining: Frog, Snake) +- ๐Ÿ”ฅ **Phase 1:** Complete Chernobyl Mutants (7 remaining) +- โšก **Phase 2:** Start Dinosaurs (15 total) --- @@ -694,9 +739,24 @@ Mimic, Basilisk, Cockatrice, Manticore, Chimera, Hydra, Phoenix, Griffin, Hippog --- -## ๐ŸŒ BIOMES (20 Total - COMPLETE!) +## ๐ŸŒ BIOMES & LOCATIONS (20 Total - COMPLETE!) +**Status:** โœ… **20/20 DEFINED!** | ๐Ÿ”„ **Assets In Progress** | ๐Ÿ”ฅ **PHASE 1 PRIORITY** -### NORMAL BIOMES (9) +| 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 @@ -961,30 +1021,200 @@ Anvil, Forge, Furnace, Kiln, Loom, Spinning Wheel, Workbench, Crafting Table, Al --- -## ๐Ÿ“ FINAL NOTES +## ๐Ÿ“Š PRODUCTION SUMMARY +**Last Updated:** 06.01.2026 22:00 CET -**Document Created:** 06.01.2026 21:30 CET -**Last Updated:** 06.01.2026 21:38 CET -**Sources Merged:** -- `scripts/generate_assets_full.py` - Complete 9000+ asset registry -- `docs/game_design/GAME_BIBLE.md` v1 - Story, mechanics, quest systems +### ๐Ÿ“ˆ OVERALL PROGRESS -**What's Complete:** -โœ… Full story (Kai & Ana 14-year-old twins, amnesia, Giant Troll King boss) -โœ… 20 Biomes (including Mexican Cenotes ๐Ÿ‡ฒ๐Ÿ‡ฝ + Witch Forest ๐Ÿง™) -โœ… 109 Creatures (including 3 Chupacabra variants + 6 Worker Creatures) -โœ… Complete asset registry (NPCs, monsters, crops, items, buildings) -โœ… Zmaj Volk removal confirmed โŒ -โœ… Giant Troll King as final boss โœ“ - -**Key Confirmations:** -- **Cyclops** โœ… Present in mythical creatures -- **Minotaur** โœ… Present in mythical creatures -- **Giant Troll** โœ… Present as boss #19 +| Category | Total | Complete | In Progress | Not Started | % Done | +|----------|-------|----------|-------------|-------------|--------| +| **Master References** | 13,500 | 188 | 0 | 13,312 | 1.4% | +| **NPCs** | 388 | 181 | 0 | 207 | 46.6% | +| **Creatures** | 109 | 22 | 0 | 87 | 20.2% | +| **Bosses** | 24 | 0 | 0 | 24 | 0% | +| **Biomes (Design)** | 20 | 20 | 0 | 0 | 100% โœ… | +| **Biomes (Assets)** | 20 | 0 | 3 | 17 | 0% | +| **Sprites** | ~50,000 | 0 | 0 | ~50,000 | 0% | --- -**STATUS:** โœ… GAME_BIBLE_2.md is COMPLETE and SYNCHRONIZED! +### โš™๏ธ GAME SYSTEMS & MECHANICS -This is the MASTER game bible merging both sources. Use this for all future development! +#### โœ… **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 | + +#### ๐Ÿ”„ **IN PROGRESS SYSTEMS** (๐Ÿ”ฅ Phase 1 / โšก Phase 2) + +| System | Status | Phase | Progress | +|--------|--------|-------|----------| +| **Creature System** | ๐Ÿ”„ 20% | ๐Ÿ”ฅ Phase 1 | 22/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 | +| **Quest 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) +**Target:** Vertical slice gameplay +**Required Assets:** +- โœ… Kai (Master Ref) โŒ Sprites needed +- โœ… Ana (Master Ref) โŒ Sprites needed +- โœ… Gronk (Master Ref) โŒ Sprites needed +- โœ… Susi (Master Ref) โŒ Sprites needed +- โŒ Grassland Biome (CRITICAL!) - 0% complete +- โŒ 1 Zombie type +- โŒ Basic Farm (8ร—8 plot) + +**Status:** ๐Ÿ”ด **BLOCKED** - Grassland biome assets needed! + +#### **๐Ÿ”ฅ 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**