app.racethesky.run

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A single Race the Sky time-trial run, published by the player into their own repo. The record stores the raw input log rather than a result: the game's physics are deterministic, so re-simulating the log reproduces the run exactly. Owning the record is the identity proof, and replaying it is the time proof — the claimed time in this record is advisory and is never trusted by a leaderboard.",
      "key": "tid",
      "record": {
        "properties": {
          "bestMs": {
            "description": "The client's own best-lap figure in milliseconds, for display before a run is verified. Advisory only — the authoritative time is whatever replaying `events` produces.",
            "minimum": 0,
            "type": "integer"
          },
          "createdAt": {
            "description": "Client-reported time the run was set.",
            "format": "datetime",
            "type": "string"
          },
          "events": {
            "description": "The whole run, as the only input the game takes: when the tether was held. Comma-separated `<delta><d|u>` pairs, where delta is ticks since the previous event at a fixed 120 Hz step, `d` is press and `u` is release. Example: `43d,17u,29d`.",
            "maxLength": 20000,
            "type": "string"
          },
          "laps": {
            "description": "Laps the session ran. Session length is a player preference, not a fairness variable — circuits rank best single lap — but the replay must run the same number of laps to reproduce it.",
            "maximum": 9,
            "minimum": 1,
            "type": "integer"
          },
          "simVersion": {
            "description": "Which physics produced this log. A verifier must replay under the matching version or refuse the run — replaying under different physics yields a plausible wrong time rather than an error.",
            "minimum": 1,
            "type": "integer"
          },
          "style": {
            "description": "Opaque encoding of the player's ship livery, so a replayed ghost looks like the ship that set the time.",
            "maxLength": 64,
            "type": "string"
          },
          "track": {
            "description": "DEPRECATED. The course's index in the client's built-in roster, which is a display-order detail and may change. Present only so a client and server deployed minutes apart still agree. Readers must prefer trackId and ignore this whenever trackId is present.",
            "minimum": 0,
            "type": "integer"
          },
          "trackId": {
            "description": "Permanent identity of the course raced. Append-only: ids are never reordered, renamed, or reused.",
            "knownValues": [
              "nebula-weave",
              "solar-loop",
              "quasar-gp",
              "photon-oval",
              "aurora-run",
              "eclipse",
              "baja"
            ],
            "maxLength": 64,
            "type": "string"
          },
          "weather": {
            "description": "Conditions the run was set under. Non-clear conditions change the physics and are ranked separately from clear times.",
            "knownValues": [
              "clear",
              "rain",
              "fog",
              "night"
            ],
            "type": "string"
          }
        },
        "required": [
          "trackId",
          "simVersion",
          "events",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.racethesky.run",
  "lexicon": 1
}