{"tab":"world","section":"unassignedAreas","title":"Areas","summary":"A holding bay for areas that no location claims. Studio puts an area here when it loses its location, and the world cannot be saved or published while any entry remains.","kind":"schema","uiLocation":"Content → World → Areas","uiSubtitle":"\"Areas within this location. Think of these as sub-locations within a location.\"","editor":"Edit in Studio + View JSON","related":[{"section":"locations","note":"an area belongs under a location's `areas`; this section is where it waits until one claims it"}],"wikiUrl":"/world/unassignedAreas","schema":{"_type":"record","domain":"string","codomain":{"_type":"intersection","parts":[{"_type":"partial","fields":{"description":"string","paths":{"_type":"array","of":"string"}}},{"_type":"partial","fields":{"images":{"_type":"intersection","parts":[{"_type":"partial","fields":{"establishingShot":{"_type":"intersection","parts":[{"_type":"partial","fields":{"crop":{"_type":"intersection","parts":[{"_type":"partial","fields":{"focus":{"_type":"intersection","parts":[{"_type":"partial","fields":{"x":"number","y":"number"}}]},"zoom":"number"}}]}}},{"_type":"partial","fields":{"imageUrl":"string"}}]}}}]},"visualTags":{"_type":"array","of":"string"}}}]}},"sizeLimits":[],"blocks":[{"type":"example","lang":"json","code":"{\n  \"unassignedAreas\": {\n    \"Old%20Mill/Quiet%20Hollow\": {\n      \"description\": \"A shaded bend in the river where the mill wheel has not turned in years.\",\n      \"paths\": [],\n      \"visualTags\": [\n        \"river\",\n        \"abandoned\"\n      ]\n    }\n  }\n}"},{"type":"fields","fields":[{"name":"description","tooltip":"What the area is. Required.","md":"What the area is, in the same terms a [location](/world/locations)'s own `areas` entry uses. Required."},{"name":"paths","tooltip":"Area keys this one connects to. Required, and may be empty.","md":"The area keys this one connects to. Required, and an empty array is valid — an area waiting for a location usually has nowhere to lead yet."},{"name":"visualTags","tooltip":"Short descriptors the image generator reads.","md":"Short descriptors the image generator reads. Optional."},{"name":"images.establishingShot","tooltip":"The area's establishing shot. Optional, but once present its crop is required.","md":"The area's establishing shot. Optional as a whole, but once it is present the `crop` is required, and that crop needs a `focus` of `x` and `y` plus a `zoom`. `imageUrl` is the optional part."}]},{"type":"prose","md":"## How entries get here\n\nAn entry appears when an area stops belonging to a location, such as when it is detached from it in Studio. The area keeps its own content; only its place in the map is gone.\n\nStudio writes the entry and its key for you, so this is not a section you author from scratch."},{"type":"prose","md":"## Every entry blocks save and publish\n\nAn area here has no place on the map, so the world will not save or publish while the section holds anything. Give each entry a location, or delete it.\n\nThis is the one section whose contents are an error by definition: an empty `unassignedAreas` is the healthy state, and a populated one is a draft midway through a change."}],"body":"## Example\n\n```json\n{\n  \"unassignedAreas\": {\n    \"Old%20Mill/Quiet%20Hollow\": {\n      \"description\": \"A shaded bend in the river where the mill wheel has not turned in years.\",\n      \"paths\": [],\n      \"visualTags\": [\n        \"river\",\n        \"abandoned\"\n      ]\n    }\n  }\n}\n```\n\n## Fields\n\n### description\n\nWhat the area is, in the same terms a [location](/world/locations)'s own `areas` entry uses. Required.\n\n### paths\n\nThe area keys this one connects to. Required, and an empty array is valid — an area waiting for a location usually has nowhere to lead yet.\n\n### visualTags\n\nShort descriptors the image generator reads. Optional.\n\n### images.establishingShot\n\nThe area's establishing shot. Optional as a whole, but once it is present the `crop` is required, and that crop needs a `focus` of `x` and `y` plus a `zoom`. `imageUrl` is the optional part.\n\n## How entries get here\n\nAn entry appears when an area stops belonging to a location, such as when it is detached from it in Studio. The area keeps its own content; only its place in the map is gone.\n\nStudio writes the entry and its key for you, so this is not a section you author from scratch.\n\n## Every entry blocks save and publish\n\nAn area here has no place on the map, so the world will not save or publish while the section holds anything. Give each entry a location, or delete it.\n\nThis is the one section whose contents are an error by definition: an empty `unassignedAreas` is the healthy state, and a populated one is a draft midway through a change."}