Scene format

interface Clip {
  id: string
  name: string
  duration: number   // seconds
  loop: boolean
  tracks: Track[]
}

interface Track {
  partId: string     // the Part (or bone) it drives
  keys: Keyframe[]
}

interface Keyframe {
  t: number          // seconds
  pos?: Vec3
  rot?: Vec3         // Euler degrees
  scale?: Vec3
}

interface Trigger {
  on: 'touch' | 'interact' | 'stomp'
  once: boolean          // fire once, or every time
  needs?: string         // key name set by an 'unlock' action
  actions: TriggerAction[]
}

type TriggerAction =
  | { type: 'message'; text: string }
  | { type: 'score'; value: number }
  | { type: 'teleport'; x: number; y: number; z: number }
  | { type: 'remove'; target?: string }
  | { type: 'show'; target: string }
  | { type: 'win'; text?: string }
  | { type: 'lose'; text?: string }
  | { type: 'heal'; value: number }
  | { type: 'hurt'; value: number }
  | { type: 'speed'; value: number; seconds: number }
  | { type: 'spawn'; asset: string; role: EntityRole; count: number }
  | { type: 'unlock'; key: string }

interface GameRule {
  id: string
  name: string
  enabled: boolean
  once: boolean
  event: RuleEvent            // start, tick, touch, interact, kill, pickup, timer,
                              // variable, score, time, enter, leave
  conditions: RuleCondition[] // { name, op: '==' | '!=' | '>' | '>=' | '<' | '<=', value }
  actions: RuleAction[]       // every TriggerAction, plus setVar, addVar, spawnAt,
                              // removeTag, showTag, sound, mood, hud, timer, endRound
}

{
  "format": 2,
  "meta": {
    "title": "Hello Sandbox",
    "description": "One player on a small plain.",
    "mode": "explore",
    "createdAt": 1790000000000,
    "updatedAt": 1790000000000
  },
  "assets": [],
  "terrain": {
    "width": 4,
    "depth": 4,
    "heights": [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
    "colors": [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
    "palette": ["", "#6fbf5a"],
    "cell": 1
  },
  "entities": [
    { "id": "e1", "assetId": null, "role": "player", "pos": [0, 1, 0], "yaw": 0, "scale": 1, "params": {} }
  ],
  "rules": {},
  "vars": [],
  "gameRules": [],
  "settings": {},
  "hud": {},
  "scripts": []
}

function canonical(value: unknown): string {
  if (Array.isArray(value)) return `[${value.map(canonical).join(',')}]`
  if (value && typeof value === 'object') {
    const o = value as Record<string, unknown>
    return `{${Object.keys(o).sort()
      .filter((k) => o[k] !== undefined)
      .map((k) => `${JSON.stringify(k)}:${canonical(o[k])}`)
      .join(',')}}`
  }
  return JSON.stringify(value)
}

const hash = keccak256(toHex(canonical(doc)))