Cloud Save Game Data

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 Cloud Dashboard to view and edit Game Data.

Access Classes

Cloud Save supports 2 different Access Classes for Custom Items.

Access ClassDescription
DefaultReadable by any player, only writeable from a server.
PrivateReadable 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.

Additional resources