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)

// 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! 🎮✨