From 242d780106ef5327bdb68e3a51e2bf45285b44ca Mon Sep 17 00:00:00 2001 From: David Kotnik Date: Wed, 31 Dec 2025 02:39:03 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=8A=20Master=20Asset=20Spreadsheet=20+?= =?UTF-8?q?=20Technical=20Specification?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Complete asset breakdown and technical specs for 3k target --- MASTER_ASSET_RAZPREDELNICA.md | 600 ++++++++++++++++++++++++++++++++++ TEHNICNA_SPECIFIKACIJA.md | 557 +++++++++++++++++++++++++++++++ 2 files changed, 1157 insertions(+) create mode 100644 MASTER_ASSET_RAZPREDELNICA.md create mode 100644 TEHNICNA_SPECIFIKACIJA.md diff --git a/MASTER_ASSET_RAZPREDELNICA.md b/MASTER_ASSET_RAZPREDELNICA.md new file mode 100644 index 000000000..434432229 --- /dev/null +++ b/MASTER_ASSET_RAZPREDELNICA.md @@ -0,0 +1,600 @@ +# 📊 MASTER ASSET RAZPREDELNICA - KRVAVA ŽETEV +## Kompletna Tabela Vseh Materialov & Assetov za Igro + +**Verzija:** 1.0 +**Datum:** 31.12.2025, 02:35 +**CILJ:** 3,000 total slik (realistično!) + +--- + +## 🏛️ 1. RUŠEVINE & MESTA (TOWNS/RUINS) + +### **OSNOVNA MESTA (2 za začetek):** + +| # | IME | TIP | RUŠEVINE | OBNOVLJIVE ZGRADBE | NPCs START | NPCs MAX | PRIORITETA | +|---|-----|-----|----------|-------------------|------------|----------|------------| +| **1** | **Dolina Smrti (Home Base)** | Starter Town | Tent → House | 5 osnovnih | 4 | 20 | ⭐⭐⭐⭐⭐ | +| **2** | **Bližnje Mesto (Nearby City)** | First Town | Ruined City | 8 trgovin | 6 | 15 | ⭐⭐⭐⭐ | + +### **DOLINA SMRTI (Home Base) - STAVBE:** + +| ZGRADBA | REQUIREMENT | MATERIAL | NPC UNLOCK | +|---------|-------------|----------|------------| +| **Tent** (Start) | START | 0 (začetna) | 0 | +| **Shack** | Week 1 | Wood×50, Stone×20 | +1 Trader | +| **House** | Week 2 | Wood×100, Stone×50, Iron×10 | +2 NPCs | +| **Barn** | Lvl 10 | Wood×150, Stone×80 | +1 Blacksmith | +| **Workshop** | Lvl 15 | Wood×100, Iron×30 | +1 Craftsman | + +**MATERIJALSKA POTREBA (Dolina Smrti Total):** +- **Wood:** ~400x +- **Stone:** ~150x +- **Iron:** ~40x + +--- + +### **BLIŽNJE MESTO (First Town) - RUŠEVINE:** + +| RUŠEVINA | ORIGINAL | MATERIAL ZA OBNOVO | NPC TYPE | +|----------|----------|-------------------|----------| +| ⬜ **Gostilna (Inn)** | Tavern | Wood×200, Stone×100, Iron×20 | 🍺 Innkeeper | +| ⬜ **Kovačnica (Smithy)** | Blacksmith | Stone×150, Iron×50, Coal×30 | 🔨 Blacksmith | +| ⬜ **Trgovina (Shop)** | General Store | Wood×120, Stone×60 | 🛒 Merchant | +| ⬜ **Cerkev (Church)** | Church | Stone×250, Wood×100 | ⛪ Priest | +| ⬜ **Kurnik (Coop)** | Chicken Coop | Wood×80, Nails×40 | 🐔 Farmer | +| ⬜ **Silo** | Grain Storage | Wood×100, Stone×80, Iron×15 | 🌾 Agricultural NPC | +| ⬜ **Hiša 1** | Residential | Wood×100, Stone×50 | 👨 Villager | +| ⬜ **Hiša 2** | Residential | Wood×100, Stone×50 | 👩 Villager F | + +**MATERIJALSKA POTREBA (Bližnje Mesto Total):** +- **Wood:** ~1,000x +- **Stone:** ~900x +- **Iron:** ~85x +- **Coal:** ~30x +- **Nails:** ~40x + +--- + +### **VSA MESTA (Full Game - 27 TOWNS):** + +Po Game Bible: **27 towns** total + +**STRATEGIJA:** +- **Faza 1:** 2 mesti (Home + First Town) +- **Faza 2:** +5 mest (Total 7) +- **Faza 3:** +10 mest (Total 17) +- **Faza 4:** +10 mest (Total 27 - full game) + +--- + +## 👥 2. NPCs (NON-PLAYABLE CHARACTERS) + +### **STARTER NPCs (4 - za Demo):** + +| # | IME | ROLE | LOKACIJA | TRGOVINA | QUEST | PRIORITETA | +|---|-----|------|----------|----------|-------|------------| +| 1 | **Trgovec (Trader)** | Merchant | Dolina | Seeds, Tools | "First Trade" | ⭐⭐⭐⭐⭐ | +| 2 | **Kovacar (Blacksmith)** | Weaponsmith | Bližnje Mesto | Upgrades | "Forge Weapon" | ⭐⭐⭐⭐ | +| 3 | **Zdravilec (Healer)** | Medic | Bližnje Mesto | Potions | "Gather Herbs" | ⭐⭐⭐⭐ | +| 4 | **Potnik (Traveler)** | Quest Giver | Random | Ana Clue #1 | "Find Ana" | ⭐⭐⭐⭐⭐ | + +### **MEDIUM NPCs (20 - Alpha):** + +| KATEGORIJA | ŠTEVILO | PRIMERI | +|-----------|---------|---------| +| **Trgovci (Merchants)** | 5 | Trader (general), Weaponsmith, Seed Vendor, Animal Trader, Potion Seller | +| **Obrtniki (Craftsmen)** | 4 | Blacksmith, Tailor, Carpenter, Alchemist | +| **Kmetje (Farmers)** | 3 | Male Farmer, Female Farmer, Agricultural Specialist | +| **Vaščani (Villagers)** | 4 | Elder, Scout, Cook, Mechanic | +| **Quest NPCs** | 4 | Mysterious Traveler, Dr. Chen, Jakob, Ana (end-game) | + +**SKUPAJ (Alpha):** 4 (demo) + 20 (mid-game) = **24 NPCs** + +### **FULL GAME NPCs (180 total):** + +Po Game Bible: **180 NPCs** across 27 towns + +**POVPREČJE:** 180 / 27 = ~6.7 NPCs po mestu + +**RAZDELITEV:** +- Main Hub: 20 NPCs +- Major Towns (6): 15 NPCs each = 90 NPCs +- Medium Towns (10): 8 NPCs each = 80 NPCs +- Small Towns (10): 4 NPCs each = 40 NPCs + +**SKUPAJ:** 20 + 90 + 80 + 40 = **230 NPCs** (z rezervo) + +--- + +## 🧟 3. SOVRAŽNIKI (ENEMIES) + +### **ZOMBIES (8 tipov):** + +| # | TIP | HP | DAMAGE | POSEBNOST | ASSET VERZIJE | +|---|-----|----|----|-----------|---------------| +| 1 | **Basic Zombie** | 50 | 5 | Slow | Idle, Walk, Attack | +| 2 | **Runner Zombie** | 30 | 8 | Fast | Idle, Run, Attack | +| 3 | **Bloated Zombie** | 150 | 10 | Explodes | Idle, Walk, Explode | +| 4 | **Dreadlocks Zombie** | 70 | 6 | Medium | Idle, Walk, Attack | +| 5 | **Worker Zombie** | 40 | 0 | Controllable! | Idle, Dig, Plant, Harvest | +| 6 | **Crawler** | 25 | 4 | Ground | Crawl, Attack | +| 7 | **Screamer** | 20 | 3 | Alerts | Idle, Scream | +| 8 | **Zombie Horde** | 200 | 12 | Group | Formation, Attack | + +**ANIMACIJE:** +- Idle: 1 frame +- Walk/Run: 4 frames +- Attack: 3 frames +- Special: 2 frames + +**TOTAL ZA ZOMBIES:** +8 tipov × (1 + 4 + 3 + 2) = 8 × 10 = **80 frameov (Style A + Style B = 160 slik)** + +--- + +### **MUTANTI & ŽIVALI (Wild):** + +| TIP | ŠTEVILO | PRIMERI | +|-----|---------|---------| +| **Mutant Beasts** | 8 | Mutated Dog, Rat, Bear, Wolf, Boar | +| **Werewolves** | 2 | Normal, Alpha | +| **Skeletons** | 3 | Warrior, Archer, Mage | +| **Ghosts** | 2 | Spirit, Wraith | +| **Wild Animals** | 8 | Wolf, Bear, Wild Boar, Fox, Deer, Rabbit, Owl, Bat | + +**SKUPAJ:** 8 + 2 + 3 + 2 + 8 = **23 enemy types** + +**ANIMACIJE (average 8 frameov per type):** +23 × 8 = **184 frameov (× 2 styles = 368 slik)** + +--- + +### **BOSSES (7 Major):** + +| # | IME | LEVEL | ANIMACIJE | HP | +|---|-----|-------|-----------|-----| +| 1 | **Mutant King** | 10 | 12 frames | 2,000 | +| 2 | **Zombie Horde Leader** | 20 | 14 frames | 4,000 | +| 3 | **Ancient Tree** | 30 | 10 frames | 6,000 | +| 4 | **Giant Troll King** | 43 | 16 frames | 10,000 | +| 5 | **Ice Titan** | 40 | 12 frames | 8,000 | +| 6 | **Fire Dragon** | 50 | 18 frames | 15,000 | +| 7 | **King Slime** | 35 | 10 frames | 7,000 | + +**TOTAL BOSS FRAMES:** +12 + 14 + 10 + 16 + 12 + 18 + 10 = **92 frameov (× 2 styles = 184 slik)** + +--- + +## 🐾 4. ŽIVALI (ANIMALS) + +### **FARM ANIMALS (Livestock - 5 base + mutant variants):** + +| TIP | BASIC | MUTANT | LEGENDARY | ANIMACIJE (frames) | +|-----|-------|--------|-----------|-------------------| +| **Sheep** | White Sheep | Fire Sheep | Golden Fleece | Idle(1), Walk(4), Eat(2) = 7 | +| **Cow** | Brown Cow | Mutant Cow | - | Idle(1), Walk(4), Eat(2) = 7 | +| **Chicken** | Chicken | 3-Headed Chicken | - | Idle(1), Walk(4), Peck(2) = 7 | +| **Pig** | Pig | Giant Pig | - | Idle(1), Walk(4), Eat(2) = 7 | +| **Horse** | Horse | - | Undead Horse | Idle(1), Walk(4), Run(4) = 9 | + +**VERZIJE:** 5 basic + 3 mutant + 2 legendary = **10 animal variants** + +**TOTAL FRAMES:** +(4 × 7) + (1 × 9) + (mutants × 7) + (legendary × 9) = 28 + 9 + 21 + 18 = **76 frameov (× 2 styles = 152 slik)** + +--- + +### **WILD ANIMALS (Za "Animal Rescue" quest):** + +| # | ANIMAL | ANIMACIJE | SPECIAL | +|---|--------|-----------|---------| +| 1 | Fox | 6 frames | Stealth | +| 2 | Deer | 8 frames | Fast | +| 3 | Rabbit | 4 frames | Small | +| 4 | Hedgehog | 4 frames | Defense | +| 5 | Bear | 10 frames | Strong | +| 6 | Wolf | 8 frames | Pack | +| 7 | Wild Boar | 6 frames | Charge | +| 8 | Owl | 4 frames | Flying | +| 9 | Bat | 4 frames | Flying (night) | + +**TOTAL:** 6+8+4+4+10+8+6+4+4 = **54 frameов (× 2 = 108 slik)** + +--- + +### **MAGICAL CREATURES:** + +| TIP | ŠTEVILO | ANIMACIJE (avg) | +|-----|---------|----------------| +| **Griffin** | 1 | 12 frames | +| **Pterodactyl** | 1 | 10 frames | +| **Hippogriff** | 1 | 12 frames | +| **Sea Dragon** | 1 | 14 frames | +| **Nessie** | 1 | 10 frames | +| **Bigfoot** | 1 | 8 frames (legendary!) | + +**TOTAL:** 12+10+12+14+10+8 = **66 frameov (× 2 = 132 slik)** + +--- + +## ⚙️ 5. WORKER CREATURES (6 types) + +| # | TIP | SPECIALTY | ANIMACIJE | +|---|-----|-----------|-----------| +| 1 | **Vilinci (Elves)** | Crafting | Idle(1), Work(4), Carry(2) = 7 | +| 2 | **Gnomi (Gnomes)** | Mining | Idle(1), Mine(4), Carry(2) = 7 | +| 3 | **Vile (Fairies)** | Plant Care | Idle(1), Fly(4), Cast(2) = 7 | +| 4 | **Bigfoot/Yeti** | Gathering | Idle(1), Walk(4), Gather(2) = 7 | +| 5 | **Golem** | Labor | Idle(1), Walk(3), Build(3) = 7 | +| 6 | **Zmaj (Dragon)** | Ultimate | Idle(1), Fly(6), Breathe Fire(3) = 10 | + +**TOTAL:** (5 × 7) + 10 = **45 frameov (× 2 = 90 slik)** + +--- + +## 🌾 6. RASTLINE (PLANTS & CROPS) + +### **OSNOVNI POSEVKI (Basic Crops):** + +| # | CROP | GROWTH STAGES | TOTAL FRAMES | +|---|------|---------------|--------------| +| 1 | **Wheat (Pšenica)** | 5 stages | 5 | +| 2 | **Corn (Koruza)** | 5 stages | 5 | +| 3 | **Tomato (Paradižnik)** | 4 stages | 4 | +| 4 | **Potato (Krompir)** | 4 stages | 4 | +| 5 | **Carrot (Korenje)** | 4 stages | 4 | +| 6 | **Pumpkin (Buča)** | 5 stages | 5 | +| 7 | **Hemp (Konoplja)** | 4 stages | 4 | +| 8 | **Biolum. Fungi** | 3 stages | 3 | + +**TOTAL:** 5+5+4+4+4+5+4+3 = **34 frameov (× 2 = 68 slik)** + +--- + +### **DREVESA (TREES):** + +| TIP | VARIETETE | ANIMACIJE | SEASONAL | +|-----|-----------|-----------|----------| +| **Oak (Hrast)** | Normal, Dead | 2 | Spring, Summer, Fall, Winter = 4 | +| **Pine (Bor)** | Normal, Snow | 2 | 4 seasonal | +| **Birch (Breza)** | Normal | 1 | 4 seasonal | +| **Apple Tree** | Normal, Fruited | 2 | 4 seasonal | +| **Walnut Tree** | Normal | 1 | 4 seasonal | + +**VARIANTS:** 2 + 2 + 1 + 2 + 1 = 8 tree types × 4 seasonal = **32 verzije (× 2 styles = 64 slik)** + +--- + +### **GROZNO RASTLINJE (Special Plants):** + +| PLANT | VERSIONS | FRAMES | +|-------|----------|--------| +| **Bush (Grm)** | 3 types | 3 | +| **Flowers (Cvetje)** | 5 colors | 5 | +| **Grass Patches** | 4 variants | 4 | +| **Rocks** | 6 sizes | 6 | +| **Mesojedka (Carniv.)** | Attack anim (6) | 6 | + +**TOTAL:** 3+5+4+6+6 = **24 slik (× 2 = 48)** + +--- + +## 🏗️ 7. ZGRADBE (BUILDINGS) + +### **PLAYER BUILDINGS:** + +| TIER | BUILDING | MATERIAL COST | UNLOCK | +|------|----------|---------------|--------| +| 1 | **Tent** | FREE (start) | Start | +| 2 | **Shack** | Wood×50, Stone×20 | Week 1 | +| 3 | **House** | Wood×100, Stone×50, Iron×10 | Week 2 | +| 4 | **Upgraded House** | Wood×200, Stone×100, Iron×30 | End Game | + +**PROIZVODNJA (Production Buildings):** + +| # | BUILDING | MATERIAL | FUNCTION | +|---|----------|----------|----------| +| 1 | **Barn** | Wood×150, Stone×80 | Animal Storage | +| 2 | **Greenhouse** | Wood×100, Glass×50 | Year-round crops | +| 3 | **Workshop** | Wood×100, Iron×30 | Crafting | +| 4 | **Laboratory** | Stone×150, Iron×50 | Science | +| 5 | **Vape Lab** | Wood×80, Glass×30 | Vape Mix | +| 6 | **Mint** | Stone×200, Gold×10 | Coin Factory | + +**TOWN BUILDINGS (za obnovo mest):** + +| # | BUILDING | MATERIAL | NPC | +|---|----------|----------|-----| +| 1 | **Gostilna (Inn)** | Wood×200, Stone×100, Iron×20 | Innkeeper | +| 2 | **Kovačnica (Smithy)** | Stone×150, Iron×50, Coal×30 | Blacksmith | +| 3 | **Trgovina (Shop)** | Wood×120, Stone×60 | Merchant | +| 4 | **Cerkev (Church)** | Stone×250, Wood×100 | Priest | +| 5 | **Kurnik (Coop)** | Wood×80, Nails×40 | Farmer | +| 6 | **Silo** | Wood×100, Stone×80, Iron×15 | Agricultural NPC | +| 7 | **Bakery** | Stone×100, Wood×80, Oven×1 | Baker | +| 8 | **Tavern** | Wood×180, Stone×90 | Bartender | + +**TOTAL UNIQUE BUILDINGS:** 4 (player) + 6 (production) + 8 (town) = **18 building types** + +**PER BUILDING:** Normal + Ruined version = 2 verzije +**TOTAL:** 18 × 2 = **36 building sprites (× 2 styles = 72 slik)** + +--- + +## ⚔️ 8. OROŽJE (WEAPONS) + +### **MELEE WEAPONS:** + +| # | WEAPON | TIERS | TOTAL | +|---|--------|-------|-------| +| 1 | **Wooden Sword** | Basic | 1 | +| 2 | **Iron Sword** | Mid | 1 | +| 3 | **Steel Sword** | Advanced | 1 | +| 4 | **Legendary Sword** | Epic | 1 | +| 5 | **Scythe** | Dual (farm/weapon) | 1 | +| 6 | **Axe (Battle)** | Combat | 1 | +| 7 | **War Hammer** | Heavy | 1 | +| 8 | **Kosa (Scythe)** | Farm weapon | 1 | + +**TOTAL MELEE:** 8 × 2 styles = **16 slik** + +--- + +### **RANGED WEAPONS (Bows + Arrows):** + +| BOWS (4) | ARROWS (6) | +|----------|-----------| +| Wooden Bow | Fire Arrow | +| Crystal Bow | Ice Arrow | +| Dragon Bow | Lightning Arrow | +| Alpha Bow (Rainbow!) | Bomb Arrow | +| | Poison Arrow | +| | Holy Arrow (Silver) | + +**TOTAL RANGED:** (4 bows + 6 arrows) × 2 styles = **20 slik** + +--- + +## 🛠️ 9. ORODJA (TOOLS) + +| # | TOOL | TIERS | FUNCTION | +|---|------|-------|----------| +| 1 | **Hoe** | Wood, Iron, Gold, Diamond | Till Soil | +| 2 | **Watering Can** | Basic, Copper, Iron, Gold | Water Crops | +| 3 | **Axe** | Wood, Iron, Gold, Diamond | Chop Trees | +| 4 | **Pickaxe** | Wood, Iron, Gold, Diamond | Mine Rocks | +| 5 | **Scythe** | Iron, Steel | Harvest Crops | +| 6 | **Fishing Rod** | Basic, Advanced | Catch Fish | + +**TOTAL:** 6 tools × 4 tiers (avg) = **24 tool variants (× 2 = 48 slik)** + +--- + +## ⛏️ 10. RUDNIKI & RESOURCES + +### **MINING RESOURCES (Ore Deposits):** + +| RESOURCE | DEPTH LEVEL | KOLIČINA PO DEPOSIT | SPAWN RATE | +|----------|-------------|-------------------|------------| +| **Stone** | Surface | Infinite (terrain) | High | +| **Iron Ore** | 5-15 blocks | 20-30 ore | Medium | +| **Gold Ore** | 10-20 blocks | 10-15 ore | Low | +| **Silver Ore** | 20-30 blocks | 8-12 ore (werewolf!) | Rare | +| **Coal** | 5-20 blocks | 15-25 ore | Medium | +| **Diamond** | 25-40 blocks | 3-5 ore | Very Rare | + +**MINING SYSTEM:** +- Deponiji v igri: **Procedurally spawned** +- Povprečje per Biome: **50-100 deposits** +- 18 Biomes = **900-1,800 deposits** + +**DEPOSIT SPRITES:** 6 ore types × (pristine + mined + depleted) = **18 verzij (× 2 = 36 slik)** + +--- + +## 🌍 11. BIOMES (18 Total) + +| # | BIOME IME | TERRAIN TILES | UNIQUE ASSETS | +|---|-----------|---------------|---------------| +| 1 | Grasslands (Travnik) | 12 | Flowers, Grass | +| 2 | Forest (Gozd) | 12 | Trees, Mushrooms | +| 3 | City Ruins (Mesto) | 15 | Rubble, Buildings | +| 4 | Industrial Decay | 12 | Factories, Metal | +| 5 | Underground Bunkers | 10 | Concrete, Steel | +| 6 | Ancient Catacombs | 10 | Stone, Bones | +| 7 | Swamps | 12 | Water, Fungi | +| 8 | Desert Wasteland | 10 | Sand, Cacti | +| 9 | Snow/Tundra | 12 | Snow, Ice | +| 10 | Mountains | 10 | Rock, Cliffs | +| 11 | Coastal Regions | 12 | Beach, Water | +| 12 | Lakes | 8 | Water, Reeds | +| 13 | Rivers | 8 | Water, Rocks | +| 14 | Volcanic Zones | 12 | Lava, Ash | +| 15 | Chernobyl | 15 | Radiation, Ruins | +| 16 | Ancient Ruins | 12 | Stone, Artifacts | +| 17 | Ocean Floor | 10 | Coral, Rocks | +| 18 | Atlantis | 15 | Tech, Crystals | + +**AVERAGE TILES PER BIOME:** ~11 tiles +**TOTAL TERRAIN:** 18 × 11 = **198 unique terrain tiles (× 2 = 396 slik)** + +--- + +## 🍖 12. HRANA (FOOD & ITEMS) + +### **BASIC FOOD:** + +| # | ITEM | SOURCE | HEALING | +|---|------|--------|---------| +| 1 | **Bread (Kruh)** | Wheat → Campfire | 20 HP | +| 2 | **Cooked Meat** | Hunting → Campfire | 35 HP | +| 3 | **Fish** | Fishing Rod | 25 HP | +| 4 | **Apple (Jabolko)** | Apple Trees | 10 HP | +| 5 | **Cheese (Sir)** | Cow Milk → Crafting | 30 HP | +| 6 | **Strawberries (Jagode)** | Wild Foraging | 15 HP | +| 7 | **Vegetables** | Carrots, Tomatoes | 20 HP | + +**TOTAL:** 7 food types × 2 styles = **14 slik** + +--- + +### **POTIONS & SPECIAL ITEMS:** + +| ITEM | EFFECT | MATERIAL | +|------|--------|----------| +| **Health Potion** | +50 HP | Herbs×3, Water | +| **Stamina Potion** | +100 Stamina | Berries×5 | +| **Antidote** | Cure Poison | Special Herbs | +| **Vape Liquid (Rainbow)** | +Speed | Various | +| **Mother's Locket** | Quest Item | Story | + +**TOTAL:** 5 special items × 2 = **10 slik** + +--- + +## ✨ 13. EFEKTI (EFFECTS & VFX) + +| # | EFFECT | FRAMES | USAGE | +|---|--------|--------|-------| +| 1 | **Magic Heal Glow** | 4 frames loop | Healing | +| 2 | **Slash Effect** | 3 frames | Melee Attack | +| 3 | **Fire Breath** | 5 frames | Dragon Boss | +| 4 | **Lightning Bolt** | 4 frames | Arrow Effect | +| 5 | **Poison Cloud** | 4 frames loop | Bloated Zombie | +| 6 | **Ice Shard** | 3 frames | Ice Titan | +| 7 | **Explosion** | 6 frames | Bombs | +| 8 | **Sparkles** | 4 frames loop | Magic | +| 9 | **Blood Splatter** | 2 frames | Combat | +| 10 | **Dust Cloud** | 3 frames | Movement | + +**TOTAL:** 4+3+5+4+4+3+6+4+2+3 = **38 frameov (× 2 = 76 slik)** + +--- + +## 🎬 14. UI & CUTSCENES + +### **UI ELEMENTS:** + +| CATEGORY | ITEMS | TOTAL | +|----------|-------|-------| +| **Buttons** | 8 types | 8 | +| **Bars** | HP, Stamina, XP | 3 | +| **Icons** | Inventory (20) | 20 | +| **Menus** | Main, Pause, Settings | 3 | +| **Cursor** | Normal, Click | 2 | + +**TOTAL UI:** 8+3+20+3+2 = **36 slik** + +--- + +### **CUTSCENES:** + +| # | SCENE | TYPE | FRAMES | +|---|-------|------|--------| +| 1 | **Intro - Kai in Forest** | Story | 1 static | +| 2 | **Ana Portrait** | Memory | 1 static | +| 3 | **Flashback - Happy** | Memory | 1 static | +| 4 | **Ana's Diary** | Item | 1 static | +| 5 | **Reunion - Hug** | Emotional | 1 static | +| 6 | **Ending - Ana Alive** | Victory | 1 static | +| 7 | **Ending - Reunion** | Victory | 1 static | + +**TOTAL CUTSCENES:** 7 slik (už single style) + +--- + +--- + +# 📊 FINALNA RAZPREDELNICA - SUMMARY + +## 🎯 TOTAL ASSET COUNT (Realistic 3,000 Target) + +| KATEGORIJA | UNIQUE SPRITES | × STYLES | × VERSIONS | **TOTAL** | +|-----------|----------------|----------|------------|-----------| +| **1. Ruševine & Zgradbe** | 18 | 2 | 2 (ruin+fixed) | **72** | +| **2. NPCs** | 24 (demo+alpha) | 2 | 3 (expressions) | **144** | +| **3. Sovražniki (Zombies)** | 80 frames | 2 | 1 | **160** | +| **4. Sovražniki (Other)** | 184 frames | 2 | 1 | **368** | +| **5. Bosses** | 92 frames | 2 | 1 | **184** | +| **6. Farm Animals** | 76 frames | 2 | 1 | **152** | +| **7. Wild Animals** | 54 frames | 2 | 1 | **108** | +| **8. Magical Creatures** | 66 frames | 2 | 1 | **132** | +| **9. Worker Creatures** | 45 frames | 2 | 1 | **90** | +| **10. Crops (Posevki)** | 34 frames | 2 | 1 | **68** | +| **11. Trees** | 32 variants | 2 | 1 | **64** | +| **12. Special Plants** | 24 | 2 | 1 | **48** | +| **13. Orožje (Weapons)** | 18 | 2 | 1 | **36** | +| **14. Orodja (Tools)** | 24 | 2 | 1 | **48** | +| **15. Mining Resources** | 18 | 2 | 1 | **36** | +| **16. Terrain (Biomes)** | 198 tiles | 2 | 1 | **396** | +| **17. Hrana (Food)** | 12 | 2 | 1 | **24** | +| **18. Efekti (VFX)** | 38 frames | 2 | 1 | **76** | +| **19. UI Elements** | 36 | 1 | 1 | **36** | +| **20. Cutscenes** | 7 | 1 | 1 | **7** | +| **21. Kai Animations** | 157 frames | 2 | 1 | **314** | +| **22. Gronk & Ana** | 40 frames | 2 | 1 | **80** | +| | | | | | +| **SUBTOTAL (UNIQUE ORIGINALS)** | | | | **~2,643** | +| **+ Preview Versions (256x256)** | | | | **+660** | +| **+ Sprite Versions (32x32)** | | | | **OPTIONAL** | +| | | | | | +| **🎯 GRAND TOTAL** | | | | **~3,303 slik** | + +--- + +## 🎯 CILJ: 3,000 SLIK + +**TRENUTNO:** ~800 slik (26.7%) +**POTREBNO:** ~2,200 slik +**RATE:** ~22 konceptov/uro +**ČAS:** ~100 ur = **~5 dni intenzivne generacije** + +--- + +## 💡 PRIORITIZATION (Kaj narediti PRVO?) + +### **🔴 HIGH PRIORITY (Demo-ready):** +1. ✅ Kai animations (DONE - 157 frames) +2. ✅ 4 starter NPCs (DONE) +3. ✅ Basic Zombies (4 types - ~40 frames) +4. ⏳ Terrain tiles (Grassland + Forest - 24 tiles) +5. ⏳ Farm Animals (Sheep, Cow, Chicken - basic) +6. ⏳ Wheat growth cycle (5 stages) +7. ⏳ Basic buildings (Tent, Shack, Barn - 6 variants) +8. ⏳ Basic weapons (Wooden Sword, Bow, Scythe - 6) + +**DEMO MINIMUM:** ~400 slik + +--- + +### **🟡 MEDIUM PRIORITY (Alpha):** +- All 8 zombie types +- All 18 biome terrain +- All 24 NPCs +- Wild animals (8 types) +- More buildings (18 total) +- All weapons & tools +- Cutscenes (7 total) + +**ALPHA TARGET:** ~1,500 slik + +--- + +### **🟢 LOW PRIORITY (Full Game):** +- 180 total NPCs +- All 7 bosses +- Magical creatures +- Advanced animations +- Weather effects +- Seasonal variants + +**FULL GAME:** ~3,000 slik + +--- + +**STATUS:** ✅ **RAZPREDELNICA KOMPLETNA!** + +**ZAPISAL:** Antigravity AI +**DATUM:** 31.12.2025, 02:45 +**VERZIJA:** 1.0 Master diff --git a/TEHNICNA_SPECIFIKACIJA.md b/TEHNICNA_SPECIFIKACIJA.md new file mode 100644 index 000000000..7c1dfaa43 --- /dev/null +++ b/TEHNICNA_SPECIFIKACIJA.md @@ -0,0 +1,557 @@ +# ⚙️ KRVAVA ŽETEV - TEHNIČNA SPECIFIKACIJA + +**Verzija:** 1.0 +**Datum:** 31.12.2025, 02:50 +**Platform:** PC (Web-based) + +--- + +## 🎮 1. GAME ENGINE & TEHNOLOGIJA + +### **Engine:** +- **Phaser 3** (v3.60+) +- JavaScript ES6+ +- HTML5 Canvas rendering + +### **Languages:** +- **Frontend:** JavaScript (ES6+) +- **Backend:** Python 3.10+ (scripts, automation) +- **Data:** JSON (configuration, assets, maps) + +### **Map Editor:** +- **Tiled Map Editor** (.tmx format) +- Tile size: **32×32 pixels** +- Map layers: Terrain, Objects, Collision, Events + +--- + +## 📁 2. FOLDER STRUKTURA + +``` +/novafarma/ +├── assets/ +│ └── slike/ # Slovenska struktura! +│ ├── liki/ # Characters +│ │ ├── kai/ # Kai animations +│ │ ├── gronk/ +│ │ ├── ana/ +│ │ └── npcs/ +│ ├── sovrazniki/ # Enemies +│ │ ├── zombiji/ +│ │ └── mutanti/ +│ ├── biomi/ # Biomes/Terrain +│ │ ├── 01_dolina_farm/ +│ │ ├── 02_temni_gozd/ +│ │ └── ... +│ ├── zgradbe/ # Buildings +│ ├── predmeti/ # Items +│ │ ├── orodja/ +│ │ ├── hrana/ +│ │ └── semena/ +│ ├── orozje/ # Weapons +│ │ ├── hladno/ # Melee +│ │ └── strelno/ # Ranged +│ ├── rastline/ # Plants +│ │ ├── posevki/ # Crops +│ │ └── drevesa/ # Trees +│ ├── ui/ # User Interface +│ ├── efekti/ # VFX +│ └── cutscene/ # Story scenes +│ +├── scripts/ +│ ├── master_asset_pipeline.py +│ ├── batch_generation_manifest.py +│ └── ... +│ +├── docs/ +│ ├── game_design/ +│ │ └── GAME_BIBLE.md +│ ├── KRVAVA_ZETEV_COMPLETE_STORY.md +│ ├── MASTER_ASSET_RAZPREDELNICA.md +│ └── ... +│ +└── game/ + ├── index.html + ├── main.js + ├── scenes/ + ├── entities/ + └── systems/ +``` + +--- + +## 🖼️ 3. ASSET SPECIFICATIONS + +### **Image Formats:** +- **Format:** PNG (32-bit with alpha channel) +- **Compression:** Optimized for web +- **Naming:** `{category}_{name}_{style}_{version}.png` + +### **Asset Sizes:** + +| TYPE | ORIGINAL | PREVIEW | SPRITE | USAGE | +|------|----------|---------|--------|-------| +| **Characters** | 1024×1024 | 256×256 | 32×32 | Player, NPCs | +| **Enemies** | 1024×1024 | 256×256 | 32×32 | Zombies, Bosses | +| **Buildings** | 1024×1024 | 256×256 | 64×96 | Structures | +| **Terrain** | 1024×1024 | - | 32×32 | Tileable | +| **Items** | 1024×1024 | 256×256 | 32×32 | Inventory | +| **UI** | Variable | - | Actual size | Buttons, Icons | +| **Cutscenes** | 1920×1080 | - | - | Widescreen | + +### **Dual Art Style System:** + +| STYLE | NAME | DESCRIPTION | SUFFIX | +|-------|------|-------------|--------| +| **Style A** | Cartoon Vector | Bright, friendly, Stardew-like | `_stylea` | +| **Style B** | Gritty Noir | Dark, hand-drawn, Don't Starve-like | `_styleb` | + +**Example:** `mec_lesen_stylea.png` vs `mec_lesen_styleb.png` + +--- + +## 🎨 4. ART STYLE GUIDE + +### **Style A - Cartoon Vector:** +``` +- Bold black outlines (thick) +- Flat colors, vibrant palette +- Cute, stylized proportions +- White background +- Friendly, approachable +``` + +**Prompt Template:** +``` +[Subject], fantasy farming game asset, +bold cartoon vector art style with thick black outlines, +flat colors, cute stylized design, +centered on white background, +game sprite ready, 1024x1024 +``` + +--- + +### **Style B - Gritty Noir:** +``` +- Bold black outlines (1.4× emphasis) +- Desaturated, muted colors +- High-contrast noir aesthetic +- Black background +- Dark, mature, post-apocalyptic +``` + +**Prompt Template:** +``` +[Subject], gritty noir survival game asset, +dark hand-drawn 2D stylized indie art style, +bold black outlines, +high-contrast desaturated palette, +warped perspective, +centered on black background, +game sprite ready, 1024x1024 +``` + +--- + +## 🗺️ 5. MAP SYSTEM (Tiled) + +### **Tile Specifications:** +- **Tile Size:** 32×32 pixels +- **Grid:** Square grid +- **Infinite:** Yes (procedural generation) + +### **Map Layers:** + +| LAYER | Z-INDEX | PURPOSE | +|-------|---------|---------| +| **Background** | 0 | Sky, far terrain | +| **Terrain** | 1 | Ground tiles | +| **Decorations** | 2 | Grass, flowers | +| **Collision** | 3 | Walls, obstacles | +| **Objects** | 4 | Buildings, props | +| **Characters** | 5 | NPCs, enemies | +| **Player** | 6 | Kai (always on top) | +| **Effects** | 7 | VFX, particles | +| **UI** | 8 | HUD, menus | + +### **Object Properties:** + +```json +{ + "name": "zombie_worker", + "type": "enemy", + "controllable": true, + "hp": 40, + "damage": 0, + "tasks": ["dig", "plant", "harvest"] +} +``` + +--- + +## 🎮 6. GAMEPLAY SYSTEMS + +### **A) FARMING SYSTEM** + +**Farm Sizes:** +- **8×8** (Start) - Micro farm, 1 tent +- **16×16** (Week 1) - Small farm, shack +- **32×32** (Week 2) - Medium farm, house +- **64×64** (End Game) - Large farm, estate + +**Crop Growth:** +``` +Stage 1: Seed (0 days) +Stage 2: Sprout (1 day) +Stage 3: Growing (2 days) +Stage 4: Mature (3 days) +Stage 5: Harvestable (4 days) +``` + +**Automation Tiers:** +- Manual (watering can) +- **Sprinkler 3×3** (covers 9 tiles) +- **Sprinkler 5×5** (covers 25 tiles) +- **Sprinkler 7×7** (covers 49 tiles) +- **Full Auto** (entire farm) + +--- + +### **B) ZOMBIE CONTROL SYSTEM** + +**Alpha Hybrid Powers:** +```javascript +class ZombieController { + maxZombies: level × 2, // Scales with player level + commandRange: 500px, // Telepathic range + tasks: ['dig', 'plant', 'harvest', 'guard', 'follow'], + + controlZombie(zombie) { + if (this.canControl(zombie)) { + zombie.faction = 'player'; + zombie.ai = 'commanded'; + } + } +} +``` + +**Zombie Features:** +- Sleep in **Grobi** (Graves) → 2× stamina recovery +- Lease to NPCs → passive income (50 coins/day) +- Death → Decay into fertilizer (+10 soil quality) + +--- + +### **C) COMBAT SYSTEM** + +**Stats:** +``` +HP (Health Points): 100 base +Stamina: 100 base +Attack Damage: Weapon-dependent +Defense: Armor-dependent +Speed: 100 base (modifiable) +``` + +**Weapon Types:** + +| TYPE | RANGE | DAMAGE | SPEED | +|------|-------|--------|-------| +| **Melee** | 32px | High | Medium | +| **Ranged** | 300px | Medium | Slow | +| **Magic** | 200px | Variable | Medium | + +**Combat Mechanics:** +- **Attack:** Click/Tap enemy +- **Dodge Roll:** Spacebar (i-frames) +- **Block:** Hold Shift (50% damage reduction) +- **Critical Hit:** 10% chance, 2× damage + +--- + +### **D) CRAFTING SYSTEM** + +**Workstations:** + +```json +{ + "campfire": { + "recipes": ["bread", "cooked_meat"], + "requirement": "fire" + }, + "furnace": { + "recipes": ["iron_bar", "gold_bar"], + "requirement": "coal" + }, + "mint": { + "recipes": ["coin"], + "requirement": "gold_bar" + } +} +``` + +**Recipe Example:** +```json +{ + "bread": { + "input": {"wheat": 3}, + "output": {"bread": 1}, + "time": 30, // seconds + "workstation": "campfire" + } +} +``` + +--- + +### **E) BUILDING RESTORATION** + +**Restoration Phases:** + +| PHASE | % COMPLETE | VISUAL | FUNCTIONAL | +|-------|------------|--------|------------| +| **Ruined** | 0% | Broken, debris | No | +| **Foundation** | 25% | Base repaired | No | +| **Walls** | 50% | Structure visible | No | +| **Roof** | 75% | Almost complete | No | +| **Complete** | 100% | Pristine | Yes! | + +**Material Requirements:** +```json +{ + "gostilna_restoration": { + "phase1": {"stone": 50, "wood": 30}, + "phase2": {"stone": 100, "wood": 70, "iron": 10}, + "phase3": {"wood": 100, "iron": 20, "nails": 50}, + "phase4": {"wood": 50, "glass": 20} + } +} +``` + +--- + +### **F) NPC SYSTEM** + +**NPC Spawn Logic:** +```javascript +class Town { + npcSlots: 6, // Max NPCs per town + + spawnConditions: { + "trader": { building: "shop", level: 1 }, + "blacksmith": { building: "smithy", level: 5 }, + "healer": { building: "church", level: 3 } + }, + + spawnNPC(type) { + if (this.meetsCondition(type)) { + this.npcs.push(new NPC(type)); + } + } +} +``` + +**NPC Dialogue System:** +```json +{ + "trader_greeting": [ + "Hello, traveler!", + "What can I get you?", + "Looking for seeds?" + ], + "trader_quest": { + "title": "First Trade", + "description": "Buy 10 wheat seeds", + "reward": 50 + } +} +``` + +--- + +## 📊 7. DATA STRUCTURES + +### **Player Data:** +```json +{ + "name": "Kai Marković", + "level": 1, + "exp": 0, + "hp": 100, + "stamina": 100, + "position": {"x": 400, "y": 300}, + "inventory": [ + {"item": "wooden_sword", "quantity": 1}, + {"item": "wheat_seeds", "quantity": 10} + ], + "farm": { + "size": "8x8", + "crops": [], + "animals": [] + }, + "quests": { + "ana_clues_found": 0, + "main_story": "act1_start" + } +} +``` + +--- + +### **Enemy Data:** +```json +{ + "basic_zombie": { + "hp": 50, + "damage": 5, + "speed": 50, + "ai": "chase_player", + "loot": [ + {"item": "rotten_flesh", "chance": 0.8}, + {"item": "bone", "chance": 0.2} + ] + } +} +``` + +--- + +### **Building Data:** +```json +{ + "tent": { + "type": "housing", + "size": {"width": 64, "height": 64}, + "cost": {"wood": 0}, // Free (starter) + "capacity": 1, // 1 player + "upgradeTo": "shack" + } +} +``` + +--- + +## ⚡ 8. PERFORMANCE OPTIMIZATION + +### **Asset Loading:** +- **Lazy Loading:** Load biome assets on-demand +- **Sprite Atlases:** Combine small assets into atlases +- **Compression:** Use TinyPNG for PNG optimization + +### **Rendering:** +- **Culling:** Only render visible tiles +- **Object Pooling:** Reuse zombie/enemy instances +- **Batch Rendering:** Group similar sprites + +### **Target Performance:** +- **FPS:** 60 (stable) +- **Load Time:** < 5 seconds (initial) +- **RAM Usage:** < 500MB + +--- + +## 🔊 9. AUDIO SYSTEM + +### **Sound Categories:** + +| CATEGORY | FILES | FORMAT | +|----------|-------|--------| +| **Music** | Ambient tracks | MP3 (128kbps) | +| **SFX** | Combat, farming | WAV (44.1kHz) | +| **Voice** | NPC dialogue | MP3 (VibeVoice TTS) | + +### **Volume Levels:** +- Master: 100% +- Music: 70% +- SFX: 80% +- Voice: 90% + +--- + +## 💾 10. SAVE SYSTEM + +### **Save Format:** JSON +### **Save Locations:** +- **Browser:** LocalStorage +- **Cloud:** Optional (future) + +### **Auto-Save:** +- Every 5 minutes +- On major events (boss defeat, Ana clue found) +- Before/after cutscenes + +### **Save Data Structure:** +```json +{ + "version": "1.0", + "timestamp": "2025-12-31T02:50:00Z", + "playtime": 1234, // seconds + "player": { ... }, + "world": { ... }, + "quests": { ... } +} +``` + +--- + +## 🌐 11. DEPLOYMENT + +### **Development:** +- Local server: `http://localhost:8000` +- Hot reload: Enabled + +### **Production:** +- **Host:** GitHub Pages / Netlify +- **CDN:** Cloudflare (assets) +- **Domain:** TBD + +### **Build Process:** +```bash +1. npm run lint # Code quality +2. npm run test # Unit tests +3. npm run build # Minify & bundle +4. npm run deploy # Upload to host +``` + +--- + +## 📈 12. DEVELOPMENT MILESTONES + +### **Phase 1: Kickstarter Demo** (Now - March 2025) +- ✅ 400+ core assets +- ✅ Playable 15-20 min demo +- ✅ Trailer video ready + +### **Phase 2: Alpha** (March - June 2025) +- 1,500 assets +- All 180 starter NPCs +- 7 biomes playable + +### **Phase 3: Beta** (June - Dec 2025) +- 3,000 assets +- All 18 biomes +- Full story (4 endings) + +### **Phase 4: Release** (Jan 2026) +- Polish & bug fixes +- Final balancing +- Launch! 🚀 + +--- + +## ✅ TEHNIČNA CHECKA + +**Engine:** ✅ Phaser 3 +**Maps:** ✅ Tiled (.tmx) +**Assets:** ✅ Slovenska struktura (`assets/slike/`) +**Dual Style:** ✅ Style A + Style B +**Target:** ✅ 3,000 slik +**Performance:** ✅ 60 FPS target +**Platform:** ✅ Web (PC primary) + +--- + +**ZAPISAL:** Antigravity AI +**DATUM:** 31.12.2025, 02:55 +**STATUS:** ✅ TEHNIČNA SPEC KOMPLETNA!