gibbed/SteamAchievementManager · error · ClientInitializeException

failed to create ISteamClient018

Error message

failed to create ISteamClient018

What it means

Client.Initialize throws ClientInitializeException with failure code CreateSteamClient when Steam.CreateInterface<SteamClient018>("SteamClient018") returns null, meaning the loaded Steam library could not provide the ISteamClient018 interface version. Usually the installed Steam client is older or newer and does not export that exact interface version.

Solutions

1. Update Steam to the latest version so SteamClient018 is exported
2. Use the SAM.API build matching your Steam client's interface versions
3. Check that the loaded steamclient dll comes from the real Steam install path (not a stray copy)
4. Reinstall Steam to restore the current interface set

Example fix

// before
var client = new Client(); client.Initialize(appId); // throws CreateSteamClient
// after
try { client.Initialize(appId); }
catch (ClientInitializeException e) when (e.Failure == ClientInitializeFailure.CreateSteamClient)
{
    Console.Error.WriteLine("Steam client does not expose ISteamClient018; update Steam.");
}

try { client.Initialize(appId); }
catch (ClientInitializeException e) when (e.Failure == ClientInitializeFailure.CreateSteamClient)
{
    // Steam client interface version mismatch; prompt to update Steam
}

When it happens

Trigger: Calling Client.Initialize(appId) on a Steam installation whose steamclient does not expose SteamClient018 (Steam updated/rolled back to an incompatible version), or CreateInterface failing inside the loaded module.

Common situations: Steam client updated and interface versions changed; running against an old portable/legacy Steam install; mismatch between the SAM.API wrapper versions and the installed Steam build.

Related errors

• failed to get Steam install path
• failed to load SteamClient
• failed to create pipe
• failed to connect to global user
• appID mismatch

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

Appendix: source

Thrown at SAM.API/Client.cs:65

            if (string.IsNullOrEmpty(Steam.GetInstallPath()) == true)
            {
                throw new ClientInitializeException(ClientInitializeFailure.GetInstallPath, "failed to get Steam install path");
            }

            if (appId != 0)
            {
                Environment.SetEnvironmentVariable("SteamAppId", appId.ToString(CultureInfo.InvariantCulture));
            }

            if (Steam.Load() == false)
            {
                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");

View on GitHub (pinned to de8b71048a)