# world.ptah.world

> Published by [ptah.world](https://lexicon.garden/identity/did:plc:l45z35sxxjuobp5q65a5vu22)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.world)
- [Documentation](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.world/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.world/examples)

## Definitions

### `world.ptah.world`

**Type**: `record`

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

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | The name of the world |
| `createdAt` | `string` (datetime) | Yes | Timestamp when this world was created |
| `coverImage` | `blob` | No | Cover image for the world |
| `creatorDID` | `string` (did) | Yes | The permanent identity of the world's originator |
| `sourceType` | `string` | No | The intellectual property status of this world |
| `description` | `string` | No | What kind of world this is |
| `governanceMode` | `string` | No | The constitutional posture of the world — sandbox (anything goes), governed (originator rules), or constitutional (community governance) |
| `renderingHints` | `ref` → `#renderingHints` | No | Metadata that tells rendering clients what kind of world this is |
| `canonicalStatus` | `string` | No | The canonical standing of this world |
| `sourceReference` | `string` | No | If sourceType is publicDomain, the specific source material |

### `world.ptah.world#renderingHints`

**Type**: `object`

Flexible metadata for rendering clients

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `era` | `string` | No | The time period or setting (e.g., Victorian, far future, mythic) |
| `tone` | `string` | No | The emotional register of the world (e.g., dark, whimsical, gritty) |
| `genre` | `string` | No | The genre classification (e.g., fantasy, noir, romance, publication) |
| `aesthetic` | `string` | No | Visual or stylistic direction (e.g., minimalist, baroque, wasteland sparse) |

## Raw Schema

```json
{
  "id": "world.ptah.world",
  "defs": {
    "main": {
      "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": {
      "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"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```