Garry's-Mod-Workshop-Addons installierst du sauber über eine Steam-Workshop-Collection, einen Steam Web API Key und optional resource.AddWorkshop() für den Client-Download. So bleibt die Serverkonfiguration nachvollziehbar, Addons lassen sich zentral austauschen, und du kannst bei Problemen gezielt prüfen, ob Collection, API Key oder einzelne Workshop-IDs fehlerhaft sind.
Voraussetzungen
Du brauchst Zugriff auf die Startparameter deines Garry's-Mod-Servers, eine Steam-Workshop-Collection und einen Steam Web API Key. Die offizielle Quelle für Garry's-Mod-Workshop-Inhalte ist der Steam Workshop für Garry's Mod. Den API Key erzeugst du über die offizielle Steam-Seite steamcommunity.com/dev/apikey.
Plane die Addon-Auswahl bewusst. Eine große Collection kann den Serverstart verlängern, Clients zu längeren Downloads zwingen und Fehler schwerer auffindbar machen. Für produktive Server ist es sinnvoll, Addons erst einzeln oder in kleinen Gruppen zu testen, bevor du sie dauerhaft in die Haupt-Collection übernimmst. Bei game-serverhosting passt dieser Ablauf gut zu einem kontrollierten Betriebsmodell: Änderungen werden dokumentiert, geprüft und erst danach für Spieler freigegeben.
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 außerdem darauf, dass die Collection öffentlich oder für den Server abrufbar ist. 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
In der Server-Startzeile:
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
Ersetze <collection_id> durch die ID deiner Workshop-Collection und <steam_web_api_key> durch deinen Steam Web API Key. Der Parameter +host_workshop_collection weist den Server an, die angegebene Collection zu laden. Der Parameter -authkey stellt den Zugriff auf Steam-Webdienste bereit, die für Workshop-Downloads benötigt werden.
Nach dem Eintragen der Startparameter startest du den Server neu. Beobachte beim ersten Start die Konsole oder das Log. Wenn Workshop-Inhalte nicht geladen werden, liegt die Ursache häufig bei einer falschen Collection-ID, einem fehlenden oder ungültigen API Key oder einem Addon, das nicht mehr erreichbar ist.
Steam Web API Key
Benötigt für Workshop-Downloads:
- Gehe zu steamcommunity.com/dev/apikey
- Key generieren
- Als
-authkeyin der Startzeile eintragen
Behandle den API Key wie ein Zugangstoken. Teile ihn nicht öffentlich und schreibe ihn nicht in Foren, Screenshots oder frei zugängliche Repositories. Wenn du vermutest, dass der Key offengelegt wurde, solltest du ihn bei Steam neu erzeugen und den alten Key nicht weiterverwenden.
Spieler laden Addons automatisch
Damit Spieler Addons automatisch herunterladen, füge in lua/autorun/server/workshop.lua hinzu:
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() nutzt einzelne Workshop-IDs. Trage hier die Addons ein, die Clients beim Verbinden automatisch beziehen sollen. Das ist besonders wichtig für Maps, Models, Materialien, Sounds oder andere Inhalte, die Spieler lokal benötigen. Server-only Addons müssen nicht zwingend an Clients verteilt werden.
Halte diese Datei klar strukturiert. Du kannst Addons nach Zweck gruppieren, etwa Maps, Waffen, Playermodels oder HUDs. Wenn ein Addon Probleme verursacht, kommentierst du den entsprechenden Eintrag testweise aus und startest den Server neu. So findest du Konflikte schneller, ohne die gesamte Collection zu zerlegen.
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 zum API Key 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 sollte benötigte Inhalte beim Verbinden automatisch laden oder keine Missing-Texture-Probleme zeigen.
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 nicht: Steam Web API Key prüfen
- Missing Textures: CSS Content Pack installieren
- Langsamer Download: Collection auf das Nötigste reduzieren
Wenn die gesamte Collection nicht geladen wird, prüfe zuerst Schreibfehler in +host_workshop_collection und -authkey. Wenn nur ein einzelnes Addon fehlt, öffne dessen Workshop-Seite und prüfe, ob es noch verfügbar ist. Bei fehlenden Texturen unterscheidest du zwischen Workshop-Inhalten und extern benötigtem Content. Garry's-Mod-Server nutzen häufig Inhalte, die nicht automatisch durch ein einzelnes Addon ersetzt werden.
Bei langen Ladezeiten entfernst du ungenutzte Maps, doppelte Modelle, alte Waffenpakete und große Sound- oder Materialsammlungen. Eine kleinere Collection ist leichter zu warten und reduziert die Wahrscheinlichkeit, dass Spieler beim ersten Join abbrechen.
Prüfung, Grenzen und sicherer Rückweg
Die Anleitung „Garry's Mod Workshop Addons installieren“ gilt für den im Artikel beschriebenen Servertyp und den zum Prüfzeitpunkt sichtbaren Versionsstand. Menünamen, verfügbare Versionen, Mod- oder Plugin-Kompatibilität und benötigte Ressourcen können nach Updates abweichen. Übertrage deshalb keine Werte ungeprüft auf eine andere Spiel-, Loader- oder Serverversion.
Erstelle vor Änderungen an Welt, Spielstand, Konfiguration oder Erweiterungen ein Backup der betroffenen Dateien. Ändere anschließend nur einen zusammengehörigen Schritt und prüfe ihn mit derselben Client- und Serverversion, mit der du später spielen möchtest.
| Prüfpunkt | Erwartetes Ergebnis | Abbruch und Rückweg |
|---|---|---|
| Serverstart | Der Server erreicht ohne neue Fehlermeldung den betriebsbereiten Zustand. | Bei Startfehlern Änderung zurücknehmen und das letzte Backup einspielen. |
| Verbindungstest | Ein Testkonto kann über die im Panel angezeigte Adresse verbinden. | Bei Versions- oder Verbindungsfehlern Version, Port und Freigaben erneut abgleichen. |
| Funktionstest | Die konkret geänderte Funktion arbeitet, ohne bestehende Welt- oder Spieldaten zu beschädigen. | Bei Nebenwirkungen Server stoppen und gesicherte Dateien wiederherstellen. |
Ein erfolgreicher Einzeltest ist keine Leistungs- oder Verfügbarkeitsgarantie. Weltgröße, Mods, Plugins, Spielerzahl, Netzwerkweg und gleichzeitige Last können das Ergebnis verändern. Dokumentiere Version, Änderung und Testergebnis, damit du spätere Abweichungen nachvollziehen kannst.
FAQ
Brauche ich immer eine Workshop-Collection?
Für einen Server mit mehreren Addons ist eine Collection der sauberste Weg, weil du die Auswahl zentral in Steam verwaltest. Einzelne Workshop-IDs in resource.AddWorkshop() bleiben trotzdem wichtig, damit Clients benötigte Inhalte automatisch herunterladen.
Was ist der Unterschied zwischen Collection-ID und Workshop-ID?
Die Collection-ID verweist auf eine Sammlung mehrerer Addons. Eine Workshop-ID verweist auf ein einzelnes Addon. In der Startzeile nutzt du die Collection-ID, in resource.AddWorkshop() trägst du einzelne Workshop-IDs ein.
Warum sehen Spieler fehlende Texturen?
Fehlende Texturen entstehen meistens, wenn Client-Inhalte nicht geladen wurden oder zusätzlicher Content benötigt wird. Prüfe resource.AddWorkshop(), die Addon-IDs und ob das betroffene Addon auf weiteren Content verweist.
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.