# 🌳 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