BIOME & CROP MASTER REFERENCE SPEC: Complete specification for seasonal terrain (Spring/Summer/Autumn/Winter) and 8-stage wheat growth across all seasons. 2048x2048px master sheet layout with exact hex colors, smooth Style 32 quality. Single source of truth for ALL vegetation/terrain generation.

This commit is contained in:
2026-01-05 17:43:36 +01:00
parent 4d35905481
commit 82a3f0ea8a

View File

@@ -0,0 +1,430 @@
# 🌍🌾 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.** 🎯