Files
novafarma/GAME_BIBLE_COMPLETE.md
David Kotnik 8a4ecc0554 📖 GAME_BIBLE Update - Jan 03 Session Summary!
Added today's complete session to GAME_BIBLE_COMPLETE.md:

UPDATES:
 3 Critical bugs fixed (PreloadScene, PrologueScene, Menu)
 Extended prologue (6 → 12 scenes)
 5 New documentation files
 Complete asset breakdown (14,077 sprites)
 Production timeline defined

CURRENT STATUS:
- Demo: 100% Functional 
- Assets: 5.6% Complete (789/14,077)
- Next Priority: Farm Crops (1,600 sprites)

Documentation complete! Bible is updated! 📖
2026-01-03 22:40:54 +01:00

17 KiB

🎮 DOLINASMRTI - COMPLETE GAME DESIGN BIBLE

Version: 4.5 FINAL LOCK
Date: January 2, 2026
Status: PRODUCTION READY


📋 TABLE OF CONTENTS

  1. Game Overview
  2. Story & Narrative
  3. Core Gameplay
  4. World & Biomes
  5. Characters
  6. Game Systems
  7. Buildings & Structures
  8. Art & Technical

🎯 GAME OVERVIEW

Title: DolinaSmrti (Krvava Žetev / Bloody Harvest)

Genre: Horror Farming Survival RPG

Platform: PC (Windows, Mac, Linux)

Engine: Phaser 3 (JavaScript/HTML5)

Target Audience: 16+ (horror, mature themes)

Release Model: Zero-DLC, All content free post-launch

Core Concept:

Stardew Valley meets Don't Starve meets Resident Evil. Farm by day, survive the undead by night, uncover the mystery of your missing sister Ana in a valley transformed by anomalous disasters.

Unique Selling Points:

  • 18 Anomalous Biomes - Dinosaurs, Atlantis, Chernobyl, Egyptian tombs, and more
  • Multi-Style Art - 5 distinct visual styles blended throughout
  • ADHD-Friendly Design - Slovenian Standard accessibility
  • Horror-Farming Hybrid - Cute meets terrifying
  • Zero-DLC Model - Everything free, forever

📖 STORY & NARRATIVE

Premise:

You are Kai, a 17-year-old survivor searching for your missing sister Ana in DolinaSmrti (Death Valley), a once-peaceful Slovenian valley now plagued by zombie outbreaks and reality-bending anomalies.

Opening:

Game starts with Kai arriving at an abandoned family farm. The town is destroyed, Ana is missing, and zombies roam the streets. You must rebuild the farm, survive, and follow clues to find Ana.

Main Story Arc:

Act 1: Arrival (Tutorial)

  • Kai arrives at the farm
  • Meets Gronk (friendly 3m tall troll)
  • Learns basic farming and combat
  • Discovers first clue about Ana's disappearance

Act 2: Investigation

  • Explore 18 anomalous biomes
  • Each biome has a boss that guards a clue
  • Collect Ana's diary pages
  • Uncover the truth about the anomalies

Act 3: Revelation

  • Ana is ALIVE but trapped
  • She's been using dark magic to survive
  • Final confrontation with the source of anomalies
  • Choose: Save Ana, Save the Valley, or Both?

Key NPCs:

Gronk - Massive 3m green troll, pink dreadlocks, wears "TROLL SABBATH" shirt, vapes constantly. Kai's best friend and farming mentor.

Grok - Gronk's cousin, practices dark Satanic magic, helps Kai with occult rituals. Owns Susi (hyperactive terrier).

Ana - Kai's missing sister (17-18). Survivor, resourceful, mysterious. Final revelation shows she's alive.

Town Survivors - Various NPCs in the rebuilt town (blacksmith, trader, doctor, etc.)

Narrative Delivery:

  • Environmental storytelling through biome design
  • Ana's diary pages (collectible items)
  • NPC dialogue and quests
  • Cutscenes at major story beats
  • Dark magic rituals unlock lore

🎮 CORE GAMEPLAY

Game Structure:

Day/Night Cycle

  • Day (6am-6pm): Farm, explore, craft, build
  • Night (6pm-6am): Zombies attack, combat focus, base defense

Core Loops:

1. Farming Loop

  • Plant crops → Water → Harvest → Sell
  • Raise animals → Feed → Collect products
  • Expand farm → Unlock new crops/buildings

2. Combat Loop

  • Zombies spawn at night → Fight → Collect loot
  • Craft better weapons → Explore harder biomes
  • Boss fights → Unlock story progression

3. Exploration Loop

  • Discover new biomes → Collect resources
  • Find clues about Ana → Progress story
  • Unlock fast travel points

4. Survival Loop

  • Manage hunger, thirst, health, stamina
  • Craft food from crops and hunted meat
  • Build shelters and defenses

Core Mechanics:

Farming:

  • 50+ crop types (normal + anomalous)
  • Animal husbandry (chickens, cows, pigs, dinosaurs)
  • Seasonal crops and weather effects
  • Crop mutations and crossbreeding

Combat:

  • Real-time action combat
  • Weapons: Melee (axes, swords), Ranged (guns, bows), Magic (dark rituals)
  • Enemy AI: Basic zombies, Special zombies, Biome-specific creatures, Bosses
  • Base defense: Build walls, traps, turrets

Crafting:

  • 200+ craftable items
  • Workbenches: Crafting Table, Furnace, Anvil, Alchemy Lab, Ritual Altar
  • Material gathering from biomes
  • Blueprint system (find recipes)

Cooking:

  • Raw ingredients → Cooked meals
  • Food provides buffs (health, stamina, combat bonuses)
  • Cooking stations: Campfire, Kitchen Stove, BBQ Grill

Building:

  • Expand farm with new structures
  • Unlock blueprints through progression
  • Customize layout and aesthetics

🌍 WORLD & BIOMES

Map Structure:

Total Biomes: 21

  • 2 Core Zones (Base Farm, Town Square)
  • 18 Anomalous Biomes (hostile, story-driven)
  • 1 Final Zone (endgame area)

Core Zones:

1. Base Farm (Starting Zone)

  • Your home base
  • All farming buildings
  • Safe zone (no zombie spawns inside walls)
  • Fully customizable

2. Town Square

  • Central hub with NPCs
  • Shops, services, quests
  • Rebuilding mechanic (restore town buildings)

18 Anomalous Biomes:

1. Dino Valley - Jurassic prehistoric zone with dinosaurs
2. Mythical Highlands - Dragons, griffins, unicorns
3. Atlantis - Underwater ruins, mermaids, sea monsters
4. Egyptian Desert - Ancient tombs, mummies, pyramids
5. Chernobyl - Radioactive wasteland, mutants
6. Mushroom Forest - Giant fungi, spore creatures
7. Arctic Zone - Frozen tundra, mammoths, ice zombies
8. Endless Forest - Dark woods, werewolves, wendigos
9. Wild West - Ghost town, bandits, undead cowboys
10. Medieval Castle - Knights, dragons, haunted castle
11. Steampunk City - Industrial revolution, clockwork zombies
12. Alien Crash Site - UFO, extraterrestrials, sci-fi tech
13. Volcanic Hellscape - Lava, fire demons, hell portals
14. Candy Kingdom - Dark twist on sweet world
15. Cyberpunk Ruins - Neon city, robots, hackers
16. Pirate Cove - Ghost ships, undead pirates, treasure
17. Haunted Asylum - Psychological horror, ghosts
18. Enchanted Garden - Twisted fairy tale, dark fae

Each biome has:

  • Unique fauna (10-20 creatures)
  • Unique flora (plants, trees, crops)
  • Biome-specific resources
  • Environmental hazards
  • 1-2 Boss fights
  • Story clues about Ana

👤 CHARACTERS

Playable Character:

Kai (Main Protagonist)

  • Age: 17
  • Appearance: Dark green dreadlocks, ear gauges, piercings, blue jacket, ripped jeans, backpack
  • Personality: Determined, resourceful, caring (searching for Ana)
  • Skills: Farming, combat, crafting

Main NPCs:

Gronk - 3m tall green troll, pink dreadlocks, "TROLL SABBATH" shirt, pink sneakers, vapes. Farming mentor, best friend.

Grok - Gronk's cousin, dark magic practitioner, teaches rituals and occult knowledge. Owns Susi the dog.

Susi - Small terrier, hyperactive ADHD energy, Grok's companion, comic relief.

Ana - Kai's sister, missing until late game reveal (she's alive and using dark magic to survive).

Town NPCs:

  • Blacksmith - Weapon/tool crafting
  • Trader - Buy/sell goods
  • Doctor - Healing services
  • Carpenter - Building construction
  • Alchemist - Potion crafting

Enemies:

Zombies (Basic Types):

  • Shambling Zombie - Slow, weak
  • Runner Zombie - Fast, moderate
  • Tank Zombie - Slow, high HP
  • Exploding Zombie - Suicide bomber
  • Spitter Zombie - Ranged acid

Special Zombies (Advanced):

  • Alpha Hybrids - Boss-tier zombies
  • Biome-specific undead (Dino Zombie, Mummy, Frozen Zombie, etc.)

Bosses (20 Total): Each anomalous biome has 1-2 bosses that guard story clues.


⚙️ GAME SYSTEMS

Survival Systems:

Health & Stamina

  • Health: Combat damage, fall damage, environmental hazards
  • Stamina: Sprinting, attacking, farming actions
  • Regeneration: Rest, food, potions

Hunger & Thirst

  • Hunger meter depletes over time
  • Thirst meter depletes faster
  • Low meters cause stat penalties
  • Food/water restore meters + buffs

Temperature

  • Biome-specific (Arctic = hypothermia, Volcanic = heatstroke)
  • Clothing provides protection
  • Campfires and shelters help

Radiation (Chernobyl biome)

  • Radiation meter accumulates in zone
  • Hazmat suit reduces exposure
  • Decontamination stations remove radiation

Progression Systems:

Experience & Leveling

  • XP from farming, combat, crafting
  • Level up → Skill points
  • Skill trees: Farming, Combat, Survival, Magic

Skills:

  • Farming: Crop yield, animal care, faster actions
  • Combat: Weapon damage, defense, special attacks
  • Survival: Health, stamina, resistance
  • Magic: Dark rituals, spell power, mana

Equipment

  • Weapons: Melee, Ranged, Magic staves
  • Armor: Head, Chest, Legs, Feet, Accessories
  • Tools: Axe, Pickaxe, Hoe, Watering Can, Fishing Rod
  • Upgrades: Better materials = better stats

Economic System:

Currency: Gold Coins

  • Earn from selling crops, loot, completing quests
  • Spend on items, building materials, upgrades

Shop System:

  • Trader NPCs sell items, blueprints, rare materials
  • Prices fluctuate based on supply/demand

Quest Rewards:

  • Gold, items, blueprints, story progression

Social Systems:

NPC Relationships

  • Talk to NPCs → Increase friendship
  • Gifts increase relationship faster
  • High relationship → Discounts, special quests, romance options

Romance (Optional)

  • Date-able NPCs (Gronk is romance option)
  • Gift items, complete quests, spend time
  • Marriage system (late game)

Dark Magic System:

Rituals:

  • Learn from Grok and found grimoires
  • Require sacrifices (crops, animals, items)
  • Powerful effects: Weather control, resurrection, teleportation

Satanic Altars:

  • Build on farm
  • Perform dark rituals
  • Trade with demonic entities
  • Risk vs reward (curses possible)

🏗️ BUILDINGS & STRUCTURES

Farm Buildings:

Housing:

  • Farmhouse (player home, upgradeable 3 tiers)
  • Cabin (extra building for storage)
  • Greenhouse (year-round crops)

Animal Buildings:

  • Chicken Coop (10 chickens)
  • Barn (4 cows/pigs)
  • Stable (2 horses)
  • Dino Pen (2 dinosaurs - exotic)

Production:

  • Silo (store animal feed)
  • Mill (grind wheat → flour)
  • Beehive (honey production)
  • Winery (ferment crops → wine)
  • Oil Press (seeds → cooking oil)

Crafting Stations:

  • Workbench (basic crafting)
  • Furnace (smelting ore)
  • Anvil (weapon/tool forging)
  • Alchemy Lab (potions)
  • Cooking Stove (advanced meals)
  • Ritual Altar (dark magic)

Utility:

  • Well (water source)
  • Scarecrow (protect crops)
  • Sprinklers (auto-water crops)
  • Lamp Posts (lighting)
  • Fences (decorative + animal containment)
  • Storage Chest (item storage)

Defense:

  • Wooden Wall (basic)
  • Stone Wall (upgraded)
  • Watchtower (spawn point + visibility)
  • Traps (spikes, bear traps, electric)
  • Turrets (automatic ranged defense)

Town Buildings:

Services:

  • General Store (buy seeds, tools)
  • Blacksmith (buy/upgrade weapons)
  • Clinic (healing, medicine)
  • Carpenter Shop (building construction)
  • Tavern (socialize, quests)

Rebuilding System:

  • Town starts destroyed
  • Collect materials → Rebuild structures
  • Restored buildings unlock services
  • Progression mechanic

🎨 ART & TECHNICAL

Art Style:

PRIMARY STYLE: Style 32 - Cult of the Lamb Cute-Dark 🔒

Official Art Style (Locked: Jan 2, 2026)

Style Name: Pastel-Gothic / Cute-Dark / Contradiction Aesthetic

Visual Characteristics:

  • Colors: Pastel palette with gothic undertones (soft pinks, purples, blues with dark shadows)
  • Shapes: Soft rounded forms, chunky proportions, big expressive eyes
  • Lines: Clean bold outlines, vector-ready, high readability
  • Mood: Adorable with edge, charming yet sinister, wholesome meets horrifying
  • Texture: Smooth gradients, minimal detail, flat colors with strategic shading

Inspiration: Cult of the Lamb, Don't Starve Together, pastel goth aesthetic

Usage:

  • PRIMARY: All main characters (Kai, Ana, Gronk, Grok, Susi)
  • PRIMARY: All zombies and undead creatures
  • PRIMARY: All bosses (20 total)
  • PRIMARY: Farm animals and pets
  • PRIMARY: Dark magic items and rituals
  • PREFERRED: NPCs, special creatures (dinosaurs, dragons)
  • OPTIONAL: Environments, crops, generic items (can vary)

Asset Specifications:

Image Format:

  • 32-bit PNG with alpha channel
  • Chroma key green background (#00FF00) for easy extraction
  • Size: Multiples of 32px (32x32, 64x64, 128x128, etc.)

Naming Convention:

  • assetname_WIDTHxHEIGHT_styleXX.png
  • Example: kai_character_64x64_style32.png

Technical Stack:

Engine: Phaser 3
Language: JavaScript (ES6+)
Rendering: CANVAS (pixel-perfect mode)
Map Editor: Tiled (TMX format)
Audio: Web Audio API
Deployment: Web (itch.io, Steam via Electron wrapper)

Performance Targets:

  • 60 FPS on mid-range hardware
  • < 3 second load times
  • Max 2GB RAM usage
  • Mobile-ready (future consideration)

Accessibility:

Slovenian ADHD Standard:

  • Native language naming (developer-side)
  • Color-coded emoji organization
  • Flattened directory structures
  • Multiple visual styles for stimulation
  • Dyslexia-friendly fonts
  • Colorblind modes
  • Screen reader support

📊 CONTENT SUMMARY

Total Assets Needed: ~14,000

  • Biomes: 21
  • Creatures: 200+
  • Crops: 50+
  • Buildings: 40+
  • Items: 500+
  • NPCs: 30+
  • Bosses: 20

Estimated Development Time:

  • Assets: 6-8 months (with AI assistance)
  • Programming: 12-18 months
  • Testing: 3-6 months
  • Total: 24-30 months to launch

🎯 RELEASE ROADMAP

Phase 1: Kickstarter Demo (February 2026)

  • Base farm functional
  • 1 biome (Dino Valley)
  • Basic combat
  • 5-10 hours gameplay

Phase 2: Early Access (Q4 2026)

  • 10 biomes
  • Full farming system
  • Combat refined
  • 30-50 hours gameplay

Phase 3: Full Release (Q2 2027)

  • All 18 biomes
  • Complete story
  • Endgame content
  • 100+ hours gameplay

Post-Launch (Free DLC):

  • New biomes
  • Seasonal events
  • Community features
  • Quality of life updates

END OF GAME BIBLE

DolinaSmrti © 2026 | Zero-DLC Forever


📋 SESSION JAN 03, 2026 - UPDATES

Engine Fixes & Optimization

Date: Jan 03, 2026 @ 22:00-22:40

Critical Bugs Fixed:

  1. PreloadScene Asset Loading

    • Problem: 100+ non-existent assets causing crashes
    • Solution: Removed 380 lines of dead asset loads
    • Result: Clean minimal preload, no errors
  2. PrologueScene Missing Data

    • Problem: Missing prologue.json → empty intro
    • Solution: Added hardcoded fallback dialogue
    • Extended: 6 → 12 dialogue scenes
    • Result: Full cinematic intro working!
  3. StoryScene Menu

    • Status: Restored original from git history
    • Result: Beautiful menu with all features

New Features:

  • Extended Prologue Story (12 scenes)
    • Ana character dialogue added
    • Lab breach scene with alarms
    • Explosion and Ana's disappearance
    • More emotional depth
    • Visual effects (shake, flash)

Documentation Created:

  1. TILED_WORKFLOW_GUIDE.md

    • Complete Tiled integration tutorial
    • Map creation steps
    • Game integration methods
    • Asset recommendations
  2. GAMESCENE_STATUS_REPORT.md

    • Full 2,392-line analysis
    • 5 major issues identified
    • 3 priority fixes documented
  3. BASE_GAME_COMPLETE_CHECKLIST.md

    • Complete 14,077 sprite breakdown
    • 15 categories analyzed
    • Priority system established
  4. MEGA_GAME_COMPLETE_STATUS.md

    • 789 PNGs current count
    • Full category breakdown
    • Production timeline
  5. OD_14K_SLIK_STATUS.md

    • Complete production roadmap
    • Time estimates (4-9 months)
    • Cost analysis

Current Game Status:

DEMO:           100% Functional ✅
Menu:           100% Working ✅
Intro Story:    100% Complete (12 scenes) ✅
Game Engine:    100% Coded ✅
Assets:         5.6% Complete (789/14,077) ⏳

Production Status:

Total Assets Needed:  14,077 sprites
Currently Done:          789 sprites ✅
Remaining:            13,288 sprites ❌

TOP PRIORITIES:
1. Farm Crops (1,600 sprites) ⭐
2. Animals (480 sprites) ⭐
3. Food System (2,000 sprites) ⭐
4. Biome Tiles (1,080 sprites) ⭐
5. Weapons/Tools (800 sprites) ⭐

Timeline Estimate:

  • Realistic (50/day): 9 months → October 2026
  • Aggressive (100/day): 4.5 months → June 2026
  • With Team (200/day): 2.3 months → April 2026

Files Modified Today:

  • src/scenes/PreloadScene.js (-380 lines)
  • src/scenes/StoryScene.js (restored)
  • src/scenes/PrologueScene.js (+50 lines, 12 scenes)
  • src/scenes/DemoSceneEnhanced.js (minimal version)

Commits Today:

b536b42d ✅ BASE GAME COMPLETE CHECKLIST
a433efaf 📊 OD 14K SLIK - Complete Production Plan
b973d02b 📊 MEGA GAME COMPLETE STATUS
b41f23b4 📋 SESSION JAN 03 FINAL
98915de3 🎮 C) GAMESCENE ANALYSIS COMPLETE
fde21fcc 🎬 A+B COMPLETE: Extended Prologue + Tiled Guide
108f8bfa 🔧 FIX: PrologueScene Fallback Dialogue
4c6ccac9 🔙 Restored StoryScene Menu
f2264c66 🧹 MINIMAL DemoSceneEnhanced
4b10a4fa 🧹 MINIMAL PreloadScene

Total: 10 commits, ~1,000 lines changed, 5 new docs created


Updated: Jan 03, 2026 @ 22:40