net.anisota.chronicle.achievement Documentation (EN)

DEPRECATED - superseded by net.anisota.chronicle.milestone. No new records are written to this collection; the schema is kept because earlier records still exist on users' PDSes and remain readable. rkey is the achievement ID (e.g. followers2500, level50). Immutable.

main record

Record Key any Any valid record key

Properties

achievementId string Required

Unique identifier for the achievement (e.g. 'followers2500', 'level50')

maxLength: 100 bytes

category string Required

Category of the achievement

Allowed: followers, level, social, collection, patterns, special, expedition

context ref #achievementContext Optional

No description available.

createdAt string datetime Required

When the achievement record was created

dailyRecordRef string Optional

AT URI of the daily record when the achievement was unlocked

description string Optional

Description of what was accomplished

maxLength: 500 bytes

name string Optional

Display name of the achievement

maxLength: 100 bytes

rarity string Optional

Rarity tier of the achievement

Allowed: common, uncommon, rare, epic, legendary

signature ref #chronicleSignature Required

No description available.

tier integer Optional

Tier or milestone value (e.g. 2500 for followers2500)

minimum: 0

unlockedAt string datetime Required

When the achievement was unlocked

xpReward integer Optional

XP awarded for this achievement

minimum: 0

View raw schema

{
  "description": "DEPRECATED - superseded by net.anisota.chronicle.milestone. No new records are written to this collection; the schema is kept because earlier records still exist on users' PDSes and remain readable. rkey is the achievement ID (e.g. followers2500, level50). Immutable.",
  "key": "any",
  "record": {
    "properties": {
      "achievementId": {
        "description": "Unique identifier for the achievement (e.g. 'followers2500', 'level50')",
        "maxLength": 100,
        "type": "string"
      },
      "category": {
        "description": "Category of the achievement",
        "enum": [
          "followers",
          "level",
          "social",
          "collection",
          "patterns",
          "special",
          "expedition"
        ],
        "type": "string"
      },
      "context": {
        "ref": "#achievementContext",
        "type": "ref"
      },
      "createdAt": {
        "description": "When the achievement record was created",
        "format": "datetime",
        "type": "string"
      },
      "dailyRecordRef": {
        "description": "AT URI of the daily record when the achievement was unlocked",
        "type": "string"
      },
      "description": {
        "description": "Description of what was accomplished",
        "maxLength": 500,
        "type": "string"
      },
      "name": {
        "description": "Display name of the achievement",
        "maxLength": 100,
        "type": "string"
      },
      "rarity": {
        "description": "Rarity tier of the achievement",
        "enum": [
          "common",
          "uncommon",
          "rare",
          "epic",
          "legendary"
        ],
        "type": "string"
      },
      "signature": {
        "ref": "#chronicleSignature",
        "type": "ref"
      },
      "tier": {
        "description": "Tier or milestone value (e.g. 2500 for followers2500)",
        "minimum": 0,
        "type": "integer"
      },
      "unlockedAt": {
        "description": "When the achievement was unlocked",
        "format": "datetime",
        "type": "string"
      },
      "xpReward": {
        "description": "XP awarded for this achievement",
        "minimum": 0,
        "type": "integer"
      }
    },
    "required": [
      "achievementId",
      "category",
      "unlockedAt",
      "signature",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}

achievementContext object

Contextual data at the time of achievement unlock

Properties

followerCount integer Optional

Follower count when achievement was unlocked

minimum: 0

level integer Optional

Player level when achievement was unlocked

minimum: 1

postCount integer Optional

Post count when achievement was unlocked

minimum: 0

specimenCount integer Optional

Specimen count when achievement was unlocked

minimum: 0

totalXP integer Optional

Total XP when achievement was unlocked

minimum: 0

View raw schema

{
  "description": "Contextual data at the time of achievement unlock",
  "properties": {
    "followerCount": {
      "description": "Follower count when achievement was unlocked",
      "minimum": 0,
      "type": "integer"
    },
    "level": {
      "description": "Player level when achievement was unlocked",
      "minimum": 1,
      "type": "integer"
    },
    "postCount": {
      "description": "Post count when achievement was unlocked",
      "minimum": 0,
      "type": "integer"
    },
    "specimenCount": {
      "description": "Specimen count when achievement was unlocked",
      "minimum": 0,
      "type": "integer"
    },
    "totalXP": {
      "description": "Total XP when achievement was unlocked",
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

chronicleSignature object

ES256 cryptographic signature proving record authenticity. The signature itself proves legitimacy - no separate verification lexicons needed.

Properties

alg string Required

Signing algorithm (ES256)

kid string Required

Key identifier for the signing key

nonce string Required

Unique random nonce to prevent replay

sig string Required

Base64-encoded ES256 signature

signedAt string datetime Required

When the record was signed

version integer Required

Signature schema version

View raw schema

{
  "description": "ES256 cryptographic signature proving record authenticity. The signature itself proves legitimacy - no separate verification lexicons needed.",
  "properties": {
    "alg": {
      "description": "Signing algorithm (ES256)",
      "type": "string"
    },
    "kid": {
      "description": "Key identifier for the signing key",
      "type": "string"
    },
    "nonce": {
      "description": "Unique random nonce to prevent replay",
      "type": "string"
    },
    "sig": {
      "description": "Base64-encoded ES256 signature",
      "type": "string"
    },
    "signedAt": {
      "description": "When the record was signed",
      "format": "datetime",
      "type": "string"
    },
    "version": {
      "description": "Signature schema version",
      "type": "integer"
    }
  },
  "required": [
    "sig",
    "alg",
    "kid",
    "signedAt",
    "nonce",
    "version"
  ],
  "type": "object"
}