245 lines
5.8 KiB
Markdown
245 lines
5.8 KiB
Markdown
# 🎯 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!
|