caki so # 🌍 BIOME REQUIREMENTS - COMPLETE OVERVIEW
**Created:** 2026-01-06 13:41 CET  
**Status:** **6 BIOMES - ALL EMPTY!** 🔴

---

## 📊 **BIOME STATUS OVERVIEW**

| Biome | Reference Sprites | Terrain Tiles | Props | Trees | Status |
|-------|------------------|---------------|-------|-------|--------|
| **Desert** | 0 | 0 | 0 | 1 (cactus ref) | 🔴 EMPTY |
| **Forest** | 0 | 0 | 0 | 3 (oak refs) | 🟡 MINIMAL |
| **Frozen Wasteland** | 0 | 0 | 0 | 0 | 🔴 EMPTY |
| **Jungle** | 0 | 0 | 0 | 1 (palm ref) | 🔴 EMPTY |
| **Volcanic** | 0 | 0 | 0 | 0 | 🔴 EMPTY |
| **Winter** | 0 | 0 | 0 | 2 (pine refs) | 🔴 EMPTY |

**TOTAL REFERENCE SPRITES:** 0/6 biomes  
**CRITICAL:** NO biome terrain tiles exist!

---

## 🎯 **WHAT EACH BIOME NEEDS**

### **PER BIOME MINIMUM (Demo):**
1. **Master Terrain Reference** (1 sprite) - Shows ground texture style
2. **Tileable Ground Tile** (1-3 variants) - 32x32px grass/sand/ice
3. **Transition Tiles** (4 variants) - Border between biomes
4. **Basic Props** (5-10 items):
   - Small rocks
   - Plants/vegetation
   - Decorative elements
5. **Trees** (2-3 types) - Biome-specific

**MINIMUM PER BIOME:** ~15-20 sprites  
**TOTAL FOR 6 BIOMES:** ~90-120 sprites

---

## 🌍 **BIOME BREAKDOWN**

### **1. 🏜️ DESERT**

**Current Status:** 🔴 EMPTY (only 1 cactus reference exists)

**Required Sprites:**
- **Terrain Master Reference** (1 sprite)
- **Ground Tiles:**
  - desert_sand_tile.png (32x32px) - Base sand
  - desert_sand_variant_1.png - Lighter/darker sand
  - desert_sand_variant_2.png - Rocky sand
- **Transition Tiles:**
  - desert_to_forest.png (grass edge)
  - desert_to_water.png (beach transition)
- **Props (10):**
  - desert_rock_small.png
  - desert_rock_large.png
  - desert_skull.png (bleached bone)
  - desert_pottery_broken.png
  - desert_tumbleweed.png
  - desert_sand_dune.png
  - desert_oasis_bush.png
  - desert_cactus_small.png
  - desert_cactus_large.png
  - desert_dead_tree.png
- **Trees:**
  - ✅ cactus (already have reference!)
  - palm_desert.png (different from jungle palm)

**TOTAL DESERT:** ~18 sprites

---

### **2. 🌲 FOREST**

**Current Status:** 🟡 MINIMAL (3 oak tree references exist)

**Required Sprites:**
- **Terrain Master Reference** (1 sprite)
- **Ground Tiles:**
  - forest_grass_tile.png (32x32px) - Lush green
  - forest_grass_dark.png - Shadowed grass
  - forest_moss.png - Moss patches
- **Transition Tiles:**
  - forest_to_desert.png
  - forest_to_winter.png
- **Props (10):**
  - forest_mushroom_red.png
  - forest_mushroom_brown.png
  - forest_fern.png
  - forest_flower_blue.png
  - forest_flower_yellow.png
  - forest_rock_mossy.png
  - forest_log_fallen.png
  - forest_stump.png
  - forest_bush_green.png
  - forest_root.png
- **Trees:**
  - ✅ oak (already have 4 seasonal references!)
  - birch.png
  - maple.png

**TOTAL FOREST:** ~18 sprites

---

### **3. 🧊 FROZEN WASTELAND**

**Current Status:** 🔴 EMPTY

**Required Sprites:**
- **Terrain Master Reference** (1 sprite)
- **Ground Tiles:**
  - frozen_ice_tile.png (32x32px) - Blue ice
  - frozen_ice_cracked.png - Cracked ice
  - frozen_snow_tile.png - Snow patches
- **Transition Tiles:**
  - frozen_to_winter.png (ice to snow)
  - frozen_to_water.png (melting edge)
- **Props (10):**
  - frozen_ice_spike_small.png
  - frozen_ice_spike_large.png
  - frozen_ice_crystal.png
  - frozen_ice_boulder.png
  - frozen_icicle_hanging.png
  - frozen_snow_drift.png
  - frozen_ice_chunk.png
  - frozen_frozen_waterfall.png (prop)
  - frozen_ice_pillar.png
  - frozen_aurora_particle.png (VFX prop)
- **Trees:**
  - frozen_dead_tree.png (ice-covered)
  - frozen_ice_tree.png (crystallized)

**TOTAL FROZEN:** ~18 sprites

---

### **4. 🌴 JUNGLE**

**Current Status:** 🔴 EMPTY (only 1 palm reference exists)

**Required Sprites:**
- **Terrain Master Reference** (1 sprite)
- **Ground Tiles:**
  - jungle_undergrowth_tile.png (32x32px) - Dark green
  - jungle_undergrowth_dense.png - Extra vegetation
  - jungle_mud.png - Muddy patches
- **Transition Tiles:**
  - jungle_to_forest.png
  - jungle_to_water.png (swamp edge)
- **Props (10):**
  - jungle_vine_hanging.png
  - jungle_vine_ground.png
  - jungle_large_leaf.png
  - jungle_flower_exotic_pink.png
  - jungle_flower_exotic_orange.png
  - jungle_bamboo_clump.png
  - jungle_fern_large.png
  - jungle_mushroom_giant.png
  - jungle_rock_overgrown.png
  - jungle_fallen_log_mossy.png
- **Trees:**
  - ✅ palm (already have reference!)
  - jungle_tree_broad.png
  - jungle_tree_tall.png

**TOTAL JUNGLE:** ~18 sprites

---

### **5. 🌋 VOLCANIC**

**Current Status:** 🔴 EMPTY

**Required Sprites:**
- **Terrain Master Reference** (1 sprite)
- **Ground Tiles:**
  - volcanic_rock_tile.png (32x32px) - Dark gray
  - volcanic_lava_cracks.png - Orange glow cracks
  - volcanic_obsidian.png - Black glass
- **Transition Tiles:**
  - volcanic_to_desert.png (cooled lava)
  - volcanic_to_water.png (steam edge)
- **Props (10):**
  - volcanic_lava_pool_small.png
  - volcanic_lava_pool_large.png
  - volcanic_rock_sharp.png
  - volcanic_rock_boulder.png
  - volcanic_smoke_vent.png
  - volcanic_ash_pile.png
  - volcanic_obsidian_shard.png
  - volcanic_molten_rock.png
  - volcanic_geyser.png
  - volcanic_lava_flow.png (animated?)
- **Trees:**
  - volcanic_dead_charred.png
  - volcanic_heat_plant.png (fire-resistant)

**TOTAL VOLCANIC:** ~18 sprites

---

### **6. ❄️ WINTER**

**Current Status:** 🔴 EMPTY (2 pine tree references exist)

**Required Sprites:**
- **Terrain Master Reference** (1 sprite)
- **Ground Tiles:**
  - winter_snow_tile.png (32x32px) - White snow
  - winter_snow_footprint.png - Disturbed snow
  - winter_snow_deep.png - Deep snow variant
- **Transition Tiles:**
  - winter_to_frozen.png (snow to ice)
  - winter_to_forest.png (sparse snow)
- **Props (10):**
  - winter_snowdrift.png
  - winter_ice_crystal.png
  - winter_icicle_small.png
  - winter_icicle_large.png
  - winter_frozen_bush.png
  - winter_snow_pile.png
  - winter_ice_rock.png
  - winter_frozen_flower.png
  - winter_snow_mound.png
  - winter_frost_particle.png
- **Trees:**
  - ✅ pine (already have 2 references!)
  - winter_evergreen_snowy.png
  - winter_birch_bare.png

**TOTAL WINTER:** ~18 sprites

---

## 📊 **GRAND TOTAL REQUIREMENTS**

| Item Type | Quantity | Est. Time |
|-----------|----------|-----------|
| **Master References** | 6 | 1 hour |
| **Ground Tiles** | 18 (3 per biome) | 2 hours |
| **Transition Tiles** | 12 (2 per biome) | 1 hour |
| **Props** | 60 (10 per biome) | 6 hours |
| **Trees** | 12 (2 per biome, some exist) | 2 hours |
| **TOTAL** | **~108 sprites** | **~12 hours** |

---

## 🎯 **PHASED APPROACH**

### **PHASE 1: MASTER REFERENCES (1 hour)**
Generate 1 master terrain reference per biome showing:
- Ground texture style
- Color palette
- Outline style (5px black)
- Cel shading example

**Output:** 6 reference images

---

### **PHASE 2: CORE BIOMES (4 hours)**
Focus on 3 most common biomes for demo:
1. **Forest** - Main gameplay area
2. **Winter** - Post-apocalyptic mood
3. **Desert** - Contrast biome

**Output:** ~54 sprites (18 per biome)

---

### **PHASE 3: EXOTIC BIOMES (4 hours)**
Complete remaining 3 biomes:
4. **Volcanic** - Late-game area
5. **Jungle** - Mid-game exploration
6. **Frozen Wasteland** - End-game challenge

**Output:** ~54 sprites (18 per biome)

---

### **PHASE 4: POLISH (3 hours)**
- Add variant tiles
- Create seamless transitions
- Add decorative props
- Test tiling in Tiled

---

## 🚀 **IMMEDIATE NEXT STEPS**

### **OPTION A: GENERATE MASTER REFERENCES (1 hour)**
Create 6 terrain reference images showing Style 32 aesthetic for each biome.

**Result:** Visual guide for all future biome asset generation

---

### **OPTION B: COMPLETE ONE BIOME (2 hours)**
Pick **Forest** (most important) and generate all 18 sprites.

**Result:** Fully functional biome ready for Tiled integration

---

### **OPTION C: SKIP BIOMES FOR NOW**
Focus on other categories (enemies, species, etc.)

**Result:** Biomes remain empty, use placeholder tiles

---

## 📝 **CURRENT REFERENCE STATUS**

**Existing Tree References:**
- ✅ Oak (4 seasonal variants) - FOREST
- ✅ Pine (2 variants) - WINTER  
- ✅ Cactus (1 variant) - DESERT
- ✅ Palm (1 variant) - JUNGLE

**Missing:**
- ❌ ALL terrain tiles (0/18)
- ❌ ALL transition tiles (0/12)
- ❌ ALL props (0/60)
- ❌ Most trees (8/12 missing)

---

## 🎮 **DEMO REQUIREMENT**

**Minimum for Playable Demo:**
- **Forest biome complete** (18 sprites) - CRITICAL
- Winter/Desert optional but recommended

**Current Demo Status:** 🔴 NO BIOME TERRAIN EXISTS

---

**Želiš da nadaljujem z biome generacijo?**
1. Master references (6 sprites, 1 hour)
2. Forest complete (18 sprites, 2 hours)
3. All 6 biomes complete (108 sprites, 12 hours)
4. Skip biomes, focus elsewhere