Function loadWorld

src/world/loader.ts:95–115

(path: string)

// Read, parse, migrate, and validate a world file. Throws on parse error or
// validation failure — the caller can catch and present the error message.
export function loadWorld(path: string): WorldData {
  const text = readFile(path);
  if (!text || text.length === 0) {
    throw new Error('loadWorld: file is empty or missing: ' + path);
  }

  let raw: WorldData;
  try {
    raw = JSON.parse(text) as WorldData;
  } catch (e) {
    throw new Error('loadWorld: invalid JSON in ' + path + ': ' + (e as Error).message);
  }

  const migrated = migrateWorldData(raw);
  const check = validateWorld(migrated);
  if (!check.ok) {
    throw new Error('loadWorld: ' + path + '\n' + formatValidationErrors(check.errors));
  }

  return migrated;
}

// Spawn scene nodes for every entity in the world and apply environment
// settings (lighting, shadows). Terrain, water, and rivers are also spawned