novafarma/assets/tilesets_auto/README.md

🎉 USPEŠNO! TSX Datoteke za Tiled

Datum: 2025-12-21
Status: ✅ POPOLNOMA KONČANO

---

🎯 Kaj Smo Naredili

Uspešno generirali 3877 TSX datotek za vse ločene objekte, pripravljene za uporabo v Tiled Map Editor-ju!

---

📊 Rezultati

3877 TSX Datotek Generirano! 🚀

Vse TSX datoteke so v:

c:\novafarma\assets\tilesets_auto\

Vsaka TSX datoteka vsebuje:

• ✅ Pravilno XML strukturo za Tiled
• ✅ Relativno pot do slike
• ✅ Pravilno velikost tile-a (avtomatsko zaznano)
• ✅ Lepo ime tileseta

---

📂 Struktura

assets/
├── narezano_loceno/           (3877 ločenih PNG slik)
│   ├── topdown_objects/       (151 objektov)
│   ├── krvava_zetev_sprites/  (915 objektov)
│   └── tiled_sprites/         (2811 objektov)
│
└── tilesets_auto/             (3877 TSX datotek)
    ├── trees_topdown_pack_..._obj01.tsx
    ├── trees_topdown_pack_..._obj02.tsx
    └── ... (3877 datotek)

---

🎮 Uporaba v Tiled

Metoda 1: Dodaj Posamezen Tileset

1. Odpri svojo mapo v Tiled (npr. micro_farm_128x128.tmx)
2. Map → Add External Tileset...
3. Izberi TSX datoteko iz assets/tilesets_auto/
4. Tileset se prikaže v Tilesets panelu
5. Uporabi tile na mapi!

Metoda 2: Dodaj Več Tilesetov Naenkrat

Tiled omogoča dodajanje več tilesetov naenkrat:

1. Map → Add External Tileset...
2. Izberi več TSX datotek (Ctrl+Click ali Shift+Click)
3. Vsi tileseti se dodajo naenkrat

---

📝 Primer TSX Datoteke

Datoteka: trees_topdown_pack_1766184490476_obj01.tsx

<?xml version="1.0" encoding="UTF-8"?>
<tileset version="1.10" tiledversion="1.11.1" 
         name="trees_topdown_pack_1766184490476 - Object 01" 
         tilewidth="95" tileheight="120" 
         tilecount="1" columns="1">
 <image source="../narezano_loceno/topdown_objects/trees_topdown_pack_1766184490476_obj01.png" 
        width="95" height="120"/>
</tileset>

Kaj pomeni:

• name: Ime tileseta (prikazano v Tiled)
• tilewidth/tileheight: Velikost enega tile-a (avtomatsko zaznano iz slike)
• source: Relativna pot do PNG slike
• tilecount="1": En tile na tileset (vsak objekt je en tile)

---

🔍 Iskanje Tilesetov

Po Imenu

Vse TSX datoteke so poimenovane po izvorni sliki + številka objekta:

• trees_topdown_pack_..._obj01.tsx = Prvo drevo
• trees_topdown_pack_..._obj02.tsx = Drugo drevo
• farm_animals_family_grid_..._obj01.tsx = Prva žival
• itd.

Po Kategoriji

Lahko uporabiš Windows Explorer Search:

• Išči trees → Najde vse drevesa
• Išči animals → Najde vse živali
• Išči buildings → Najde vse zgradbe

---

🎨 Organizacija v Tiled

Priporočilo: Ustvari Skupine

V Tiled lahko organiziraš tilesete v skupine:

1. Drevesa (trees_topdown_pack_obj01-16)
2. Živali (farm_animals_family_grid_obj01-44)
3. Zgradbe (buildings_ruins_states_obj01-26)
4. Karakterji (kai_character, ana_character, itd.)
5. Predmeti (tools, weapons, itd.)

---

📐 Velikosti Tilesetov

Vsi tileseti so avtomatsko pomanjšani na 50% originalne velikosti.

Primeri velikosti:

• Majhni objekti (orodja): ~24x24px do 48x48px
• Srednji objekti (živali): ~48x48px do 96x96px
• Veliki objekti (drevesa, zgradbe): ~96x96px do 192x192px

---

🔧 Če Želiš Spremeniti

Regeneriraj TSX Datoteke

Če želiš spremeniti imena ali strukture TSX datotek:

python tools/generiraj_tsx_datoteke.py

Spremeni Velikost Slik

Če želiš spremeniti velikost slik (trenutno 50%):

1. Odpri tools/obdelaj_tilesete.py
2. Spremeni nova_velikost_faktor = 0.5 na želeno vrednost
3. Zaženi: python tools/obdelaj_tilesete.py
4. Regeneriraj TSX: python tools/generiraj_tsx_datoteke.py

---

🚀 Naslednji Koraki

1. Odpri Tiled Map Editor
2. Ustvari novo mapo ali odpri obstoječo
3. Dodaj tilesete iz assets/tilesets_auto/
4. Začni ustvarjati epic mape! 🎮

---

📊 Statistika

• Izvornih slik: 234
• Ločenih objektov: 3877
• TSX datotek: 3877
• Povprečno objektov na sliko: ~16.5
• Največje število objektov iz ene slike: 63 (biome_terrain_tiles)
• Čas generiranja: ~5 sekund

---

✨ Uspeh!

Zdaj imaš 3877 ločenih objektov in 3877 TSX datotek, vse pripravljeno za uporabo v Tiled! 🎮🌳🐄🏠

Vse je pripravljeno za ustvarjanje epic map! 🚀

---

Skripta:

• tools/obdelaj_tilesete.py - Ločevanje objektov in odstranjevanje zelenega ozadja
• tools/generiraj_tsx_datoteke.py - Generiranje TSX datotek

Rezultati:

• assets/narezano_loceno/ - Ločeni PNG objekti
• assets/tilesets_auto/ - TSX datoteke za Tiled

Naslednji korak: Odpri Tiled in začni ustvarjati! 🎨