novafarma/assets/maps/AUTO_TILING_VODIC.md

🎨 Auto-Tiling v Tiled - Praktični Vodič

📋 Kaj je bilo narejeno

Ustvarjeni so bili TSX tileset files z integriranimi Terrain Sets in Wang Sets za avtomatično tiling:

✅ Pripravljeni Tilesets:

1. grass_soil_autotile.tsx - Trava in zorana zemlja
2. fence_autotile.tsx - Ograje (Wang Set)
3. water_tileset_autotile.tsx - Voda
4. grass_tileset_autotile.tsx - Velika trava z dirt paths

---

🚀 Kako Uporabiti Auto-Tiling (Korak za Korakom)

KORAK 1: Odpri Tiled in Naloži Tileset

1. Odpri Tiled Map Editor
2. File → Open → Izberi micro_farm_8x8.tmx
3. V Tilesets panelu (spodaj desno):
   • Klikni "+" (Add Tileset)
   • Import External Tileset
   • Izberi grass_soil_autotile.tsx

KORAK 2: Preveri Terrain Definicije

1. V Tilesets panelu izberi grass_soil
2. Na vrhu bi moral videti Terrains tab
3. Tam so definirani:
   • Grass (zelena)
   • TilledSoil (rjava zorana zemlja)

KORAK 3: Uporabi Terrain Brush

1. Na levi orodni vrstici izberi Terrain Brush orodje
   • Ikona z 4 pikami v kvadratu
   • Bližnjica: T
2. V Terrains panelu (lahko pod Tilesets) izberi "Grass"
3. Riši na mapi - Tiled bo avtomatsko izbral pravilne robove!

KORAK 4: Paint z Različnimi Terrains

Uporaba Trave:

1. Izberi Terrain Brush (T)
2. Izberi "Grass" terrain
3. Riši po Ground layerju
→ Avtomatsko dodaja robove in kotičke!

Uporaba Zorane Zemlje:

1. Izberi Terrain Brush (T)
2. Izberi "TilledSoil" terrain
3. Riši po TilledSoil layerju
→ Lepo narisan plot z robovi!

---

🔧 Napredno: Wang Sets za Ograje

Uporaba Fence Auto-Tiling:

Ograje uporabljajo Wang Sets za povezane strukture.

1. Dodaj fence_autotile.tsx v tvojo mapo
2. V Tilesets panelu izberi fence_autotile
3. Na vrhu klikni Wang Sets tab
4. Izberi "Fence Connections" wang set
5. Uporabi Wang Brush (ikona z vzorci)
6. Riši ograje - avtomatsko se bodo povezale!

Wang Brush Orodje:

• Avtomatsko izbere:
  • Kotičke (Top-Left, Top-Right, Bottom-Left, Bottom-Right)
  • T-križišča
  • 4-way križišča
  • Ravne horizontalne/vertikalne dele

---

🎯 Primeri Uporabe

Primer 1: Narisi Travnato Polje z Urejenim Plotom

1. Layer: Ground
   → Terrain Brush → "Grass" → Pobarvi celotno mapo

2. Layer: TilledSoil  
   → Terrain Brush → "TilledSoil" → Nariši 4x4 kvadrat
   → Tiled bo AVTOMATSKO dodal robove in kotičke!

3. Layer: Fences
   → Wang Brush → "Fence Connections" → Nariši ograjo okrog plota
   → Avtomatsko nastanejo pravilni kotički!

Primer 2: Dodaj Vodo z Robovi

1. Dodaj tileset: water_tileset_autotile.tsx
2. Novi layer: WaterLayer
3. Terrain Brush → "Water" → Nariši jezero
   → Robovi se avtomatsko ujemajo s kopnim!

Primer 3: Dirt Path skozi Travo

1. Tileset: grass_tileset_autotile.tsx
2. Layer: Ground → Terrain Brush → "Grass" (pobarvi vse)
3. Layer: Paths → Terrain Brush → "Dirt Path" → Riši pot
   → Avtomatski prehodi med travo in potjo!

---

🛠️ Troubleshooting

❌ Problem: "Terrain ne dela"

Rešitev:

• Preveri, da si naložil TSX file (ne samo PNG)
• File → Reload Tileset
• Preveri, da uporabljaš Terrain Brush (T), ne Stamp Brush (B)

❌ Problem: "Napačni tile-i"

Rešitev:

• Tile IDs v TSX mogoče ne ustrezajo dejanskemu PNG layoutu
• Odpri TSX v text editorju in prilagodi tile id="X" številke

❌ Problem: "Wang Sets ni viden"

Rešitev:

• Prepričaj se, da uporabljaš Tiled 1.10+
• Wang Sets delujejo samo za določene tipe povezav (ograje, cevi)

---

📐 Terrain Notation Explained

Tiled uporablja 4-corner notation za terrain:

Format: "TopLeft,TopRight,BottomLeft,BottomRight"

Primeri:
- "0,0,0,0" = Vse 4 kote pripadajo terrainu 0 (FILL)
- ",,,0"    = Samo BottomRight kot (TOP-LEFT edge tile)
- ",,0,0"   = Oba spodnja kota (TOP edge tile)
- "0,,,0"   = Levi koti (RIGHT edge tile)

---

🎨 Naslednji Koraki

• Odpri micro_farm_8x8.tmx
• Dodaj vse 4 TSX tilesets
• Preizkusi Terrain Brush na Ground layerju
• Nariši zorano zemljo z avtomatskimi robovi
• Dodaj ograjo z Wang Brush
• Nariši vodo ali dirt path
• Izvozi kot JSON za testiranje v igri

---

💡 Pro Tips

1. Kombiniraj Terrains: Najprej nariši Background Grass, potem dodaj Dirt Path za lepe prehode
2. Layer Vrstni Red: Ground → Paths → TilledSoil → Fences → Decorations
3. Variacije: Kombiniraj auto-tiling z ročno dodanimi flower tiles za raznolikost
4. Erase Terrain: Uporabi Eraser Tool (E) za odstranjevanje terrain-ov
5. Fill Tool: Terrain Bucket Fill (Shift+T) za hitro polnjenje velikih območij

---

Zdaj go create beautiful auto-tiled maps! 🎨✨