world.ptah.temp.location

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "locationProperties": {
      "description": "Flexible properties for any kind of world geography. All fields optional — worlds define what matters.",
      "properties": {
        "climate": {
          "maxGraphemes": 256,
          "maxLength": 2560,
          "type": "string"
        },
        "controllingFaction": {
          "maxGraphemes": 256,
          "maxLength": 2560,
          "type": "string"
        },
        "notableHistory": {
          "maxGraphemes": 1024,
          "maxLength": 10240,
          "type": "string"
        },
        "population": {
          "maxGraphemes": 256,
          "maxLength": 2560,
          "type": "string"
        }
      },
      "type": "object"
    },
    "main": {
      "description": "A pin dropped on a map that does not exist yet. The pin creates the place. Hwt-ka-Ptah — the House of the Ka of Ptah — gave Egypt its name. A place becomes so significant that it names everything around it.",
      "key": "tid",
      "record": {
        "properties": {
          "authorshipRecord": {
            "description": "Permanent link to the creator. Provenance travels.",
            "format": "did",
            "type": "string"
          },
          "canonicalStatus": {
            "description": "The canonical standing of this location within its world.",
            "knownValues": [
              "world.ptah.temp.defs#canonicalStatusOfficial",
              "world.ptah.temp.defs#canonicalStatusCommunity",
              "world.ptah.temp.defs#canonicalStatusApocryphal"
            ],
            "type": "string"
          },
          "createdAt": {
            "description": "Timestamp of location creation.",
            "format": "datetime",
            "type": "string"
          },
          "creatorDID": {
            "description": "Who named and defined this place.",
            "format": "did",
            "type": "string"
          },
          "depthIndex": {
            "description": "How deep in the geographic hierarchy this location sits. World-level is 0, continent is 1, country is 2, city is 3, and so on. Any rendering layer can read this single number and decide how much geographic context it needs without traversing the full parent chain.",
            "minimum": 0,
            "type": "integer"
          },
          "description": {
            "description": "What kind of place this is, in plain language.",
            "maxGraphemes": 1024,
            "maxLength": 10240,
            "type": "string"
          },
          "locationType": {
            "description": "The geographic or spatial classification. Open-ended so any kind of world geography works.",
            "knownValues": [
              "city",
              "region",
              "building",
              "territory",
              "landmark",
              "vessel",
              "abstractSpace"
            ],
            "maxGraphemes": 64,
            "maxLength": 640,
            "type": "string"
          },
          "name": {
            "description": "What this place is called.",
            "maxGraphemes": 64,
            "maxLength": 640,
            "type": "string"
          },
          "parentLocation": {
            "description": "If this location exists inside a larger location — a tavern inside a city, a room inside a building. Lets geography nest infinitely. Places come into existence as people need them.",
            "format": "at-uri",
            "type": "string"
          },
          "properties": {
            "description": "Flexible fields — climate, population, controlling faction, notable history. Whatever the world requires.",
            "ref": "#locationProperties",
            "type": "ref"
          },
          "worldReference": {
            "description": "The AT URI of the world this location exists in.",
            "format": "at-uri",
            "type": "string"
          }
        },
        "required": [
          "name",
          "creatorDID",
          "worldReference",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A location record in The Ptah Protocol. A place inside a world — what gives events and actions an address. Without it, things happen in the world but they happen nowhere specific. With it, history accumulates in places and places develop gravity over time.",
  "id": "world.ptah.temp.location",
  "lexicon": 1
}