world.ptah.location

ptah.world

Documentation

A place inside a world. Where things happen. Locations nest infinitely — a room inside a building inside a city inside a territory.

main record

A place inside a world. Where things happen. Locations nest infinitely — a room inside a building inside a city inside a territory.

Record Key tid Timestamp-based ID

Properties

canonicalStatus string Optional

The canonical standing of this location

Known values: world.ptah.defs#canonicalStatusOfficial, world.ptah.defs#canonicalStatusCommunity, world.ptah.defs#canonicalStatusApocryphal
createdAt string datetime Required

Timestamp when this location was created

creatorDID string did Required

The permanent identity of the location's creator

depthIndex integer Optional

Nesting depth — 0 for top-level, incrementing for each level down

minimum: 0
description string Optional

What this location is like

maxLength: 10240 bytesmaxGraphemes: 1024 graphemes
locationProperties ref #locationProperties Optional

Additional structured properties for this location

locationType string Optional

The type of location

Known values: territory, city, building, room, landmark, wilderness, vessel, virtual
name string Required

The name of the location

maxLength: 640 bytesmaxGraphemes: 64 graphemes
parentLocation string at-uri Optional

Reference to the parent location (if nested)

worldReference string at-uri Required

Reference to the world this location exists in

View raw schema 
{
  "description": "A place inside a world. Where things happen. Locations nest infinitely — a room inside a building inside a city inside a territory.",
  "key": "tid",
  "record": {
    "properties": {
      "canonicalStatus": {
        "description": "The canonical standing of this location",
        "knownValues": [
          "world.ptah.defs#canonicalStatusOfficial",
          "world.ptah.defs#canonicalStatusCommunity",
          "world.ptah.defs#canonicalStatusApocryphal"
        ],
        "type": "string"
      },
      "createdAt": {
        "description": "Timestamp when this location was created",
        "format": "datetime",
        "type": "string"
      },
      "creatorDID": {
        "description": "The permanent identity of the location's creator",
        "format": "did",
        "type": "string"
      },
      "depthIndex": {
        "description": "Nesting depth — 0 for top-level, incrementing for each level down",
        "minimum": 0,
        "type": "integer"
      },
      "description": {
        "description": "What this location is like",
        "maxGraphemes": 1024,
        "maxLength": 10240,
        "type": "string"
      },
      "locationProperties": {
        "description": "Additional structured properties for this location",
        "ref": "#locationProperties",
        "type": "ref"
      },
      "locationType": {
        "description": "The type of location",
        "knownValues": [
          "territory",
          "city",
          "building",
          "room",
          "landmark",
          "wilderness",
          "vessel",
          "virtual"
        ],
        "type": "string"
      },
      "name": {
        "description": "The name of the location",
        "maxGraphemes": 64,
        "maxLength": 640,
        "type": "string"
      },
      "parentLocation": {
        "description": "Reference to the parent location (if nested)",
        "format": "at-uri",
        "type": "string"
      },
      "worldReference": {
        "description": "Reference to the world this location exists in",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "name",
      "creatorDID",
      "worldReference",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
locationProperties object

Structured metadata for locations

Properties

climate string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
controllingFaction string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
notableHistory string Optional

No description available.

maxLength: 2560 bytesmaxGraphemes: 256 graphemes
population string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
View raw schema 
{
  "description": "Structured metadata for locations",
  "properties": {
    "climate": {
      "maxGraphemes": 64,
      "maxLength": 640,
      "type": "string"
    },
    "controllingFaction": {
      "maxGraphemes": 64,
      "maxLength": 640,
      "type": "string"
    },
    "notableHistory": {
      "maxGraphemes": 256,
      "maxLength": 2560,
      "type": "string"
    },
    "population": {
      "maxGraphemes": 64,
      "maxLength": 640,
      "type": "string"
    }
  },
  "type": "object"
}

Lexicon Garden

@