world.ptah.character

ptah.world

Documentation

A person, creature, or entity inside a world. Characters take actions, participate in events, and accumulate history.

main record

A person, creature, or entity inside a world. Characters take actions, participate in events, and accumulate history.

Record Key tid Timestamp-based ID

Properties

authorshipRecord string did Optional

The DID of the original author if different from creator

avatar blob Optional

Avatar image for the character

maxSize: 1.0 MB
canonicalStatus string Optional

The canonical standing of this character

Known values: world.ptah.defs#canonicalStatusOfficial, world.ptah.defs#canonicalStatusCommunity, world.ptah.defs#canonicalStatusApocryphal
characterProperties ref #characterProperties Optional

Additional structured properties for this character

controlType string Optional

Who can act as this character — exclusive (creator only), open (anyone), or contested (multiple claimants)

Known values: exclusive, open, contested
createdAt string datetime Required

Timestamp when this character was created

creatorDID string did Required

The permanent identity of the character's creator

description string Optional

Who this character is

maxLength: 10240 bytesmaxGraphemes: 1024 graphemes
name string Required

The name of the character

maxLength: 640 bytesmaxGraphemes: 64 graphemes
originType string Optional

The intellectual property status of this character

Known values: originalIP, publicDomain, collaborativeCommons
templateReference string at-uri Optional

Reference to the template this character embodies (if any)

worldReference string at-uri Required

Reference to the world this character inhabits

View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "name",
      "creatorDID",
      "worldReference",
      "createdAt"
    ],
    "properties": {
      "name": {
        "type": "string",
        "maxLength": 640,
        "description": "The name of the character",
        "maxGraphemes": 64
      },
      "avatar": {
        "type": "blob",
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp"
        ],
        "maxSize": 1000000,
        "description": "Avatar image for the character"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when this character was created"
      },
      "creatorDID": {
        "type": "string",
        "format": "did",
        "description": "The permanent identity of the character's creator"
      },
      "originType": {
        "type": "string",
        "description": "The intellectual property status of this character",
        "knownValues": [
          "originalIP",
          "publicDomain",
          "collaborativeCommons"
        ]
      },
      "controlType": {
        "type": "string",
        "description": "Who can act as this character — exclusive (creator only), open (anyone), or contested (multiple claimants)",
        "knownValues": [
          "exclusive",
          "open",
          "contested"
        ]
      },
      "description": {
        "type": "string",
        "maxLength": 10240,
        "description": "Who this character is",
        "maxGraphemes": 1024
      },
      "worldReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the world this character inhabits"
      },
      "canonicalStatus": {
        "type": "string",
        "description": "The canonical standing of this character",
        "knownValues": [
          "world.ptah.defs#canonicalStatusOfficial",
          "world.ptah.defs#canonicalStatusCommunity",
          "world.ptah.defs#canonicalStatusApocryphal"
        ]
      },
      "authorshipRecord": {
        "type": "string",
        "format": "did",
        "description": "The DID of the original author if different from creator"
      },
      "templateReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the template this character embodies (if any)"
      },
      "characterProperties": {
        "ref": "#characterProperties",
        "type": "ref",
        "description": "Additional structured properties for this character"
      }
    }
  },
  "description": "A person, creature, or entity inside a world. Characters take actions, participate in events, and accumulate history."
}
characterProperties object

Structured metadata for characters

Properties

abilities string Optional

No description available.

maxLength: 2560 bytesmaxGraphemes: 256 graphemes
affiliation string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
age string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
role string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
species string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
View raw schema 
{
  "type": "object",
  "properties": {
    "age": {
      "type": "string",
      "maxLength": 640,
      "maxGraphemes": 64
    },
    "role": {
      "type": "string",
      "maxLength": 640,
      "maxGraphemes": 64
    },
    "species": {
      "type": "string",
      "maxLength": 640,
      "maxGraphemes": 64
    },
    "abilities": {
      "type": "string",
      "maxLength": 2560,
      "maxGraphemes": 256
    },
    "affiliation": {
      "type": "string",
      "maxLength": 640,
      "maxGraphemes": 64
    }
  },
  "description": "Structured metadata for characters"
}

Lexicon Garden

@