Laatst gecontroleerd: 27 september 2026. Garry’s Mod Workshop-addons laadt de dedicated server via een Workshop-collection. Vanaf Garry’s Mod 2026.09.22 kan hij alternatief losse ID's uit cfg/srcds_workshop_ids.txt ophalen. resource.AddWorkshop() verspreidt benodigde bestanden naar clients, maar installeert zelf geen addons op de server. De actuele Facepunch-handleiding beschrijft beide serverroutes.
Vereisten
Je hebt toegang nodig tot de instelling voor de Workshop-collection van je Garry’s Mod-server en een openbare of niet-vermelde collection. In het game-serverhosting paneel is hiervoor de variabele WORKSHOP_ID beschikbaar. Controleer addon-afhankelijkheden en test wijzigingen in kleine groepen. Een Steam Web API Key eist de actuele Facepunch-handleiding voor deze werkwijze niet standaard.
Workshop Collection aanmaken
- Ga naar de Steam Workshop
- Maak een nieuwe collection aan
- Voeg alle gewenste addons toe
- Kopieer de collection-ID
De collection-ID staat in de URL van de Steam-collection. Kopieer alleen de numerieke ID, niet de volledige URL. Zorg ervoor dat de collection openbaar of niet-vermeld is; privécollections kan de server volgens Facepunch niet ophalen. Als een addon wordt verwijderd, privé wordt gezet of door de auteur wordt bijgewerkt, kan dat gevolgen hebben voor het opstarten van je server of de client-downloads. Controleer daarom na grotere wijzigingen altijd de serverconsole.
Collection op de server laden
Voer in het game-serverhosting paneel bij de startvariabelen de numerieke collection-ID in bij Workshop-collection (WORKSHOP_ID) en herstart de server. Op zelfbeheerde servers is de bijbehorende startparameter:
+host_workshop_collection <collection_id>
Controleer de serverconsole op Workshop-meldingen. Bij een fout controleer je eerst de ID, de zichtbaarheid en de bereikbaarheid van de addons. Een algemene -authkey-stap hoort niet bij de actuele Facepunch-werkwijze.
Losse Workshop-ID's in plaats van een collection
Met Garry’s Mod 2026.09.22 of nieuwer kun je aanvullend op of in plaats van een collection het bestand cfg/srcds_workshop_ids.txt aanmaken. Het formaat vind je in de documentatie voor dedicated servers. Controleer de geïnstalleerde serverversie voordat je deze route gebruikt. Het bestand bevat ID's van losse addons, geen collection-ID.
Spelers laden benodigde inhoud
resource.AddWorkshop() start de download voor clients. Het installeert geen addon op de server. Gebruik het gericht voor extra modellen, materialen of geluiden:
-- garrysmod/lua/autorun/server/workshop.lua
resource.AddWorkshop("JOUW_ADDON_ID")
Vervang JOUW_ADDON_ID door de numerieke Workshop-ID van een beschikbare addon met client-inhoud. Pure Lua-addons hebben deze regel niet nodig. De huidige map en een Workshop-compatibele spelmodus worden automatisch vanuit de server-collection voor clients gemarkeerd. Bekijk de Facepunch-documentatie over resource.AddWorkshop en test het joinen zonder lokaal addon-abonnement.
Populaire addon-categorieën
| Categorie | Voorbeelden |
|---|---|
| Maps | ttt_minecraft, ph_office |
| Wapens | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Tools | Wiremod, Precision Tool |
| HUD's | DarkRP HUD, TTT HUD |
Deze categorieën zijn typische voorbeelden en geen aanbeveling voor elke setup. DarkRP-, TTT-, Prop Hunt- en Sandbox-servers hebben verschillende eisen. Doorslaggevend is dat addons bij de spelmodus passen, actief worden onderhouden en geen dubbele functies meebrengen. Twee wapenbases, meerdere HUD's of meerdere admin-tools kunnen elkaar storen.
Als je ook andere games met mod-workflows host, helpen de principes uit de Project Zomboid Workshop-gids en de gids over ARK-mods installeren: eerst afhankelijkheden uitzoeken, dan de ID's netjes invoeren en daarna controleren met logs en een client-test.
Resultaat controleren
Herstart de server na elke grotere wijziging en controleer drie punten. Ten eerste: de console mag geen Workshop-fouten over de collection of de losse ID's tonen. Ten tweede: de gewenste addons moeten aan de serverkant beschikbaar zijn, bijvoorbeeld maps in de maplijst of tools in de bijpassende spelmodus. Ten derde: een testclient moet benodigde inhoud bij het verbinden automatisch laden of geen missing-texture-problemen laten zien.
Test bij voorkeur met een client die de addons nog niet lokaal heeft geabonneerd. Anders zie je gemakkelijk over het hoofd dat de automatische download voor nieuwe spelers niet werkt. Bij openbare servers is bovendien een korte opmerking in de serverbeschrijving handig als er zeer grote inhoud moet worden geladen.
Troubleshooting
- Addon laadt niet aan de serverkant: Controleer collection-ID, zichtbaarheid, Workshop-pagina en startconsole. Voor het bestand met losse ID's is versie 2026.09.22 of nieuwer nodig.
- Spelers zien ontbrekende texturen: Controleer addon-afhankelijkheden en client-verspreiding. Sinds de update van juli 2025 is het grootste deel van de CS:S-inhoud inbegrepen; maps en enkele andere bestanden zijn uitgezonderd. Upload geen retail-contentpacks van anderen naar de Workshop: dat verbieden de Facepunch Workshop-regels.
- Download duurt lang: Verwijder ongebruikte maps, dubbele modellen en oude pakketten uit de collection.
Controle, grenzen en veilige terugweg
De handleiding “Garry's Mod Workshop Addons installeren” geldt voor het in het artikel beschreven servertype en de versiestand die zichtbaar was op het moment van controle. Menunamen, beschikbare versies, mod- of pluginconpatibiliteit en benodigde resources kunnen na updates afwijken. Neem daarom geen waarden ongecontroleerd over naar een andere game-, loader- of serverversie.
Maak vóór wijzigingen aan wereld, savegame, configuratie of uitbreidingen een back-up van de betreffende bestanden. Wijzig daarna slechts één samenhangende stap en test die met dezelfde client- en serverversie waarmee je later wilt spelen.
| Controlepunt | Verwacht resultaat | Afbreken en terugweg |
|---|---|---|
| Serverstart | De server bereikt zonder nieuwe foutmelding de bedrijfsklare status. | Draai bij startfouten de wijziging terug en zet de laatste back-up terug. |
| Verbindingstest | Een testaccount kan verbinden via het in het paneel getoonde adres. | Vergelijk bij versie- of verbindingsfouten versie, poort en vrijgaves opnieuw. |
| Functietest | De concreet gewijzigde functie werkt zonder bestaande wereld- of speldata te beschadigen. | Stop bij bijwerkingen de server en herstel de gemaakte back-upbestanden. |
Een geslaagde losse test is geen garantie voor prestaties of beschikbaarheid. Wereldgrootte, mods, plugins, aantal spelers, netwerkroute en gelijktijdige belasting kunnen het resultaat veranderen. Documenteer versie, wijziging en testresultaat, zodat je latere afwijkingen kunt herleiden.
FAQ
Heb ik altijd een Workshop-collection nodig?
Nee. Een collection is handig bij meerdere addons. Sinds versie 2026.09.22 kan de server ook losse ID's uit cfg/srcds_workshop_ids.txt laden. resource.AddWorkshop() regelt alleen de client-download.
Wat is het verschil tussen collection-ID en Workshop-ID?
De collection-ID verwijst naar een verzameling en hoort in de paneelvariabele WORKSHOP_ID of bij +host_workshop_collection. Losse addon-ID's kunnen vanaf versie 2026.09.22 in cfg/srcds_workshop_ids.txt staan. resource.AddWorkshop() gebruikt eveneens een losse addon-ID, maar alleen voor client-bestanden.
Waarom zien spelers ontbrekende texturen?
Controleer de betreffende addon, afhankelijkheden en de client-download. Het grootste deel van de CS:S-assets levert Garry’s Mod sinds juli 2025 zelf mee; maps en enkele bestanden zijn uitgezonderd. Een algemeen “CSS Content Pack” is geen veilige herstelstap.
Moet ik de server na elke addon-wijziging herstarten?
Bij wijzigingen aan startparameters, de Workshop-collection of Lua-bestanden aan de serverkant moet je herstarten. Alleen zo controleer je betrouwbaar of de server de collection correct laadt en de client-resources registreert.
Hoe groot mag een collection zijn?
Zo klein mogelijk en zo groot als nodig. Verwijder addons die je spelmodus niet actief gebruikt. Dat maakt foutopsporing eenvoudiger, houdt downloads overzichtelijk en maakt wijzigingen tijdens het draaien beter beheersbaar.