So integrieren Sie das Startprogramm in Steam

So funktioniert's

Sie können Ihr Spiel samt Startprogramm in Steam integrieren und so Ihre anderen Steam-Spiele über das Xsolla-Startprogramm bewerben.

Voraussetzungen

Das benötigen Sie für die Steam-Integration:

  • Steam-AppID
  • Steamworks-Konto mitsamt Spiel
  • auf Steam veröffentlichbare Spiel-Build
  • einsatzbereites Startprogramm, konfigurierbar im Kundenportal

Die Steam-AppID finden Sie im Admin-Dashboard Ihres Spiels in Steamworks. Navigieren Sie zu Steamworks > App-Admin, dort wird die ID neben dem Namen Ihres Projekts angezeigt.

Integrationsschritte

Steam-Plattform einrichten und Dateien herunterladen

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Startprogramm.
  3. Klicken Sie im Dashboard beim gewünschten Startprogramm auf Startprogramm bearbeiten.
  4. Wechseln Sie zu den Einstellungen, und klicken Sie rechts neben dem Steam-Logo auf Einrichten.
  5. Geben Sie Ihren Steam Web-API-Schlüssel ein.
  6. Geben Sie die Steam-App-ID Ihres Spiels ein.
  7. Klicken Sie auf Startprogramm-Host herunterladen, um das LauncherHost.zip-Archiv für Windows oder macOS herunterzuladen.
  8. Klicken Sie auf Config herunterladen, um die Konfigurationsdateien des Spiels herunterzuladen.
  9. Wechseln Sie zur Registerkarte Startprogrammverhalten, und wählen Sie aus, wie sich das Startprogramm verhalten soll, wenn ein Benutzer das Spiel über Steam ausführt (optional):
    • Startprogramm ausführen (vorausgewählt)
    • Spiel ausführen

Hinweis
Ganz gleich, wofür Sie sich entscheiden: Das Startprogramm wird nach dem Schließen des Spiels immer angezeigt.

  1. Wechseln Sie zur Registerkarte Nutzeranmeldung, und wählen Sie eine Anmeldemethode aus (optional):
    • Automatisch über Steam-Konto (vorausgewählt).
    • Manuell über das Login-Widget. Das Widget nutzt das beim Erstellen des Startprogramms ausgewählte Login-Projekt.

Startprogramm-Installer generieren und herunterladen

Beachten Sie den Leitfaden zum Generieren und Herunterladen des Startprogramm-Installers.

Spiel-Build für Steam vorbereiten

  1. Entpacken Sie das LauncherHost.zip-Archiv (sollte in Schritt 1 heruntergeladen werden) in ein beliebiges Verzeichnis. Das Archiv enthält das Verzeichnis PreparingSteam, mit dem sich das Spiel für den Upload auf Steam vorbereiten lässt. Ordnerstruktur unter Windows:
    • LauncherHost.exe – ausführbare Datei für das Dienstprogramm LauncherHost
    • Qt5Core.dll, vcruntime140-140_1.dll, msvcp140-140_1.dll – Dienstbibliotheken für das Dienstprogramm LauncherHost.exe
    • installer – Ordner für den Startprogramm-Installer

  1. Ordnerstruktur unter macOS:
    • LauncherHost – ausführbare Datei für das Dienstprogramm LauncherHost
    • Frameworks – Systemordner für die LauncherHost-Dienstbibliotheken
    • installer – Ordner für den Startprogramm-Installer

  1. Erstellen Sie einen neuen Ordner im Verzeichnis PreparingSteam.
  2. Kopieren Sie Ihre Spiel-Build in dieses Verzeichnis.
  3. Konfigurieren Sie die ausführbare Spieldatei (Windows/macOS) unter Spiel > Build > Ausführbare Dateien, und geben Sie den relativen Pfad zur ausführbaren Spieldatei an.

Hinweis
Geben Sie beim Benennen der ausführbaren Spieldatei auch die Dateierweiterung an.

  1. Kopieren Sie den eigenständigen Startprogramm-Installer (Windows/macOS) in den Ordner installer.
  2. Kopieren Sie die Steam-Konfigurationsdateien in den Ordner PreparingSteam.
  3. Wenn Ihr Spiel bereits auf Steam ist, ersetzen Sie den Namen der Datei LauncherHost.exe durch den Namen der ausführbaren Datei Ihres Spiels. Diese Informationen finden Sie im Admin-Dashboard Ihres Spiels im Ausführungsfeld, navigieren Sie zu dazu zu Apps & Pakete > Alle Anwendungen > Ihre Anwendung > Steamworks Admin > Installation > Allgemeine Installation.

Hinweis
Sie können den Namen der Datei LauncherHost.exe durch den Namen der ausführbaren Datei Ihres Spiels für das Integrations-Debugging ersetzen, wenn Sie die ausführbare Datei nicht ändern wollen.

  1. Aktivieren Sie die Nutzung von ISteamApps::GetLaunchCommandLine() im Admin-Dashboard Ihres Spiels.

  1. Klicken Sie auf Für Veröffentlichung vorbereiten, um zu prüfen, ob es Konflikte zwischen Ihrer Arbeit und der anderer Benutzer gibt.

Windows-Spiel-Build-Dateien auf Steam hochladen

  1. Melden Sie sich bei Steamworks an, und laden Sie das Steamworks-SDK herunter.
  2. Entpacken Sie das SDK-Archiv.

  1. Wechseln Sie in den Ordner steamworks_sdk_151\sdk\tools, und entpacken Sie das Dienstprogramm SteamPipeGUI, mit dem sich Spiel-Builds auf Steam hochladen lassen.

  1. Führen Sie das Dienstprogramm SteamPipeGUI aus.

  1. Füllen Sie die folgenden Felder im Einstellungsfenster aus:
    1. Geben Sie im Feld App-ID die Steam-AppID Ihres Spiels an.
    2. Geben Sie im Feld Build-Beschreibung eine kurze Beschreibung der Build ein, damit Sie die Build einfacher im Steam-Admin-Dashboard identifizieren können.
    3. Geben Sie im Feld Steamworks SDK ContentBuilder-Pfad den Pfad zum Steamworks SDK ContentBuilder an.
    4. Geben Sie in den Feldern Steam-Login und Steam-Passwort Ihren Steam-Benutzernamen und Ihr ‑Passwort ein.

    1. Klicken Sie auf Depot hinzufügen. Geben Sie im Feld Build-Pfad den Pfad zum PreparingSteam mit der Spiel-Build und den Startprogramm-Installer ein.

    1. Klicken Sie auf Hochladen, und warten Sie, bis der Upload abgeschlossen ist.

macOs-Spiel-Build-Dateien auf Steam hochladen

  1. Kopieren Sie die Datei launcher.dmg in den Ordner prepairingSteam/installer.
  2. Kopieren Sie die Datei hostArgs.json in den Ordner prepairingSteam.
  3. Laden Sie die Dateien auf Steam hoch:
    1. Öffnen Sie den entpackten Ordner SteamSDK.

    1. Wechseln in den Ordner tools/scripts.
    2. Erstellen Sie ein vdf-Skript namens appbuild<steam_id>.vdf, wobei <steam_id> die Steam-ID Ihres Projekts und den folgenden Inhalt darstellt. (ersetzen Sie xxxxxx in Zeile 3 durch die Steam-ID, yyyyyy in Zeile 11 durch die Depot-ID – die Steam-ID + 1:

Copy
Full screen
Small screen

       "AppID" "xxxxxx" // your AppID
        "Desc" "This is a simple build script 1" // internal description for this build
    
        "ContentRoot" "../content/" // root content folder, relative to location of this file
        "BuildOutput" "../output/" // build output folder for build logs and build cache files
    
        "Depots"
        {
            "yyyyyy" // your DepotID
            {
                "FileMapping"
                {
                    "LocalPath" "*" // all files from contentroot folder
                    "DepotPath" "." // mapped into the root of the depot
                    "recursive" "1" // include all subfolders
                }
            }
        }
    }

      1. Speichern Sie die Änderungen.
      2. Kopieren Sie den Inhalt des Verzeichnisses PrepairingSteam in den Ordner tools/ContentBuilder/Content.
      3. Wechseln Sie in die Terminalkonsole, und navigieren Sie zum Ordner tools/ContentBuilder/builder_osx.
      4. Rufen Sie den Befehl ./steamcmd.sh auf, um die Initialisierung und Konfiguration zu starten.
      5. Rufen Sie den folgenden Befehl auf, um das Skript auszuführen, daraufhin wir die Build auf die Steam-Server hochgeladen:

    Copy
    Full screen
    Small screen

      cmd.sh +login <username> <password> +run_app_build_http ../scripts/app_build_{Steam_id}.vdf

      Spiel-Build auf Steamworks veröffentlichen

      1. Wechseln Sie zum Admin-Dashboard Ihres Spiels in Steamworks.
      2. Klicken Sie auf Steamworks-Admin, um die Admin-Seite des Spiels zu öffnen.

      1. Navigieren Sie zu SteamPipes > Builds.

      1. Erstellen Sie eine neue Branch, oder nutzen Sie eine Standardbranch.
      2. Suchen Sie nach der hochgeladenen Build anhand der Build-ID, dem Upload-Datum oder der Beschreibung, und platzieren Sie die Build in Ihre Branch.
      3. Klicken Sie auf Änderungsvorschau, und betrachten Sie die vorgenommenen Änderungen.
      4. Klicken Sie auf Build jetzt live freigeben.

      War dieser Artikel hilfreich?
      Vielen Dank!
      Gibt es etwas, das wir verbessern können? Nachricht
      Das tut uns leid
      Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
      Vielen Dank für Ihr Feedback!
      Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
      Diese Seite bewerten
      Diese Seite bewerten
      Gibt es etwas, das wir verbessern können?

      Jetzt nicht

      Vielen Dank für Ihr Feedback!
      Letztmalig aktualisiert: 5. April 2023

      Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

      Problem melden
      Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
      Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
      Vielen Dank für Ihr Feedback!