novafarma/docs/TILED_QUICK_START.md

🎯 QUICK START: Tiled Import

NovaFarma / Krvava Žetev
TASK 1: Import Tilesets (30 minutes)

---

✅ PREREQUISITES

• ✅ Tiled Map Editor installed
• ✅ 25 TSX files ready at: c:/novafarma/assets/maps/organized_tilesets/
• ✅ 122 sprite sheets available
• ✅ 3,877 individual objects processed

---

🚀 STEP-BY-STEP GUIDE

STEP 1: Open Tiled (1 minute)

1. Launch Tiled Map Editor
2. File → New → New Map...
3. Settings:
   • Orientation: Orthogonal
   • Tile layer format: Base64 (zlib compressed)
   • Tile render order: Right Down
   • Map size: 128 × 128 tiles
   • Tile size: 48 × 48 px
4. Click Save As: main_world_128x128.tmx
   • Location: c:/novafarma/assets/maps/

---

STEP 2: Import Character Tilesets (10 minutes)

1. Map → Add External Tileset...
2. Navigate to: c:/novafarma/assets/maps/organized_tilesets/01_Characters_NPCs/
3. Select all 8 files (Ctrl+Click):

   ☑ kai_character_2x2_grid_1766098341666.tsx
   ☑ ana_character_2x2_grid_1766098371171.tsx
   ☑ lena_farmer_2x2_grid_1766098603722.tsx
   ☑ marija_baker_2x2_grid_1766098547935.tsx
   ☑ ivan_blacksmith_2x2_grid_1766098520072.tsx
   ☑ jakob_trader_2x2_grid_1766098576532.tsx
   ☑ dr_chen_doctor_2x2_grid_1766098631185.tsx
   ☑ dr_krnic_villain_2x2_grid_1766099043511.tsx
   

4. Click Open

✅ Verify:

• All 8 tilesets appear in Tilesets panel (bottom-right)
• Each shows 10×10 grid of character sprites
• No red "missing file" errors

---

STEP 3: Import Animals & Pets (5 minutes)

1. Map → Add External Tileset...
2. Navigate to: 02_Animals_Pets/
3. Select all 4 files:

   ☑ farm_animals_family_grid_1766099078030.tsx
   ☑ dog_companions_5_breeds_1766096740462.tsx
   ☑ rare_livestock_animals_1766096790785.tsx
   ☑ delivery_creatures_bat_owl_1766097497616.tsx
   

4. Click Open

---

STEP 4: Import Environment (3 minutes)

1. Navigate to: 04_Environment_Terrain/
2. Import: grass_soil_tileset_1766171156780.tsx

---

STEP 5: Import Crops (2 minutes)

1. Navigate to: 05_Crops_Farming/
2. Import: seasonal_seed_packets_1766097126381.tsx

---

STEP 6: Import Monsters (3 minutes)

1. Navigate to: 18_Monsters_Bosses/
2. Select all 3 files:

   ☑ slimes_8_types_pack_1766096713230.tsx
   ☑ giant_troll_king_boss_1766097563405.tsx
   ☑ grok_fabulous_complete_sprite_1766097599612.tsx
   

---

STEP 7: (Optional) Import DLC Content (6 minutes)

Only if you want to work on DLC maps:

10_DLC_Dino_World/      → dinosaurs_animation_strips.tsx
11_DLC_Mythical/        → mythical_creatures_pack.tsx
13_DLC_Egypt/           → egyptian_structures_pack.tsx + pyramids.tsx
14_DLC_Atlantis/        → atlantis_objects_pack.tsx
15_DLC_Chernobyl/       → anomalous_creatures.tsx

---

STEP 8: Verify All Tilesets (1 minute)

Check Tilesets panel:

• ✅ 15+ tilesets loaded
• ✅ All show preview images
• ✅ No missing file errors
• ✅ Can select tiles

---

🎨 TEST: Place a Character

1. Select kai_character_2x2_grid tileset
2. Click first sprite (frame 0)
3. Select Stamp Brush tool (B)
4. Click on map to place Kai
5. Success! Character appears on map

---

🎬 NEXT: Setup Animations

Once all tilesets are imported, proceed to Animation Setup:

Character Walk Animation (Example: Kai)

1. In Tilesets panel, select kai_character_2x2_grid
2. Right-click on tile 0 → Tile Animation Editor
3. Add frames:

   Frame 0 (tile 0)   → 150ms
   Frame 1 (tile 1)   → 150ms
   Frame 2 (tile 2)   → 150ms
   Frame 3 (tile 3)   → 150ms
   

4. Click OK
5. Place animated tile on map → Verify it animates!

Repeat for:

• Down walk (row 1: tiles 0-3)
• Left walk (row 2: tiles 10-13)
• Right walk (row 3: tiles 20-23)
• Up walk (row 4: tiles 30-33)

---

📊 COMPLETION CHECKLIST

Core Tilesets (Priority ⭐⭐⭐)

• Characters & NPCs (8 files) ✅ Imported
• Animals & Pets (4 files)
• Environment Terrain (1 file)
• Crops & Farming (1 file)
• Monsters & Bosses (3 files)

DLC Tilesets (Priority ⭐⭐)

• Dino World (1 file)
• Mythical Highlands (1 file)
• Egypt (2 files)
• Atlantis (1 file)
• Chernobyl (1 file)

Animations (Priority ⭐⭐⭐)

• Character walks (8 × 4 = 32 animations)
• Tree growth (4 species)
• Crop growth (10+ crops)

Maps Created

• Main world (128×128 or 500×500)
• Starter farm (16×16)
• DLC maps (8 maps)

---

⏱️ TIME ESTIMATE

Task	Duration
Import core tilesets	15 min
Import DLC tilesets	10 min
Setup character animations	30 min
Setup crop/tree animations	20 min
TOTAL	~75 min

---

🆘 TROUBLESHOOTING

❌ "Cannot find tileset image"

Solution: Check that PNG files exist in correct location:

c:/novafarma/assets/krvava_zetev_sprites/

❌ Tileset shows red placeholder

Solution: Right-click tileset → Tileset Properties → Fix image path

❌ Animation doesn't play

Solution:

1. Verify animation defined in Tile Animation Editor
2. Check "Loop" is enabled for walk cycles
3. Test by placing tile on map (animations auto-play)

❌ Tiles are wrong size

Solution:

• Characters should be 96×96 (2×2 grid)
• Terrain should be 48×48
• Edit TSX file if needed: tilewidth="96" tileheight="96"

---

✅ SUCCESS!

Once complete, you'll have:

• ✅ 25 tilesets imported
• ✅ 122 sprite sheets accessible
• ✅ Animations configured
• ✅ Ready to design maps!

Next: Export map to JSON and test in Phaser!

# Export map
File → Export As → JSON map files (*.tmj *.json)

# Test in game
npm run dev
# Open: http://localhost:8080

---

STATUS: 🎯 READY TO START IMPORTING!