# ✅ MASS TSX GENERATION - 3877 INDIVIDUAL OBJECTS

**Date**: 2025-12-22, 10:54  
**Script**: `scripts/generate_mass_tsx.py`  
**Status**: ⏳ PROCESSING...

---

## 🎯 CILJ

Generiranje **individualnih .tsx tileset datotek** za VSE 3877 ločenih objektov iz včerajšnjega narezovanja, da jih lahko neposredno uporabiš v Tiled Map Editorju.

---

## 📂 IZVORNE SLIKE

### Struktura:
```
assets/narezano_loceno/
├── topdown_objects/        (151 PNG datotek)
├── krvava_zetev_sprites/   (915 PNG datotek)
└── tiled_sprites/          (2811 PNG datotek)
```

**Total**: **3877 individualnih objektov!**

---

## 🔧 ŠTO DELA SCRIPT

Za vsako PNG sliko ustvari .tsx datoteko:

### Primer:
**Vhodna slika**: `assets/narezano_loceno/topdown_objects/trees_topdown_pack_1766184490476_obj01.png`

**Generirana TSX**: `assets/tilesets/individual_objects/trees_topdown_pack_1766184490476_obj01.tsx`

```xml
<?xml version="1.0" encoding="UTF-8"?>
<tileset version="1.10" tiledversion="1.11.0" name="trees_topdown_pack_1766184490476_obj01" tilewidth="128" tileheight="256" tilecount="1" columns="1">
 <image source="../../narezano_loceno/topdown_objects/trees_topdown_pack_1766184490476_obj01.png" width="128" height="256"/>
</tileset>
```

### Ključne lastnosti:
- ✅ **Auto-določanje dimenzij** (width/height iz slike)
- ✅ **Relativne poti** (`../../narezano_loceno/...`)
- ✅ **UTF-8-BOM encoding** za XML stabilnost
- ✅ **Unikaten name** za vsak tileset

---

## 📁 OUTPUT

**Lokacija**: `assets/tilesets/individual_objects/`

**Število datotek**: **3877 .tsx datotek**

Vsaka .tsx datoteka referencira svojo originalno PNG sliko z relativno potjo.

---

## 🎮 UPORABA V TILED

### Korak 1: Odpri Mapo
1. Zaženi **Tiled Map Editor**
2. Odpri svojo mapo (npr. `micro_farm_128x128.tmx`)

### Korak 2: Dodaj Tileset
1. Klikni **Map** → **Add External Tileset...**
2. Pojdi v: `assets/tilesets/individual_objects/`
3. Izberi .tsx datoteke, ki jih želiš uporabiti

### Korak 3: Uporabi Objekte
- Objekti se bodo prikazali v Tilesets panelu
- Drag & drop na mapo
- Vsak objekt je **samostojni tileset**

---

## ⚡ PERFORMANCE

### Obdelava:
- **Hitrost**: ~1000 datotek na minuto
- **Čas**: ~4 minute za vse 3877 datotek
- **RAM**: Nizka poraba (samo branje metapodatkov)

### Velikost Datotek:
- **Ena .tsx datoteka**: ~200-800 bytes
- **Skupna velikost**: ~2-3 MB za vse .tsx datoteke

---

## 📊 PROGRESS

| Mapa | PNG Datotek | TSX Generirano | Status |
|------|-------------|----------------|--------|
| `topdown_objects` | 151 | 151 | ✅ DONE |
| `krvava_zetev_sprites` | 915 | 915 | ✅ DONE |
| `tiled_sprites` | 2811 | ⏳ IN PROGRESS | 🔄 PROCESSING |
| **TOTAL** | **3877** | **?** | **⏳ ** |

---

## 🔍 TROUBLESHOOTING

### Problem: "Tileset path not found"
**Vzrok**: Relativna pot je nepravilna  
**Rešitev**: Prepričaj se, da je mapa na prave lokacije (assets/tilesets/individual_objects/)

### Problem: "Image dimensions wrong"
**Vzrok**: PNG slika je pokvarjena  
**Rešitev**: Ponovno generiraj sliko iz originala

### Problem: "Too many tilesets in Tiled"
**Vzrok**: Dodal si vse 3877 tilesets naenkrat  
**Rešitev**: Dodaj samo tilesets, ki jih potrebuješ za trenutno mapo

---

## 💡 PRIPOROČILA

### Za Manjše Mape (npr. 16x16):
Dodaj samo **10-50 tilesets** (najpogosteje uporabljeni objekti)

### Za Večje Mape (npr. 128x128):
Dodaj **50-200 tilesets** (različne kategorije)

### Za Testing:
Dodaj samo **5-10 tilesets** (preizkusite osnovne funkcije)

---

## 📂 ORGANIZACIJA TILESETOV

### Po Kategorijah:
- **Drevesa**: `tree_*`
- **Živali**: `farm_animals_*`, `mutant_animals_*`
- **Orodja**: `tools_*`
- **Zgradbe**: `buildings_*`, `city_*`
- **NPCs**: `npcs_*`, `ivan_*`, `marija_*`
- **DLC**: `dlc_*`

---

## ✅ NASLEDNJI KORAKI

1. **Počakaj da se script dokonča** (~4 minute)
2. **Preveri število datotek**: `assets/tilesets/individual_objects/` (should have 3877 .tsx files)
3. **Odpri Tiled** in preizkusi dodajanje tilesetov
4. **Začni ustvarjati mapo** z uporablnimi objekti!

---

**Script**: `scripts/generate_mass_tsx.py`  
**Output**: `assets/tilesets/individual_objects/`  
**Status**: ⏳ PROCESSING (waiting for completion...)