chore: Update LDtk project with new layers and fixed assets dimensions (using sips)
This commit is contained in:
172
.agent/workflows/full_terrain_tall_grass_guide.md
Normal file
172
.agent/workflows/full_terrain_tall_grass_guide.md
Normal file
@@ -0,0 +1,172 @@
|
||||
# 🎬 FILMIČNI TERRAIN + TALL GRASS - FINAL REPORT
|
||||
|
||||
## ✅ KAJ JE NAREJENO:
|
||||
|
||||
### 1. 🌊 **FULL 47-TILE WANG BLOB TERRAIN SETS**
|
||||
- ✅ **Terrain_Sand_Water.tsx** (47 tiles, smooth transitions)
|
||||
- ✅ **Terrain_Dirt_Grass.tsx** (47 tiles, smooth transitions)
|
||||
- ✅ **Terrain_Grass_Water.tsx** (47 tiles, smooth transitions)
|
||||
|
||||
**KAKO DELUJE:**
|
||||
- Standard Wang Blob pattern (kot v Clear Code tutorialu)
|
||||
- 16x3 grid (48 tiles, zadnji prazen)
|
||||
- Avtomatični terrain brush v Tiledu
|
||||
- ULtra smooth alpha-blended edges (Gaussian blur, NO kocke!)
|
||||
|
||||
### 2. 🌾 **TALL GRASS ANIMATED**
|
||||
- ✅ **Tall_Grass_Animated.tsx** (4 frames, wind sway)
|
||||
- ✅ Transparent background (prosojen backdrop)
|
||||
- ✅ Harvestable property: `isHarvestable: true`
|
||||
- ✅ NO LSD glitching (gentle sway: -2px, 0px, +2px)
|
||||
|
||||
**KAKO DELUJE:**
|
||||
- Posamezni šopi visoke trave (24x28px tufts)
|
||||
- Wind animacija (250ms/frame = smooth)
|
||||
- Stardew-style harvesting (Kai lahko požanje s koso!)
|
||||
- Low performance impact (samo šopi, ne celotna tla!)
|
||||
|
||||
### 3. 🎮 **STATIC GROUND LAYER**
|
||||
- ✅ Podlaga (Ground layer) ostane **STATIČNA**
|
||||
- ✅ NO animation waste (Macbook prihrani moč)
|
||||
- ✅ Samo tall grass šopi so animirani (performance win!)
|
||||
|
||||
### 4. 🗺️ **FAZA1_FINALNA.JSON - UPDATED**
|
||||
- ✅ Vsi novi tilesets so dodani:
|
||||
- `Terrain_Sand_Water.tsx` (GID: 14430)
|
||||
- `Terrain_Dirt_Grass.tsx` (GID: 14477)
|
||||
- `Terrain_Grass_Water.tsx` (GID: 14524)
|
||||
- `Tall_Grass_Animated.tsx` (GID: 14571)
|
||||
|
||||
---
|
||||
|
||||
## 📂 DODANE DATOTEKE:
|
||||
|
||||
```
|
||||
✅ /scripts/generate_full_terrain_sets.py ← 47-tile Wang Blob generator
|
||||
✅ /scripts/generate_tall_grass.py ← Tall grass tuft generator
|
||||
|
||||
✅ /assets/maps/tilesets/Terrain_Sand_Water.png (512x96px, 47 tiles)
|
||||
✅ /assets/maps/tilesets/Terrain_Sand_Water.tsx
|
||||
✅ /assets/maps/tilesets/Terrain_Dirt_Grass.png (512x96px, 47 tiles)
|
||||
✅ /assets/maps/tilesets/Terrain_Dirt_Grass.tsx
|
||||
✅ /assets/maps/tilesets/Terrain_Grass_Water.png (512x96px, 47 tiles)
|
||||
✅ /assets/maps/tilesets/Terrain_Grass_Water.tsx
|
||||
✅ /assets/maps/tilesets/Tall_Grass_Animated.png (128x32px, 4 frames)
|
||||
✅ /assets/maps/tilesets/Tall_Grass_Animated.tsx
|
||||
|
||||
✅ /assets/maps/Faza1_Finalna.json (Updated with all new tilesets)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎮 KAKO UPORABITI V TILEDU:
|
||||
|
||||
### A) TERRAIN BRUSH (Smooth Transitions):
|
||||
|
||||
1. **Odpri Tiled** → `Faza1_Finalna.json`
|
||||
2. V **Tilesets** panelu vidiš vse 3 terrain sete
|
||||
3. Izberi npr. **Terrain_Grass_Water**
|
||||
4. V **Terrains** tab klikni **"Primary"** terrain
|
||||
5. Izberi **Terrain Brush** (ikona "T")
|
||||
6. **Riši čez travo** → Voda dobi **smooth edges!** 🎬
|
||||
|
||||
**REPEAT** za Sand→Water in Dirt→Grass!
|
||||
|
||||
### B) TALL GRASS (Harvestable Tufts):
|
||||
|
||||
1. V **Layers** ustvari **nov layer**: "Tall_Grass" (nad Ground layer!)
|
||||
2. V **Tilesets** izberi **Tall_Grass_Animated**
|
||||
3. Izberi **Stamp Brush** (normal brush)
|
||||
4. **Paint grass tufts** kjer želiš (forests, fields, itd.)
|
||||
5. V igri → Kai lahko **požanje s koso!** ✂️
|
||||
|
||||
### C) GROUND LAYER (Static):
|
||||
|
||||
1. **Ground layer** naj uporablja **navadno grass.png** (NO animation!)
|
||||
2. **NE** uporabljaj Grass_Animated.tsx za ground layer!
|
||||
3. **Samo** Tall_Grass_Animated za posamezne šope!
|
||||
|
||||
---
|
||||
|
||||
## 🎨 WANG BLOB TERRAIN SYSTEM (Technical):
|
||||
|
||||
### Tile Layout (16x3 grid):
|
||||
|
||||
```
|
||||
Row 0: Basic tiles (center, edges, outer corners)
|
||||
0: Full terrain 5: TL outer corner
|
||||
1: Top edge 6: TR outer corner
|
||||
2: Bottom edge 7: BL outer corner
|
||||
3: Left edge 8: BR outer corner
|
||||
4: Right edge ...
|
||||
|
||||
Row 1: Complex edges (U-shapes, multi-corners)
|
||||
16-31: Various combinations
|
||||
|
||||
Row 2: Special cases + fill tiles
|
||||
32-46: Inner corners, fill tiles
|
||||
```
|
||||
|
||||
### Terrain Notation (TSX):
|
||||
|
||||
```xml
|
||||
<tile id="0" terrain="0,0,0,0"> <!-- Full water (all 4 corners) -->
|
||||
<tile id="1" terrain="0,0,,"> <!-- Top edge (only top 2 corners) -->
|
||||
<tile id="2" terrain=",,0,0"> <!-- Bottom edge -->
|
||||
<tile id="3" terrain="0,,0,"> <!-- Left edge -->
|
||||
<tile id="4" terrain=",0,,0"> <!-- Right edge -->
|
||||
<tile id="5" terrain="0,,,"> <!-- TL outer corner -->
|
||||
...
|
||||
```
|
||||
|
||||
**Tiled AVTOMATIČNO** izbere pravi tile based on okolico!
|
||||
|
||||
---
|
||||
|
||||
## 🚀 PERFORMANCE NOTES:
|
||||
|
||||
### ✅ OPTIMIZIRANO:
|
||||
- **Ground layer**: Static (no CPU waste)
|
||||
- **Tall grass**: Samo mali šopi (4 frames x ~100 tufts = OK)
|
||||
- **Water/Grass animations**: Že prej implementirano (Water glimmer, Grass sway)
|
||||
|
||||
### ⚠️ WATCH OUT:
|
||||
- **NE** animiraj celotnega ground layerja!
|
||||
- **NE** dodaj previsokega števila tall grass tuftov (max ~200-300 tufts)
|
||||
- **Use layers strategically**: Ground (static), Decorations (animated), Objects (interactive)
|
||||
|
||||
---
|
||||
|
||||
## 🎬 NEXT STEPS:
|
||||
|
||||
**TI SI READY ZA TILED!**
|
||||
|
||||
1. ✅ Odpri `Faza1_Finalna.json` v Tiledu
|
||||
2. ✅ Uporabi Terrain Brush za mehke prehode
|
||||
3. ✅ "Sadi" Tall Grass šope (harvestable!)
|
||||
4. ✅ Test v igri → Kai požanje travo s koso!
|
||||
|
||||
**KAJ ŠE RABIŠ?**
|
||||
- Scythe (kosa) mehanika v Phaseru?
|
||||
- Več grass variants (rumena, mrtva, cvetoča)?
|
||||
- Rock→Grass terrain set?
|
||||
- Desert→Oasis terrain set?
|
||||
|
||||
---
|
||||
|
||||
## 📊 SUMMARY:
|
||||
|
||||
| Asset | Tiles | Size | Features |
|
||||
|-------|-------|------|----------|
|
||||
| Terrain_Sand_Water | 47 | 512x96 | Wang Blob, auto-tile |
|
||||
| Terrain_Dirt_Grass | 47 | 512x96 | Wang Blob, auto-tile |
|
||||
| Terrain_Grass_Water | 47 | 512x96 | Wang Blob, auto-tile |
|
||||
| Tall_Grass_Animated | 4 | 128x32 | Wind sway, harvestable |
|
||||
|
||||
**TOTAL**: 188 tiles generated! 🎉
|
||||
|
||||
**ALL IMPORTED** v `Faza1_Finalna.json`!
|
||||
|
||||
---
|
||||
|
||||
**TI SI READY! ZAČNI 'SEJATI' ŽIVO TRAVO NA SVOJI KMETIJI! 🌾🚜**
|
||||
Reference in New Issue
Block a user