Added Tiled auto-tiling system + TOP-DOWN assets

- Created 4 TSX tilesets with terrain/wang set definitions
- grass_soil_autotile.tsx (terrain-based)
- fence_autotile.tsx (wang set)
- water_tileset_autotile.tsx
- grass_tileset_autotile.tsx

Documentation:
- AUTO_TILING_VODIC.md (Slovenian guide)
- TERRAIN_NOTATION_REFERENCE.md
- AUTO_TILING_CHECKLIST.md
- AUTO_TILING_SESSION_SUMMARY.md
- Updated MICRO_FARM_VODIC.md
- Updated DNEVNIK.md

Generated TOP-DOWN sprite sheets (7 packs):
- town_buildings_topdown.png
- trees_topdown_pack.png
- rocks_obstacles_topdown.png
- mine_entrances_topdown.png
- starting_camp_topdown.png
- farm_structures_topdown.png
- buildings_ruins_states.png (3 states per building)

Organized 60 Krvava Zetev sprites in krvava_zetev_sprites folder
All assets vibrant colors, NO grays, ready for Tiled!
This commit is contained in:
2025-12-19 23:58:25 +01:00
parent befbd74b69
commit 7cc66d0e2b
203 changed files with 1653 additions and 0 deletions

View File

@@ -0,0 +1,179 @@
# 🎨 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!** 🎨✨