Documentation

Support

Cloud Save

Unity SDK tutorial

Cloud Save for Cloud Code

Open Unity Dashboard

Cloud Save

Cloud Save Game Data

Understand how Cloud Save stores key and value pairs for game-wide data with different access classes.
Read time 1 minuteLast updated 2 days 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

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

  • 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