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:

• grass_soil_autotile.tsx - Trava + Zorana zemlja terrain
• fence_autotile.tsx - Ograje Wang Set
• water_tileset_autotile.tsx - Voda terrain
• grass_tileset_autotile.tsx - Velika trava + Dirt paths terrain
• AUTO_TILING_VODIC.md - Celovit vodič (SLO)
• TERRAIN_NOTATION_REFERENCE.md - Quick reference
• 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 🟢