novafarma/docs/PHASE28_SESSIONS_4_5_6_PLAN.md

🗺️ PHASE 28 - Sessions 4-6 Implementation Plan

Datum: 15.12.2025
Status: NAČRTOVANO za naslednjo sejo

---

📋 PREGLED:

Session 3: Debug & fixes (v teku)
Session 4: Biome transitions ⏭️
Session 5: Rivers & lakes ⏭️
Session 6: Structures & polish ⏭️

---

🎯 SESSION 4: BIOME TRANSITIONS (1-2h)

Cilj: Gladki prehodi med biomi

Naloge:

1. Transition Zones (45 min)

• Določi transition širino (20-30 tiles)
• Implementiraj blend algoritm
• Mešaj tile barve med biomi
• Test na vseh biome mejah

2. Mixed Features (30 min)

• V transition zones mešaj funkcije
• 50% grassland trees + 50% forest trees
• Postopno spreminjanje gostote
• Naravni izgled

3. Edge Smoothing (15 min)

• Soft edges namesto sharp
• Perlin noise za naravne meje
• Variacija v transition širini

Deliverables:

• TransitionSystem.js (~150 linij)
• Gladki prehodi med vsemi biomi
• Testiran na vseh kombinacijah

---

🌊 SESSION 5: RIVERS & LAKES (2-3h)

Cilj: Naravne vodne formacije

Naloge:

1. River Generation (1h)

• River pathfinding algoritm
• Start points (mountains)
• Flow to edges ali lakes
• Serpentine curves (ne ravne linije)
• Width variacija (2-5 tiles)

2. Lake Creation (45 min)

• Lake placement algoritem
• Organic shapes (ne krogi!)
• Size variacija (15-30 tiles)
• Povezava z rekami
• Shoreline tiles

3. Water Features (30 min)

• Waterfalls (če river po mountain)
• Rapids (hitrejša voda)
• Calm water (v lakes)
• Water plants (lily pads, reeds)

Deliverables:

• RiverSystem.js (~200 linij)
• LakeSystem.js (~150 linij)
• 5-10 rivers
• 3-5 lakes
• Natural water flow

---

🏛️ SESSION 6: STRUCTURES & POLISH (2-3h)

Cilj: Zanimivi objekti in končna kvaliteta

Naloge:

1. Roads (45 min)

• Main roads med biomi
• Dirt paths v forests
• Stone paths v mountains
• Connect key points
• PathfindingRoads algoritm

2. Structures (1h)

• Abandoned buildings (5-7)
• Ruins v various biomes
• Watchtowers (2-3)
• Bridges (over rivers)
• Camps (1-2)
• Size: 3x3 to 7x7 tiles

3. Landmarks (30 min)

• Special unique locations
• Mountain peaks (flags/markers)
• Ancient trees
• Stone circles
• View points

4. Final Polish (45 min)

• Remove debug borders
• Performance optimization
• Visual consistency check
• Minimap update
• Documentation

Deliverables:

• StructureSystem.js (~300 linij)
• 10+ structures placed
• Roads implemented
• Landmarks added
• Everything polished

---

📊 TEHNIČNE SPECIFIKACIJE:

Session 4: Transitions

Transition Algorithm:

function getTransitionBlend(x, y) {
    const biome1 = getBiomeAt(x, y);
    const nearbyBiomes = getBiomesInRadius(x, y, 20);
    
    if (nearbyBiomes.length > 1) {
        // Calculate blend weights
        const weights = calculateDistanceWeights(x, y, nearbyBiomes);
        return mixBiomes(weights);
    }
    
    return biome1;
}

Session 5: Rivers

River Generation:

function generateRiver(startX, startY) {
    let current = { x: startX, y: startY };
    const path = [current];
    
    while (!isEdgeOrLake(current)) {
        const next = flowDownhill(current);
        path.push(next);
        current = next;
    }
    
    return createRiverFromPath(path);
}

Session 6: Structures

Structure Placement:

function placeStructures() {
    const candidates = findSuitableLocations();
    const selected = selectBestLocations(candidates, minDistance: 50);
    
    selected.forEach(loc => {
        const structure = chooseStructureForBiome(loc.biome);
        placeStructure(loc.x, loc.y, structure);
    });
}

---

🎨 VIZUALNI CILJI:

Session 4:

• Biome meje izgledajo naravno
• Ni očitnih "linij" med biomi
• Postopne spremembe

Session 5:

• Reke izgledajo naravno
• Jezera imajo organic shapes
• Vode connectivity makes sense

Session 6:

• Svet izgleda živ in populated
• Structures so smiselno postavljene
• Roads povezujejo pomembne točke

---

⏱️ ČASOVNICA:

Session	Naloge	Čas	Prioriteta
4	Transitions	1-2h	HIGH
5	Rivers/Lakes	2-3h	MEDIUM
6	Structures	2-3h	MEDIUM
TOTAL		5-8h

---

✅ SUCCESS CRITERIA:

Session 4:

• Vsi biome prehodi gladki
• Ni sharp edges
• Naravni izgled
• 60 FPS maintained

Session 5:

• 5+ rivers generated
• 3+ lakes created
• Natural water flow
• Shorelines smooth

Session 6:

• 10+ structures placed
• Roads connect biomes
• Landmarks visible
• No debug artifacts
• Performance good

---

🔧 TOOLS NEEDED:

Session 4:

• Perlin noise for transitions
• Distance calculation utilities
• Color blending functions

Session 5:

• Pathfinding algorithm
• Terrain height map (simple)
• Water flow simulation

Session 6:

• Structure templates (JSON)
• Placement validation
• Collision detection

---

📝 DOKUMENTACIJA:

Po vsakem session-u:

• Update session log
• Commit changes
• Update main roadmap
• Screenshot examples

---

🎯 KONČNI REZULTAT:

Po Session 6 bi morali imeti:

• ✅ 500x500 fully functional world
• ✅ 5 distinct biomes
• ✅ Smooth transitions
• ✅ Rivers & lakes
• ✅ Structures & landmarks
• ✅ Roads connecting everything
• ✅ 60 FPS performance
• ✅ Professional quality

Phase 28 bo 100% complete! 🎊

---

Ready for Session 4 when you are! 🚀