novafarma/docs/DNEVNIK.md

📖 DNEVNIK RAZVOJA - NovaFarma

⚠️ POMEMBNO - User Availability:

Status: Na dopustu / bolniški
Razpoložljivost: Lahko delamo dolge sessions (3-4+ ur)
Ni potrebe: Skrbeti za čas spanja ali utrujenost
User bo povedal: Ko je utrujen/zaspan

---

🗓️ 14. December 2024 - Session 1: Tiled Map Editor Exploration

Trajanje: 2 uri (20:00 - 22:00)
Cilj: Integracija Tiled Map Editor za custom map design

✅ Dosežki:

1. Tiled Map Editor Setup:

   • ✅ Instaliran Tiled v1.11.2 (via winget)
   • ✅ Ustvarjena workflow dokumentacija (.agent/workflows/tiled-map-setup.md)
   • ✅ Demo mapa ustvarjena (farm_map.tmx, farm_map.json)
   • ✅ Tileset files (.tsx) pripravljeni

2. Bug Fixes:

   • ✅ SaveSystem.js - fixed compatibility z Flat2DTerrainSystem
   • ✅ InteractionSystem.js - dodal null check za terrainSystem

3. 2D Visual Enhancements (Predhodni session):

   • ✅ Cherry blossom trees (flat 2D triangular design)
   • ✅ Vibrant colors (grass, water, dirt)
   • ✅ Outlines za 2D cartoon style

❌ Izzivi:

1. Tiled Integration Incomplete:

   • Tileset PNG slike so prevelike (3072x3072 namesto 192x192)
   • Tile indices ne kažejo pravih pixlov
   • Layer rendering ne deluje
   • ODLOČITEV: Rollback na procedural Flat2DTerrainSystem

2. Časovna omejitev:

   • 2 uri dela brez vidnega rezultata
   • Kompleksnost Tiled integracije podcenjena

🎯 Naslednji Koraki:

1. Tiled Map - Future Work:

   • Narediti pravilne tileset PNG slike (192x192, 4x4 grid)
   • Testirati z manjšimi demo mapami
   • Raziskati Phaser Tiled integration best practices

2. 2D Map Improvements:

   • Nadaljnja vizualna poliranje procedural sistema
   • Auto-tiling za smooth edges (grass/water transitions)
   • Weather effects (rain on water)

📊 Statistika:

• Datoteke spremenjene: 11
• Nove datoteke: 5 (Tiled setup)
• Linije kode: ~500 (večinoma debugging in testiranje)
• Bugs fixed: 3

💡 Lekcije:

1. Procedural sistem deluje dobro - ni nujno zamenjati
2. Tiled integration zahteva več raziskave - tileset dimensions critical
3. Incremental approach - manjše testne mape pred velikimi
4. Time management - vedno imej rollback plan!

---

🗓️ 15. December 2024 - Session 4: Micro Farm & Minting System

Trajanje: 4.5 uri (00:50 - 01:42)
Cilj: Phase 37 (Micro Farm) + Phase 40 (Minting) Implementation

✅ Dosežki:

PHASE 37: MICRO FARM & EXPANSION 🌱

1. 8x8 Micro Farm System:

   • ✅ Initial farm boundary (center of 100x100 map)
   • ✅ White boundary visualization with corner markers
   • ✅ Tile tracking system (Set-based unlocked tiles)
   • ✅ MicroFarmSystem.js created

2. Visual Feedback:

   • ✅ Locked tile overlay (30% opacity black)
   • ✅ Clear farm vs locked distinction
   • ✅ Dynamic rendering (15 tile viewRange)
   • ✅ Depth-sorted overlays

3. Farming Restrictions:

   • ✅ Block tilling outside farm boundary
   • ✅ Error messages with floating text
   • ✅ FarmingSystem integration
   • ✅ Boundary validation on every action

4. Expansion System:

   • ✅ 4-direction unlock buttons (⬆️⬇️➡️⬅️)
   • ✅ Cost system (50 gold per 2x2 expansion)
   • ✅ Interactive UI with hover effects
   • ✅ Dynamic boundary updates

5. Minimap Integration:

   • ✅ Farm boundary visible in minimap
   • ✅ White box indicator
   • ✅ Fixed terrainSystem compatibility
   • ✅ Player-relative rendering

PHASE 40: MINTING SYSTEM 💰

1. Core System:

   • ✅ Smelter (Gold Ore → Gold Bar)
   • ✅ Mint (Gold Bar → Gold Coins)
   • ✅ MintingSystem.js created
   • ✅ Processing time tracking

2. Recipes:

   • ✅ Smelt: 1 ore + 1 coal → 1 bar (5s)
   • ✅ Mint: 1 bar → 10 coins (3s)
   • ✅ Fuel system for smelter
   • ✅ Progress tracking

3. Visual Representation:

   • ✅ Smelter sprite (🔥 brown with fire outline)
   • ✅ Mint sprite (💰 gold with coin icon)
   • ✅ Processing feedback
   • ✅ Completion floating text

🔧 Technical Fixes:

1. Flat2DTerrainSystem:

   • ✅ Added decorationsMap (Map) for InteractionSystem
   • ✅ Fixed crash in handleInteraction
   • ✅ Compatibility with existing systems

2. UIScene Minimap:

   • ✅ Fixed player position reading (gridX/gridY)
   • ✅ TerrainSystem.getTile() integration
   • ✅ Farm boundary rendering
   • ✅ Circular minimap compatibility

3. Variable Scope:

   • ✅ Fixed farmCenterX/Y references
   • ✅ Proper this. prefixing
   • ✅ Overlay rendering fixes

❌ Izzivi:

1. AI Image Generation:

   • Green screen transparency NE deluje zanesljivo
   • Manual background removal potreben
   • LEKCIJA: Direct transparent PNG je edina pot!

2. Sprite Processing:

   • Automatic green removal briše pravilne barve (pink, red)
   • Disabled processAllTransparency() globally
   • LEKCIJA: Ready assets = no processing!

3. Complexity:

   • 3 velike features v 1 session
   • Water auto-tiling postponed
   • Phase 38 postponed

🎯 Naslednji Koraki:

1. Phase 38: Town Repair (Next priority)

   • Ruined buildings system
   • NPC relationship (hearts)
   • Trading shops
   • Repair mechanics

2. Water Auto-Tiling (Visual improvement)

   • Edge detection
   • Smooth transitions
   • Wave animations

3. Weather Improvements:

   • Rain ripples on water
   • Better puddles
   • Particle effects

📊 Statistika:

• Session trajanje: 4.5 uri
• Datoteke spremenjene: 6
• Nove datoteke: 2 (MicroFarmSystem.js, MintingSystem.js)
• Linije kode: +500
• Features completed: 2 major phases
• Commits: 2 (Phase 37, Phase 40)

💡 Lekcije:

1. Micro systems work! - 8x8 start je dovolj za gameplay
2. Visual feedback je critical - overlay + boundaries = clarity
3. Expansion mechanics engaging - unlock buttons + cost = satisfying
4. Minting = unique economy - no random coin drops!
5. 4.5h session možen - ampak potreben break! 😴

---

🗓️ 14. December 2024 - Session 2: Cherry Blossom Trees + Visual Polish

Trajanje: 30 min (22:30 - 23:00)
Cilj: Dodati cherry blossom drevesa in testirati PNG sprite integration

✅ Dosežki:

1. Cherry Blossom Trees:

   • ✅ Generirane AI PNG slike (roza_cesnjevo_drevo.png, cesnja_sadje.png)
   • ✅ Dodan loading v PreloadScene.js
   • ✅ Implementiran PNG sprite rendering v Flat2DTerrainSystem
   • ✅ Testiranje različnih velikosti (0.8x → 0.5x scale)

2. Background Removal Attempts:

   • ✅ Dodal cherry tree v processSpriteTransparency() seznam
   • ✅ Implementiral ultraRemoveBackground() za pink + brown piksle
   • ❌ AI generiran PNG ima črne obrobe ki jih težko odstranimo

3. Končna Rešitev:

   • ✅ Revert nazaj na proceduralne cherry blossom trees (roza trikotniki)
   • ✅ Čisto brez artefaktov, pravilno rendering

🎨 POMEMBNO PRAVILO - Image Generation:

🟢 VSE PRIHODNJE AI GENERIRANE SLIKE:

• GREEN SCREEN BACKGROUND (RGB: 0, 255, 0)
• 100% solid green - NO gradients, NO transparency
• Razlog: Chroma-key removal je 100% zanesljiv!
• Sistem že ima processSpriteTransparency() - lahko dodamo green detection

Format:

Background: Solid bright green (#00FF00)
Subject: Clear, sharp edges
No anti-aliasing on green boundary

💡 Lekcije:

1. AI transparency NE DELUJE zanesljivo - vedno ostanejo artefakti
2. Green screen je STANDARD - uporablja Hollywood, uporabimo tudi mi!
3. Procedural graphics > problematic PNGs - če PNG ne deluje, procedural je backup
4. Test early - raje testiraj hitro kot da persistent z nedelujočim pristopom

---

Prejšnji Sessions:

(Sessions pred 14.12.2024 niso dokumentirani v tem dnevniku)