novafarma/assets/narezano_in_majhno/KAKO_UPORABITI.md

🎮 Kako Uporabiti Obdelane Tilesete v Tiled

✅ Kaj Smo Naredili

Uspešno smo obdelali 234 tileset slik iz treh map:

• topdown_objects (7 slik)
• krvava_zetev_sprites (60 slik)
• tiled_sprites (180 slik)

Vse slike so zdaj:

• ✂️ Narezane (odstranjen prazen prostor)
• 📏 Pomanjšane na 50% originalne velikosti
• 💾 Shranjene v assets/narezano_in_majhno/

---

🚀 Naslednji Koraki

1️⃣ Preglej Obdelane Slike

Odpri mapo in preveri, ali so slike pravilno obdelane:

c:\novafarma\assets\narezano_in_majhno\

2️⃣ Ustvari TSX Datoteke za Tiled

Za vsako sliko, ki jo želiš uporabiti v Tiled, ustvari .tsx datoteko:

Primer: kai_character_2x2_grid_1766098371171_obdelan.png

Ustvari datoteko: assets/tilesets/kai_character_obdelan.tsx

<?xml version="1.0" encoding="UTF-8"?>
<tileset version="1.10" tiledversion="1.11.1" name="Kai Character (Obdelan)" tilewidth="96" tileheight="96" tilecount="1" columns="1">
 <image source="../narezano_in_majhno/krvava_zetev_sprites/kai_character_2x2_grid_1766098371171_obdelan.png" width="96" height="96"/>
</tileset>

Pomembno:

• tilewidth in tileheight morata biti velikost enega tile-a (ne celotne slike!)
• Če je slika 96x96px in je to en objekt, uporabi tilewidth="96" tileheight="96"
• Če je slika 192x192px in vsebuje 2x2 grid (4 tile-e), uporabi tilewidth="96" tileheight="96"

3️⃣ Dodaj Tileset v Tiled Mapo

1. Odpri svojo mapo (npr. micro_farm_128x128.tmx)
2. Klikni Map → Add External Tileset...
3. Izberi .tsx datoteko, ki si jo ustvaril
4. Tileset se bo prikazal v Tilesets panelu

4️⃣ Uporabi v Mapi

1. Izberi tileset v Tilesets panelu
2. Izberi tile, ki ga želiš postaviti
3. Klikni na mapo, kjer želiš postaviti tile
4. Tile se bo prikazal na mapi!

---

📐 Priporočene Velikosti za Tiled

Glede na tvoj projekt (48x48px ground tiles):

Objekti na Mapi

• Majhni objekti (orodja, predmeti): 48x48px (1x1 tile)
• Srednji objekti (šotor, ogenj): 96x96px (2x2 tiles)
• Veliki objekti (hiše, drevesa): 144x144px ali 192x192px (3x3 ali 4x4 tiles)

Če Želiš Spremeniti Velikost

Če so obdelane slike še vedno prevelike/premajhne:

1. Odpri tools/obdelaj_tilesete.py
2. Spremeni nova_velikost_faktor:

   nova_velikost_faktor = 0.3  # Za 30% (manjše)
   nova_velikost_faktor = 0.7  # Za 70% (večje)
   

3. Zaženi ponovno:

   python tools/obdelaj_tilesete.py
   

---

🎨 Primeri Uporabe

Primer 1: Dodaj Kai Karakterja

1. Ustvari assets/tilesets/kai_obdelan.tsx
2. Dodaj v micro_farm_128x128.tmx
3. Postavi na mapo kot Object Layer (ne Tile Layer!)

Primer 2: Dodaj Orodja Pack

1. Ustvari assets/tilesets/tools_pack_obdelan.tsx
2. Če je na sliki več orodij (grid), nastavi tilewidth in tileheight na velikost enega orodja
3. Dodaj v mapo in izberi posamezno orodje iz grida

Primer 3: Dodaj Zgradbe

1. Ustvari assets/tilesets/buildings_obdelan.tsx
2. Če je zgradba večja (npr. 192x192px), nastavi tilewidth="192" tileheight="192"
3. Dodaj kot Object (ne Tile!), da lahko postaviš na poljubno pozicijo

---

🔧 Avtomatizacija (Opcijsko)

Če želiš avtomatsko generirati TSX datoteke za vse obdelane slike:

# Ustvari tools/generiraj_tsx.py
# Ta skript bo avtomatsko ustvaril .tsx datoteke za vse slike v narezano_in_majhno/

Ali pa mi povej, če želiš, da ti ustvarim ta skript! 😊

---

📝 Troubleshooting

Problem: Slika je preveč narezana

• Zmanjšaj min_velikost_objekta v obdelaj_tilesete.py

Problem: Slika je še vedno prevelika

• Zmanjšaj nova_velikost_faktor (npr. na 0.3)

Problem: Na sliki je več objektov, a so vsi skupaj

• Skript poskuša najti ločene objekte glede na prosojnost
• Če so objekti povezani, jih bo obdelal kot en objekt
• Ročno narezovanje v Photoshop/GIMP je najboljša opcija

---

Srečno z ustvarjanjem map! 🎮✨