Docs/Spatial Context

Spatial Context

Spatial Context is Mistscale's real-time environmental awareness covering location, time, weather, and freeform context that shapes how an NPC responds in the moment. It's deliberately short-lived (five minutes) because stale context is worse than no context.

Spatial Context tells the NPC where it is and what's happening around it right now. It's deliberately short-lived (five minutes), because the world moves fast and stale context is worse than no context.

What it carries

location
A semantic place name like "The Rusty Anchor Tavern". Required.
time_of_day
Optional descriptor like "midnight" or "noon".
weather
Optional descriptor like "rain" or "thunderstorm".
context
Optional free-form data: crowd level, danger level, nearby threats, anything else the NPC should react to.
Note
Spatial context expires automatically after five minutes if not refreshed. This keeps NPCs honest about what they currently perceive.
Platform availability
Spatial context is wired through the system but primarily intended for runtime integrations (e.g. a future Unity SDK). The dashboard does not currently expose a UI for setting it manually.