Cloud Save Game Data
Understand how Cloud Save stores key and value pairs for game-wide data with different access classes.
Read time 2 minutesLast updated 8 months ago
Cloud Save Game Data is key/value storage for objects that are Custom Items associated with a game (this differs from Player Data, which is objects associated with a player).
You can use Custom Items for data that is player readable (but only server writeable), or for data that is only accessible from a server authoritative context (for example, Cloud Code).
You can use Custom Items with Cloud Code to add features like guilds/clans, community goals, and battle passes, or to store the state of items or NPCs in multiplayer games.
You can use the Unity Dashboard to view and edit Game Data.
Access Classes
Cloud Save supports 2 different Access Classes for Custom Items.
Access Class | Description |
|---|---|
| Default | Readable by any player, only writeable from a server. |
| Private | Readable and writeable only from a server. |
For a list of methods to write Game Data from Cloud Code, refer to the Cloud Save SDK for Cloud Code documentation.
Limits
Note
These limits are per Custom Item, there are no limits on the number of Custom Items.
- Custom Items have a limit of 2000 key/value pairs each, per Access Class:
- 2000 keys in the default Access Class
- 2000 keys in Private Data
- Custom Items have a total limit of 5 MiB each, per Access Class:
- 5 MiB of data in the default Access Class
- 5 MiB of Private Data
For example, you can have 2000 keys of 2.5 KiB each on each Custom Item, or 1 key on a Custom Item that is 5 MiB.