# 🌍🌾 BIOME & CROP MASTER REFERENCE

**Purpose:** Single master reference sheet showing seasonal terrain changes and crop growth cycles across all 4 seasons.

**File:** `BIOME_CROP_MASTER.jpg` (to be created)
**Location:** `/references/BIOME_CROP_MASTER.jpg`

---

## 📐 MASTER SHEET LAYOUT

### **Sheet Dimensions:** 2048 x 2048px (high-resolution)

### **Grid Layout:**
```
┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│   🌸 SPRING     │   ☀️ SUMMER     │   🍂 AUTUMN     │   ❄️ WINTER     │
│  (Pomlad)       │   (Poletje)     │   (Jesen)       │   (Zima)        │
├─────────────────┼─────────────────┼─────────────────┼─────────────────┤
│ TERRAIN SECTION │ TERRAIN SECTION │ TERRAIN SECTION │ TERRAIN SECTION │
│ - Grass         │ - Grass         │ - Grass         │ - Snow/Ice      │
│ - Soil          │ - Soil          │ - Soil          │ - Frozen Soil   │
│ - Path          │ - Path          │ - Path          │ - Icy Path      │
├─────────────────┼─────────────────┼─────────────────┼─────────────────┤
│ WHEAT GROWTH    │ WHEAT GROWTH    │ WHEAT GROWTH    │ WHEAT GROWTH    │
│ Stage 1-8       │ Stage 1-8       │ Stage 1-8       │ Stage 1-8       │
│ (all stages)    │ (all stages)    │ (all stages)    │ (all stages)    │
└─────────────────┴─────────────────┴─────────────────┴─────────────────┘
```

---

## 🌍 PART 1: BIOME TERRAIN (Seasonal Changes)

### **🌸 SPRING COLUMN (Pomlad)**

**Grass:**
- **Color:** `#90EE90` (Light Green) - Fresh, bright
- **Texture:** Smooth Style 32, 5px black outlines
- **Details:** New growth, vibrant, alive
- **Flowers:** Small pink/yellow dots scattered

**Soil:**
- **Color:** `#8B4513` (Saddle Brown) - Rich, moist
- **Texture:** Tilled furrows visible (smooth lines)
- **Details:** Fresh, ready for planting

**Path/Dirt:**
- **Color:** `#D2B48C` (Tan) - Light brown
- **Texture:** Smooth, slightly wet appearance

**Overall Mood:** Fresh, new life, vibrant greens

---

### **☀️ SUMMER COLUMN (Poletje)**

**Grass:**
- **Color:** `#228B22` (Forest Green) - Deep, rich
- **Texture:** Lush, full coverage
- **Details:** Maximum growth, sun-kissed
- **Flowers:** Full blooms, colorful

**Soil:**
- **Color:** `#8B4513` (Saddle Brown) - Dry, warm
- **Texture:** Compact, sun-baked
- **Details:** Established crops growing

**Path/Dirt:**
- **Color:** `#CD853F` (Peru) - Warmer brown
- **Texture:** Dry, dusty appearance

**Overall Mood:** Hot, vibrant, peak growth

---

### **🍂 AUTUMN COLUMN (Jesen)**

**Grass:**
- **Color:** `#DAA520` (Goldenrod) + `#FF8C00` (Dark Orange)
- **Texture:** Mixed green/yellow/orange patches
- **Details:** Dying grass, harvest colors
- **Fallen Leaves:** Orange/red scattered on ground

**Soil:**
- **Color:** `#8B4513` (Saddle Brown) - Cooling down
- **Texture:** Loose, harvest-ready
- **Details:** Post-harvest stubble

**Path/Dirt:**
- **Color:** `#A0522D` (Sienna) - Rich brown
- **Texture:** Crisp, dry autumn ground

**Overall Mood:** Warm tones, harvest time, transition

---

### **❄️ WINTER COLUMN (Zima)**

**Snow/Grass:**
- **Color:** `#F0F8FF` (Alice Blue) - White snow
- **Under-snow:** `#556B2F` (Dark Olive) - Dead grass patches
- **Texture:** Snow drifts, smooth curves (NOT chunky pixels)
- **Details:** Sparse brown grass poking through

**Frozen Soil:**
- **Color:** `#708090` (Slate Gray) - Frozen hard
- **Texture:** Icy, cracked surface (smooth Style 32)
- **Details:** Frost patterns (simple, stylized)

**Icy Path:**
- **Color:** `#B0E0E6` (Powder Blue) - Ice patches
- **Texture:** Reflective, slippery look
- **Details:** Snow footprints (if any)

**Overall Mood:** Cold, dormant, blue-gray tones

---

## 🌾 PART 2: WHEAT CROP GROWTH (8 Stages × 4 Seasons = 32 Sprites)

### **Layout per Season Column:**
```
Stage 1: Seed/Sprout
Stage 2: Seedling
Stage 3: Young Plant
Stage 4: Vegetative
Stage 5: Pre-Flowering
Stage 6: Flowering
Stage 7: Maturing
Stage 8: Harvest Ready ✨
```

---

### **SPRING WHEAT (Stages 1-8):**

**Stage 1 (Seed):**
- Tilled soil, tiny green sprout (2px)
- Color: `#90EE90` (Light Green)
- Size: 8x8px visible portion

**Stage 2 (Seedling):**
- 2 small leaves
- Color: `#90EE90`
- Size: 16x16px

**Stage 3 (Young):**
- 4-6 blade leaves
- Color: `#32CD32` (Lime)
- Size: 24x24px

**Stage 4 (Vegetative):**
- Bushy, many leaves
- Color: `#228B22` (Forest Green)
- Size: 32x32px

**Stage 5 (Pre-Flower):**
- Tall stalks, beginning to shoot up
- Color: `#228B22`
- Size: 40x40px

**Stage 6 (Flowering):**
- White flowers appearing on tips
- Color: Green `#228B22` + white blooms
- Size: 48x48px

**Stage 7 (Maturing):**
- Light green grain forming
- Color: `#9ACD32` (Yellow Green)
- Size: 56x56px

**Stage 8 (Harvest):**
- Golden grain, ready
- Color: `#F0E68C` (Khaki) - early harvest
- Size: 64x64px, sparkle ✨

---

### **SUMMER WHEAT (Stages 1-8):**

**Stages 1-4:** Same as Spring but slightly deeper greens
- Use `#228B22` instead of lime earlier

**Stage 5-7:** Faster growth, more robust
- Stalks thicker, darker green

**Stage 8 (Harvest):**
- **FULL GOLDEN COLOR:** `#FFD700` (Gold)
- Maximum size, full heads
- 64x64px, bright sparkle ✨
- **This is PRIME harvest time**

---

### **AUTUMN WHEAT (Stages 1-8):**

**Stages 1-3:** Slower growth, cooler colors
- Light green with slight yellow tint

**Stages 4-6:** Struggling growth
- Mix of green and early yellowing

**Stage 7-8 (Late Harvest):**
- **Over-ripe:** `#8B4513` (Saddle Brown) - drying out
- Stalks bent, seeds falling
- Must harvest NOW or lose crop
- Faded sparkle (amber/brown)

---

### **WINTER WHEAT (Stages 1-8):**

**ALL STAGES:**
- **DORMANT or DEAD** (outdoor crops)
- Snow covering plants
- Brown/dead stalks visible
- Color: `#8B4513` (brown) + `#F0F8FF` (snow)

**Exception: Greenhouse Wheat (optional note)**
- Can grow indoors
- Slower but still green
- Artificial warmth allows growth

**Outdoor Winter Wheat:**
- Stages 1-8: All show dead/frozen plants
- NO harvest possible
- Must plant in Spring

---

## 🎨 STYLE REQUIREMENTS (ALL ELEMENTS)

### **✅ MANDATORY:**
- **Smooth vector-style lines** (matches Ana reference)
- **5px thick black outlines** on ALL elements
- **High-resolution rendering** (2048px total sheet)
- **Flat cel shading** (no gradients except ground shadows)
- **Vibrant seasonal colors** (not muted/realistic)
- **Transparent background** OR white reference grid
- **Cult of the Lamb aesthetic** (smooth, polished)

### **❌ FORBIDDEN:**
- NO pixel art / stair-stepping
- NO chunky blocks
- NO low-resolution sprites
- NO dithering/grain
- NO realistic photo textures

---

## 📏 DETAILED SPECIFICATIONS

### **Individual Element Sizes:**

**Terrain Tiles (each season):**
- **Grass tile:** 128x128px
- **Soil tile:** 128x128px  
- **Path tile:** 128x128px
- Show tileable edges (seamless repeat)

**Wheat Sprites (each stage, each season):**
- **Stage 1:** 16x16px (tiny)
- **Stage 2:** 24x24px
- **Stage 3:** 32x32px
- **Stage 4:** 40x40px
- **Stage 5:** 48x48px
- **Stage 6:** 56x56px
- **Stage 7:** 60x60px
- **Stage 8:** 64x64px (maximum)

**Spacing:**
- 20px padding between elements
- Clear labels for each season/stage
- Grid lines (thin, light gray) for organization

---

## 🏷️ LABELS & ANNOTATIONS

### **Season Headers (top of each column):**
```
🌸 SPRING (Pomlad)
Fresh Growth · Bright Greens · New Life

☀️ SUMMER (Poletje)  
Peak Growth · Rich Colors · Heat

🍂 AUTUMN (Jesen)
Harvest Time · Warm Tones · Transition

❄️ WINTER (Zima)
Dormancy · Cold Blues · Snow
```

### **Wheat Stage Labels (left side):**
```
Stage 1: Seed/Sprout (0-10%)
Stage 2: Seedling (10-20%)
Stage 3: Young (20-40%)
Stage 4: Vegetative (40-60%)
Stage 5: Pre-Flower (60-70%)
Stage 6: Flowering (70-85%)
Stage 7: Maturing (85-95%)
Stage 8: Harvest ✨ (95-100%)
```

### **Color Code Key (bottom of sheet):**
```
GRASS COLORS:
Spring #90EE90 → Summer #228B22 → Autumn #DAA520 → Winter #F0F8FF

WHEAT COLORS:
Young #32CD32 → Mature #228B22 → Flowering #9ACD32 → Harvest #FFD700

SOIL COLORS:
Spring/Summer #8B4513 → Autumn #A0522D → Winter #708090
```

---

## 🚀 USAGE INSTRUCTIONS

### **When generating ANY biome terrain:**
1. Open `BIOME_CROP_MASTER.jpg`
2. Identify season (Spring/Summer/Autumn/Winter)
3. Extract EXACT grass/soil colors from reference
4. Use exact hex codes in prompt
5. Match smoothness/style to master reference

### **When generating ANY crop:**
1. Open `BIOME_CROP_MASTER.jpg`
2. Identify growth stage (1-8)
3. Identify season
4. Find corresponding wheat sprite in grid
5. Match size, color, style exactly
6. Apply same logic to new crop (tomato, carrot, etc.)

### **Color Extraction:**
- Use eyedropper tool on reference
- Copy exact hex codes
- Include in generation prompt
- NO guessing colors

---

## ✅ VERIFICATION CHECKLIST

Before approving BIOME_CROP_MASTER.jpg:

**Overall:**
- [ ] 2048x2048px high-resolution
- [ ] 4 clear season columns
- [ ] All terrain types shown per season
- [ ] All 8 wheat stages per season (32 total sprites)
- [ ] Smooth Style 32 lines (matches Ana)
- [ ] 5px black outlines on everything
- [ ] Clear labels and color key
- [ ] Professional, polished appearance

**Spring Column:**
- [ ] Light green grass (#90EE90)
- [ ] Fresh soil (#8B4513)
- [ ] Light tan path (#D2B48C)
- [ ] Wheat stages 1-8 in spring colors

**Summer Column:**
- [ ] Dark green grass (#228B22)
- [ ] Dry soil (#8B4513)
- [ ] Warmer path (#CD853F)
- [ ] Wheat stages 1-8, golden harvest (#FFD700)

**Autumn Column:**
- [ ] Orange/yellow grass (#DAA520)
- [ ] Rich soil (#A0522D)
- [ ] Autumn path (#A0522D)
- [ ] Wheat stages 1-8, over-ripe (#8B4513)

**Winter Column:**
- [ ] Snow/ice (#F0F8FF)
- [ ] Frozen soil (#708090)
- [ ] Icy path (#B0E0E6)
- [ ] Wheat stages 1-8, dead/dormant

**Style:**
- [ ] NO pixelation anywhere
- [ ] Smooth curves (vector-quality)
- [ ] Consistent outline thickness (5px)
- [ ] Vibrant colors (not muted)
- [ ] Matches Ana reference quality

---

## 🎯 CRITICAL NOTES

### **This reference will be used for:**
- ALL 20 biomes (terrain base)
- ALL crops (growth pattern template)
- ALL seasonal variations (color reference)
- ALL terrain tiles (style guide)

### **Every vegetation asset MUST:**
1. Check this master reference FIRST
2. Match seasonal colors exactly
3. Match growth stage size/detail
4. Match smooth line quality
5. Use exact hex codes provided

### **This is THE definitive seasonal & growth reference.**
- No guessing seasonal colors
- No inventing growth stages
- No style deviations
- Everything checks against this master

---

**STATUS:** Specification complete, awaiting image creation
**PRIORITY:** CRITICAL - needed before generating any more vegetation/terrain
**FILE:** `/references/BIOME_CROP_MASTER.jpg` (to be generated)

---

**Once this master reference exists, ALL future biome/crop generation becomes:**
1. Open master reference
2. Find relevant season + stage
3. Copy exact colors/style
4. Generate matching asset
5. Verify against master

**No more inconsistency. One source of truth.** 🎯