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
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Startprogramm.
- Klicken Sie im Dashboard beim gewünschten Startprogramm auf Startprogramm bearbeiten.
- Wechseln Sie zu den Einstellungen, und klicken Sie rechts neben dem Steam-Logo auf Einrichten.
- Geben Sie Ihren Steam Web-API-Schlüssel ein.
- Geben Sie die Steam-App-ID Ihres Spiels ein.
- Klicken Sie auf Startprogramm-Host herunterladen, um das
LauncherHost.zip
-Archiv für Windows oder macOS herunterzuladen. - Klicken Sie auf Config herunterladen, um die Konfigurationsdateien des Spiels herunterzuladen.
- 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.
- 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
- Entpacken Sie das
LauncherHost.zip
-Archiv (sollte in Schritt 1 heruntergeladen werden) in ein beliebiges Verzeichnis. Das Archiv enthält das VerzeichnisPreparingSteam
, 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 DienstprogrammLauncherHost
Qt5Core.dll
,vcruntime140-140_1.dll
,msvcp140-140_1.dll
– Dienstbibliotheken für das DienstprogrammLauncherHost.exe
installer
– Ordner für den Startprogramm-Installer

- Ordnerstruktur unter macOS:
LauncherHost
– ausführbare Datei für das DienstprogrammLauncherHost
Frameworks
– Systemordner für dieLauncherHost
-Dienstbibliothekeninstaller
– Ordner für den Startprogramm-Installer

- Erstellen Sie einen neuen Ordner im Verzeichnis
PreparingSteam
. - Kopieren Sie Ihre Spiel-Build in dieses Verzeichnis.
- 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.
- Kopieren Sie den eigenständigen Startprogramm-Installer (Windows/macOS) in den Ordner installer.
- Kopieren Sie die Steam-Konfigurationsdateien in den Ordner
PreparingSteam
. - 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.
- Aktivieren Sie die Nutzung von
ISteamApps::GetLaunchCommandLine()
im Admin-Dashboard Ihres Spiels.
- 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
- Melden Sie sich bei Steamworks an, und laden Sie das Steamworks-SDK herunter.
- Entpacken Sie das SDK-Archiv.
- Wechseln Sie in den Ordner
steamworks_sdk_151\sdk\tools
, und entpacken Sie das DienstprogrammSteamPipeGUI
, mit dem sich Spiel-Builds auf Steam hochladen lassen.
- Führen Sie das Dienstprogramm
SteamPipeGUI
aus.
- Füllen Sie die folgenden Felder im Einstellungsfenster aus:
- Geben Sie im Feld App-ID die Steam-AppID Ihres Spiels an.
- Geben Sie im Feld Build-Beschreibung eine kurze Beschreibung der Build ein, damit Sie die Build einfacher im Steam-Admin-Dashboard identifizieren können.
- Geben Sie im Feld Steamworks SDK ContentBuilder-Pfad den Pfad zum Steamworks SDK ContentBuilder an.
- Geben Sie in den Feldern Steam-Login und Steam-Passwort Ihren Steam-Benutzernamen und Ihr ‑Passwort ein.

- 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.

- Klicken Sie auf Hochladen, und warten Sie, bis der Upload abgeschlossen ist.
macOs-Spiel-Build-Dateien auf Steam hochladen
- Kopieren Sie die Datei
launcher.dmg
in den OrdnerprepairingSteam/installer
. - Kopieren Sie die Datei
hostArgs.json
in den OrdnerprepairingSteam
. - Laden Sie die Dateien auf Steam hoch:
- Öffnen Sie den entpackten Ordner
SteamSDK
.
- Öffnen Sie den entpackten Ordner
- Wechseln in den Ordner
tools/scripts
. - Erstellen Sie ein vdf-Skript namens
appbuild<steam_id>.vdf
, wobei<steam_id>
die Steam-ID Ihres Projekts und den folgenden Inhalt darstellt. (ersetzen Siexxxxxx
in Zeile 3 durch die Steam-ID,yyyyyy
in Zeile 11 durch die Depot-ID – die Steam-ID + 1:
- Wechseln in den Ordner
Copy
"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
}
}
}
}
- Speichern Sie die Änderungen.
- Kopieren Sie den Inhalt des Verzeichnisses
PrepairingSteam
in den Ordnertools/ContentBuilder/Content
. - Wechseln Sie in die Terminalkonsole, und navigieren Sie zum Ordner
tools/ContentBuilder/builder_osx
. - Rufen Sie den Befehl
./steamcmd.sh
auf, um die Initialisierung und Konfiguration zu starten. - Rufen Sie den folgenden Befehl auf, um das Skript auszuführen, daraufhin wir die Build auf die Steam-Server hochgeladen:
Copy
cmd.sh +login <username> <password> +run_app_build_http ../scripts/app_build_{Steam_id}.vdf
Spiel-Build auf Steamworks veröffentlichen
- Wechseln Sie zum Admin-Dashboard Ihres Spiels in Steamworks.
- Klicken Sie auf Steamworks-Admin, um die Admin-Seite des Spiels zu öffnen.
- Navigieren Sie zu SteamPipes > Builds.
- Erstellen Sie eine neue Branch, oder nutzen Sie eine Standardbranch.
- Suchen Sie nach der hochgeladenen Build anhand der Build-ID, dem Upload-Datum oder der Beschreibung, und platzieren Sie die Build in Ihre Branch.
- Klicken Sie auf Änderungsvorschau, und betrachten Sie die vorgenommenen Änderungen.
- Klicken Sie auf Build jetzt live freigeben.
War dieser Artikel hilfreich?
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.Diese Seite bewerten
Diese Seite bewerten
Jetzt nicht
Vielen Dank für Ihr Feedback!
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.