​

Blueprint 10 - Planetary Runtime

Status: PLAN - FINAL. Aerospace planetary layer: seamless, persistent, planet-scale exploration with community-built surface facilities. Simulation scope deliberately small - aerospace operations first, not a full civilization simulator. 09 paused at Fase 5.

​

1. Overview

​

2. Objectives / Non-Objectives

• Seamless SPACE -> ORBIT -> ATMOSPHERE -> SURFACE without loading screens.
• Planet-scale geography that is explored, not teleported.
• Community-built surface facilities that are persistent and have consequences.
• Character that can leave the vessel and operate inside facilities.

• Global NPC / fauna / city simulation, terrain deformation, procedural cities, full economy - not in this blueprint.

​

3. Foundation Reuse (No New Laws)

• Lighting: scene3d.ts:249 DirectionalLight + PMREM scene.environment:858 + MeshStandard - same sun illuminates planet and clouds.
• Orbit: Kepler environs.ts:49 r=a(1-e²)/(1+e cosθ) + lunar phase.
• Physics: physics.ts:12 G, σ, c, AU + g=9.81 + thermics.ts:34 L/4πr² + collision.ts:92 KE=½mv²×angle.
• Persistence: WorldRegion:41 Map + RegionSnapshot:79 /snapshot server.ts:139 + persistence.ts:120 RecoveryManager + gate.ts:86 + bridge.ts:75 + relay/registry.ts:33.
• Vessel as Repository: universe/connect.ts:74 -> .arclux/ -> buildVesselModel stats.ts:183 -> server.ts:216 spawnPlayerVessel.

​

4. Planetary Substrate - Natural Environment (Visual-Only)

• Terrain: seed -> continental -> mountain -> biome -> river heightmap, streaming LOD 16-64 settings.ts:28, vertexColors topsoil/clay/rock.
• Ocean: SphereGeometry + Gerstner waves ω²=g·k g=9.81, depth from heightmap, 71% coverage.
• Atmosphere: Sphere 1.018 + procedural clouds makeCloudTexture 512 per-kind (gasGiant banded, ocean swirl, ice wispy, desert dust, volcanic ash) scene3d.ts child depthWrite:false.
• Weather: mulberry32(tick) + Perlin rain, wind, fog, not fully deterministic.
• Environment: per-planet gravity, temperature, weather, day/night 24h, lighting - streamed, g varies (Earth 9.81, Mars 3.71).

​

5. Scale & Persistence - Large Planet, Chunked Runtime

PLANET (thousands km)
  ┌──────────────────────────┐
  │   REGION A [HANGAR A]    │
  │                 REGION B │
  │      REGION C            │
  └──────────────────────────┘

• Chunking: regionId = planetId:chunkX:chunkZ distributed via WorldRegion:41 relay/registry.ts:33 claimRegion - only chunks with players or facilities are ticked; world state for all chunks stays persistent in persistence.ts:120.

ERRATUM F9 (10.V F0, 2026-09-11, mengikat): paragraf chunking di atas DINYATAKAN KELIRU. Fakta terverifikasi: claimRegion = handoff shard vessel (bukan tick chunk); chunking yang berjalan = streaming + LOD sisi klien + persist koordinat. Chunk-tick server beneran = opsi (a) yang DITUNDA ke fase MMO-server. Lihat 10-visual-fidelity.md §4 F9.

• Persistent Coordinate: position Vec3{x,y,z} types.ts:18 stored in RegionSnapshot:79 RegionState:65 Map - logging out in Planet-07 / Region-A / Hangar-A returns to the same Hangar-A; Player A ↔2000 km↔ Player B are on the same planet, different locations. Coordinates are shareable (gate.ts:34 position) for rendezvous. Spawn is at the chosen facility, not a global 0,0,0.
• Empty Land Rule: community facilities may only be placed on empty land (ARCLUX limits buildable area, forest/ocean stay natural) - hutan/laut remain, hangar is built where land is empty.

​

6. Time & Compass - Real-World Laws

• Time: day/night 24h + lunar Kepler environs.ts:49 + season + physics.ts:12 G,σ - north is night while west is day because compass follows planet rotation + lunar orbit Newtonian tidal. No night faster - time equals real world.

​

7. Aerospace Operations - Seamless Flight

ORBIT -> ATMOSPHERE (cloud occlusion) -> LOW-ALTITUDE FLIGHT -> PLANET SURFACE -> LANDING PAD -> HANGAR -> SHIP OPERATIONS
HANGAR -> LAUNCH -> ATMOSPHERE -> ORBIT

• GateLink:34 spaceport activationRadius 800m gate.ts:86 + cloud drift scene3d.ts:890 + simulation.ts:238 p+=v*dt - approach can be safe (auto Gate notifyTarget->ACK) or manual (raycast terrain, KE damage on crash).
• Low-altitude flight is gameplay: cloud closes cockpit 2s -> terrain LOD fades in -> search for facility.

​

8. Surface Facilities - Built by Community

​

9. Character - Limited to Facilities

Vessel -> Dock -> Exit -> Hangar -> Repair/Refit -> Return -> Launch

​

10. Strategic Geography - Terrain Creates Opportunity

• mountains (slope>0.4) -> military, plains (slope<0.1) -> spaceport, desert -> remote, poles -> observatory, coastline <2km -> coastal facilities, valleys -> hidden.

​

11. Night & Discovery - Planet Feels Inhabited Without NPCs

• Night: StationEntity emissive #ffd9a0 96 windows/ring + PointLight runway amber - from orbit at night DirectionalLight off, facility emissive stays (PMREM off) - orbit sees light -> descend -> runway -> hangar feels inhabited without one NPC.
• Discovery: Radar world.ts:83 entitiesWithin(pos,50000) + distanceBetween:150 + directory listServers - Planet-07: Hangar-A 12 km / Military-B 847 km / Spaceport-C 1,920 km / Unknown 430 km - thousands of km matter.

​

12. Social Geography - Empty by Default, Shaped by Players

Developer:  “Here is the planet.”
Community A: “Here I build a spaceport.”
Community B: “I build a military hangar 800 km away.”
Player:      “I discover their facilities.”

​

13. Checklist

• Substrate natural terrain/ocean/atmosphere/clouds streaming LOD (visual-only) - 10.2 done
• Scale + chunk + persistent coordinate Planet/Chunk Vec3 persist - 10.3 done (F9 erratum: claimRegion DICABUT dari baris ini — handoff shard, bukan tick chunk)
• Time & compass Newtonian 24h + lunar Kepler + G,σ - 10.4 done
• Aerospace seamless ORBIT->HANGAR GateLink without loading - 10.4 done
• Community facilities 10 types StationEntity persistent - 10.5 done
• Character limited to facilities FPS 5.5 - 10.5 done
• Strategic geography from heightmap - 10.6 done (geography.ts 6 niches)
• Night emissive + discovery Radar + Unknown - 10.6 done (night.ts 96 windows + PointLight)
• Empty by default, shaped by players - DONE (persistent WorldRegion + community facilities)

09 Part A Fase 6-7 + Part B 8-12 remain next after 10 - 10 is now final aerospace depth, not SimCity.

​

10.X - Cinematic Environmental Interaction Layer

Status: PLAN - FINAL (Extension of 10). Visual authority boundary - effects derived from EnvironmentalContext, never becomes gameplay authority. Parent: Planetary Runtime (§3 reuse).

​

10.X.1 Purpose - Coherent Visual System

​

10.X.2 Architectural Boundary

​

10.X.3 EnvironmentalContext (single source)

​

10.X.4 Global Wind Field

​

10.X.5–10.X.9 Sun, Cloud–Sun, Cloud Shadows, God Rays, Scattering

​

10.X.10–10.X.12 Volumetric Clouds, Intersection, Weather Stack

​

10.X.13–10.X.20 Rain, Lightning

​

10.X.21–10.X.26 Fog, Vegetation, Low-Altitude Vessel

​

10.X.27–10.X.29 Dust, Landing, Exhaust

​

10.X.30–10.X.37 Ocean, Terrain, Snow, Heat

​

10.X.38–10.X.45 Entry, Orbit Weather, Night, Facility Response, Particles, Event Chain

​

10.X.46–10.X.51 Sunrise/Sunset, Camera, Reflections, Occlusion, Local Volumes

​

10.X.52–10.X.55 Quality, Budget, Determinism, Persistence

​

10.X.56–10.X.59 Seamless + Composition + Non-Goals + Contract

​

10.X Checklist (implementation - like other blueprints)

Each row = PR (or iris), no auto-merge. Visual-only unless StationEntity:54 health involved - then via component.ts:10 + combat.ts:39/collision.ts:92 + persistence.ts:120 (audit trail: authority vs visual).

• EnvironmentalContext + WindState contracts (EnvironmentalContext.ts, WindState.ts - derived from planetSeed/simulationTick/worldTime/sunDirection)
• Sun / day-night lighting (sunDirection/elevation/intensity -> terrain/ocean/vegetation/clouds) - DONE 10.X.1 sun.ts
• Dynamic cloud–sun + cloud shadows (CLOUD -> MOVING SHADOW -> SURFACE) - DONE 10.X.1 cloudShadows.ts
• God rays volumetric (GodRayContext - mountain/forest/cloud-gap shafts, not overlay) - DONE 10.X.1 godRays.ts
• Atmospheric scattering SPACE -> SURFACE + volumetric clouds (coverage/density/altitude/thickness/wind) + cloud intersection (CLEAR -> EDGE -> INTERIOR) - DONE 10.X.1 (part of godRays/fog)
• Weather stack CLEAR/OVERCAST/RAIN/STORM coordinated - DONE 10.X.2 weatherStack.ts
• Rain + rain–surface/ocean (wet/puddles/runoff/reflection, micro-ripples) - DONE 10.X.2 rain.ts
• Lightning event chain (LightningEvent -> cloud flash -> terrain/ocean/facility + reflection) - DONE 10.X.2 lightning.ts
• Fog (+ fog–sun god-ray feed) + vegetation wind/rain (grass->tree phased) - DONE 10.X.3 fog.ts + vegetation.ts
• Low-altitude vessel -> vegetation/dust + landing dust phases + exhaust–ground - DONE 10.X.3 vegetation tick + oceanSystem wake (partial, landing dust deferred to 10.E)
• Ocean system (OceanState + vessel spray/wake + sun reflection) - DONE 10.X.3 oceanSystem.ts
• Terrain wet/snow/heat + dust storms - DONE 10.2 terrain wet + 10.X.3 fog/vegetation (dust deferred to 10.E)
• Entry effects + orbit weather visibility + night emissive - DONE via 10.E + 10.G G6
• Facility–weather (wet/wind/fog/lightning/night) + landing pad cinematic + damage visualization (smoke/debris via authority) - DONE via 10.G + 10.E
• Particles derived (wind+gravity+turbulence) + environmental event chain - DONE via 10.G G1 + 10.X
• Sunrise/sunset cinematic + camera response (exposure/visibility/touchdown) + reflections + occlusion - DONE via 10.X sun/godRays + 10.C6-C7
• Local effect volumes + quality FAR->CINEMATIC + budget proximity->importance->cost + determinism seeding + persistence boundary - DONE 10.X.4 localVolumes.ts + qualityBudget.ts

Dependency: 10 substrate (terrain/ocean/atmosphere visual-only) lands first; 10.X rides on top. 09 Part B 9-12 land before 10.X needs facilities to illuminate. No new authority - every effect is a resolver over EnvironmentalContext.

​

14. File Mapping - Where Code Goes (No Guessing, 1 Contract + 1 Folder)

Biar pas code gak ngarang: BLUEPRINT 10 numpang ke file yang udah ada, BLUEPRINT 10.X cuma tambah 1 kontrak. Hujan gak 1 planet - per chunk, deterministik dari planetSeed+tick.

​

BLUEPRINT 10 (substrate) -> 2 tempat

• environs.ts (udah ada, SystemBodies Kepler) -> tambah planetaryEnvirons.ts - heightmap seed, chunk planetId:chunkX:chunkZ via claimRegion (world.ts:41 + relay/registry.ts:33 udah ada). Chunk cuma di-tick kalau ada pemain/facility; persistence.ts:120 simpan semua.
• physics.ts:12 (G, KE) + thermics.ts:34 (1/r²) -> reuse buat gravity per planet (Earth 9.81 vs Mars 3.71), collision.ts:92 KE=½mv² buat crash.
• types.ts:18 Vec3 + world.ts:41 Map + persistence.ts:120 -> koordinat persisten Vec3 udah ada, tinggal planetId di regionId (log out Hangar-A -> Hangar-A, 2000 km same planet).
• cosmicEvent.ts (udah ada, anomali acak) -> cuaca/anomali numpang di sini: weatherSeed = mulberry32(planetSeed + tick) -> rain/wind/fog lokal per chunk, bukan global. Anomali = cosmicEvent yang sama, visualnya beda. Gak bikin file gede baru.

• scene3d/planets.ts (udah ada, buildPlanetSystem + makeCloudTexture) -> tambah scene3d/planetary/ folder:
  scene3d/planetary/
  ├── terrain.ts    (heightmap LOD 16-64, vertexColors, continental->mountain->biome->river)
  ├── ocean.ts      (Gerstner g=9.81, 71% coverage, depth dari heightmap)
  ├── atmosphere.ts (Sphere 1.018 + clouds 512 per-kind, depthWrite:false)
  ├── weather.ts    (rain/wind/fog dari EnvironmentalContext - per chunk)
  ├── chunks.ts     (streaming LOD, cull jauh, claimRegion)
  ├── facilities.ts (spawn di empty land - hutan/laut tetep natural)
  └── surface.ts    (lerp SPACE->ORBIT->ATMOSPHERE->SURFACE tanpa loading)
  
  Semua child sphere 1.018 + depthWrite:false + dispose buildPlanetSystem:283 - gak masuk WorldRegion.entities / EnvironsState.bodies / RegionSnapshot, gak nambah O(V*B) simulation.ts:121. Hujan di Valley A, Valley B cerah - weatherState per chunk.

​

BLUEPRINT 10.X (cinematic) -> 1 kontrak + numpang

• EnvironmentalContext.ts + WindState.ts (di planetary/environment.ts tadi) - satu angin dilihat awan+hujan+kabut+daun bareng (10.X §4). Gak ada rain punya angin sendiri.
• Efek lain (god rays, landing dust 4 fase, puddles, lightning flash) gak bikin file otoritas baru - cuma visual resolver baca EnvironmentalContext -> THREE. localEffectBudget per chunk -> habitat A hujan deres, B kering.

​

15. Addendum - Gaps Closed (Continuous Event & Shoreline) - PLAN FINAL

Temuan 8 celah setelah review APA efek ada vs GIMANA efek ketemu sepanjang waktu - ditutup sebagai addendum, bukan arsitektur baru (semua cuma resolver di atas EnvironmentalContext, visual-only).

​

G1 - Continuous Environmental Event (Priority 1 - wajib)

​

G2 - Weather Accumulation -> Recovery (gabung G1)

​

G3 - Coastal Transition (Priority 2)

​

G4 - Hydrological Continuity

​

G5 - Terrain Visual Memory (Future - decal only)

​

G6 - Atmospheric Continuity (Optical)

​

G7 - Terrain + Sun Moving Shadows

​

Checklist Gaps (PR - no auto-merge)

• EnvironmentalEvent state machine clear->pre->storm->landing->post->recovery + WET->DRAINING->DRYING (visual timers, gak ganti weather authority)
• Coastal zone WET SHORE -> SHALLOW -> OPEN OCEAN + foam/spray/shoreline mist (terrain/ocean meet)
• Hydrological river flow + foam + wet banks + river->ocean (dari heightmap)
• Terrain Visual Memory (FUTURE decal scaffold — wire ready, persist via persistence.ts) decal per chunk (FUTURE - persist scorch/dust)
• Atmospheric optical haze->valley fog->mountain contrast + moving terrain shadows

Catatan file: G1-G2 di planetary/weather.ts + EnvironmentalContext; G3-G4 di planetary/terrain.ts + ocean.ts; G5 di planetary/surface.ts decal; G6-G7 di planetary/atmosphere.ts. Semua visual resolver, no new authority.

​

16. Emergency Landing - ADRIFT -> FALLING -> CRASHED (PLAN FINAL)

Kapal habis perang gak langsung respawn. Rusak -> terombang-ambing -> jatuh kayak film -> mendarat darurat -> butuh Repair = commit biar hidup lagi. Sinematik, persistent, dan numpang di pondasi yang udah ada.

​

State Machine (visual + authority tipis)

BATTLE (SPACE, health 100->12%)
  ↓ engine 0% + reactor bocor (combat.ts:39 DAMAGE_CEILING=12)
ADRIFT (terombang-ambing, velocity drift 8->0, emissive red pulse, HUD ENGINE 0%)
  ↓ gravitasi planet narik (physics.ts:12 G + thermics.ts:34 1/r² beneran, bukan animasi)
FALLING (atmosphere entry -> heat haze + cloud intersection + exhaust mati)
  ↓ raycast terrain (planetary/terrain.ts heightmap) + KE=½mv² (collision.ts:92)
EMERGENCY LANDING (empty land? -> survive, hutan/laut? -> crash)
  ↓
CRASHED (VesselEntity grounded, health 5%, velocity 0, gak bisa takeoff, smoke/debris)
  ↓ Repair = commit (benerin code di repo -> buildVesselModel -> integrity balik -> launch)

• ADRIFT: VesselEntity health < 10% -> state="adrift" + velocity drift pelan + cooldowns lock + HUD ENGINE 0% + sfxDebris pelan. Pemain lain lihat ◈ VSL GSF-xxxx 847 km - ADRIFT (via world.ts:83 entitiesWithin + directory). Gak bisa thrust - server validator.ts reject move kalau health < 10%.
• FALLING: Gravitasi physics.ts:12 narik ke planet terdekat (bukan jatuh meteor batu, tapi pitch 70° + velocity 120 m/s + heat haze + cloud gap god rays kayak film Interstellar). simulation.ts:238 p+=v*dt + drag 0.02 + clampSpeed biar drift natural. Visual: atmospheric entry (10.X §38) + cloud intersection (10.X §11).
• EMERGENCY LANDING: GateLink:34 spaceport 800m gak kepake - ini manual raycast terrain cari empty land (planetary facilities.ts rule: hutan/laut tetep natural). Landing dust 4 fase (10.X §28) Approach->Hover->Touchdown burst->Settlement + wind advection. Kalau miring/cepat -> KE crash -> wreckage (persistence.ts:120 + 04).
• CRASHED: VesselEntity position = terrain height, health 5%, velocity 0, state="crashed" persist via RegionSnapshot + persistence.ts. Visual: smoke/debris + emissive red (10.X §43). Gak bisa launch sampai integrity balik.

​

Kenapa Gak Butuh File Baru Gede

• Damage -> combat.ts:39 + collision.ts:92 + thermics.ts:34
• Jatuh -> physics.ts:12 G + environs.ts:49 Kepler + simulation.ts:238
• Terrain -> planetary/terrain.ts + chunks.ts planetId:chunkX:chunkZ
• Visual -> 10.X atmosphere.ts + weather.ts + planetary/surface.ts
• Persist -> persistence.ts:120 RecoveryManager (restart ≠ reset V6)

​

Checklist (PR - no auto-merge)

• VesselState + transisi adrift->falling->crashed (server, health <10% -> adrift, gravitasi -> falling, raycast -> crashed)
• ADRIFT drift + HUD ENGINE 0% + validator reject thrust
• FALLING heat haze + cloud intersection + pitch sinematik (bukan meteor)
• EMERGENCY LANDING raycast empty land + dust 4 fase + KE crash check
• CRASHED persist + smoke/debris + Repair=commit -> launch lagi
• Visual only: WIND FIELD bawa dust settlement, EnvironmentalContext bawa falling state

Catatan: Bukan respawn 3 detik arcade. Ini film - terombang-ambing dulu, jatuh pelan, mendarat darurat, baru bisa commit. Planet jadi kuburan + bengkel.

Urutan: 09 Part B 9-12 -> 10 substrate -> 10.X cinematic + 15 gaps -> 16 emergency landing (numpang semua). Gak lompat.

​

10.C - Cinematic Atmospheric & Experiential Continuity (Filtered - PLAN FINAL)

Parent 10 + 10.X + 10.E. Scope: client presentation - bukan authority baru. No New Authority: gak boleh ubah position/velocity/health/physics/weather/terrain/facility/persistence - cuma baca EnvironmentalContext -> CinematicContext -> presentation.

• 10.C.1 Contracts CinematicContext/Event/Phase (typecheck)
• 10.C.2 Director trigger/phase/priority/exit (multiple events)
• 10.C.3 Flight wind+density+velocity+altitude -> turbulence/motion/camera
• 10.C.4 Heat entry->heating->peak->cooling
• 10.C.5 Camera entry/landing/crash/docking (bounded, player control intact)
• 10.C.6 Audio wind/rain/thunder/engine/atmosphere sync
• 10.C.7 Cockpit rain/lightning/heat/cloud/turbulence presentation-only
• 10.C.8 Impact impact->debris->smoke->settling->wreck
• 10.C.9 Facility discovery distant->reveal->approach->hangar (no cutscene)
• 10.C.10 Continuity SPACE->ORBIT->ATMOSPHERE->CLOUD->SURFACE->FACILITY under FAR->CINEMATIC

Dependency: 10 substrate -> 10.X/10.G/10.E -> 10.C paling akhir (presentation di atas environmental). 10.C bisa dibangun bareng 10.X karena pakai EnvironmentalContext sama, tapi merge terakhir.

​

17. Implementation Phases - Urutan Eksekusi (KAYAK 09 - TIAP FASE = PR, NO AUTO-MERGE)

Biar gak lupa besok habis A-B-C dari mana - kayak 09 ada Fase 1-12, 10 juga ada fase. Tiap fase punya file + checklist + dependency. No guessing.

​

FASE 10.1 - Substrate Contracts (pondasi dulu)

• packages/gameserver/planetary/environment.ts - EnvironmentalContext + WindState - DONE 10.1 (planetId, planetSeed, tick, worldTime, sunDirection, weatherState, dll) - 1 kontrak, semua baca ini
• Verify: npx tsc --noEmit + node -e "require('./environment.ts')" - kontrak kebaca semua sistem - DONE tsc 0

​

FASE 10.2 - Planetary Substrate Visual (terrain/ocean/atmosphere)

• scene3d/planetary/terrain.ts - heightmap continental->mountain->biome->river - DONE 10.2 LOD 16-64, vertexColors
• scene3d/planetary/ocean.ts - Gerstner g=9.81, 71%, depth dari heightmap - DONE 10.2
• scene3d/planetary/atmosphere.ts - Sphere 1.018 + clouds 512 per-kind - DONE 10.2, depthWrite:false
• Verify: build-game.mjs OK, scene.environment PMREM tetap - DONE 1.5mb

​

FASE 10.3 - Scale & Chunk + Persistent Coordinate

• scene3d/planetary/chunks.ts - streaming LOD, cull jauh, planetId:chunkX:chunkZ - DONE 10.3 (F9 erratum: frasa “via claimRegion” DICABUT — streaming klien, bukan tick server)
• packages/gameserver/planetary/chunks.ts + geography.ts - matematika kunci + helper chunk - DONE 10.3 (F9 erratum: frasa “chunk tick via claimRegion” DICABUT — tanpa loop tick)
• types.ts:18 Vec3 - log out Hangar-A -> Hangar-A, 2000 km same planet, shareable gate.ts:34 - DONE via persistence
• Verify: 2 player 2000 km same planet, relog tetap di tempat - DONE

​

FASE 10.4 - Time & Aerospace Seamless

• scene3d/planetary/surface.ts - lerp SPACE->ORBIT->ATMOSPHERE->SURFACE (bukan teleport), cloud occlusion 2s - DONE 10.4
• environs.ts:49 + physics.ts:12 - 24h + lunar Kepler + G,σ -> north night west day - DONE via deriveSunState
• gate.ts:86 GateLink spaceport 800m + simulation.ts:238 p+=v*dt - auto ACK vs manual raycast crash KE - DONE
• Verify: SPACE->SURFACE tanpa loading, low flight cari facility - DONE

​

FASE 10.5 - Facilities + Character Limited

• scene3d/planetary/facilities.ts - 10 facility di empty land - DONE 10.5
• packages/gameserver/world.ts:41 - FacilityEntity spawn di empty land rule - DONE canBuildOnEmptyLand
• Character FPS 5.5 m/s limited hangar/facility only (clampSpeed 5.5, baseline.ts:16) - DONE
• Verify: build di empty land bisa, hutan/laut tetep natural, facility health combat.ts:39 - DONE

​

FASE 10.6 - Geography & Night

• Strategic geography mountains->military, plains->spaceport, poles->observatory dari heightmap (mulberry32) - DONE 10.6 geography.ts
• Night emissive #ffd9a0 + PointLight runway + Radar entitiesWithin 50000 + Unknown - DONE 10.6 night.ts
• Verify: orbit malam liat facility nyala, Radar Hangar-A 12 km / Unknown 430 km - DONE

​

FASE 10.X.1 - Sun + Clouds + God Rays (cinematic core) - DONE

• WindState shared -> clouds drift, rain slant, fog flow - DONE via deriveWindState
• Cloud–sun illuminated tops/darker bases/self-shadow + CLOUD->SHADOW->SURFACE - DONE via cloudShadows.ts
• GodRayContext - mountain gap/valley/canopy/cloud gap shafts, not overlay, coupled sun+fog+cloud+terrain+camera - DONE via godRays.ts
• Verify: cloud lewat -> forest darkens -> god ray gerak - DONE

​

FASE 10.X.2 - Weather Stack + Rain + Lightning - DONE

• WeatherState CLEAR/OVERCAST/RAIN/STORM coordinated -> RainState + wet/puddles/runoff/reflection + ocean ripples - DONE via weatherStack.ts
• LightningEvent -> cloud flash + terrain/ocean/facility illumination + reflection (bolt cuma 1 part) - DONE via lightning.ts
• Verify: storm cloud density -> sunlight down -> rain -> puddles -> lightning flash -> ocean reflection - DONE

​

FASE 10.X.3 - Fog + Vegetation + Dust + Ocean - DONE

• Fog temperature/humidity/weather -> height/distance/valley/entry haze + fog–sun god-ray feed - DONE via fog.ts
• Vegetation grass->tree wind phased + rain wetness - DONE via vegetation.ts
• Ocean OceanState + spray/wake/foam + sun reflection - DONE via oceanSystem.ts
• Verify: wind gust -> leaves/grass beda fase, rain -> leaf wetness - DONE

​

FASE 10.X.4 - Local Volumes + Quality + Budget - DONE

• Local effect volumes (player/landing/facility) + quality FAR->CINEMATIC graceful degrade - DONE via localVolumes.ts
• Budget proximity->importance->cost + determinism planetSeed+tick+chunkKey + persistence boundary (transient vs persistent) - DONE via qualityBudget.ts
• Verify: jauh = low cost, dekat = cinematic, handoff/reconnect regenerate - DONE

​

FASE 10.G - Gaps Closed (Continuous Event & Shoreline)

• EnvironmentalEvent clear->pre->storm->landing->post->recovery + WET->DRAINING->DRYING (G1-G2) - DONE via environmentalEvent.ts wire10G
• Coastal WET SHORE->SHALLOW->OPEN OCEAN + foam/spray (G3) + Hydrological river->ocean (G4) - DONE via coastal.ts/hydrological.ts wire10G
• Verify: POST-STORM genangan masih ada, coastal gradual, river ketemu ocean - DONE

​

FASE 10.E - Emergency Landing (film-like)

• vesselState.ts adrift->falling->crashed + ADRIFT drift + FALLING heat + LANDING dust 4 fase + KE + CRASHED persist - DONE via vesselState.ts/wire10E #720
• Verify: health<10% -> adrift -> falling pitch film -> empty land survive / hutan crash -> Repair=commit - DONE

​

FASE 10.C.1 - Cinematic Contracts (pondasi presentasi)

• scene3d/cinematic/CinematicContext.ts + CinematicEvent.ts + CinematicPhase.ts - eventId, eventType, phase TRIGGER->EXIT, priority, exposure
• Verify: npx tsc --noEmit + typecheck, no authority - DONE tsc 0

​

FASE 10.C.2 - Event Director

• CinematicEventDirector.ts - trigger/phase/priority/exit (CRASH 100 > EMERGENCY 90 > ENTRY 70)
• Verify: multiple events, priority resolve - DONE via CinematicEventDirector

​

FASE 10.C.3 - Atmospheric Flight & Turbulence

• AtmosphericFlightResolver.ts + TurbulenceResolver.ts - wind+density+velocity+altitude -> turbulence/motion/camera NORMAL->BUILDUP->ACTIVE->DECAY
• Verify: SPACE -> ATMOSPHERE -> LOW FLIGHT turbulence continuity - DONE via AtmosphericFlightResolver

​

FASE 10.C.4 - Heat Response

• HeatResponseResolver.ts - entry->heating->peak->cooling (visual, gak ganti physics)
• Verify: heat visual continuity COLD->PEAK->NORMAL - DONE

​

FASE 10.C.5 - Camera Director (bounded)

• CinematicCameraDirector.ts - entry/landing/crash/docking ≤2° pitch/roll, exposure ≤+0.3 additive, never forced cutscene
• Verify: player control intact, camera additive - DONE via CinematicCameraDirector

​

FASE 10.C.6 - Audio Context

• EnvironmentalAudioResolver.ts - wind/rain/thunder/engine/atmosphere sync dari EnvironmentalContext - DONE via EnvironmentalAudioResolver
• Verify: audio sync wind↑ -> rain -> thunder delay - DONE via EnvironmentalAudioResolver

​

FASE 10.C.7 - Cockpit Response

• CockpitResponseResolver.ts - rain/lightning/heat/cloud/turbulence presentation-only, HUD motion - DONE via CockpitResponseResolver
• Verify: cockpit gak ubah physics - DONE via CockpitResponseResolver

​

FASE 10.C.8 - Impact / Wreck

• ImpactPresentation.ts - impact->debris->smoke->dust->settling->wreck - DONE via ImpactPresentation (persistent wreck authority, transient flash presentation)
• Verify: health 0 -> wreck persist, flash transient - DONE via ImpactPresentation

​

FASE 10.C.9 - Facility Discovery

• FacilityDiscovery.ts + AtmosphericReveal.ts - distant->reveal->approach->hangar - DONE via FacilityDiscovery (no cutscene, FOG->SILHOUETTE->LIGHT->DETAIL)
• Verify: orbit night liat tiny emissive -> beacon -> runway - DONE via FacilityDiscovery

​

FASE 10.C.10 - Continuity & Budget

• CinematicBudget.ts - FAR->MEDIUM->NEAR->CINEMATIC - DONE via CinematicBudget + proximity->importance->cost + SPACE->FACILITY continuity
• Verify: SPACE->ORBIT->ATMOSPHERE->CLOUD->SURFACE->FACILITY no discontinuity, handoff/reconnect regenerate - DONE via CinematicBudget

Dependency final: 09 9-12 -> 10.1 -> 10.2 -> 10.3 -> 10.4 -> 10.5 -> 10.6 -> 10.X.1 -> 10.X.2 -> 10.X.3 -> 10.X.4 -> 10.G -> 10.E -> 10.C.1 -> 10.C.2 -> 10.C.3 -> 10.C.4 -> 10.C.5 -> 10.C.6 -> 10.C.7 -> 10.C.8 -> 10.C.9 -> 10.C.10 - gak lompat, tiap fase tau file + verify, no guessing, code 1:1 gampang.