GS2-Datastore API Reference

Provides the ability to store arbitrary binary data on the server. Uploaded data is subject to access permission control (ACL - Access Control List).

The data can be stored in a public directory, where anyone can access the data, or in a protected, accessible only to game players with the specified user ID Three types of ACLs can be set: private`, which allows access only to the user.

Uploaded data is versioned, and older generations are retained for 30 days even after the data is updated or deleted. By specifying a generation ID when downloading, you can retrieve the data as it was before the update or deletion. Uploaded data is assigned a unique ID (UUID v4) and generation ID, and the generation ID is updated when data is updated or deleted. When downloading data, the generation ID is specified to identify the specific file.

The generation ID can be included in the download request to avoid unintentionally retrieving a newer version of the data if another player attempts to access the data at the same time as the data is being updated. By adding the generation ID to the download request, you can ensure that you are downloading the data as of the time you list it.

However, some games may not want to have access to older generation data forever. Therefore, an option exists to allow downloading of older generation data only within 60 minutes of the update and only for one previous generation, except for the owner of the data.

Please consider your tolerance for cheating when using this feature to manage your saved data. Other GS2 services are controlled so that addition and subtraction cannot be freely performed according to game specifications. However, trusting local save data can be a source of cheating. If GS2 functionality is provided, use that in preference, and only control elements that have only minor impact if tampered with, such as the exchange of UGC content or configuration settings.