Glaze Games SDK v3

<script src="https://glazegames.com/sdk/v3/glaze.js"></script>
<script>
  async function boot() {
    // 1. Connect to the platform (or fall back to the local simulator).
    const env = await Glaze.init();
    console.log('Glaze ready:', env.stage); // 'live' | 'qa' | 'local'

    // 2. Tell the platform your splash is done and play has started.
    Glaze.game.loadingStop();
    Glaze.game.gameplayStart();
  }
  boot();
</script>

const env = await Glaze.init();
// env: SdkEnvironment
//   sdkVersion: string
//   locale: string                 // e.g. 'en-US'
//   stage: 'qa' | 'live' | 'local' // 'local' === simulator
//   host: string
//   userAccountAvailable: boolean

Glaze.version;       // 'glaze-v3'
Glaze.isSimulator;   // true when running outside the platform
Glaze.environment;   // the SdkEnvironment, or null before init

Glaze.game.loadingStart();  // assets started loading (optional)
Glaze.game.loadingStop();   // loading done — REQUIRED once ready to play
Glaze.game.gameplayStart(); // a round/level started
Glaze.game.gameplayStop();  // a round/level ended (pause, death, menu)

// Signal a moment of delight (boss killed, level beaten). The platform
// uses these to time non-intrusive prompts.
Glaze.game.happytime();

// Invite / deep links. Build a shareable link with custom params, then
// read them back when a friend opens the game.
const link = await Glaze.game.inviteLink({ room: 'abc123' });
const room = Glaze.game.getInviteParam('room'); // 'abc123' | null

// Rewarded ad — only grant the reward when it actually finished.
await Glaze.ads.requestAd('rewarded', {
  adStarted:  () => pauseAndMute(),
  adFinished: () => { resume(); grantCoins(100); },
  adError:    (err) => { resume(); console.warn(err.code); },
});

// Interstitial between rounds.
const { shown } = await Glaze.ads.requestAd('midgame');

// Detect ad blockers so you can adjust your economy / messaging.
const blocked = await Glaze.ads.hasAdblock(); // boolean

// Fill the element with id="ad-slot".
await Glaze.banner.request({ id: 'ad-slot', width: 320, height: 50 });

await Glaze.banner.clear('ad-slot'); // remove one banner
await Glaze.banner.clearAll();       // remove every banner

// Is a player-account system available in this context?
const available = await Glaze.user.isUserAccountAvailable();

// Current player (or null if not signed in).
const user = await Glaze.user.getUser();
// user: { id: string, username: string, avatarUrl: string | null }

// Prompt sign-in; resolves with the user (or null if dismissed).
const signedIn = await Glaze.user.showAuthPrompt();

// React to sign-in / sign-out anywhere in your game.
function onAuth(u) { updateProfileUi(u); }
Glaze.user.addAuthListener(onAuth);
Glaze.user.removeAuthListener(onAuth);

const token = await Glaze.user.getUserToken();
await fetch('/my-api/sync', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + token },
});
// Server: verify against https://glazegames.com/sdk/v3/jwks.json

await Glaze.data.setItem('progress', { level: 7, coins: 320 });

const progress = await Glaze.data.getItem('progress');
// -> { level: 7, coins: 320 }  (or null if unset)

await Glaze.data.removeItem('progress');
await Glaze.data.clear(); // wipe all of this game's saved keys

// Submit a score (optionally with metadata). Returns the new rank.
const { rank } = await Glaze.leaderboards.submitScore('highscores', 9001, {
  combo: 12,
});

// Read a board.
const { entries } = await Glaze.leaderboards.getLeaderboard('highscores', {
  scope: 'global',   // or 'friends'
  period: 'weekly',  // 'alltime' | 'daily' | 'weekly'
  limit: 25,
});
// entries: { rank, username, score, meta? }[]

// Where does the current player sit?
const me = await Glaze.leaderboards.getPlayerEntry('highscores');

await Glaze.achievements.unlock('first-win');

const unlocked = await Glaze.achievements.getAll();
// -> ['first-win', ...]

const products = await Glaze.purchases.getAvailableProducts();
// products: { id, name, priceLabel, priceMicros, currency }[]

const purchase = await Glaze.purchases.purchase('remove-ads');
// purchase: { productId, purchasedAt, token }

const owned = await Glaze.purchases.getPurchases();

await Glaze.screen.requestFullscreen();
await Glaze.screen.exitFullscreen();

// 'portrait' | 'landscape' | 'any'
await Glaze.screen.lockOrientation('landscape');

Glaze.analytics.track('level_complete', { level: 7, time: 42.3 });

const dropRate = await Glaze.config.get('rare_drop_rate', 0.05);
const theme = await Glaze.config.get('event_theme', 'default');

Glaze.debug.show();      // open the devtools panel
Glaze.isSimulator;       // true when simulating
Glaze.environment.stage; // 'local' in the simulator