novafarma/assets/maps/AUTO_TILING_CHECKLIST.md

# ✅ Auto-Tiling Quick Start Checklist

## 🎯 Cilj
Implementacija auto-tiling funkcionalnosti v Tiled Map Editor za NovaFarma assete.

---

## 📦 Kaj je bilo pripravljeno

### ✅ Ustvarjeni Files:
- [x] `grass_soil_autotile.tsx` - Trava + Zorana zemlja terrain
- [x] `fence_autotile.tsx` - Ograje Wang Set
- [x] `water_tileset_autotile.tsx` - Voda terrain
- [x] `grass_tileset_autotile.tsx` - Velika trava + Dirt paths terrain
- [x] `AUTO_TILING_VODIC.md` - Celovit vodič (SLO)
- [x] `TERRAIN_NOTATION_REFERENCE.md` - Quick reference
- [x] Posodobljen `tiled_autotiling_guide.md` v Knowledge Base

---

## 🚀 Naslednji Koraki (Zdaj je tvoj čas!)

### ⬜ STEP 1: Odpri Tiled
```
1. Zaženi Tiled Map Editor
2. File → Open
3. Izberi: c:\novafarma\assets\maps\micro_farm_8x8.tmx
```

### ⬜ STEP 2: Dodaj Auto-Tiling Tilesets
```
V Tilesets panelu (spodaj):
1. Klikni [+] gumb
2. Izberi "Import External Tileset"
3. Dodaj:
   ✓ grass_soil_autotile.tsx
   ✓ fence_autotile.tsx
   (opcijsko: water_tileset_autotile.tsx, grass_tileset_autotile.tsx)
```

### ⬜ STEP 3: Preveri Terrain Definitions
```
1. Klikni na grass_soil tileset
2. Na vrhu izberi "Terrains" tab
3. Videl bi moral:
   → Grass (zelena ikona)
   → TilledSoil (rjava ikona)
```

### ⬜ STEP 4: Testiraj Terrain Brush
```
1. Izberi "Ground" layer (desni panel)
2. Pritisni tipko [T] za Terrain Brush
3. V Terrains panelu izberi "Grass"
4. Riši po mapi
   → Opazil bi moral avtomatske robove! 🎉
```

### ⬜ STEP 5: Nariši Zorano Zemljo z Robovi
```
1. Izberi "TilledSoil" layer
2. Terrain Brush (T) → "TilledSoil"
3. Nariši 4×4 kvadrat
   → Avtomatski kotički in robovi! ✨
```

### ⬜ STEP 6: Dodaj Ograjo z Wang Brush
```
1. Izberi "Fences" layer
2. V Tilesets panelu izberi fence_autotile
3. Klikni "Wang Sets" tab
4. Izberi "Fence Connections"
5. Uporabi Wang Brush orodje (desno od Terrain Brush)
6. Nariši ograjo okoli plota
   → Avtomatski kotički in križi! 🚧
```

### ⬜ STEP 7: Izvozi in Testiraj
```
1. Map → Save (Ctrl+S)
2. File → Export As → JSON
3. Shrani kot: micro_farm_8x8_autotiled.json
4. Testiraj v Phaser (glej MICRO_FARM_VODIC.md)
```

---

## 🎨 Dodatne Opcije (Opcijska Razširitev)

### Dodaj Vodo
```
⬜ Dodaj water_tileset_autotile.tsx
⬜ Ustvari nov layer: "Water"
⬜ Terrain Brush → "Water"
⬜ Nariši ribnik ali reko
```

### Dodaj Dirt Paths
```
⬜ Dodaj grass_tileset_autotile.tsx
⬜ Ustvari layer: "DirtPaths"
⬜ Terrain Brush → "Dirt Path"
⬜ Riši poti med stavbami
```

### Dodaj Dekoracije
```
⬜ Layer: "Decorations"
⬜ Tileset: farm_obstacles
⬜ Ročno dodaj:
   - Skale (tile 33, 34, 42)
   - Podrta drevesa (tiles 41-42, 49-50)
   - Cvetlice (tile 36)
```

---

## 🆘 Če kaj ne dela

### Problem: "Ne vidim Terrains tab"
**Fix:** 
- Preveri, da si dodal `.tsx` file, ne `.png`
- Preveri Tiled verzijo (potrebuješ 1.10+)

### Problem: "Napačni tile-i se izberejo"
**Fix:**
- Odpri TSX file v text editorju
- Preveri ID numbers v `<tile id="X">`
- Prilagodi indexe, če se ne ujemajo s PNG layoutom

### Problem: "Terrain Brush ne dela"
**Fix:**
- Prepričaj se, da uporabljaš **Terrain Brush (T)**, ne Stamp Brush (B)
- Preveri, da je layer aktiven (desni panel)

---

## 📚 Pomoč in Dokumentacija

### Hitri Vodič:
```
📖 AUTO_TILING_VODIC.md           → Celovit slovenski vodič
📖 TERRAIN_NOTATION_REFERENCE.md  → Terrain syntax cheat sheet
📖 MICRO_FARM_VODIC.md            → Micro farm setup
```

### Vizualni Primeri:
```
🖼️ terrain_pattern_guide.png      → 3x3 terrain pattern
🖼️ autotiling_example_farm.png    → Before/After primer
```

### Knowledge Base:
```
📚 novafarma_technical_systems_implementation/
   └── tiled_autotiling_guide.md  → Tehnična dokumentacija
```

---

## 🎯 Success Criteria

Veš, da je uspešno, ko:

✅ **Terrain Brush avtomatsko izbere pravilne robove**
✅ **Kotički so gladki in se ujemajo**
✅ **Wang Brush naredi ograje z avtomatskimi T-križišči**
✅ **Izvožen JSON file pravilno prikaže v Phaser-u**
✅ **Ni seams ali napačnih tile-ov**

---

## ⏱️ Časovna Ocena

- **Tiled Setup:** 5 min
- **Prvi test (terrain brush):** 10 min
- **Nariši micro farm z auto-tiling:** 20 min
- **Dodaj ograje in dekoracije:** 15 min
- **Izvoz in testiranje:** 10 min

**Skupaj:** ~60 min za popolnoma funkcionalno auto-tiled micro farm 🚜

---

## 🌟 Pro Tips

1. **Save Often:** Auto-tiling lahko produkuje nepričakovane rezultate, redno shrani
2. **Test Small:** Najprej testiraj na majhnem območju (2×2), potem razširi
3. **Layer by Layer:** Naredi en layer naenkrat, ne mešaj
4. **Erase Tool:** Uporabi (E) za hitro odstranjevanje terrain-ov
5. **Fill Tool:** Shift+T za bucket fill z terrain-om

---

**Zdaj začni s STEP 1 in uživaj v auto-tiling magic!** ✨🎨

---

**Created:** 2025-12-19  
**Status:** Ready to Use  
**Difficulty:** Beginner-Friendly 🟢