diff --git a/docs/game_design/BIOME_ASSET_SPECIFICATION.md b/docs/game_design/BIOME_ASSET_SPECIFICATION.md new file mode 100644 index 000000000..12bfd7955 --- /dev/null +++ b/docs/game_design/BIOME_ASSET_SPECIFICATION.md @@ -0,0 +1,493 @@ +# ๐ŸŒ BIOME-SPECIFIC ASSETS SPECIFICATION + +**Created:** Jan 7, 2026 22:40 CET +**Purpose:** Define unique assets for each of 20 biomes +**Status:** ๐Ÿ”„ **SPECIFICATION PHASE** + +--- + +## ๐Ÿ“‹ ASSET CATEGORIES PER BIOME + +Each biome CAN have unique: +1. **Buildings** - Architecture style matching biome theme +2. **Clothing** - Weather/culture appropriate attire +3. **Trees** - Biome-specific vegetation +4. **Crops** - Unique harvestables +5. **Weapons/Tools** - Themed equipment +6. **Props** - Environmental decorations + +--- + +## ๐ŸŒพ **NORMAL BIOMES (9)** + +### 1. GRASSLAND (Travnik) +**Theme:** Starter farm, tutorial zone, peaceful + +**Buildings:** +- โœ… **Generic farm buildings** (DONE: farmhouse, barn, silo, shed, well, windmill) +- โŒ Small wooden fence +- โŒ Scarecrow +- โŒ Basic storage hut + +**Clothing:** +- โœ… **Basic worker clothes** (DONE: shirt, pants, boots, hat, gloves, apron) +- โŒ Straw sun hat (light variant) +- โŒ Simple cloak + +**Trees:** +- โœ… Oak, Birch, Willow (**11 trees available**) +- โŒ Fruit trees (apple, pear, cherry) - growth stages needed + +**Crops:** +- โœ… **All 80 basic crops available!** + +**Weapons/Tools:** +- โŒ Basic wooden tools (hoe, axe, pickaxe) +- โŒ Pitchfork +- โŒ Watering can + +**Verdict:** โœ… **60% COMPLETE** - Have buildings, clothing, trees, crops. Missing tools/weapons. + +--- + +### 2. FOREST (Gozd) +**Theme:** Dense woods, hunting, lumber + +**Buildings:** +- โŒ Log cabin (dark wood) +- โŒ Lumber mill +- โŒ Treehouse +- โŒ Hunter's lodge + +**Clothing:** +- โŒ Leather hunter's outfit +- โŒ Forest ranger cloak (green) +- โŒ Leather boots (taller) + +**Trees:** +- โœ… Oak, Pine, Maple, Birch (**available**) +- โŒ Moss-covered variants +- โŒ Dead tree variants + +**Crops:** +- โŒ Mushrooms (forest-specific) +- โŒ Berries (wild variants) +- โŒ Medicinal herbs + +**Weapons/Tools:** +- โŒ Hunting bow +- โŒ Axe (better quality) +- โŒ Trapper's knife + +**Verdict:** โŒ **10% COMPLETE** - Only have generic trees. + +--- + +### 3. DESERT +**Theme:** Sand, heat, nomadic + +**Buildings:** +- โŒ Sand stone hut +- โŒ Bedouin tent (large) +- โŒ Oasis well (ornate) +- โŒ Pyramid ruins + +**Clothing:** +- โŒ Desert robes (light, flowing) +- โŒ Head wrap (turban) +- โŒ Sandals +- โŒ Face veil + +**Trees:** +- โœ… Cactus, Palm (**available**) +- โŒ Dead/twisted trees +- โŒ Baobab + +**Crops:** +- โœ… Dates (from palm trees) +- โŒ Desert herbs +- โŒ Prickly pear + +**Weapons/Tools:** +- โŒ Scimitar +- โŒ Spear +- โŒ Sand hammer + +**Verdict:** โŒ **15% COMPLETE** - Have palm/cactus trees only. + +--- + +### 4. MOUNTAIN +**Theme:** Rocks, cold peaks, mining + +**Buildings:** +- โŒ Stone cabin (grey stone) +- โŒ Mineshaft entrance +- โŒ Forge (blacksmith) +- โŒ Watch tower + +**Clothing:** +- โŒ Thick fur coat +- โŒ Mountain boots (heavy) +- โŒ Leather gloves (thick) +- โŒ Wool hat + +**Trees:** +- โœ… Pine, Birch (**available**) +- โŒ Stunted alpine trees +- โŒ Gnarled wind-swept trees + +**Crops:** +- โŒ Mountain herbs +- โŒ Hardy vegetables +- โŒ Lichen + +**Weapons/Tools:** +- โŒ Pickaxe (iron/steel) +- โŒ Ice axe +- โŒ War hammer + +**Verdict:** โŒ **10% COMPLETE** - Have pine/birch trees only. + +--- + +### 5. SWAMP (Moฤvirje) +**Theme:** Murky water, fog, decay + +**Buildings:** +- โŒ Stilted hut (raised on poles) +- โŒ Moss-covered shack +- โŒ Boat dock +- โŒ Witch hut + +**Clothing:** +- โŒ Waterproof cloak (dark green) +- โŒ Waders (tall boots) +- โŒ Swamp hat (wide brim) +- โŒ Gas mask (toxic areas) + +**Trees:** +- โœ… Willow (**available**) +- โŒ Dead trees (many variants) +- โŒ Mangrove +- โŒ Cypress + +**Crops:** +- โŒ Swamp mushrooms +- โŒ Water plants +- โŒ Poisonous herbs + +**Weapons/Tools:** +- โŒ Harpoon +- โŒ Machete +- โŒ Poison dagger + +**Verdict:** โŒ **5% COMPLETE** - Have willow tree only. + +--- + +### 6. SNOW/TUNDRA +**Theme:** Ice, blizzards, survival + +**Buildings:** +- โŒ Igloo +- โŒ Wooden lodge (thick walls) +- โŒ Ice sculpture/altar +- โŒ Fire pit (large, covered) + +**Clothing:** +- โŒ Fur parka (heavy) +- โŒ Snow boots (insulated) +- โŒ Fur mittens +- โŒ Thermal pants +- โŒ Goggles + +**Trees:** +- โœ… Pine (**available**) +- โŒ Frozen variants +- โŒ Snow-laden trees + +**Crops:** +- โŒ Winter berries +- โŒ Ice flowers +- โŒ Frost herbs + +**Weapons/Tools:** +- โŒ Ice pick +- โŒ Snow shovel +- โŒ Frost blade + +**Verdict:** โŒ **5% COMPLETE** - Have pine tree only. + +--- + +### 7. WASTELAND +**Theme:** Ruins, scrap, post-apocalypse + +**Buildings:** +- โŒ Scrap metal shelter +- โŒ Ruined building (half-destroyed) +- โŒ Makeshift camp +- โŒ Bunker entrance + +**Clothing:** +- โŒ Scavenger outfit (patched) +- โŒ Gas mask +- โŒ Combat boots +- โŒ Shoulder pads (Mad Max style) + +**Trees:** +- โŒ Dead trees (completely bare) +- โŒ Twisted metal poles +- โŒ None - wasteland + +**Crops:** +- โŒ None - scavenging only +- โŒ Mutant plants + +**Weapons/Tools:** +- โŒ Pipe wrench +- โŒ Scrap sword +- โŒ Makeshift gun + +**Verdict:** โŒ **0% COMPLETE** - Nothing done. + +--- + +### 8. TROPICAL/BEACH +**Theme:** Sand, palm trees, paradise + +**Buildings:** +- โŒ Bamboo hut +- โŒ Tiki bar +- โŒ Beach cabana +- โŒ Pier/dock + +**Clothing:** +- โŒ Swimming shorts +- โŒ Light shirt (open) +- โŒ Sandals +- โŒ Straw hat (beach style) +- โŒ Sunglasses + +**Trees:** +- โœ… Palm, Bamboo, Coconut (**available**) +- โŒ Banana tree + +**Crops:** +- โœ… Coconut, Banana, Pineapple (**available**) +- โŒ Tropical fruits + +**Weapons/Tools:** +- โŒ Spear (fishing) +- โŒ Machete +- โŒ Net + +**Verdict:** โœ… **40% COMPLETE** - Have palm/coconut/banana/pineapple. + +--- + +### 9. RADIOACTIVE ZONE +**Theme:** Nuclear, toxic, glowing + +**Buildings:** +- โŒ Hazmat tent +- โŒ Reactor ruins +- โŒ Bunker +- โŒ Decontamination station + +**Clothing:** +- โŒ Hazmat suit (full body) +- โŒ Gas mask +- โŒ Radiation gloves +- โŒ Protective boots + +**Trees:** +- โŒ Mutant trees (glowing) +- โŒ Dead/twisted variants + +**Crops:** +- โŒ Mutant vegetables +- โŒ Glowing mushrooms + +**Weapons/Tools:** +- โŒ Geiger counter +- โŒ Radiation gun +- โŒ Decontamination spray + +**Verdict:** โŒ **0% COMPLETE** - Nothing done. + +--- + +## ๐Ÿ”ฎ **ANOMALOUS BIOMES (11)** + +### 10. DINO VALLEY +**Theme:** Prehistoric, dinosaurs, Jurassic + +**Buildings:** +- โŒ Bone hut (dinosaur ribs) +- โŒ Cave entrance +- โŒ Research station (modern) + +**Clothing:** +- โŒ Caveman furs +- โŒ Bone armor +- โŒ Leather wraps + +**Trees:** +- โŒ Ferns (giant) +- โŒ Cycads +- โŒ Prehistoric palms + +**Crops:** +- โŒ Prehistoric plants +- โŒ Giant mushrooms + +**Weapons/Tools:** +- โŒ Bone club +- โŒ Stone axe +- โŒ Spear (wooden) + +**Creatures:** โœ… **14 dinosaurs DONE!** + +**Verdict:** โœ… **40% COMPLETE** - Dinosaurs done, need everything else. + +--- + +### 11. MYTHICAL HIGHLANDS +**Theme:** Magic, crystals, floating + +**Buildings:** +- โŒ Crystal tower +- โŒ Floating platform +- โŒ Magic shrine +- โŒ Enchanter's workshop + +**Clothing:** +- โŒ Wizard robes +- โŒ Magic cloak +- โŒ Crystal accessories + +**Trees:** +- โŒ Glowing trees (blue/purple) +- โŒ Crystal trees + +**Crops:** +- โŒ Magic herbs +- โŒ Glowing flowers +- โŒ Mana berries + +**Weapons/Tools:** +- โŒ Magic staff +- โŒ Wand +- โŒ Crystal blade + +**Creatures:** โœ… **Many mythical creatures DONE!** + +**Verdict:** โœ… **35% COMPLETE** - Creatures done, need everything else. + +--- + +### 12. WITCH FOREST (Endless Forest) +**Theme:** Dark magic, cryptids, Baba Yaga + +**Buildings:** +- โŒ Witch hut (5 types) +- โŒ **Baba Yaga's walking hut (chicken legs!)** +- โŒ Dark altar +- โŒ Ritual circle + +**Clothing:** +- โŒ Witch robes (long, tattered) +- โŒ Pointed hat +- โŒ Black cloak +- โŒ Cursed jewelry + +**Trees:** +- โŒ Ancient trees (massive) +- โŒ Cursed trees (faces) +- โŒ Dark pine + +**Crops:** +- โŒ Poison mushrooms (6 types) +- โŒ Dark herbs (5 types) +- โŒ Cursed flowers + +**Weapons/Tools:** +- โŒ **Broomstick (reward!)** +- โŒ Witch's knife +- โŒ Cauldron (tool) + +**Boss:** Baba Yaga โœ… **DONE!** + +**Verdict:** โœ… **15% COMPLETE** - Boss done, need everything else. + +--- + +### 13-20. OTHER ANOMALOUS (Loch Ness, Catacombs, Egyptian, Amazon, Atlantis, Chernobyl, Mexican Cenotes) + +**Assessment:** โŒ **0-10% COMPLETE** on most - Have some creatures, but NO biome-specific buildings/clothing/trees/weapons. + +--- + +## ๐Ÿ“Š OVERALL BIOME ASSET STATUS + +| Biome | Buildings | Clothing | Trees | Crops | Weapons | % Complete | +|-------|-----------|----------|-------|-------|---------|------------| +| **Grassland** | โœ… 6/10 | โœ… 6/10 | โœ… 11/15 | โœ… 80/80 | โŒ 0/5 | **60%** | +| **Forest** | โŒ 0/4 | โŒ 0/3 | โœ… 4/10 | โŒ 0/5 | โŒ 0/3 | **10%** | +| **Desert** | โŒ 0/4 | โŒ 0/4 | โœ… 2/5 | โœ… 1/3 | โŒ 0/3 | **15%** | +| **Mountain** | โŒ 0/4 | โŒ 0/4 | โœ… 2/5 | โŒ 0/3 | โŒ 0/3 | **10%** | +| **Swamp** | โŒ 0/4 | โŒ 0/4 | โœ… 1/5 | โŒ 0/3 | โŒ 0/3 | **5%** | +| **Snow/Tundra** | โŒ 0/4 | โŒ 0/5 | โœ… 1/5 | โŒ 0/3 | โŒ 0/3 | **5%** | +| **Wasteland** | โŒ 0/4 | โŒ 0/4 | โŒ 0/3 | โŒ 0/2 | โŒ 0/3 | **0%** | +| **Tropical** | โŒ 0/4 | โŒ 0/5 | โœ… 3/5 | โœ… 3/5 | โŒ 0/3 | **40%** | +| **Radioactive** | โŒ 0/4 | โŒ 0/4 | โŒ 0/3 | โŒ 0/2 | โŒ 0/3 | **0%** | +| **Dino Valley** | โŒ 0/3 | โŒ 0/3 | โŒ 0/3 | โŒ 0/2 | โŒ 0/3 | **40%** โœ… | +| **Mythical** | โŒ 0/4 | โŒ 0/3 | โŒ 0/2 | โŒ 0/3 | โŒ 0/3 | **35%** โœ… | +| **Witch Forest** | โŒ 0/5 | โŒ 0/4 | โŒ 0/3 | โŒ 0/11 | โŒ 0/3 | **15%** โœ… | +| **Other 8** | โŒ Most 0% | โŒ 0% | โŒ 0% | โŒ 0% | โŒ 0% | **0-10%** | + +**AVERAGE: ~15% COMPLETE** + +--- + +## ๐ŸŽฏ PRIORITY GENERATION LIST + +### **IMMEDIATE (Next Session):** +1. โœ… **Grassland tools/weapons** - Complete the starter biome (5 items) +2. **Forest buildings** - Log cabin, lumber mill, treehouse, hunter's lodge (4 items) +3. **Forest clothing** - Hunter outfit, cloak, boots (3 items) + +### **PHASE 1 (Critical):** +1. **Desert biome assets** - Buildings, clothing, special props (15+ items) +2. **Mountain biome assets** - Buildings, clothing, mining tools (15+ items) +3. **Swamp biome assets** - Stilted huts, waders, boats (15+ items) + +### **PHASE 2 (Anomalous):** +1. **Witch Forest** - Baba Yaga's hut (ANIMATED!), witch buildings, dark herbs (20+ items) +2. **Dino Valley** - Bone huts, prehistoric trees, caveman gear (15+ items) +3. **Mythical Highlands** - Crystal towers, magic trees, wizard robes (20+ items) + +--- + +## ๐Ÿ’ก FINAL VERDICT + +**ANSWER:** โŒ **NE, NISO VSI PRILAGOJENI!** + +- โœ… **Grassland** je **60% complete** (buildings โœ…, clothing โœ…, trees โœ…, crops โœ…) +- โŒ **Ostalih 19 biomov**: **0-40% complete** +- โŒ **Veฤina biomov nima** unique buildings, clothing, ali weapons! +- โœ… **Imajo** pa mnogi creatures (79 done) + +**POTREBUJEM:** +- ~200+ biome-specific buildings +- ~100+ biome-specific clothing sets +- ~50+ biome-specific trees/plants +- ~100+ biome-specific weapons/tools + +**SKUPAJ:** ~450-500 additional biome-specific assets! + +--- + +**Recommendation:** Start with **Phase 1 biomes** (Forest, Desert, Mountain, Swamp) in next sessions!