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