Tileset organization system - 25 TSX files + comprehensive workflow docs
This commit is contained in:
244
docs/TILED_QUICK_START.md
Normal file
244
docs/TILED_QUICK_START.md
Normal file
@@ -0,0 +1,244 @@
|
||||
# 🎯 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!
|
||||
Reference in New Issue
Block a user