FAQ
FAQ
Submission and review#
Which engines work? Anything that exports to HTML5/WebGL: Unity, Godot, Phaser, Construct 3, GameMaker, Cocos, Defold, PlayCanvas, Pixi, Babylon and plain JavaScript. See engines.
How do I submit? Create a studio at /developer/onboarding, create a game, fill in the wizard, upload a zip and press Submit for review. See the submission walkthrough.
How long does review take? The console shows the state of your submission and emails you the outcome. Review time depends on the queue, so we do not promise a number. A complete listing, a clean build and a note for the reviewer help.
Why was my game rejected or sent back? The decision lists reasons, such as: game does not run, performance, ad integration, external links or popups, unclear controls, quality below the bar, artwork not meeting specs, inaccurate listing, audience flag. Some reasons are final (copyright or brand misuse, a copy of another game, inappropriate content, unsafe code). See quality guidelines.
Can I update a live game? Yes, upload a new build at any time. During basic launch it goes live immediately; in full launch a reviewer approves it first. Games in review are locked until the decision.
Can I host the game on my own server? Hosting on ZokoGames is recommended: it is served from a global network under versioned paths. A game on your own https server is supported, must allow being framed from zokogames.com, and only earns when it uses the SDK.
Do I have to use the SDK? It is optional to submit and for basic launch, and required for full launch.
Is there a size limit? 250 MB unpacked, 1,500 files and an estimated initial download of 50 MB (20 MB for mobile). See technical requirements.
Testing#
How do I test without uploading? Run the game on localhost (the SDK mocks the portal), then open the Preview tool, enter your address and play inside the real portal frame. No account is needed. See testing.
Is there a starting point? Yes, three starter kits: plain HTML5, Vite with TypeScript, and Phaser 3.
SDK#
Why does every call fail with sdkDisabled? The page is not inside the portal and not on localhost. Add ?useLocalSdk=true for testing. See environments.
Can I call the SDK before init() resolves? No. You get sdkNotInitialized.
Why is my ad not showing in local mode? It is: local ads are a three-second overlay. If nothing shows, check the console with ?sdk_debug=true, and check whether a midgame ad ran within the last three minutes.
Why do I get adsDisabled in the portal? Ads only run for games in full launch with ads enabled, and never for kids' games. Your code must treat it like any other ad error: resume the game and continue without an ad.
Do I need to implement the user module? Only if you use accounts, friends or leaderboards. If you do, follow accounts.
Is the player's id safe to use? __dangerousUserId is client-provided and can be forged. Verify the token on your server and use its claims. See player accounts.
How big can cloud save be? 1 MiB for the whole save. See data and cloud saves.
Monetisation#
Where do I add my own ad network? You cannot. Only SDK-served ads are allowed.
Can I sell items in my game? Purchases are invite-only today. See in-game purchases.
Why do I see no ad revenue? Basic launch has no ads. After full launch check that you call requestAd at natural breaks and what adError codes you receive.
What is the revenue share? The console shows your rate on the Revenue page; see revenue share and the developer terms summary.
Content#
Can I have chat? Yes if it is moderated (at least a profanity filter and report option) and you honour disableChat.
Can I link to my store page? Add store links in the submission's metadata fields, not inside the game.
Which age rating? Games must fit PEGI 12. See gameplay requirements.
Account and payouts#
Who can see my game's data? The members of your studio. Owners and admins manage the team; add or remove members on the Team page.
When do I get paid? Statements are prepared monthly and invoiced above a minimum balance; see payouts.
Not here? See support.