gibbed/SteamAchievementManager · error · ClientInitializeException

failed to connect to global user

Error message

failed to connect to global user

What it means

Client.Initialize throws ClientInitializeException with failure code ConnectToGlobalUser when SteamClient.ConnectToGlobalUser(pipe) returns 0, meaning the pipe was created but the library could not authenticate/attach to Steam's global user session on that pipe.

Solutions

1. Ensure Steam is fully logged in to an account before initializing
2. Take Steam out of offline mode / complete any pending update or login
3. Restart Steam and retry
4. Run the app with the same privileges as the Steam process

Example fix

// before
client.Initialize(appId);
// after
try { client.Initialize(appId); }
catch (ClientInitializeException e) when (e.Failure == ClientInitializeFailure.ConnectToGlobalUser)
{
    Console.Error.WriteLine("Steam is not logged in; log in and retry.");
    RetryAfterDelay(TimeSpan.FromSeconds(5));
}

var steamRunning = System.Diagnostics.Process.GetProcessesByName("steam").Length > 0; // and ensure user is logged in

try { client.Initialize(appId); }
catch (ClientInitializeException e) when (e.Failure == ClientInitializeFailure.ConnectToGlobalUser)
{
    // Steam not logged in; ask user to log in then retry
}

When it happens

Trigger: Calling Client.Initialize(appId) when Steam is running but not logged in (offline/anonymous state), the session is in a transitional state, or the pipe is valid but the global user handle cannot be established.

Common situations: Steam open only at the login prompt; Steam in offline mode; Steam client restarting after an update; permission/elevation mismatch between Steam and the calling process.

Related errors

• failed to get Steam install path
• failed to load SteamClient
• failed to create ISteamClient018
• failed to create pipe
• appID mismatch

AI-assisted analysis of gibbed/SteamAchievementManager@de8b71048a (2026-09-12). Data as JSON: /api/errors/9ef71be4a6578e07. Report an issue: GitHub.

Appendix: source

Thrown at SAM.API/Client.cs:77

                throw new ClientInitializeException(ClientInitializeFailure.Load, "failed to load SteamClient");
            }

            this.SteamClient = Steam.CreateInterface<Wrappers.SteamClient018>("SteamClient018");
            if (this.SteamClient == null)
            {
                throw new ClientInitializeException(ClientInitializeFailure.CreateSteamClient, "failed to create ISteamClient018");
            }

            this._Pipe = this.SteamClient.CreateSteamPipe();
            if (this._Pipe == 0)
            {
                throw new ClientInitializeException(ClientInitializeFailure.CreateSteamPipe, "failed to create pipe");
            }

            this._User = this.SteamClient.ConnectToGlobalUser(this._Pipe);
            if (this._User == 0)
            {
                throw new ClientInitializeException(ClientInitializeFailure.ConnectToGlobalUser, "failed to connect to global user");
            }

            this.SteamUtils = this.SteamClient.GetSteamUtils004(this._Pipe);
            if (appId > 0 && this.SteamUtils.GetAppId() != (uint)appId)
            {
                throw new ClientInitializeException(ClientInitializeFailure.AppIdMismatch, "appID mismatch");
            }

            this.SteamUser = this.SteamClient.GetSteamUser012(this._User, this._Pipe);
            this.SteamUserStats = this.SteamClient.GetSteamUserStats013(this._User, this._Pipe);
            this.SteamApps001 = this.SteamClient.GetSteamApps001(this._User, this._Pipe);
            this.SteamApps008 = this.SteamClient.GetSteamApps008(this._User, this._Pipe);
        }

        ~Client()
        {
            this.Dispose(false);
        }

View on GitHub (pinned to de8b71048a)