novafarma/docs/MASS_TSX_GENERATION.md

✅ 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 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...)