Reference
Errors and limits
Every failing call rejects with an ArcadeError that has a code. Here is what each code means and what to do.
try {
await sdk.save.set('state', state);
} catch (error) {
if (error instanceof ArcadeError) console.log(error.code, error.message, error.retryAfterMs);
}Error codes
| Code | Meaning | What to do |
|---|---|---|
NOT_SIGNED_IN | The call needs a player; this is a guest. | Keep playing; offer sign-in. |
PERMISSION_DENIED | This game isn’t allowed that call. | Check the game’s settings in ARCADE. |
NOT_FOUND | Unknown save key or board. | save.get already turns it into null. |
VERSION_CONFLICT | Another device saved first. | Load again, then save. |
TOO_LARGE | Over a save limit. | Save less, or split into keys. |
INVALID_ARGUMENT | Bad key, event name, metadata or score. | Fix the call; the message says what. |
RATE_LIMITED | Too many calls. | Wait retryAfterMs. |
SCORE_REJECTED | The score failed the checks. | Show the message; don’t retry. |
SCORE_HELD | The score waits for a moderator. | Tell the player it’s under review. |
SESSION_EXPIRED | The play session ended. | Ask the player to reload. |
UNAVAILABLE | ARCADE couldn’t be reached. | Retry later; keep playing. |
UNSUPPORTED_API_VERSION | The page speaks another SDK version. | Update the SDK. |
NOT_AVAILABLE | Not live yet. | Leave it out for now. |
Limits
| What | Limit |
|---|---|
| Save key | 1 to 64 of A-Z a-z 0-9 . - _ |
| One saved value | 64 KB as JSON |
| Keys per player per game | 100 |
| Everything one player saves in a game | 1 MB |
| Saves | 30 a minute per player per game |
| Events | 600 per play session per hour, 50 per batch |
| Game session | 15 minutes, renewed by the page while the game is open |