novafarma/TILED_WORKFLOW.md

# 🗺️ TILED WORKFLOW - Praktični nasveti za Mac

## 📁 Organizacija Datotek

### Folder Struktura
```
novafarma/
├── assets/
│   ├── maps/
│   │   ├── NovaFarma.tmx          ← FAZA 1: Demo (8x8)
│   │   ├── Mesto.tmx              ← FAZA 2: Town Square
│   │   ├── DinoValley.tmx         ← FAZA 3: Portal zone
│   │   ├── MythicalHighlands.tmx  ← FAZA 3: Portal zone
│   │   ├── EndlessForest.tmx      ← FAZA 3: Portal zone
│   │   └── Chernobyl.tmx          ← FAZA 4: Final zone
│   │
│   └── tilesets/
│       ├── Master.tsx             ← Shared assets (Kai, ground, basics)
│       ├── DinoValley.tsx         ← Zone-specific (dinosaurs, palms)
│       ├── Mythical.tsx           ← Zone-specific (unicorns, pegasus)
│       └── Chernobyl.tsx          ← Zone-specific (radiation)
```

---

## ⚡ Hitri Start - FAZA 1 Demo

### Koraki v Tiled:

1. **Odpri Tiled**
   - Mac: Applications → Tiled

2. **Nova Mapa**
   - File → New → New Map
   - Orientation: Orthogonal (2D top-down)
   - Tile size: 48x48 px
   - Map size: 8 tiles wide × 8 tiles high
   - Shrani kot: `NovaFarma.tmx`

3. **Uvozi Tileset**
   - Map → New Tileset
   - Name: "Ground"
   - Tile size: 48x48
   - Source: `../tilesets/01_Ground.tsx`
   - Import sliko: `ground_tiles.png`

4. **Nariši Zemljo**
   - Izberi brown tile (dirt)
   - Bucket tool (G)
   - Fill vse 8x8 kocke

5. **Dodaj Šotor**
   - New object layer: "Objects"
   - Insert tile (T)
   - Postavi tent sprite
   - Position: (2, 2) - zgornji levi del

6. **Izvozi**
   - File → Export As... → JSON
   - Shrani: `NovaFarma.json`

---

## 🎨 Tileset Tips

### Master Tileset (Shared)
**Kaj gre vanj:**
- Ground tiles (dirt, grass, stone, water)
- Basic objects (trees, rocks, bushes)
- Kai sprite (character)
- Grok sprite
- Susi sprite
- Basic zombie sprite

**Prednost:** Naloži 1x, uporabljaj povsod = hitrejše!

### Zone-Specific Tilesets
**Kdaj narediš novega:**
- Stvari ki so samo v 1 zoni
- Primer: Dinosaurs samo v Dino Valley
- Primer: Radiation signs samo v Chernobyl

---

## 💻 Antigravity Integration

### Loading .tmx v Phaser (Koda)
```javascript
// main.js
preload() {
    // Load tilemap
    this.load.tilemapTiledJSON('novafarma', 'assets/maps/NovaFarma.json');
    
    // Load tileset image
    this.load.image('ground_tiles', 'assets/tilesets/ground_tiles.png');
}

create() {
    // Create map
    const map = this.make.tilemap({ key: 'novafarma' });
    
    // Add tileset
    const tiles = map.addTilesetImage('Ground', 'ground_tiles');
    
    // Create layer
    const layer = map.createLayer('Ground', tiles, 0, 0);
}
```

---

## ⚠️ Tipične Napake (Izogni se!)

### ❌ NAROBE:
- Ena gigantska mapa za VSO igro
- Vse sprites v Master tileset
- Različne tile sizes (32px, 48px, 64px mešano)
- Pozabi izvozit kot JSON

### ✅ PRAVILNO:
- Vsaka zona svoja .tmx datoteka
- Samo shared assets v Master
- Vedno 48x48 tile size
- Vedno izvozi JSON ob shranjevanju

---

## 🚀 Quick Commands

### Tiled Shortcuts (Mac):
- **B** - Brush (paint tiles)
- **G** - Bucket fill
- **E** - Eraser
- **T** - Insert tile (object)
- **Cmd+Z** - Undo
- **Cmd+Shift+E** - Export as JSON

---

## 📊 Demo Checklist:

- [ ] Nova mapa: `NovaFarma.tmx` (8x8)
- [ ] Ground layer (brown dirt tiles)
- [ ] Objects layer (tent, 1 field)
- [ ] Kai spawn point (object)
- [ ] Zombie spawn point (object)
- [ ] Grok spawn point (easter egg)
- [ ] Susi spawn point (easter egg)
- [ ] Izvoz kot JSON
- [ ] Test v Phaser (load map)

---

**PRIORITETA:** Naredi samo to kar rabiš ZA DEMO!  
**Ne dodajaj:** Fancy stuff ki ni v FAZA 1!

**Začni ZDAJ!** 🎮✨