Creator Studio
Help
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 fix 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 a web address (an origin) that is not in network.allow.
How to fix it
Add the address, such as https://api.example.com, to network.allow in game.json and publish a new version. Use HTTPS with no path, wildcard or IP address; the limit is eight addresses.
user_rejected
user_rejected
The player dismissed the confirmation dialog.
How to fix 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.
Your game can have at most 256 requests waiting at once; methods also have their own rate limits.
How to fix 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 fix 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 request was larger than the 256 KiB size limit.
How to fix 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 in your game and UniPlays use different versions of the connection.
How to fix it
Use the built-in window.uniplays and remove any copy of the SDK you bundled yourself. Reload the game; if it still fails, report the two versions shown in 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 fix 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 fix 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 fix 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 fix it
Keep the transaction hash and action ID from error.data. Use UniPlays’ saved-transaction recovery to check what happened without sending again. If you do not have the hash, find it in the wallet history before you retry.
Open referencewallet_required
wallet_required
The call requires a connected wallet, but none is available.
How to fix 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 fix it
Stop platform calls and contact UniPlays support to resolve the suspension. For a draws call with reason NotLiveLongEnough, retry after five minutes.
hosting_suspended
hosting_suspended
The game’s hosted online action could not complete.
How to fix it
Retry with the same unique ID (the idempotency key) you used the first time. Developers can check 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 fix it
Retry with the same unique ID (the idempotency key) you used the first time. Developers can check 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 fix it
Retry with the same unique ID (the idempotency key) you used the first time. Developers can check 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 fix it
Retry with the same unique ID (the idempotency key) you used the first time. Developers can check deployment health and prepaid credit in the game dashboard.
Open referenceunknown_method
unknown_method
That method does not exist.
How to fix it
Check the method name in the SDK reference, and call it through the built-in SDK instead of sending messages yourself.
Open referenceinvalid_params
invalid_params
The arguments did not match the schema for that method.
How to fix it
Inspect error.data for validation details, including issues when present, and correct the values before retrying.
internal
internal
UniPlays could not complete the call, and no more specific error applies.
Internal details never reach your game; error.data holds what UniPlays could name.
How to fix it
Retry once. If it repeats, read error.data for the method and the reason, and report them with the time of the call.
not_available
not_available
The platform did not serve that call: the feature is off for this network or game, or a session or service could not answer.
It is a fact about this network or game and not about the method, so the same call can succeed elsewhere.
How to fix it
Read error.data for the method and for binding or reason, and hide that feature in your game. uniplays.can() only checks what game.json declares, not whether the network offers it.
not_ready
not_ready
A call that needs the session ran before UniPlays finished connecting your game.
How to fix it
Await uniplays.ready() at startup before calling other SDK methods.
bridge_closed
bridge_closed
The connection to UniPlays closed while calls were still waiting.
The connection closes when the session ends, or when UniPlays sees too many requests for too long.
How to fix 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 connect to UniPlays.
How to fix it
Open your game from the preview link you get from the launch flow, your agent or the CLI. Opening the files directly gives no UniPlays session.
Open reference