Garry's Mod Workshop-addons installeer je netjes via een Steam Workshop-collectie, een Steam Web API Key en optioneel resource.AddWorkshop() voor de clientdownload. Zo blijft de serverconfiguratie overzichtelijk, kun je addons centraal vervangen en kun je bij problemen gericht controleren of de collectie, API Key of afzonderlijke Workshop-ID's fout zijn.
Vereisten
Je hebt toegang nodig tot de startparameters van je Garry's Mod-server, een Steam Workshop-collectie en een Steam Web API Key. De officiële bron voor Garry's Mod Workshop-content is de Steam Workshop voor Garry's Mod. De API Key maak je aan via de officiële Steam-pagina steamcommunity.com/dev/apikey.
Plan je addonselectie bewust. Een grote collectie kan de serverstart verlengen, clients tot langere downloads dwingen en fouten moeilijker vindbaar maken. Voor productieve servers is het verstandig om addons eerst afzonderlijk of in kleine groepen te testen voordat je ze permanent in de hoofdcollectie opneemt. Bij game-serverhosting past deze aanpak goed bij een gecontroleerd bedrijfsmodel: wijzigingen worden gedocumenteerd, gecontroleerd en pas daarna voor spelers vrijgegeven.
Workshop Collection maken
- Ga naar de Steam Workshop
- Maak een nieuwe collectie
- Voeg alle gewenste addons toe
- Kopieer de Collection-ID
De Collection-ID staat in de URL van de Steam-collectie. Kopieer alleen de numerieke ID, niet de volledige URL. Let er ook op dat de collectie openbaar is of door de server kan worden opgehaald. Als een addon wordt verwijderd, privé wordt gezet of door de auteur wordt bijgewerkt, kan dat invloed hebben op je serverstart of de clientdownloads. Controleer daarom na grotere wijzigingen altijd de serverconsole.
Collectie op de server laden
In de startregel van de server:
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
Vervang <collection_id> door de ID van je Workshop-collectie en <steam_web_api_key> door je Steam Web API Key. De parameter +host_workshop_collection geeft de server opdracht om de opgegeven collectie te laden. De parameter -authkey biedt toegang tot Steam-webdiensten die nodig zijn voor Workshop-downloads.
Nadat je de startparameters hebt ingevoerd, herstart je de server. Bekijk bij de eerste start de console of het log. Als Workshop-content niet wordt geladen, ligt de oorzaak vaak bij een verkeerde Collection-ID, een ontbrekende of ongeldige API Key of een addon die niet meer bereikbaar is.
Steam Web API Key
Nodig voor Workshop-downloads:
- Ga naar steamcommunity.com/dev/apikey
- Genereer een key
- Vul deze als
-authkeyin de startregel in
Behandel de API Key als een toegangstoken. Deel hem niet openbaar en plaats hem niet in forums, screenshots of vrij toegankelijke repositories. Als je vermoedt dat de key openbaar is geworden, moet je hem bij Steam opnieuw aanmaken en de oude key niet meer gebruiken.
Spelers laden addons automatisch
Voeg het volgende toe aan lua/autorun/server/workshop.lua, zodat spelers addons automatisch downloaden:
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() gebruikt afzonderlijke Workshop-ID's. Vul hier de addons in die clients automatisch moeten ophalen wanneer ze verbinden. Dit is vooral belangrijk voor maps, models, materialen, sounds of andere content die spelers lokaal nodig hebben. Server-only addons hoeven niet per se naar clients te worden verspreid.
Houd dit bestand duidelijk gestructureerd. Je kunt addons groeperen op doel, bijvoorbeeld Maps, wapens, playermodels of HUDs. Als een addon problemen veroorzaakt, zet je de bijbehorende regel bij wijze van test in commentaar en herstart je de server. Zo vind je conflicten sneller zonder de hele collectie uit elkaar te halen.
Populaire addon-categorieën
| Categorie | Voorbeelden |
|---|---|
| Maps | ttt_minecraft, ph_office |
| Wapens | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Tools | Wiremod, Precision Tool |
| HUDs | DarkRP HUD, TTT HUD |
Deze categorieën zijn typische voorbeelden, geen aanbeveling voor elke setup. DarkRP-, TTT-, Prop Hunt- en Sandbox-servers hebben verschillende eisen. Belangrijk is dat addons bij de spelmodus passen, actief worden onderhouden en geen dubbele functies meebrengen. Twee wapenbases, meerdere HUDs of meerdere admin-tools kunnen elkaar storen.
Als je ook andere games met mod-workflows beheert, helpen de principes uit de Project Zomboid Workshop Guide en de ARK Mods installeren Guide: eerst afhankelijkheden verduidelijken, daarna ID's netjes invoeren en vervolgens met logs en een clienttest controleren.
Resultaat controleren
Herstart de server na elke grotere wijziging en controleer drie punten. Ten eerste: de console mag geen Workshop-fouten over de collectie of de API Key tonen. Ten tweede: de gewenste addons moeten serverseitig beschikbaar zijn, bijvoorbeeld maps in de maplijst of tools in de passende spelmodus. Ten derde: een testclient moet benodigde content automatisch laden bij het verbinden of geen problemen met missing textures tonen.
Test bij voorkeur met een client die de addons nog niet lokaal heeft geabonneerd. Anders zie je makkelijk over het hoofd dat de automatische download voor nieuwe spelers niet werkt. Bij openbare servers is bovendien een korte melding in de serverbeschrijving zinvol als er zeer grote content moet worden geladen.
Troubleshooting
- Addon laadt niet: Steam Web API Key controleren
- Missing Textures: CSS Content Pack installeren
- Langzame download: collectie beperken tot het noodzakelijke
Als de hele collectie niet wordt geladen, controleer dan eerst typefouten in +host_workshop_collection en -authkey. Als slechts één addon ontbreekt, open dan de Workshop-pagina ervan en controleer of die nog beschikbaar is. Bij ontbrekende textures maak je onderscheid tussen Workshop-content en extern benodigde content. Garry's Mod-servers gebruiken vaak content die niet automatisch door één enkele addon wordt vervangen.
Bij lange laadtijden verwijder je ongebruikte maps, dubbele modellen, oude wapenpakketten en grote sound- of materiaalcollecties. Een kleinere collectie is makkelijker te onderhouden en verkleint de kans dat spelers bij hun eerste join afhaken.
Controle, grenzen en veilige terugweg
De handleiding “Garry's Mod Workshop Addons installeren” geldt voor het servertype dat in het artikel wordt beschreven en de versiestand die op het moment van controle zichtbaar was. Menunamen, beschikbare versies, mod- of plugincompatibiliteit en benodigde resources kunnen na updates afwijken. Neem waarden daarom niet ongecontroleerd over naar een andere game-, loader- of serverversie.
Maak vóór wijzigingen aan wereld, savegame, configuratie of uitbreidingen een backup van de betrokken bestanden. Wijzig daarna slechts één samenhangende stap en controleer 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. | Bij startfouten de wijziging terugdraaien en de laatste backup terugzetten. |
| Verbindingstest | Een testaccount kan verbinden via het adres dat in het Panel wordt getoond. | Bij versie- of verbindingsfouten versie, poort en vrijgaven opnieuw vergelijken. |
| Functietest | De concreet gewijzigde functie werkt zonder bestaande wereld- of speldata te beschadigen. | Bij bijwerkingen de server stoppen en opgeslagen bestanden herstellen. |
Een geslaagde afzonderlijke test is geen garantie voor prestaties of beschikbaarheid. Wereldgrootte, mods, plugins, spelersaantal, 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-collectie nodig?
Voor een server met meerdere addons is een collectie de netste manier, omdat je de selectie centraal in Steam beheert. Afzonderlijke Workshop-ID's in resource.AddWorkshop() blijven toch belangrijk, zodat clients benodigde content automatisch downloaden.
Wat is het verschil tussen Collection-ID en Workshop-ID?
De Collection-ID verwijst naar een verzameling van meerdere addons. Een Workshop-ID verwijst naar één afzonderlijke addon. In de startregel gebruik je de Collection-ID, in resource.AddWorkshop() vul je afzonderlijke Workshop-ID's in.
Waarom zien spelers ontbrekende textures?
Ontbrekende textures ontstaan meestal wanneer clientcontent niet is geladen of extra content nodig is. Controleer resource.AddWorkshop(), de addon-ID's en of de betreffende addon naar verdere content verwijst.
Moet ik de server na elke addonwijziging herstarten?
Voor wijzigingen aan startparameters, de Workshop-collectie of serverzijdige Lua-bestanden moet je herstarten. Alleen zo controleer je betrouwbaar of de server de collectie correct laadt en de clientresources registreert.
Hoe groot mag een collectie zijn?
Zo klein mogelijk en zo groot als nodig. Verwijder addons die je spelmodus niet actief gebruikt. Dat maakt foutopsporing makkelijker, houdt downloads overzichtelijk en maakt wijzigingen tijdens live gebruik beter controleerbaar.