Function instantiateWorld

src/world/loader.ts:121–164

(world: WorldData, ctx: InstantiateContext)

// when present. Water and river rendering depend on engine additions that
// land in later tasks; for now they are no-ops with TODO warnings.
export function instantiateWorld(world: WorldData, ctx: InstantiateContext): InstantiateResult {
  const result: InstantiateResult = {
    entityHandles: new Map<string, SceneNodeHandle>(),
    terrainHandle: 0,
    warnings: [],
  };

  // Apply environment first so the first frame renders with correct lighting.
  applyEnvironment(world);

  // Terrain before entities so entities can drop onto it visually.
  if (world.terrain) {
    result.terrainHandle = spawnTerrain(world);
    if (result.terrainHandle !== 0 && ctx.onTerrainSpawned) {
      ctx.onTerrainSpawned(result.terrainHandle);
    }
  }

  // Spawn each entity. Prefab entities are expanded into a root group node
  // with one child per leaf glb.
  for (let i = 0; i < world.entities.length; i++) {
    const entity = world.entities[i];
    const handle = spawnEntity(entity, ctx, result.warnings);
    if (handle !== 0) {
      result.entityHandles.set(entity.id, handle);
      if (ctx.onEntitySpawned) {
        ctx.onEntitySpawned(entity.id, handle);
      }
    }
  }

  if (world.water.length > 0) {
    result.warnings.push(
      'world has ' + world.water.length + ' water volume(s) — water rendering pending engine Q8 shader',
    );
  }
  if (world.rivers.length > 0) {
    result.warnings.push(
      'world has ' + world.rivers.length + ' river(s) — river rendering pending engine Q9 spline ribbon helper',
    );
  }

  return result;
}

// Build the terrain mesh from the heightmap grid and upload it to a dedicated
// scene node. Called once per world load; the editor's brush tool re-uploads