world.ptah.world

ptah.world

Documentation

The foundational record. Everything else references it. A world must exist before characters, events, or logs can exist inside it.

main record

The foundational record. Everything else references it. A world must exist before characters, events, or logs can exist inside it.

Record Key tid Timestamp-based ID

Properties

canonicalStatus string Optional

The canonical standing of this world

Known values: world.ptah.defs#canonicalStatusOfficial, world.ptah.defs#canonicalStatusCommunity, world.ptah.defs#canonicalStatusApocryphal
coverImage blob Optional

Cover image for the world

maxSize: 1.0 MB
createdAt string datetime Required

Timestamp when this world was created

creatorDID string did Required

The permanent identity of the world's originator

description string Optional

What kind of world this is

maxLength: 10240 bytesmaxGraphemes: 1024 graphemes
governanceMode string Optional

The constitutional posture of the world — sandbox (anything goes), governed (originator rules), or constitutional (community governance)

Known values: sandbox, governed, constitutional
name string Required

The name of the world

maxLength: 640 bytesmaxGraphemes: 64 graphemes
renderingHints ref #renderingHints Optional

Metadata that tells rendering clients what kind of world this is

sourceReference string Optional

If sourceType is publicDomain, the specific source material

maxLength: 2560 bytesmaxGraphemes: 256 graphemes
sourceType string Optional

The intellectual property status of this world

Known values: world.ptah.defs#sourceTypeOriginalIP, world.ptah.defs#sourceTypePublicDomain, world.ptah.defs#sourceTypeCollaborativeCommons
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "name",
      "creatorDID",
      "createdAt"
    ],
    "properties": {
      "name": {
        "type": "string",
        "maxLength": 640,
        "description": "The name of the world",
        "maxGraphemes": 64
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when this world was created"
      },
      "coverImage": {
        "type": "blob",
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp"
        ],
        "maxSize": 1000000,
        "description": "Cover image for the world"
      },
      "creatorDID": {
        "type": "string",
        "format": "did",
        "description": "The permanent identity of the world's originator"
      },
      "sourceType": {
        "type": "string",
        "description": "The intellectual property status of this world",
        "knownValues": [
          "world.ptah.defs#sourceTypeOriginalIP",
          "world.ptah.defs#sourceTypePublicDomain",
          "world.ptah.defs#sourceTypeCollaborativeCommons"
        ]
      },
      "description": {
        "type": "string",
        "maxLength": 10240,
        "description": "What kind of world this is",
        "maxGraphemes": 1024
      },
      "governanceMode": {
        "type": "string",
        "description": "The constitutional posture of the world — sandbox (anything goes), governed (originator rules), or constitutional (community governance)",
        "knownValues": [
          "sandbox",
          "governed",
          "constitutional"
        ]
      },
      "renderingHints": {
        "ref": "#renderingHints",
        "type": "ref",
        "description": "Metadata that tells rendering clients what kind of world this is"
      },
      "canonicalStatus": {
        "type": "string",
        "description": "The canonical standing of this world",
        "knownValues": [
          "world.ptah.defs#canonicalStatusOfficial",
          "world.ptah.defs#canonicalStatusCommunity",
          "world.ptah.defs#canonicalStatusApocryphal"
        ]
      },
      "sourceReference": {
        "type": "string",
        "maxLength": 2560,
        "description": "If sourceType is publicDomain, the specific source material",
        "maxGraphemes": 256
      }
    }
  },
  "description": "The foundational record. Everything else references it. A world must exist before characters, events, or logs can exist inside it."
}
renderingHints object

Flexible metadata for rendering clients

Properties

aesthetic string Optional

Visual or stylistic direction (e.g., minimalist, baroque, wasteland sparse)

maxLength: 640 bytesmaxGraphemes: 64 graphemes
era string Optional

The time period or setting (e.g., Victorian, far future, mythic)

maxLength: 640 bytesmaxGraphemes: 64 graphemes
genre string Optional

The genre classification (e.g., fantasy, noir, romance, publication)

maxLength: 640 bytesmaxGraphemes: 64 graphemes
tone string Optional

The emotional register of the world (e.g., dark, whimsical, gritty)

maxLength: 640 bytesmaxGraphemes: 64 graphemes
View raw schema 
{
  "type": "object",
  "properties": {
    "era": {
      "type": "string",
      "maxLength": 640,
      "description": "The time period or setting (e.g., Victorian, far future, mythic)",
      "maxGraphemes": 64
    },
    "tone": {
      "type": "string",
      "maxLength": 640,
      "description": "The emotional register of the world (e.g., dark, whimsical, gritty)",
      "maxGraphemes": 64
    },
    "genre": {
      "type": "string",
      "maxLength": 640,
      "description": "The genre classification (e.g., fantasy, noir, romance, publication)",
      "maxGraphemes": 64
    },
    "aesthetic": {
      "type": "string",
      "maxLength": 640,
      "description": "Visual or stylistic direction (e.g., minimalist, baroque, wasteland sparse)",
      "maxGraphemes": 64
    }
  },
  "description": "Flexible metadata for rendering clients"
}

Lexicon Garden

@