Zuletzt geprüft: 27. September 2026. Garry’s-Mod-Workshop-Addons lädt der Dedicated Server über eine Workshop-Collection. Ab Garry’s Mod 2026.09.22 kann er alternativ einzelne IDs aus cfg/srcds_workshop_ids.txt beziehen. resource.AddWorkshop() verteilt benötigte Dateien an Clients, installiert selbst aber keine Addons auf dem Server. Die aktuelle Facepunch-Anleitung beschreibt beide Serverwege.
Voraussetzungen
Du brauchst Zugriff auf die Workshop-Collection-Einstellung deines Garry’s-Mod-Servers und eine öffentliche oder nicht gelistete Collection. Im game-serverhosting Panel ist dafür die Variable WORKSHOP_ID vorgesehen. Prüfe Addon-Abhängigkeiten und teste Änderungen in kleinen Gruppen. Einen Steam Web API Key verlangt die aktuelle Facepunch-Anleitung für diesen Ablauf nicht pauschal.
Workshop Collection erstellen
- Gehe zum Steam Workshop
- Erstelle eine neue Collection
- Füge alle gewünschten Addons hinzu
- Collection-ID kopieren
Die Collection-ID steht in der URL der Steam-Collection. Kopiere nur die numerische ID, nicht die komplette URL. Achte darauf, dass die Collection öffentlich oder nicht gelistet ist; private Collections kann der Server laut Facepunch nicht abrufen. Wenn ein Addon entfernt, privat gestellt oder vom Autor aktualisiert wird, kann sich das auf deinen Serverstart oder die Client-Downloads auswirken. Prüfe deshalb nach größeren Änderungen immer die Serverkonsole.
Collection auf dem Server laden
Trage im game-serverhosting Panel unter den Startvariablen die numerische Collection-ID bei Workshop-Collection (WORKSHOP_ID) ein und starte den Server neu. Auf selbst verwalteten Servern lautet der entsprechende Startparameter:
+host_workshop_collection <collection_id>
Prüfe die Serverkonsole auf Workshop-Meldungen. Bei einem Fehler kontrollierst du zuerst ID, Sichtbarkeit und Erreichbarkeit der Addons. Ein pauschaler -authkey-Schritt gehört nicht zum aktuellen Facepunch-Ablauf.
Einzelne Workshop-IDs statt Collection
Mit Garry’s Mod 2026.09.22 oder neuer kannst du zusätzlich oder anstelle einer Collection die Datei cfg/srcds_workshop_ids.txt anlegen. Das Format steht in der Dedicated-Server-Dokumentation. Prüfe die installierte Serverversion, bevor du diesen Weg nutzt. Die Datei enthält IDs einzelner Addons, keine Collection-ID. Verwende das dokumentierte KeyValues-Format, kein JSON und keine bloße Zeilenliste:
"my_workshop_addons"
{
"1" { "wsid" "DEINE_ADDON_ID" }
}
Ersetze DEINE_ADDON_ID durch eine echte numerische Addon-ID; weitere Einträge erhalten eigene Schlüssel wie "2".
Spieler laden benötigte Inhalte
resource.AddWorkshop() veranlasst den Download für Clients. Es installiert kein Addon auf dem Server. Nutze es gezielt für zusätzliche Modelle, Materialien oder Sounds:
-- garrysmod/lua/autorun/server/workshop.lua
resource.AddWorkshop("DEINE_ADDON_ID")
Ersetze DEINE_ADDON_ID durch die numerische Workshop-ID eines verfügbaren Addons mit Client-Inhalten. Reine Lua-Addons brauchen diesen Eintrag nicht. Die aktuelle Map und ein Workshop-fähiger Spielmodus werden aus der Server-Collection automatisch für Clients markiert. Prüfe die Facepunch-Dokumentation zu resource.AddWorkshop und teste den Beitritt ohne lokales Addon-Abo.
Beliebte Addon-Kategorien
| Kategorie | Beispiele |
|---|---|
| Maps | ttt_minecraft, ph_office |
| Waffen | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Tools | Wiremod, Precision Tool |
| HUDs | DarkRP HUD, TTT HUD |
Diese Kategorien sind typische Beispiele, keine Empfehlung für jedes Setup. DarkRP, TTT, Prop Hunt und Sandbox-Server haben unterschiedliche Anforderungen. Entscheidend ist, dass Addons zum Spielmodus passen, aktiv gepflegt werden und keine doppelten Funktionen mitbringen. Zwei Waffenbasen, mehrere HUDs oder mehrere Admin-Tools können sich gegenseitig stören.
Wenn du auch andere Spiele mit Mod-Workflows betreibst, helfen die Prinzipien aus dem Project Zomboid Workshop Guide und dem ARK Mods installieren Guide: erst Abhängigkeiten klären, dann IDs sauber eintragen, danach mit Logs und Client-Test prüfen.
Ergebnis prüfen
Starte den Server nach jeder größeren Änderung neu und kontrolliere drei Punkte. Erstens: Die Konsole sollte keine Workshop-Fehler zur Collection oder den einzelnen IDs anzeigen. Zweitens: Die gewünschten Addons sollten serverseitig verfügbar sein, zum Beispiel Maps in der Mapliste oder Tools im passenden Spielmodus. Drittens: Ein Testclient ohne Abos sollte die benötigten Inhalte laden. Teste danach auch die eigentliche Addon-Funktion und den nächsten Mapwechsel; vorhandene Dateien beweisen noch keine fehlerfreie Lua-Ausführung.
Teste möglichst mit einem Client, der die Addons nicht bereits lokal abonniert hat. Sonst übersiehst du leicht, dass der automatische Download für neue Spieler nicht funktioniert. Bei öffentlichen Servern lohnt sich außerdem ein kurzer Hinweis in der Serverbeschreibung, wenn sehr große Inhalte geladen werden müssen.
Troubleshooting
- Addon lädt serverseitig nicht: Prüfe Collection-ID, Sichtbarkeit, Workshop-Seite und Startkonsole. Bei der Einzel-ID-Datei ist Version 2026.09.22 oder neuer nötig.
- Spieler sehen fehlende Texturen: Prüfe Addon-Abhängigkeiten und Client-Verteilung. Seit dem Juli-2025-Update sind die meisten CS:S-Inhalte enthalten; Maps und einige andere Dateien sind ausgenommen. Lade keine fremden Retail-Content-Packs in den Workshop hoch: Das untersagen die Facepunch-Workshop-Regeln.
- Download dauert lange: Miss zuerst, welche Pakete tatsächlich angefordert werden. Entferne ungenutzte Maps, doppelte Modelle und alte Pakete aus Collection und zusätzlicher
resource.AddWorkshop()-Liste; ein verbliebener Autorun-Eintrag kann den Clientdownload weiterhin auslösen.
FAQ
Brauche ich immer eine Workshop-Collection?
Nein. Eine Collection ist für mehrere Addons bequem. Seit Version 2026.09.22 kann der Server auch einzelne IDs aus cfg/srcds_workshop_ids.txt laden. resource.AddWorkshop() steuert nur den Client-Download.
Was ist der Unterschied zwischen Collection-ID und Workshop-ID?
Die Collection-ID bezeichnet eine Sammlung und gehört in die Panel-Variable WORKSHOP_ID oder zu +host_workshop_collection. Einzelne Addon-IDs können ab Version 2026.09.22 in cfg/srcds_workshop_ids.txt stehen. resource.AddWorkshop() verwendet ebenfalls eine einzelne Addon-ID, aber nur für Client-Dateien.
Warum sehen Spieler fehlende Texturen?
Prüfe das betroffene Addon, Abhängigkeiten und den Client-Download. Die meisten CS:S-Assets bringt Garry’s Mod seit Juli 2025 mit; Maps und einige Dateien sind ausgenommen. Ein pauschales „CSS Content Pack“ ist kein sicherer Reparaturschritt.
Muss ich den Server nach jeder Addon-Änderung neu starten?
Für Änderungen an Startparametern, Workshop-Collection oder serverseitigen Lua-Dateien solltest du neu starten. Nur so prüfst du zuverlässig, ob der Server die Collection korrekt lädt und die Client-Ressourcen registriert.
Wie groß sollte eine Collection sein?
So klein wie möglich und so groß wie nötig. Entferne Addons, die dein Spielmodus nicht aktiv nutzt. Das erleichtert Fehlersuche, hält Downloads überschaubar und macht Änderungen im laufenden Betrieb besser kontrollierbar.