# World Manifest Reference

The file `world/manifest.toml` defines the world identity and spawn location. There is exactly one manifest per world.

## Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | World name (e.g. shown at login). |
| `spawn_room` | string | Yes | Full room ID where new characters and respawned dead characters appear (e.g. `"town:town_square"`). Must reference an existing room. |

## Example

```toml
name = "The Shattered Realm"
spawn_room = "town:town_square"
```

## Directory layout

The loader expects (under `world/`):

- `manifest.toml` — this file
- `races/*.toml` — race definitions (see `races/RACES.md`)
- `classes/*.toml` — class definitions (see `classes/CLASSES.md`)
- `guilds/*.toml` — guild definitions (see `guilds/GUILDS.md`)
- `spells/*.toml` — spell definitions (see `spells/SPELLS.md`)
- `<region>/` — one folder per region (e.g. `town/`), each containing:
  - `region.toml` — region metadata (see `town/REGION.md`)
  - `rooms/*.toml` — rooms (see `town/rooms/ROOMS.md`)
  - `npcs/*.toml` — NPCs (see `town/npcs/NPCS.md`)
  - `objects/*.toml` — objects (see `town/objects/OBJECTS.md`)

Folder names `races`, `classes`, `guilds`, and `spells` are reserved; other top-level directories are treated as regions.