diff --git a/references/BIOME_CROP_MASTER_SPEC.md b/references/BIOME_CROP_MASTER_SPEC.md new file mode 100644 index 000000000..3565e9d97 --- /dev/null +++ b/references/BIOME_CROP_MASTER_SPEC.md @@ -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.** ๐ŸŽฏ