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**

```xml
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**

```xml
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**

```xml
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!** 🎨✨