Docs

Replace the sample state, rebuildScene, startGameLoop and showStartupError with your game implementation. Use the generated game ID and save-format version.

<script src="https://www.ai-made.games/sdk/cloud-saves-v1.js"></script>
<script>
let state = { level: 1, inventory: [], playSeconds: 0 };

async function boot() {
  try {
    await AIWanna.saves.initialize({
      platformOrigin: 'https://www.ai-made.games',
      gameId: 'YOUR_GAME_ID',
      schemaVersion: 1,
      gameVersion: '1.0.0',
      exportState: () => structuredClone(state),
      importState: async data => {
        state = data;
        await rebuildScene(state);
      },
      summary: data => 'Level ' + data.level
    });
    startGameLoop();
  } catch (error) {
    showStartupError(error.message);
  }
}

async function checkpointReached() {
  try { await AIWanna.saves.save(); }
  catch (error) { console.warn('Save needs attention:', error.code); }
}
boot();
</script>

This is a transport example. A complete integration also needs the dedicated cloud-save-session handshake, local retry queue and management-command acknowledgments described in the full protocol.

// Transport example: token comes from the cloud-save-session handshake.
// Call only after validating game/account identity. Do not use a leaderboard token.
const platformOrigin = 'https://www.ai-made.games';
const gameId = 'YOUR_GAME_ID';
const endpoint = platformOrigin + '/api/v1/games/' + gameId + '/saves/main';

async function readProgress(token) {
  const response = await fetch(endpoint, {
    credentials: 'omit',
    headers: { Authorization: 'Bearer ' + token },
    signal: AbortSignal.timeout(15000)
  });
  const result = await response.json();
  if (!response.ok) throw Object.assign(new Error(result.error.message), {
    code: result.error.code
  });
  return result; // { save: snapshot | null, revision }
}

// Only prepare after readProgress succeeds and the player resolves any conflict.
// Persist this exact { key, body } locally before sending it.
function prepareCheckpoint(lastRead, state, schemaVersion) {
  return {
    key: crypto.randomUUID(),
    body: JSON.stringify({
      protocolVersion: 1, schemaVersion, gameVersion: '1.0.0',
      summary: 'Level ' + state.level,
      baseRevision: lastRead.revision, data: state
    })
  };
}

async function sendCheckpoint(token, pending) {
  const response = await fetch(endpoint, {
    method: 'PUT', credentials: 'omit',
    headers: {
      Authorization: 'Bearer ' + token,
      'Content-Type': 'application/json', 'Idempotency-Key': pending.key
    },
    body: pending.body, signal: AbortSignal.timeout(15000)
  });
  const result = await response.json();
  if (!response.ok) throw Object.assign(new Error(result.error.message), {
    code: result.error.code, retryAfter: response.headers.get('Retry-After')
  });
  return result; // Metadata and revision; state stays in the acknowledged local snapshot.
}
// Retries reuse pending.key and pending.body, even after refreshing a token.
// On 409, retain both versions and obtain the player's choice before a NEW write.
// Add the local queue, startup gate and command acknowledgements from the full guide.