Hoppa till innehållet
ZokoGames

Logga in

Den här sidan är inte översatt ännu och visas på engelska.

Embedding and sitelock policy

På den här sidan

Embedding and sitelock policy

Where your game runs#

A game uploaded to ZokoGames is served from its own origin:

https://g-<your-game-slug>.zokogames.com/<build-id>/index.html

Covers come from https://imgs.zokogames.com/. Because each game has its own origin, your localStorage, cookies and service workers are isolated from every other game and from the portal. The portal page embeds the game in an iframe and the SDK talks to it through postMessage.

The iframe sandbox#

The frame carries these sandbox tokens:

allow-scripts allow-same-origin allow-forms allow-pointer-lock
allow-orientation-lock allow-modals allow-downloads allow-presentation

Popups are opt-in per game: tick the popup option in the technical step of the submission if you need one (for example an OAuth window). Without it, window.open and target="_blank" links are blocked.

The frame also delegates these permissions: autoplay, fullscreen, gamepad, clipboard-write, accelerometer, gyroscope, microphone, camera, xr-spatial-tracking and keyboard-map. A browser can still ask the player before it grants camera or microphone.

What this means in practice:

  • Do not depend on window.top, window.parent content or cookies shared with another site. Use SDK.data for saves.
  • Do not add your own fullscreen button. The portal provides one.
  • Pointer lock works after a user gesture. Handle Escape by pausing.
  • Navigation of the top window is blocked. Do not redirect players away from the game.

Sitelock#

Sitelock stops people re-hosting your build. It is optional, and it must never lock out the portal or your own testing.

const host = location.hostname;
const allowed =
  host === "zokogames.com" || host.endsWith(".zokogames.com") ||
  host === "localhost" || host === "127.0.0.1" || host.endsWith(".localhost");

if (!allowed) {
  document.body.textContent = "Play this game on zokogames.com";
  throw new Error("sitelock");
}

Rules:

  1. Allow zokogames.com and every subdomain of it. Game origins use the g-<slug> pattern today and may change; never lock to one exact hostname.
  2. Allow localhost so the SDK's local mode and the Preview tool keep working.
  3. Run the check before you load assets, but do not block the first frame on a network call.
  4. A visible message beats a blank screen. Reviewers must be able to tell a sitelock from a crash.

Hosting on your own server#

If you choose "on your own server" in the submission, your https page must allow being framed by the portal:

Content-Security-Policy: frame-ancestors 'self' https://zokogames.com https://*.zokogames.com

Do not send X-Frame-Options: DENY or SAMEORIGIN. Cross-origin cookies are not available in the frame, so use the data module and the verified token for identity. Games on your own host only earn when they use the SDK, and they are judged on time to gameplay. See technical requirements.

Embedding the SDK handshake#

You do not need to code the handshake. SDK.init() posts a request to the parent window, pins the origin that answers and ignores messages from anywhere else. If no portal answers within 1.5 seconds, the SDK falls back to local mode on localhost (or when the URL has useLocalSdk=true), and otherwise reports "disabled". See environments.

Är något oklart, fel eller saknas på den här sidan? Hör av dig via support · Testa ditt spel i förhandsvisningsverktyget

Cookieinställningar

Välj vilka cookies ZokoGames får använda. Nödvändiga cookies är alltid på, eftersom webbplatsen inte fungerar utan dem.

  • Inloggning, språk och de här valen. Alltid på.

  • Kommer ihåg saker som dina senast spelade spel på den här enheten.

  • Räknar spelomgångar och sidbesök med ett slumpmässigt besökar-id så att vi kan förbättra sidan.

  • Tillåter personanpassade annonser, som betalar för de gratis spelen.