Docs · Errors and limits

SDK

Errors and limits

The SDK resolves with a safe default and does not throw, so a failure never breaks your game loop.

Error codes

CodeMeaning
needs_signinThe player is a guest. VPlay opens its own sign-in.
insufficientNot enough VCoins. VPlay tells the player.
unavailableThe item, game or feature is not available (or switched off).
price_changedThe price moved while the sheet was open; the player is asked again.
rate_limitedToo many requests. Slow down.
not_grantedYour game isn't allowed to do that. Ask us to switch it on.

Limits

LimitValue
Cloud save64 KB of JSON
Live hints (score, lives, level)10 per second
Shortest counted run3 seconds
Item and milestone ids80 characters
Purchase confirmationwaits up to 3 minutes for the player

Read the live numbers from host.limits instead of copying them.