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.

This commit is contained in:
2026-01-05 17:29:57 +01:00
parent f3c9c7fa1e
commit 5c04b7a1ed
2 changed files with 746 additions and 0 deletions

View File

@@ -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

View File

@@ -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