GOG also provides support to some games steam does not. For Example, The Witcher: Enhanced Edition Developer's Cut on Steam black screens whenever I close out the game, causing my computer to crash. GOG has optimized the game to where it doesn't do that (though it could be because CK Projekt owns the site:P). GOG Connect is an offer from us, in collaboration with participating developers and publishers, which allows you to import certain eligible games from your Steam library to your GOG account.
Chances are you already have your game prepared for Valve’s Steam platform. The best option would be to simply push this Steam-ready build to GOG and have all implemented features working out of the box on our platform. Although we strive to make this transition as smooth as possible, the differences between the two platforms are too significant to overcome them with just a few clicks.
Here, you will find a list of items that need your attention when trying to adapt an existing Steam build to the GOG environment.
No DRM, No Problem¶
- GOG Connect is an offer from us, in collaboration with participating developers and publishers, which allows you to import certain eligible games from your Steam library to your GOG account. To use GOG Connect, you need to connect your GOG and Steam accounts on the following page by logging into your Steam account in the form: https://www.gog.
- Steam connection often goes offline. So this doesn't work in the last (188.8.131.52 - beta) and didn't in past versions of GOG. Now it's just always showing as offline. When I click Retry - nothing happens. I already did reconnect Steam a few times in the past, so I really don't want to do all the sorting and tagging again. Is there any smoother.
GOG’s “DRM-Free” philosophy means that games released on GOG can’t have any DRM/copy protection and should work in all possible scenarios, regardless of the result of GOG GALAXY authentication, GOG GALAXY client presence or Internet connection availability. Of course, online-only features such as multiplayer, retrieving friends or leaderboards cannot be available when the user is offline, yet all other aspects of the game should not be affected, e.g. achievements functionality should be available no matter if the user is online or offline (as long as the GOG GALAXY client is installed and the user is logged in to it).
Therefore, all Steam methods related to DRM (user authentication in particular) are of no use on GOG. For more, please see the articles on authorization in GOG GALAXY and authenticating using Steam credentials.
Speaking of user authentication: for online features to be available, a user has to be authenticated against GOG backend services. Unlike Steamworks, which relies on the Steam client to authenticate a user, the GOG GALAXY SDK requires a user to be authenticated explicitly. For this, the
IUser::SignInGalaxy() method is provided in the GOG GALAXY SDK.
There are two ways to authenticate a user:
using the GOG GALAXY client to log in (this is the default way),
using “Steam Encrypted App Ticket” (request acquiring ticket using Steamworks first).
As mentioned previously, authentication failure should not limit the ability of a player to play offline.
Like in Steamworks, to handle the results of async operations, Galaxy uses a concept of callbacks and listeners. To process the input/output data and call appropriate listeners, the
galaxy::api::ProcessData() method should be called once in a while, similarly to
Listeners can be of one out of the two types:
- automatically registered global listeners: such listeners automatically register themselves upon the creation and react on every related event until unregistered (or deleted),
- specific listeners: listeners for a particular method call. Unlike global listeners, they are not registered automatically. Instead, you should pass them as a parameter to a function.
Both global and specific listeners share the same interfaces, so it’s easier to use/re-use them.
Unlike Steamworks, we do not provide a macro similar to
STEAM_CALLBACK to declare a listener. Instead, a developer has to inherit from a specific abstract class representing a listener and implement appropriate callback methods, e.g.:
Instead of returning a handle for an asynchronous operation, specific listeners are passed by pointer to a specific method. For example:
It’s safe to unregister such a listener manually (by calling the
galaxy::api::IListenerRegistrar::Unregister() method) before it’s called by the SDK in case its result is not important anymore.
Achievements, Leaderboards and Statistics¶
Most of the operations regarding achievements that are available on Steam are also accessible using the GOG GALAXY SDK with no or minimal changes. For example,
Steam method is equivalent to
method in GOG GALAXY.
The major difference you may notice is that although there is no direct correlation between statistics and achievements both in Steam and the GOG GALAXY SDK, the former allows to set achievements progress, while the latter relies solely on stats (achievements have only a locked/unlocked state). In order to unlock an achievement, which is supposed to be based on a statistic, you need to retrieve and check the desired statistic using the
IStats::GetStatFloat() user statistics methods, and unlock the achievement using the
SetAchievement() method, when the desired value is reached. Then, you can set a user statistics value with the
Because of this discrepancy, as well as no support for global achievements information and global statistics in the GOG GALAXY SDK, functionalities realized by Steam methods such as
GetAchievementAchievedPercent will have to be replaced by some workarounds or removed altogether from the version to be released on GOG.
Please note that “trusted” statistics (that may be set only by a game server) and server-related achievements are not yet supported by the GOG GALAXY SDK.
In case of leaderboards, the implementation is similar to the one in Steamworks: the methods for creating, finding and setting leaderboards scores are corresponding in both platforms. And, like in Steam, before working with the leaderboards, you have to find and retrieve them from the backend.
Trusted leaderboards are supported in the GOG GALAXY SDK, but there are no methods provided for resetting leaderboard entries.
For more, please see Statistics and Achievements and Leaderboards.
Gog Steam Connect Offline
Gog Steam Connect
Unlike Steam, we do not separate game sessions into pre-game lobbies and game servers. Instead, a unified term “Lobby” exist in the GOG GALAXY SDK. Lobbies are different by the topology types used when connecting players:
For most games, it is convenient to use the STAR topology, however CONNECTIONLESS lobby might be a better choice when implementing a pre-game chat-like lobby, since it doesn’t require a direct connection between users.
There is no limitation to the number of lobbies that the user is in at the same time, yet one lobby cannot host more than 250 members.
Also, we do not expose IP addresses of users and a game host (both user-created and dedicated servers) and use GalaxyIDs of an appropriate type (User or Lobby) instead. As a result, all methods related to retrieving GameServer information (such as
ISteamMatchmaking::GetLobbyGameServer()) are not provided.
There is also no need to establish a connection between the peers as long as they are in the same lobby, so methods/callbacks for requesting/accepting incoming connections are not provided. Packets from unwanted sources may be simply ignored.
For more, please see Multiplayer.
Gog Steam Logging In Problem
Crossplay is a Galaxy-specific feature that does not exist in Steamworks and allows play between Steam and Galaxy users.
Most of the operations regarding friends interactions can be implemented in a very similar way on both platforms with analogous naming convention. Functions like
GetFriendPersonaName have the same meaning and result both on Steam and GOG GALAXY. The most notable differences will be that the GOG GALAXY SDK lacks the methods regarding Clan, Groups, Co-play (although some part of it might be done based on rich-presence) and Followers functionalities.
Both GOG GALAXY and Steam provide Storage interfaces, which allow writing, uploading and sharing files among users, as well as syncing between cloud and PC.
For more, please see Storage.
This interface is almost identical on both platforms and allows sending, checking and reading P2P packets. The main difference is that GOG GALAXY doesn’t offer Sockets and public interfaces in general as all methods are based on GalaxyID (public interfaces might be needed for custom dedicated servers).
Moreover, the GOG GALAXY SDK has two ways of checking whether any packets are available for the lobby member:
INetworkingListener::OnP2PPacketAvailable()can only be triggered after the callback is processed by the
INetworking::IsP2PPacketAvailable()allows to check for packets immediately after they arrive on a target machine. This may be crucial in latency-sensitive games.
As mentioned in Multiplayer section, game hosts in GOG GALAXY are not publicly available: their IP addresses are not exposed and the communication is based on GalaxyID. Therefore, all Steamworks methods related to GameServers, e.g. for setting map names (
ISteamGameServer::SetServerName), favorite game server, a friend’s game server etc., have no counterparts in the GOG GALAXY SDK.