Resources / Guide
Troubleshooting
Actionable fixes for errors the current platform actually returns.
Connection and rendering
| Symptom | Check and action |
|---|---|
| PlayIsland is undefined | Confirm hosted release URL and HTML head tag; do not expect injection on an external URL/editor preview |
| The platform did not respond | Confirm a regular /play/ parent; standalone/provider visual previews have no gameplay responder |
| CSP / unsafe-eval error | Bundle a compatible runtime; remove dynamic code generation; WASM permission does not permit JS eval |
| Missing wasm, pck or data | Verify root paths, case, all export files and supported extensions |
| Storage SecurityError | Opaque sandbox has no same-origin storage; do not assume localStorage/IndexedDB |
Rejected gameplay
| Error | Corrective action |
|---|---|
| This event is not registered for this game | Staff must publish the event definition for this game, not another game |
| This event is not supported by this release | Staff must review the definition's release scope |
| The event contains an unregistered payload field | Remove extras or have staff explicitly agree and publish them |
| Version 2 events require a sequence / out of order | Use the injected SDK; stop after rejection and reload; do not mix counters |
| Completion was reported too quickly | Report real completion after at least 3 seconds from session creation |
| Reported duration exceeds this session | Use honest elapsed active time and the current run; do not reuse prior-run duration |
| Event frequency is implausible | Respect the registered minimum interval and avoid per-frame reports |
| This play session has ended / event limit reached | End/replay deliberately or reload for a fresh session |
| An accepted event cannot be changed | Reuse UUID only for an identical retry; do not mutate previously accepted input |
| Account restriction / gameplay sanction | Resolve the account state through platform support |
Optional features
This game does not support checkpoints means the game's slug is not on the current allowlist; adding SDK calls cannot enable it. A save conflict means another tab advanced the revision: reload and reconcile. 'This item is unavailable' can mean missing/mismatched product or another pending purchase. 'This leaderboard is unavailable' means the current game/mode/mission is unsupported.
Rewards
accepted:true is not proof of a reward. Guests earn no account reward; a signed-in rule can be capped, ineligible, review-only or asynchronous. Check the server decision/receipt and ask staff to inspect the rule/worker when appropriate. Never fix this by granting currency in browser code.