# 🎯 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!

```bash
# 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!