So fügen Sie einem GMod-Server Workshop-Addons hinzu
In dieser Anleitung erfahren Sie, wie Sie Ihrem Garry's-Mod-Server (GMod) Addons aus dem Steam Workshop hinzufügen: eine Kollektion mit dem Server verbinden, die Addon-IDs in der Datei srcds_workshop_ids.txt auflisten und mit resource.AddWorkshop dafür sorgen, dass Modelle, Texturen und Sounds auch bei den Spielern ankommen. Außerdem sehen Sie Schritt für Schritt, wie Sie Ordner-Addons installieren, die es nicht im Workshop gibt, und das häufigste Problem mit ERROR-Modellen beheben.
Bevor Sie beginnen
Diese Anleitung setzt voraus, dass der Server installiert ist und sich starten lässt. Falls SteamCMD, GSLT (Game Server Login Token, Anmeldeschlüssel für Gameserver) und der Startbefehl noch nicht bereit sind, arbeiten Sie zuerst die Anleitung Garry's-Mod-Server von Grund auf einrichten durch. Die folgenden Pfade verwenden die Ordner aus dieser Anleitung: unter Windows C:\GModServer, unter Linux /home/steam/gmod. Weitere Themen sind auf der Seite Garry's-Mod-Anleitungen zusammengefasst.
- Steam-Konto: Wird benötigt, um die Kollektion zu erstellen und ihr Addons hinzuzufügen.
- Zugriff auf den Server: Mit einem Windows-VDS verbinden Sie sich per RDP (Remotedesktop), mit einem Linux-VDS per SSH; unter Linux können Sie Dateien per SFTP hochladen. Kommt keine Verbindung zustande, öffnet die VNC-Konsole im Kundenbereich den Bildschirm des Servers im Browser.
- Ressourcenbedarf: Große Map- und Modellpakete füllen die Festplatte schnell, und jedes Addon, das Lua-Code ausführt, belastet zusätzlich die CPU. Beobachten Sie beim Hinzufügen von Addons die Festplatten-, RAM- und CPU-Auslastung in den Live-Diagrammen im Kundenbereich. Da die Single-Core-Leistung entscheidend ist, wird für Gameserver die AMD Ryzen 9 9950X VDS-Familie empfohlen.
- Backup: Automatische Backups sind bei VDS nicht enthalten. Kopieren Sie vor Änderungen die Ordner
garrysmod/addons,garrysmod/cfg,garrysmod/dataundgarrysmod/luaauf einen Speicher außerhalb des Servers.
Es gibt drei Wege, ein Addon auf den Server zu bringen:
| Methode | Wie es auf den Server kommt | Wie die Inhalte zum Spieler gelangen | Wann |
|---|---|---|---|
| Workshop-Kollektion | Wird beim Start über +host_workshop_collection heruntergeladen und aktualisiert | resource.AddWorkshop (Map und Spielmodus automatisch) | Wenn die meisten Addons im Workshop sind; empfohlener Weg |
srcds_workshop_ids.txt | Die IDs in der Datei werden beim Start heruntergeladen | resource.AddWorkshop | Wenn Sie die Liste auf dem Server statt in Steam führen möchten |
| Ordner-Addon (Legacy, alter Typ) | Wird manuell in garrysmod/addons hochgeladen | FastDL (schneller Download) oder Inhalte in den Workshop hochladen und resource.AddWorkshop | Wenn das Addon nicht im Workshop ist |
1. Kollektion in Steam erstellen
Öffnen Sie in Steam den Garry's-Mod-Workshop und erstellen Sie im Bereich für Kollektionen eine neue Kollektion. Fügen Sie dann jedes Addon, das Sie auf dem Server haben möchten, über die Schaltfläche zum Hinzufügen zu einer Kollektion auf seiner Seite dieser Kollektion hinzu. Achten Sie auf drei Punkte:
- Sichtbarkeit: Die Kollektion muss öffentlich (public) oder nicht gelistet (unlisted) sein. Laut der Facepunch-Seite Workshop for Dedicated Servers kann der Server (srcds) sonst nicht auf die Kollektion zugreifen. Wenn die Kollektion nicht in Suchergebnissen erscheinen soll, genügt die Option „nicht gelistet“.
- ID: Die Kollektions-ID ist der Wert
?id=in der Adresse der Kollektionsseite; beihttps://steamcommunity.com/sharedfiles/filedetails/?id=123456789lautet dieser Wert123456789. Die Nummer an derselben Stelle auf der Seite eines einzelnen Addons ist dagegen die Addon-ID; verwechseln Sie die beiden nicht. - Verschachtelte Kollektionen: Der Server lädt auch Unterkollektionen innerhalb der Kollektion herunter. Wenn Sie getrennte Kollektionen für Maps und Waffen führen, fügen Sie diese einer gemeinsamen übergeordneten Kollektion hinzu und geben dem Server die ID der übergeordneten Kollektion.
2. Kollektion zum Startbefehl hinzufügen
Schreiben Sie ans Ende des Startbefehls, den Sie in der Einrichtungsanleitung vorbereitet haben, den Parameter +host_workshop_collection und Ihre Kollektions-ID. Der Server lädt die Addons der Kollektion bei jedem Start herunter, prüft, ob sie aktuell sind, und bindet sie ein (mount).
Windows (C:\GModServer\start.bat):
@echo off
srcds.exe -console -game garrysmod -port 27015 -tickrate 66 +maxplayers 24 +gamemode sandbox +map gm_construct +sv_setsteamaccount IHR_GSLT_SCHLUESSEL +host_workshop_collection 123456789
Linux (/home/steam/gmod/start.sh):
#!/bin/bash
cd /home/steam/gmod
./srcds_run -game garrysmod -port 27015 -tickrate 66 +maxplayers 24 +gamemode sandbox +map gm_construct +sv_setsteamaccount IHR_GSLT_SCHLUESSEL +host_workshop_collection 123456789
Speichern Sie die Datei und starten Sie den Server neu. Der erste Start kann je nach Größe der Kollektion lange dauern; verfolgen Sie in der Konsole die Zeilen, die das Herunterladen und Einbinden der Addons anzeigen. Vergessen Sie das Zeichen + am Anfang des Parameters nicht: Werte, die mit + beginnen, werden nach dem Spielstart als Konsolenvariable (ConVar) oder Befehl angewendet.
Um mit einer Map aus der Kollektion zu starten, tragen Sie bei +map den Namen der .bsp-Datei der Map ohne Endung ein. Stimmt der Name der geladenen Map mit einer Map in der Kollektion überein, laden die Spieler sie automatisch herunter, und in der Konsole erscheint die Zeile Making workshop map available for client download. Details zu eigenen Maps finden Sie in der Anleitung Eigene Map (Custom Map) auf den GMod-Server laden.
3. Alternative: ID-Liste mit srcds_workshop_ids.txt
Ab Garry's Mod 2026.09.22 können Sie Workshop-IDs auch in einer Konfigurationsdatei auflisten. Die Datei kann statt der Kollektion oder zusätzlich verwendet werden; so müssen Sie sich nicht bei Steam anmelden, um die Liste zu ändern. Legen Sie die Datei manuell unter dem Namen garrysmod/cfg/srcds_workshop_ids.txt an und behalten Sie die Struktur aus dem Facepunch-Beispiel bei:
"my_workshop_addons"
{
"1"
{
"wsid" "111111111"
}
"2"
{
"wsid" "222222222"
}
}
Öffnen Sie für jedes Addon wie im Beispiel einen neuen Block mit der nächsten Nummer und tragen Sie bei wsid die ID des Addons ein. Fehlt eine geschweifte Klammer oder ein Anführungszeichen, wird die Datei nicht korrekt gelesen. Starten Sie den Server nach der Änderung neu. Ist Ihr Server älter als diese Version, wird die Datei ignoriert; aktualisieren Sie den Server dann zuerst, indem Sie den SteamCMD-Befehl aus der Einrichtungsanleitung (+app_update 4020 validate) erneut ausführen.
4. Inhalte zu den Spielern bringen: resource.AddWorkshop
Die Kollektion installiert die Addons auf dem Server, lässt sie aber nicht von den Spielern herunterladen. Fehlen einem Spieler Inhalts-Addons (Modelle, Texturen, Sounds), die keine Map und kein Spielmodus sind, sieht er diese Objekte als ERROR-Schriftzug oder als lila-schwarzes Schachbrettmuster. Die Facepunch-Seite Serving Content nennt den Workshop-Download als schnellsten Weg, Inhalte auszuliefern. Legen Sie dafür eine Lua-Datei an, die serverseitig ausgeführt wird.
Windows: Legen Sie den Ordner C:\GModServer\garrysmod\lua\autorun\server an, falls er nicht existiert. Schreiben Sie die folgenden Zeilen in „Notepad“; wählen Sie im Fenster „Save As“ als Dateityp „All Files“ und geben Sie als Dateinamen workshop.lua ein. Andernfalls wird die Datei als workshop.lua.txt gespeichert und funktioniert nicht.
Linux (als Benutzer steam):
mkdir -p /home/steam/gmod/garrysmod/lua/autorun/server
nano /home/steam/gmod/garrysmod/lua/autorun/server/workshop.lua
Der Inhalt der Datei besteht aus einer Zeile pro Inhalts-Addon:
-- Workshop-Inhalte, die die Spieler herunterladen
resource.AddWorkshop("111111111") -- Beispiel: Modellpaket
resource.AddWorkshop("222222222") -- Beispiel: Soundpaket
Speichern Sie in nano mit Ctrl+S, beenden Sie mit Ctrl+X und starten Sie den Server neu. Dateien im Ordner lua/autorun/server werden beim Start automatisch und nur serverseitig ausgeführt. Halten Sie sich beim Erstellen der Liste an folgende Regeln:
- Fügen Sie nur Inhalts-Addons hinzu. Addons, die nur Lua-Dateien enthalten, in diese Liste aufzunehmen, bringt nichts und belastet die Spieler mit unnötigen Downloads. Lua-Dateien gelangen auf einem eigenen Weg und ohne zusätzliche Einstellungen zu den Spielern.
- Tragen Sie keine Kollektions-ID ein.
resource.AddWorkshopakzeptiert die ID eines einzelnen Addons, keine Kollektions-ID. - Fügen Sie Map und Spielmodus nicht erneut hinzu. Ist die geladene Map in der Kollektion oder ist in der Datei
garrysmod/gamemodes/<mod>/<mod>.txtdes Spielmodus eineworkshopiddefiniert, werden diese automatisch heruntergeladen. - Kennen Sie das Limit. Laut Facepunch gilt für alle
resource.Add*-Funktionen gemeinsam ein Limit von 8192 herunterladbaren Dateien; wenn Sie sich diesem Limit nähern, verschlanken Sie Ihre Download-Liste.
Spieler können in den Spieleinstellungen ändern, welche Dateitypen sie herunterladen. Ist auf Ihrem Server alles korrekt und sieht nur ein Spieler ERROR, lassen Sie zuerst dessen Download-Einstellung prüfen. Details zur Funktion finden Sie auf der Seite resource.AddWorkshop.
5. Addon-Updates verwalten
Standardmäßig prüft der Server bei jedem Start, ob die Addons der Kollektion aktuell sind; um die neue Version eines Addons zu erhalten, genügt ein Neustart des Servers. Um die Aktualisierung beim Start abzuschalten, fügen Sie dem Startbefehl Folgendes hinzu:
+host_workshop_autoupdate 0
Diese Einstellung schützt Ihren Server, wenn der Besitzer eines Addons eine unerwünschte oder schädliche Änderung hochlädt. Der Preis dafür: Während der Server auf der alten Version bleibt, können Spieler die aktuelle Version aus dem Workshop erhalten. Wie Facepunch warnt, kann eine aktualisierte Map deshalb verhindern, dass Spieler den Server betreten. Wenn Sie die Aktualisierung abgeschaltet haben, aktualisieren Sie die Addons in regelmäßigen Abständen selbst: Setzen Sie den Wert vorübergehend auf 1 und starten Sie den Server neu; treten keine Probleme auf, setzen Sie ihn wieder auf 0. Sichern Sie vor jeder größeren Aktualisierung die Ordner addons, cfg und data; der Cloud-Backup-Speicher mit SFTP-Zugang ist dafür ein geeignetes Ziel.
6. Addons, die nicht im Workshop sind: Ordner addons
Nicht im Workshop veröffentlichte Addons werden als Ordner-Addons (Legacy) installiert. Jedes Addon braucht in garrysmod/addons einen eigenen Ordner, dessen Inhalt der Struktur des Ordners garrysmod folgt. Alle Unterordner sind optional; vorhanden sind nur die Ordner, die das Addon benötigt:
garrysmod/addons/beispiel_addon/
lua/autorun/server/beispiel_sv.lua
materials/beispiel/
models/beispiel/
Liegt Ihr Addon als einzelne .gma-Datei vor, entpacken Sie sie zuerst in einen Ordner. Das erledigt das im bin-Ordner von Garry's Mod liegende Werkzeug gmad.exe; den Ordner erreichen Sie in Steam per Rechtsklick auf das Spiel über „Verwalten“ > „Lokale Dateien durchsuchen“. Führen Sie den Befehl auf Ihrem eigenen Windows-Computer in einer Eingabeaufforderung aus, die Sie in diesem bin-Ordner geöffnet haben, und laden Sie den entpackten Ordner auf den Server hoch:
gmad.exe extract -file "C:\downloads\beispiel_addon.gma" -out "C:\downloads\beispiel_addon"
Achten Sie auf Linux-Servern auf zwei Punkte. Laut Facepunch können Ordnernamen mit Großbuchstaben dazu führen, dass ältere Addons nicht funktionieren; ändern Sie die Ordnernamen in Kleinbuchstaben und passen Sie die Pfade im Lua-Code entsprechend an. Wenn Sie die Dateien mit dem root-Konto per SFTP hochgeladen haben, übertragen Sie den Besitz an den Benutzer steam, der den Server ausführt (wenn Sie als root angemeldet sind, ist das vorangestellte sudo nicht nötig):
sudo chown -R steam:steam /home/steam/gmod/garrysmod/addons
Modelle und Texturen aus Ordner-Addons gelangen nicht automatisch zu den Spielern. Sie können sie per FastDL (schneller Download) verteilen oder die Inhaltsdateien in den Workshop hochladen und der Liste aus Schritt 4 hinzufügen. Legen Sie für das Hochladen im Inhaltsordner eine Datei an, deren Typ (type) ServerContent ist, und zwar die Datei addon.json; ihr Format beschreibt die Facepunch-Seite „Workshop Addon Creation“. Packen Sie den Ordner anschließend mit gmad.exe in eine .gma-Datei und veröffentlichen Sie sie mit gmpublish.exe. Beide Werkzeuge liegen im selben bin-Ordner; geben Sie für -icon ein Titelbild im Format .jpg an:
gmad.exe create -folder "C:\downloads\beispiel_inhalt" -out "C:\downloads\beispiel_inhalt.gma"
gmpublish.exe create -addon "C:\downloads\beispiel_inhalt.gma" -icon "C:\downloads\beispiel_inhalt.jpg"
Laden Sie keine fremden Inhalte ohne Erlaubnis hoch. Verwenden Sie nicht den direkten Download vom Server (sv_allowdownload); Facepunch betrachtet diesen Weg als veraltet, sehr langsam und missbrauchsanfällig.
Beispielkonfiguration
Die folgende Tabelle fasst die in dieser Anleitung verwendeten Dateien und Parameter zusammen. Die Pfade sind relativ zum Ordner garrysmod.
| Datei / Parameter | Wo | Aufgabe | Beispiel |
|---|---|---|---|
+host_workshop_collection | Startbefehl | Lädt die Kollektion beim Start herunter, aktualisiert sie und bindet sie ein | +host_workshop_collection 123456789 |
+host_workshop_autoupdate | Startbefehl | 0: Beim Start findet keine Aktualisierung statt | +host_workshop_autoupdate 0 |
srcds_workshop_ids.txt | cfg/ | ID-Liste statt oder zusätzlich zur Kollektion (ab 2026.09.22) | "wsid" "111111111" |
workshop.lua | lua/autorun/server/ | Lässt die Spieler Inhalts-Addons herunterladen | resource.AddWorkshop("111111111") |
workshopid | gamemodes/<mod>/<mod>.txt | Lässt die Spieler den Spielmodus automatisch herunterladen | "workshopid" "111111111" |
| Ordner-Addon | addons/<addon>/ | Installiert ein Addon, das nicht im Workshop ist, auf dem Server | addons/beispiel_addon/ |
Häufige Fehler
- Die Kollektion wird gar nicht heruntergeladen: Die Sichtbarkeit der Kollektion steht weder auf „öffentlich“ noch auf „nicht gelistet“, die eingetragene ID gehört zu einem Addon, oder der Server wurde nach der Änderung der Startdatei nicht neu gestartet. Kopieren Sie die ID erneut aus der Adresse der Kollektionsseite.
- Spieler sehen ERROR-Modelle und lila-schwarze Texturen: Das Inhalts-Addon steht nicht in der Liste von
workshop.lua, oder die Datei liegt im falschen Ordner. Stammt die fehlende Textur aus Inhalten von Counter-Strike: Source, prüfen Sie die serverseitige Einstellung inmount.cfganhand der Einrichtungsanleitung; diese Inhalte müssen auch beim Spieler vorhanden sein. workshop.luafunktioniert nicht: Unter Windows wurde die Datei möglicherweise alsworkshop.lua.txtgespeichert; aktivieren Sie im Datei-Explorer („File Explorer“) die Anzeige der Dateinamenerweiterungen („File name extensions“) und prüfen Sie den Namen. Gibt es in der Konsole einen Lua-Fehler, kontrollieren Sie Anführungszeichen und Klammern.- Nach einem Update können Spieler die Map nicht betreten: Bei aktivem
+host_workshop_autoupdate 0wurde die Map im Workshop aktualisiert, der Server ist aber auf der alten Version geblieben. Schalten Sie die Aktualisierung einmal ein und starten Sie den Server neu. - Ordner-Addon wird unter Linux nicht geladen: Der Ordnername enthält Großbuchstaben, oder die Dateien gehören root. Ändern Sie die Namen in Kleinbuchstaben und führen Sie den Befehl
chownaus. - Das Betreten des Servers dauert sehr lange: Die
workshop.lua-Liste enthält möglicherweise Addons, die nur aus Lua bestehen, oder die an die Spieler verteilten Inhalte sind größer als nötig. Löschen Sie überflüssigeresource.AddWorkshop-Zeilen und entfernen Sie ungenutzte Addons aus der Kollektion. srcds_workshop_ids.txtwird ignoriert: Der Server ist älter als Version2026.09.22, die Datei liegt nicht im Ordnercfg, oder in der Struktur fehlt eine Klammer oder ein Anführungszeichen.- Ein Addon bringt den Server zum Absturz: Um das problematische Addon zu finden, teilen Sie die Kollektion in zwei Hälften und testen mit einer Hälfte; die problematische Hälfte teilen Sie erneut und so weiter. Führen Sie die Tests nicht auf dem Live-Server durch, sondern auf einer Kopie, die Sie in einem separaten Ordner installiert haben und mit einem anderen Port starten. Wie Sie Lua-Fehler in der Konsole lesen, erklärt die Anleitung Lua-Fehler und Lag beheben.
Häufig gestellte Fragen
Werden Workshop-Addons auf dem Server automatisch aktualisiert?
Ja, die Prüfung auf Updates erfolgt beim Start. Bei jedem Start prüft der Server, ob die Addons der Kollektion aktuell sind; um die neue Version zu erhalten, starten Sie den Server neu. Mit +host_workshop_autoupdate 0 können Sie diese Prüfung abschalten.
Kann ich mehrere Kollektionen verwenden?
In den Startbefehl wird eine Kollektions-ID geschrieben. Fügen Sie mehrere Kollektionen einer gemeinsamen übergeordneten Kollektion hinzu; der Server lädt auch die Unterkollektionen herunter. Zusätzlich können Sie in der Datei srcds_workshop_ids.txt einzelne Addon-IDs auflisten.
Ist ein Steam-Web-API-Schlüssel (-authkey) erforderlich?
Die aktuelle Facepunch-Seite „Workshop for Dedicated Servers“ nennt für Kollektionen nur den Parameter +host_workshop_collection; einen Steam-Web-API-Schlüssel und den Parameter -authkey erwähnt sie nicht. Dieser Parameter taucht in Startbefehlen älterer Anleitungen auf. Wird die Kollektion nicht heruntergeladen, prüfen Sie zuerst Sichtbarkeit und ID. Enthält Ihre Startdatei einen API-Schlüssel oder ein GSLT, behandeln Sie diese wie Passwörter und teilen Sie keine Screenshots der Datei.
Wie viele Addons kann ich hinzufügen?
Auf den Facepunch-Seiten ist keine Obergrenze für die Zahl der Addons in einer Kollektion angegeben; für Dateien, die Spieler herunterladen können, gilt dagegen ein Limit von 8192. In der Praxis bestimmen die Ressourcen des Servers und die Ladezeit für die Spieler die Grenze. Behalten Sie beim Hinzufügen von Addons die CPU- und RAM-Diagramme im Kundenbereich im Blick; reichen die Ressourcen nicht aus, finden Sie Optionen auf der Seite Garry's-Mod-Server.
Verwandte Anleitungen
- So richten Sie einen Garry's-Mod-Server ein: Anleitung zu SteamCMD und srcds
- GMod FastDL (schneller Download): Was ist das und wie richtet man es ein?
- Eigene Map (Custom Map) auf den GMod-Server laden
- GMod-DarkRP-Server installieren und konfigurieren
- GMod: ULX und ULib installieren – so vergeben Sie Adminrechte
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.