Creator Studio
Help & reference
Answers for your first build, your next launch, and everything after.
26 errors
capability_not_declared
capability_not_declared
The game called a method whose capability is not in its manifest.
How to resolve it
Add the capability in error.data.capability to capabilities in game.json, then publish a new version.
network_blocked
network_blocked
The game tried to reach an origin that is not in network.allow.
How to resolve it
Add the origin to network.allow in game.json and publish a new version. Use an HTTPS origin without a path, wildcard, or IP literal; the limit is eight origins.
user_rejected
user_rejected
The player dismissed the confirmation dialog.
How to resolve it
Return to the previous state. Wait for another player action before opening a new confirmation.
Open referencerate_limited
rate_limited
The call exceeded a method rate limit or the limit on concurrent requests.
The bridge allows at most 256 concurrent requests; methods also have individual rate limits.
How to resolve it
Wait error.retryAfterMs when provided. Otherwise, wait for pending requests to finish and reduce polling frequency.
quota_exceeded
quota_exceeded
The player or the game is over a storage or submission quota.
Account storage allows 64 keys and 256 KiB per game; guest storage allows 16 keys and 64 KiB with a 30-day expiry.
How to resolve it
Inspect error.data for the affected limit. For storage, delete unused keys or reduce the saved data.
payload_too_large
payload_too_large
A bridge message exceeded the 256 KiB encoded size limit.
How to resolve it
Reduce the payload or split it across smaller requests. Splitting does not increase the total storage quota.
Open referenceprotocol_version_unsupported
protocol_version_unsupported
The SDK and the shell do not speak the same bridge protocol version.
How to resolve it
Use the injected window.uniplays SDK and remove any separately bundled SDK copy. Reload the game; if the mismatch persists, report the SDK and shell versions from error.data.
timeout
timeout
The request did not complete before its deadline.
Read requests allow 15 seconds, writes 20 seconds, and one confirmation call up to 43 minutes.
How to resolve it
Retry reads with a delay. Treat a timeout on a confirmation as an unknown outcome, never as a failure: the action may still complete, and opening the same purchase or payment again can pay twice.
Open referenceversion_conflict
version_conflict
The stored value changed between your read and your write.
How to resolve it
Re-read the key, merge the changes, and retry with the returned etag as ifMatch.
consent_required
consent_required
The player has not approved this capability for this version of the game.
Access to player.wallet requires the player to approve sharing their wallet address.
How to resolve it
Continue without the protected data. Do not retry automatically or repeatedly prompt the player.
Open referencetransaction_pending
transaction_pending
A transaction may have been sent but is not confirmed yet.
How to resolve it
Keep the transaction hash and action identity in error.data. Use the shell’s saved transaction recovery to check the original receipt without sending again. If the hash is unknown, recover it from wallet history before retrying.
Open referencewallet_required
wallet_required
The call requires a connected wallet, but none is available.
How to resolve it
Keep wallet-dependent actions unavailable until the player signs in. Preserve guest gameplay and saves where possible.
Open referencegame_suspended
game_suspended
This game is suspended and cannot make platform calls.
How to resolve it
Stop platform calls and contact UniPlays support to resolve the suspension.
Open referencehosting_suspended
hosting_suspended
The game’s hosted online action could not complete.
How to resolve it
Retry with the same idempotency key. Developers can inspect deployment health and prepaid credit in the game dashboard.
Open referencehosting_deployment_failed
hosting_deployment_failed
The game’s hosted online action could not complete.
How to resolve it
Retry with the same idempotency key. Developers can inspect deployment health and prepaid credit in the game dashboard.
Open referencehosting_execution_failed
hosting_execution_failed
The game’s hosted online action could not complete.
How to resolve it
Retry with the same idempotency key. Developers can inspect deployment health and prepaid credit in the game dashboard.
Open referencehosting_busy
hosting_busy
The game’s hosted online action could not complete.
How to resolve it
Retry with the same idempotency key. Developers can inspect deployment health and prepaid credit in the game dashboard.
Open referenceunknown_method
unknown_method
The requested method is not in the bridge registry.
How to resolve it
Check the method name in the SDK reference and use the injected SDK instead of sending bridge messages directly.
Open referenceinvalid_params
invalid_params
The arguments did not match the schema for that method.
How to resolve it
Inspect error.data for validation details, including issues when present, and correct the values before retrying.
internal
internal
The shell could not complete the call, and the failure has no more specific code.
A throw inside the shell never crosses the bridge, so no stack or internal trace reaches the game; error.data carries what the shell could name.
How to resolve it
Retry once. If it repeats, read error.data for the method and the reason the shell could name, and report those with the time of the call.
not_available
not_available
This deployment did not serve that call: a contract binding is not pinned, a route is not mounted, or a session or service could not answer.
It is a fact about the running deployment and not about the method, so the same call can succeed elsewhere.
How to resolve it
Read error.data for the method and for binding or reason, and hide the affected path. uniplays.can() checks manifest declarations, not runtime support.
not_ready
not_ready
A call that needs the session ran before the handshake completed.
How to resolve it
Await uniplays.ready() at startup before calling other SDK methods.
bridge_closed
bridge_closed
The bridge was torn down with calls outstanding.
The connection closes when the session ends or the shell detects sustained excess traffic.
How to resolve it
Stop calls from the closed session and clean up timers and subscriptions. If it happens during play, check for calls made in a render loop.
Open referenceunsupported_environment
unsupported_environment
The SDK could not establish a connection to a UniPlays game frame.
How to resolve it
Open the preview URL from the launch flow, MCP, or CLI. Opening the bundle directly does not provide a UniPlays session.
Open reference