novafarma/assets/references/trees/TREE_TEMPLATE.md

🌳 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