One player identity. Any web stack.

<script src="https://games.riz.africa/riz-games-sdk.js"></script>

<!-- TypeScript projects can pull in the ambient types: -->
<!-- https://games.riz.africa/riz-games-sdk.d.ts -->

// 1. Open the run. Resolves once Riz has issued a session.
const { player, game, capabilities } = await RizGames.init({
  gameKey: "riz_game_your_public_key"
});
showPlayerName(player.displayName);

// 2. Mark the start of a real run. Begins active-time measurement.
await RizGames.game.start();

// 3. Report progress as it happens.
await RizGames.score.submit(2400);
await RizGames.analytics.level.complete("level-1", { time: 42 });
await RizGames.analytics.track("shop_opened", { source: "lobby" });

// 4. Finish. Score, rank and RP come back from the Riz server.
const run = await RizGames.game.end(2400);
showResults(run.score, run.rpEarned, run.rank);

// Unity WebGL, Godot, or any build with a long download.
// Works before initialize(). Report while you are still loading.
createUnityInstance(canvas, config, (fraction) => {
  RizGames.loading.progress(fraction);   // drives the Riz loading bar
}).then(() => {
  RizGames.loading.ready();              // dismisses the loading screen
  return RizGames.init({ gameKey: "riz_game_..." });
}).catch((error) => {
  RizGames.loading.failed(error.message); // shows the player a retry screen
});

// WRONG: a 60fps loop burns the run's 500-event budget in seconds.
function onFrame() { RizGames.score.submit(score); }

// RIGHT: report on meaningful change, and always at the end.
function onCheckpoint() { RizGames.score.submit(score); }
function onGameOver()   { RizGames.game.end(score); }

// The live ceilings, sent by the server at handshake:
const { limits } = RizGames.getSession();
limits.maxEventsPerSession;  // 500
limits.maxEventsPerMinute;   // 120
limits.maxAdEventsPerSession; // 120, metered separately from gameplay

// What this game is allowed to do is an operator setting, not a
// property of the SDK build. Ask before you offer the feature.
if (RizGames.supports("data.storage")) {
  await RizGames.data.setItem("save", JSON.stringify(state));
}

if (RizGames.supports("ads.rewarded")) {
  const ad = await RizGames.ads.rewarded({ placement: "continue" });
  if (ad.rewarded) grantExtraLife();   // never infer this from ad.completed
}

// A disabled capability rejects with capability_disabled. The method is
// always present, so this never throws a TypeError.

// Opened outside the Riz wrapper (a local dev server, or the file
// straight from disk), the SDK runs in demo mode instead of hanging.
// Every call resolves locally and the console says so.
await RizGames.init({ gameKey: "riz_game_your_public_key" });

RizGames.environment;   // "local" while developing, "production" on Riz
RizGames.dev.isDemo();  // same question, as a boolean
RizGames.dev.log();     // every operation your build attempted

// Force demo mode on any host, including a staging deploy:
//   https://your-game.example.com/?rizLocalSdk=true

// Script the outcomes you cannot trigger on demand:
RizGames.dev.simulate({ ads: { outcome: "skipped", durationMs: 3000 } });
RizGames.dev.forceError("rate_limited");

// Force the strict behaviour when you want to test the real handshake:
await RizGames.init({ gameKey: "...", sandbox: false });

// In-game leaderboard, including the player's own row even when
// they are outside the top slice.
const board = await RizGames.leaderboard.get({ limit: 10 });
board.entries.forEach((e) => draw(e.rank, e.displayName, e.score));
if (board.you) drawYou(board.you.rank, board.you.score);

// Live player record, including the RP balance after the last run.
const me = await RizGames.user.get();

try {
  await RizGames.score.submit(score);
} catch (error) {
  // error.code is stable; error.message is not.
  if (error.code === "session_expired") showReconnectScreen();
  else if (error.permanent) reportBug(error);
  // Transient failures never reach here. The SDK already retried them.
}

RizGames.on("session-ended", ({ code }) => pauseGame(code));
RizGames.on("progress", ({ rpBalance }) => updateHud(rpBalance));