storage:save

Save Data

Use saveData for player progress, settings, unlocks, and small game-state snapshots.

saveDatastorageprogresslimits

Basic save example

saveData is intended for compact state. Do not store huge maps, logs, images, or full replays. Keep the save key stable and the value JSON-serializable.

Save keys are capped at 64 characters.
Serialized save payloads are capped at 20,000 characters.
Use one key per save slot or feature area.
Avoid putting personal data in saveData.

Save a checkpoint

await QubizSDK.requestPermissions(["storage:save"]);

const saveResult = await QubizSDK.saveData("main-slot", {
  level: 8,
  coins: 420,
  unlocked: ["dash", "double-jump"],
  updatedAt: new Date().toISOString()
});

if (saveResult.status !== "granted") {
  console.warn("Save skipped", saveResult.status);
}