novafarma/.agent/workflows/full_terrain_tall_grass_guide.md

🎬 FILMIČNI TERRAIN + TALL GRASS - FINAL REPORT

✅ KAJ JE NAREJENO:

1. 🌊 FULL 47-TILE WANG BLOB TERRAIN SETS

• ✅ Terrain_Sand_Water.tsx (47 tiles, smooth transitions)
• ✅ Terrain_Dirt_Grass.tsx (47 tiles, smooth transitions)
• ✅ Terrain_Grass_Water.tsx (47 tiles, smooth transitions)

KAKO DELUJE:

• Standard Wang Blob pattern (kot v Clear Code tutorialu)
• 16x3 grid (48 tiles, zadnji prazen)
• Avtomatični terrain brush v Tiledu
• ULtra smooth alpha-blended edges (Gaussian blur, NO kocke!)

2. 🌾 TALL GRASS ANIMATED

• ✅ Tall_Grass_Animated.tsx (4 frames, wind sway)
• ✅ Transparent background (prosojen backdrop)
• ✅ Harvestable property: isHarvestable: true
• ✅ NO LSD glitching (gentle sway: -2px, 0px, +2px)

KAKO DELUJE:

• Posamezni šopi visoke trave (24x28px tufts)
• Wind animacija (250ms/frame = smooth)
• Stardew-style harvesting (Kai lahko požanje s koso!)
• Low performance impact (samo šopi, ne celotna tla!)

3. 🎮 STATIC GROUND LAYER

• ✅ Podlaga (Ground layer) ostane STATIČNA
• ✅ NO animation waste (Macbook prihrani moč)
• ✅ Samo tall grass šopi so animirani (performance win!)

4. 🗺️ FAZA1_FINALNA.JSON - UPDATED

• ✅ Vsi novi tilesets so dodani:
  • Terrain_Sand_Water.tsx (GID: 14430)
  • Terrain_Dirt_Grass.tsx (GID: 14477)
  • Terrain_Grass_Water.tsx (GID: 14524)
  • Tall_Grass_Animated.tsx (GID: 14571)

---

📂 DODANE DATOTEKE:

✅ /scripts/generate_full_terrain_sets.py   ← 47-tile Wang Blob generator
✅ /scripts/generate_tall_grass.py          ← Tall grass tuft generator

✅ /assets/maps/tilesets/Terrain_Sand_Water.png   (512x96px, 47 tiles)
✅ /assets/maps/tilesets/Terrain_Sand_Water.tsx
✅ /assets/maps/tilesets/Terrain_Dirt_Grass.png   (512x96px, 47 tiles)
✅ /assets/maps/tilesets/Terrain_Dirt_Grass.tsx
✅ /assets/maps/tilesets/Terrain_Grass_Water.png  (512x96px, 47 tiles)
✅ /assets/maps/tilesets/Terrain_Grass_Water.tsx
✅ /assets/maps/tilesets/Tall_Grass_Animated.png  (128x32px, 4 frames)
✅ /assets/maps/tilesets/Tall_Grass_Animated.tsx

✅ /assets/maps/Faza1_Finalna.json  (Updated with all new tilesets)

---

🎮 KAKO UPORABITI V TILEDU:

A) TERRAIN BRUSH (Smooth Transitions):

1. Odpri Tiled → Faza1_Finalna.json
2. V Tilesets panelu vidiš vse 3 terrain sete
3. Izberi npr. Terrain_Grass_Water
4. V Terrains tab klikni "Primary" terrain
5. Izberi Terrain Brush (ikona "T")
6. Riši čez travo → Voda dobi smooth edges! 🎬

REPEAT za Sand→Water in Dirt→Grass!

B) TALL GRASS (Harvestable Tufts):

1. V Layers ustvari nov layer: "Tall_Grass" (nad Ground layer!)
2. V Tilesets izberi Tall_Grass_Animated
3. Izberi Stamp Brush (normal brush)
4. Paint grass tufts kjer želiš (forests, fields, itd.)
5. V igri → Kai lahko požanje s koso! ✂️

C) GROUND LAYER (Static):

1. Ground layer naj uporablja navadno grass.png (NO animation!)
2. NE uporabljaj Grass_Animated.tsx za ground layer!
3. Samo Tall_Grass_Animated za posamezne šope!

---

🎨 WANG BLOB TERRAIN SYSTEM (Technical):

Tile Layout (16x3 grid):

Row 0: Basic tiles (center, edges, outer corners)
  0: Full terrain     5: TL outer corner
  1: Top edge         6: TR outer corner  
  2: Bottom edge      7: BL outer corner
  3: Left edge        8: BR outer corner
  4: Right edge       ...

Row 1: Complex edges (U-shapes, multi-corners)
  16-31: Various combinations

Row 2: Special cases + fill tiles  
  32-46: Inner corners, fill tiles

Terrain Notation (TSX):

<tile id="0" terrain="0,0,0,0">  <!-- Full water (all 4 corners) -->
<tile id="1" terrain="0,0,,">    <!-- Top edge (only top 2 corners) -->
<tile id="2" terrain=",,0,0">    <!-- Bottom edge -->
<tile id="3" terrain="0,,0,">    <!-- Left edge -->
<tile id="4" terrain=",0,,0">    <!-- Right edge -->
<tile id="5" terrain="0,,,">     <!-- TL outer corner -->
...

Tiled AVTOMATIČNO izbere pravi tile based on okolico!

---

🚀 PERFORMANCE NOTES:

✅ OPTIMIZIRANO:

• Ground layer: Static (no CPU waste)
• Tall grass: Samo mali šopi (4 frames x ~100 tufts = OK)
• Water/Grass animations: Že prej implementirano (Water glimmer, Grass sway)

⚠️ WATCH OUT:

• NE animiraj celotnega ground layerja!
• NE dodaj previsokega števila tall grass tuftov (max ~200-300 tufts)
• Use layers strategically: Ground (static), Decorations (animated), Objects (interactive)

---

🎬 NEXT STEPS:

TI SI READY ZA TILED!

1. ✅ Odpri Faza1_Finalna.json v Tiledu
2. ✅ Uporabi Terrain Brush za mehke prehode
3. ✅ "Sadi" Tall Grass šope (harvestable!)
4. ✅ Test v igri → Kai požanje travo s koso!

KAJ ŠE RABIŠ?

• Scythe (kosa) mehanika v Phaseru?
• Več grass variants (rumena, mrtva, cvetoča)?
• Rock→Grass terrain set?
• Desert→Oasis terrain set?

---

📊 SUMMARY:

Asset	Tiles	Size	Features
Terrain_Sand_Water	47	512x96	Wang Blob, auto-tile
Terrain_Dirt_Grass	47	512x96	Wang Blob, auto-tile
Terrain_Grass_Water	47	512x96	Wang Blob, auto-tile
Tall_Grass_Animated	4	128x32	Wind sway, harvestable

TOTAL: 188 tiles generated! 🎉

ALL IMPORTED v Faza1_Finalna.json!

---

TI SI READY! ZAČNI 'SEJATI' ŽIVO TRAVO NA SVOJI KMETIJI! 🌾🚜