novafarma/assets/references/BIOME_CROP_MASTER_SPEC.md

🌍🌾 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. 🎯