From 5c04b7a1ed786e31e11669c543f596469222509b Mon Sep 17 00:00:00 2001 From: David Kotnik Date: Mon, 5 Jan 2026 17:29:57 +0100 Subject: [PATCH] CROPS & TREES REFERENCE SYSTEM: Template Growth (8 stages), Seasonal Rules (4 seasons), Smooth Lines standard (NOT pixel art). Oak/Pine/Palm/Dead tree templates. Cannabis/Mushrooms are reference standards. Agent must check these templates before generating ANY vegetation. --- references/crops/CROP_GROWTH_TEMPLATE.md | 351 ++++++++++++++++++++ references/trees/TREE_TEMPLATE.md | 395 +++++++++++++++++++++++ 2 files changed, 746 insertions(+) create mode 100644 references/crops/CROP_GROWTH_TEMPLATE.md create mode 100644 references/trees/TREE_TEMPLATE.md diff --git a/references/crops/CROP_GROWTH_TEMPLATE.md b/references/crops/CROP_GROWTH_TEMPLATE.md new file mode 100644 index 000000000..809be037b --- /dev/null +++ b/references/crops/CROP_GROWTH_TEMPLATE.md @@ -0,0 +1,351 @@ +# 🌾 CROP GROWTH TEMPLATE - Style 32 Standards + +**Purpose:** Strict template for ALL crop growth stages ensuring consistency across 8 growth phases and 4 seasons. + +--- + +## 📐 TEMPLATE GROWTH - 8 STAGES (Universal) + +**REQUIRED REFERENCE IMAGES:** +- `cannabis_stage_1.png` through `cannabis_stage_4.png` (current) +- `mushroom_stage_1.png` through `mushroom_stage_4.png` (current) +- `wheat_stage_1.png` through `wheat_stage_8.png` (to be created) + +### **Stage 1: Seed/Planted (0-10%)** +- **Visual:** Freshly tilled soil, tiny sprout barely visible +- **Size:** 1-2 pixels above soil line +- **Color:** Light green `#90EE90` (Light Green) +- **Detail:** Minimal, just hint of life + +### **Stage 2: Seedling (10-20%)** +- **Visual:** Small sprout with 2 leaves +- **Size:** 25% of final height +- **Color:** Light green `#90EE90` to `#32CD32` (Lime) +- **Detail:** First leaf pair visible + +### **Stage 3: Young Plant (20-40%)** +- **Visual:** Growing stem, 4-6 leaves +- **Size:** 40% of final height +- **Color:** Lime `#32CD32` +- **Detail:** Stem visible, multiple leaf nodes + +### **Stage 4: Vegetative (40-60%)** +- **Visual:** Full foliage, bushy appearance +- **Size:** 60% of final height +- **Color:** Forest Green `#228B22` +- **Detail:** Thick stem, many branches/leaves + +### **Stage 5: Pre-Flowering (60-70%)** +- **Visual:** Buds/flowers starting to appear +- **Size:** 75% of final height +- **Color:** Dark green with color accents +- **Detail:** Flower buds visible + +### **Stage 6: Flowering (70-85%)** +- **Visual:** Full flowers/fruit forming +- **Size:** 90% of final height +- **Color:** Vibrant flower colors appear +- **Detail:** Flowers/small fruit prominent + +### **Stage 7: Maturing (85-95%)** +- **Visual:** Fruit/harvest growing larger +- **Size:** 100% height +- **Color:** Fruit changing color (green → final color) +- **Detail:** Harvest almost ready + +### **Stage 8: Harvest Ready (95-100%)** +- **Visual:** Fully ripe, maximum size +- **Size:** 100% height, maximum visual appeal +- **Color:** Final harvest color (red tomatoes, gold wheat, etc.) +- **Detail:** Sparkle/glow effect (optional VFX) +- **Indicator:** ✨ Harvestable icon overlay + +--- + +## 🎨 VISUAL STYLE RULES (NO EXCEPTIONS) + +### **Smooth Lines (NOT Pixel Art):** +- **Outlines:** THICK 5px black `#000000` +- **Style:** Vector-smooth, anti-aliased curves +- **NOT:** Chunky pixel blocks or low-res sprites +- **Reference:** Cannabis/Mushroom stages (smooth, not pixelated) + +### **Style 32 Consistency:** +- Flat cel shading (no soft gradients) +- Vibrant colors (not muted/realistic) +- Chibi proportions (cute, not realistic) +- Transparent background (always) +- Black outlines (5px, always) + +### **Size Standards:** +- Small crops (lettuce, herbs): 32x32px +- Medium crops (tomatoes, carrots): 48x48px or 64x64px +- Large crops (pumpkins, wheat): 64x64px or 96x96px +- Cannabis/special: 64x64px +- Mushrooms: 48x48px + +--- + +## 🌍 SEASONAL VARIATIONS (All Crops) + +### **🌸 SPRING (Pomlad)** +**Visual Changes:** +- Bright, fresh colors +- Light greens `#90EE90`, `#32CD32` +- Flowers visible (white, pink, yellow) +- Rain droplets on leaves (optional) +- Vibrant new growth + +**Example:** +- Wheat: Bright green stalks, no grain yet +- Tomatoes: Green with white flowers +- Cannabis: Light green leaves, vigorous growth + +--- + +### **☀️ SUMMER (Poletje)** +**Visual Changes:** +- Deeper, richer colors +- Dark greens `#228B22`, `#006400` +- Fruits forming/maturing +- Sun-kissed highlights +- Maximum growth + +**Example:** +- Wheat: Golden stalks, grain visible +- Tomatoes: Red fruits, green leaves +- Cannabis: Dark green, resinous appearance + +--- + +### **🍂 AUTUMN (Jesen)** +**Visual Changes:** +- Warm, harvest colors +- Browns `#8B4513`, oranges `#FF8C00` +- Dying leaves (some yellowing) +- Harvest-ready appearance +- Crisp, dry look + +**Example:** +- Wheat: Fully golden, ready to harvest +- Tomatoes: Deep red, some fallen +- Cannabis: Purple hues appearing + +--- + +### **❄️ WINTER (Zima)** +**Visual Changes:** +- Cold, dormant colors +- Gray-greens `#556B2F`, browns +- Withered/dead appearance +- Snow accumulation on leaves +- Minimal growth (except greenhouses) + +**Example:** +- Wheat: Brown stubble, snow patches +- Tomatoes: Dead/frozen plants +- Cannabis: Indoor only, vibrant still + +**Note:** Most crops DON'T grow in winter (except in greenhouse) + +--- + +## 📋 CROP-SPECIFIC TEMPLATES + +### **Cannabis (Reference Standard)** +**8 Stages:** +1. Seed in soil +2. Cotyledon (first round leaves) +3. 3-blade fan leaves +4. 5-blade fan leaves, branching +5. Pre-flower stretch, sex showing +6. Flowering, buds visible +7. Buds swelling, trichomes forming +8. Harvest ready, frosty appearance ✨ + +**Colors:** +- Young: `#32CD32` (Lime) +- Vegetative: `#228B22` (Forest Green) +- Flowering: `#006400` (Dark Green) + purple accents +- Trichomes: White sparkle overlay + +**Style:** Smooth 5px outlines, NO pixelation + +--- + +### **Magic Mushrooms (Reference Standard)** +**8 Stages:** +1. Spore inoculation (substrate visible) +2. Mycelium spreading (white threads) +3. Pin formation (tiny bumps) +4. Young mushroom (small cap) +5. Cap expanding +6. Veil breaking +7. Cap fully opened +8. Mature, glowing appearance ✨ + +**Colors:** +- Cap: `#FF1493` (Deep Pink) or `#9370DB` (Purple) +- Spots: `#FFD700` (Gold) or white +- Stem: `#F5DEB3` (Wheat) +- Glow: `#00CED1` (Cyan, semi-transparent) + +**Style:** Smooth outlines, cute chibi mushrooms + +--- + +### **Standard Crops (Tomato, Wheat, etc.)** +**8 Stages Template:** +1. Tilled soil, seed planted +2. Sprout (1-2 leaves) +3. Young plant (4-6 leaves) +4. Bushy vegetative growth +5. Flowering begins +6. Fruit/grain forming +7. Fruit/grain maturing +8. Harvest ready ✨ + +**Follow color progression:** +- Light green → Dark green → Harvest color +- Smooth transitions between stages +- 5px black outlines maintained + +--- + +## 🌿 PERENNIAL CROPS (Special Rules) + +**Examples:** Strawberries, asparagus, fruit trees + +**Multiple Harvests:** +- Stage 1-4: Initial growth (once) +- Stage 5-8: Repeat every season (perennial cycle) +- Winter dormancy stage (leafless/minimal) +- Spring regrowth (from stage 5, not stage 1) + +**Visual Difference:** +- Woody stems remain in winter +- Leaves fall but structure stays +- Spring: New leaves on old structure + +--- + +## 📏 CROP SPACING & LAYOUT + +### **Grid System:** +- Small crops: 1x1 tile (32x32px) +- Medium crops: 1x1 tile (64x64px, centered) +- Large crops: 2x2 tiles (128x128px) +- Trees: 3x3 tiles (192x192px) + +### **Transparent Background:** +- ALWAYS 100% transparent +- No ground/soil included in crop sprite +- Ground is separate layer (tilemap) + +### **Shadow:** +- Simple oval shadow at base +- Color: `#000000` at 30% opacity +- Size: 50-70% of crop width + +--- + +## 🚫 FORBIDDEN STYLES (Crops) + +**NEVER use:** +- Pixel art style (chunky blocks) +- Realistic photography textures +- Soft gradients (only flat cel shading) +- Muted/dull colors +- Thin outlines (< 4px) +- Background that's not transparent + +--- + +## ✅ CROP GENERATION CHECKLIST + +Before approving ANY crop sprite: +- [ ] Viewed cannabis/mushroom references first +- [ ] 8 growth stages defined +- [ ] Smooth lines (NOT pixelated) +- [ ] 5px thick black outlines +- [ ] Flat cel shading +- [ ] Vibrant colors (matches COLOR_MASTER) +- [ ] Transparent background +- [ ] Matches Style 32 aesthetic +- [ ] Seasonal variants planned (if applicable) +- [ ] Size matches category (small/medium/large) + +--- + +## 🚀 GENERATION WORKFLOW + +**For ANY new crop:** + +1. **Check References:** + - View `/references/crops/cannabis_stage_*.png` + - View `/references/crops/mushroom_stage_*.png` + - Review COLOR_MASTER.md for exact colors + +2. **Plan 8 Stages:** + - Sketch out progression (seed → harvest) + - Define color changes per stage + - Plan size increase per stage + +3. **Generate Stage 1:** + - Include "EXACT Style 32 matching /references/crops/" + - Include "Smooth lines, NOT pixel art" + - Include "5px black outlines #000000" + - Include exact hex colors + +4. **Verify Match:** + - Compare to cannabis/mushroom references + - Check outline thickness (5px) + - Check smoothness (no pixelation) + - If mismatch → Auto-reroll + +5. **Generate Remaining Stages:** + - Maintain consistency across all 8 stages + - Same outline thickness + - Same color palette + - Progressive size increase + +6. **Save & Organize:** + - `assets/sprites/crops/[crop_name]_stage_[1-8].png` + - Update manifest + - Document in crop registry + +--- + +## 🌱 EXAMPLE PROMPT (Correct) + +``` +Wheat crop Stage 3 (young plant). EXACT Style 32 matching /references/crops/: +SMOOTH LINES (NOT pixel art), 5px black outlines #000000, +flat cel shading, lime green stalks #32CD32, +4-6 blade leaves visible, 40% of final height, +transparent background, chibi cute proportions, +Cult of the Lamb aesthetic. +``` + +--- + +## 📊 CROP REGISTRY + +**Current Crops (Style 32):** +- ✅ Cannabis (4 stages) - Reference standard +- ✅ Magic Mushrooms (4 stages) - Reference standard +- ✅ Strawberries (4 stages) +- ✅ Onions (4 stages) +- 🔄 Wheat (8 stages needed) +- 🔄 Tomatoes (8 stages needed) +- 🔄 Carrots (8 stages needed) +- 🔄 Potatoes (8 stages needed) +- 🔄 Lettuce (8 stages needed) +- 🔄 Corn (8 stages needed) +- ❌ Peppers (not started) + +--- + +**STATUS:** Template defined, cannabis/mushrooms are reference standards +**PRIORITY:** HIGH - needed for farming system +**NEXT STEP:** Expand existing 4-stage crops to 8 stages, generate remaining crops diff --git a/references/trees/TREE_TEMPLATE.md b/references/trees/TREE_TEMPLATE.md new file mode 100644 index 000000000..ab76d6577 --- /dev/null +++ b/references/trees/TREE_TEMPLATE.md @@ -0,0 +1,395 @@ +# 🌳 TREE TEMPLATE - Style 32 Standards + +**Purpose:** Strict template for ALL trees ensuring consistency across tree types, seasons, and growth stages. + +--- + +## 🌲 TREE TYPES (Universal Categories) + +### **1. OAK TREES (Deciduous)** +**REQUIRED REFERENCE:** `oak_tree_summer_style32.png` + +**Visual DNA:** +- Thick trunk with visible bark texture (Style 32) +- Broad, round canopy +- Many branches visible +- Leaf clusters (not individual leaves) +- **Height:** 192x192px (3x3 tiles) +- **Outlines:** 5px black `#000000` + +**Colors:** +- Bark: `#8B4513` (Saddle Brown) +- Leaves (Summer): `#228B22` (Forest Green) +- Shadows: `#2F4F4F` (Dark Slate Gray) + +--- + +### **2. PINE TREES (Evergreen)** +**REQUIRED REFERENCE:** `pine_tree_style32.png` + +**Visual DNA:** +- Straight trunk, conical shape +- Layered branches (triangular tiers) +- Needle clusters (simplified, not individual) +- **Height:** 192x256px (3x4 tiles for tall) +- **Outlines:** 5px black `#000000` + +**Colors:** +- Bark: `#8B4513` (Saddle Brown) +- Needles: `#2E8B57` (Sea Green) - stays green all seasons +- Shadows: `#006400` (Dark Green) + +--- + +### **3. PALM TREES (Tropical)** +**REQUIRED REFERENCE:** `palm_tree_style32.png` + +**Visual DNA:** +- Curved/bent trunk with texture +- Large fronds at top (5-7 leaves) +- Coconuts visible (optional) +- **Height:** 192x192px (3x3 tiles) +- **Outlines:** 5px black `#000000` + +**Colors:** +- Bark: `#CD853F` (Peru) +- Fronds: `#228B22` (Forest Green) +- Coconuts: `#8B4513` (Saddle Brown) + +--- + +### **4. DEAD TREES (Universal)** +**REQUIRED REFERENCE:** `dead_tree_style32.png` + +**Visual DNA:** +- Bare branches (no leaves) +- Weathered, cracked bark +- Hollow sections/holes +- Tilted/broken branches +- **Height:** 160x160px (2.5x2.5 tiles) +- **Outlines:** 5px black `#000000` + +**Colors:** +- Bark: `#696969` (Dim Gray) +- Highlights: `#D3D3D3` (Light Gray) +- Shadows: `#2F4F4F` (Dark Slate Gray) + +--- + +## 🍂 SEASONAL CHANGES (Deciduous Trees ONLY) + +### **🌸 SPRING (Pomlad)** +**Visual Changes:** +- Light green new leaves +- Pink/white blossoms (fruit trees) +- Bright, fresh appearance +- 80% leaf coverage + +**Oak Example:** +- Leaves: `#90EE90` (Light Green) +- Blossoms: `#FFB6C1` (Light Pink) clusters +- Trunk unchanged: `#8B4513` + +--- + +### **☀️ SUMMER (Poletje)** +**Visual Changes:** +- Full, dark green canopy +- 100% leaf coverage +- Dense, lush appearance +- Fruits visible (if fruit tree) + +**Oak Example:** +- Leaves: `#228B22` (Forest Green) +- Trunk unchanged: `#8B4513` +- Optional: Acorns `#8B4513` (small dots) + +--- + +### **🍂 AUTUMN (Jesen)** +**Visual Changes:** +- Orange, red, yellow leaves +- 60-80% leaf coverage (some falling) +- Warm color palette +- Leaves on ground nearby + +**Oak Example:** +- Leaves: `#FF8C00` (Dark Orange) + `#FFD700` (Gold) + `#FF4500` (Orange Red) +- Mix of colors in canopy +- Trunk unchanged: `#8B4513` +- Ground: Scattered fallen leaves + +--- + +### **❄️ WINTER (Zima)** +**Visual Changes:** +- Bare branches (deciduous) +- Snow on branches +- 0% leaf coverage +- Stark, skeletal appearance + +**Oak Example:** +- No leaves (branches visible) +- Trunk: `#8B4513` with snow patches +- Snow: `#F0F8FF` (Alice Blue) on top of branches +- Icicles: `#B0E0E6` (Powder Blue) hanging + +**Pine (Evergreen) Winter:** +- KEEPS green needles `#2E8B57` +- Snow accumulated on branches +- Heavier, snow-laden appearance + +--- + +## 📏 TREE SIZE STANDARDS + +### **Small Trees (Saplings/Young):** +- **Size:** 96x96px (1.5x1.5 tiles) +- **Age:** 0-5 years +- **Trunk:** Thin (10-15px width) +- **Canopy:** Small, sparse + +### **Medium Trees (Mature):** +- **Size:** 160x160px (2.5x2.5 tiles) +- **Age:** 5-20 years +- **Trunk:** Medium (20-30px width) +- **Canopy:** Full, rounded + +### **Large Trees (Ancient):** +- **Size:** 192x192px or 256x256px (3x3 or 4x4 tiles) +- **Age:** 20+ years +- **Trunk:** Thick (40-60px width) +- **Canopy:** Massive, spreading + +--- + +## 🎨 VISUAL STYLE RULES (Trees) + +### **Smooth Lines (NOT Pixel Art):** +- **Outlines:** THICK 5px black `#000000` +- **Style:** Vector-smooth curves, anti-aliased +- **Bark texture:** Simplified lines (chibi style, not realistic) +- **Leaves:** Cluster shapes, not individual leaves + +### **Style 32 Consistency:** +- Flat cel shading (no soft gradients) +- Vibrant colors (not muted/realistic) +- Chibi proportions (cute, stylized trunks) +- Transparent background (always) +- Black outlines (5px, always) + +### **Trunk Texture:** +- Vertical lines suggesting bark (3-5 lines max) +- Knots/branches as simple ovals +- NOT photorealistic texture +- Chibi-simplified detail + +### **Leaf Clusters:** +- Groups of 5-10 leaves as single shape +- 5px black outline per cluster +- Overlapping clusters create canopy +- NOT individual leaf sprites + +--- + +## 🌳 TREE GROWTH STAGES (Optional, for farming trees) + +### **Stage 1: Sapling** +- Tiny trunk, 2-3 small branches +- Few leaf clusters +- 64x64px + +### **Stage 2: Young Tree** +- Thin trunk, more branches +- Growing canopy +- 96x96px + +### **Stage 3: Adolescent** +- Medium trunk, branching visible +- Half-full canopy +- 128x128px + +### **Stage 4: Mature** +- Thick trunk, many branches +- Full canopy +- 192x192px + +### **Stage 5: Ancient** +- Very thick trunk, spreading branches +- Massive canopy +- 256x256px or larger + +--- + +## 🌍 BIOME-SPECIFIC TREES + +### **Forest Biome:** +- Oak, Maple, Birch +- Dense foliage +- Color: `#228B22` (Forest Green) + +### **Desert Biome:** +- Palm, Cactus +- Sparse foliage +- Color: `#6B8E23` (Olive Drab) + +### **Winter Biome:** +- Pine, Spruce, Fir +- Evergreen, snow-laden +- Color: `#2E8B57` (Sea Green) + snow + +### **Jungle Biome:** +- Banyan, Kapok, Jungle vines +- Massive, overgrown +- Color: `#00FF00` (Lime) + `#013220` (Dark Green) + +### **Volcanic Biome:** +- Dead/burnt trees only +- Charred appearance +- Color: `#2F4F4F` (Dark Slate) + black char + +--- + +## 🍎 FRUIT TREES (Special Category) + +**Examples:** Apple, Cherry, Orange + +### **Spring:** +- Blossoms (pink/white flowers) +- No fruit yet +- Color: `#FFB6C1` (Light Pink) blossoms + +### **Summer:** +- Small green fruits forming +- Full green leaves +- Color: `#90EE90` (Light Green) fruits + +### **Autumn:** +- Ripe, colored fruits +- Leaves turning colors +- Color: `#FF0000` (Red) apples, `#FF8C00` (Orange) oranges + +### **Winter:** +- Bare branches +- All fruit harvested/fallen +- No leaves + +--- + +## 🪓 CHOPPED/STUMP STATE + +**When tree is cut:** +- Stump sprite: 64x64px +- Circular shape, rings visible +- Same bark color as tree +- 5px black outlines +- Optional: Axe marks (diagonal cuts) + +**Stump Colors:** +- Bark: Same as original tree +- Rings: `#D2B48C` (Tan) alternating with darker +- Cut surface: `#F5DEB3` (Wheat) + +--- + +## 🚫 FORBIDDEN STYLES (Trees) + +**NEVER use:** +- Pixel art style (chunky, low-res) +- Realistic photo textures +- Individual leaf sprites (use clusters) +- Soft gradients (only flat shading) +- Muted/dull colors +- Thin outlines (< 4px) +- Non-transparent background + +--- + +## ✅ TREE GENERATION CHECKLIST + +Before approving ANY tree sprite: +- [ ] Viewed biome-appropriate tree reference +- [ ] Smooth lines (NOT pixelated) +- [ ] 5px thick black outlines +- [ ] Flat cel shading +- [ ] Vibrant colors (matches COLOR_MASTER) +- [ ] Transparent background +- [ ] Matches Style 32 aesthetic +- [ ] Seasonal variants planned (if deciduous) +- [ ] Size matches category (small/medium/large) +- [ ] Trunk texture simplified (chibi style) +- [ ] Leaf clusters (not individual leaves) + +--- + +## 🚀 GENERATION WORKFLOW + +**For ANY new tree:** + +1. **Check References:** + - Determine tree type (Oak, Pine, Palm, Dead) + - View corresponding reference image + - Review COLOR_MASTER.md for colors + - Check BIOME_GUIDES.md for biome + +2. **Determine Season:** + - Spring, Summer, Autumn, or Winter? + - Evergreen or deciduous? + - Plan leaf coverage/color + +3. **Generate Base Tree (Summer):** + - Include "EXACT Style 32 matching /references/trees/" + - Include "Smooth lines, NOT pixel art" + - Include "5px black outlines #000000" + - Include exact hex colors + - Include "Leaf clusters, not individual leaves" + +4. **Verify Match:** + - Compare to reference tree + - Check outline thickness (5px) + - Check smoothness (no pixelation) + - Check leaf cluster style + - If mismatch → Auto-reroll + +5. **Generate Seasonal Variants:** + - Spring: Light green, blossoms + - Summer: Dark green, full + - Autumn: Orange/red/yellow + - Winter: Bare (or snow if evergreen) + +6. **Save & Organize:** + - `assets/sprites/trees/[tree_type]_[season].png` + - Update manifest + - Document in tree registry + +--- + +## 🌲 EXAMPLE PROMPT (Correct) + +``` +Oak tree Summer. EXACT Style 32 matching /references/trees/: +SMOOTH LINES (NOT pixel art), 5px black outlines #000000, +flat cel shading, thick trunk #8B4513 (Saddle Brown), +dark green leaf clusters #228B22 (Forest Green), +leaf clusters NOT individual leaves, +192x192px, transparent background, +chibi proportions, Cult of the Lamb aesthetic. +``` + +--- + +## 📊 TREE REGISTRY + +**Current Trees (Style 32):** +- ❌ Oak (needs all 4 seasons) +- ❌ Pine (evergreen, with/without snow) +- ❌ Palm (tropical) +- ❌ Dead tree (universal) +- ❌ Apple tree (fruit bearing, 4 seasons) +- ❌ Cherry tree (blossom, 4 seasons) + +--- + +**STATUS:** Template defined, awaiting reference images +**PRIORITY:** MEDIUM - needed for biome variety +**NEXT STEP:** Generate master references for Oak, Pine, Palm, Dead trees