Skip to content

GOG GALAXY Features and Operational States

GOG GALAXY Operational States

When implementing the GOG GALAXY SDK features, you need to pay special attention to these two methods:

Method Description
galaxy::api::Init(initOptions) Initializes the GOG GALAXY Peer with specified client (game) credentials. It succeeds when the GOG GALAXY client is installed and running. You need to call Init() before calling any other GOG GALAXY SDK function
galaxy::api::IUser::SignInGalaxy() Allows to sign in the user based on the GOG GALAXY client authentication

Based on their results, GOG GALAXY sets up two statuses:

Status Method to Check the Status Description
SignedIn galaxy::api::User()::SignedIn() Determines whether the user has a license for the game and is logged in to the GOG GALAXY client
LoggedOn galaxy::api::User::IsLoggedOn() Determines if the user has a license for the game, is logged in to the GOG GALAXY client and is connected to the Internet

The table below shows how GOG GALAXY operational state depends on SignedIn and LoggedOn values:

Operational States

GOG GALAXY Features vs. Operational States

This table shows how GOG GALAXY features depend on GOG GALAXY operational states. Please note that if the SignedIn() method returns false, achievements, leaderboards, networking and matchmaking services should not be called.

Interfaces that can be called — if used — regardless of GOG GALAXY operational states are the IApps (including the IsDlcInstalled(ProductID productID) method) and the IStorage interface methods (without the FileShare() method). These can be called only after calling the Init() method, but are not dependent on its result. This means that the IApps and the IStorage interfaces are available even if the Init() call fails.

Feature / Scenario No GOG GALAXY or No User GOG GALAXY: Installed and running, game known in the client but the user doesn’t own it GOG GALAXY: Installed and running, game launched externally and the user has a license GOG GALAXY: Installed and running, game launched in the client and the user has a license GOG GALAXY: Installed and running, game launched offline, the user has a license Other platforms (crossplay)
SignedIn FALSE FALSE TRUE TRUE TRUE TRUE
LoggedOn FALSE FALSE TRUE TRUE FALSE TRUE
Multiplayer ✔︎ ✔︎ ✔︎
Achievements ✔︎ ✔︎ ✔︎
Leaderboards ✔︎ ✔︎ ✔︎
Stats ✔︎ ✔︎ ✔︎
Rich presence ✔︎ ✔︎
Overlay ✔︎ ✔︎*
Game time tracking ✔︎ ✔︎
DLC and language discovery ✔︎ ✔︎ ✔︎ ✔︎ ✔︎
Cloud Storage — local storage ✔︎ ✔︎ ✔︎ ✔︎ ✔︎
Cloud Storage — cloud sync ✔︎ ✔︎

*Overlay works in offline mode, but will not show any content requiring the internet connection.