Workshop collectie koppelen aan je GMod server

Met een Workshop-collectie zorgt u ervoor dat spelers automatisch de juiste addons downloaden wanneer zij verbinden met uw Garry's Mod server. Dit voorkomt ontbrekende texturen, modellen en geluiden. In dit artikel leest u stap voor stap hoe u een collectie aanmaakt en koppelt.

Stap 1: Steam Web API Key aanvragen

Uw server heeft een Steam Web API Key nodig om Workshop-content te downloaden:

1. Ga naar steamcommunity.com/dev/apikey en log in met uw Steam-account.
2. Vul een domeinnaam in (mag fictief zijn, bijvoorbeeld mijnserver.nl) en accepteer de voorwaarden.
3. Kopieer de API Key die verschijnt.

Stap 2: Workshop-collectie aanmaken

1. Open Steam en ga naar de Garry's Mod Workshop.
2. Klik rechts op Browse en kies Collections.
3. Klik op Create Collection.
4. Geef de collectie een naam, bijvoorbeeld "Server Addons".
5. Zoek en voeg de gewenste addons toe aan de collectie. Kies maps, wapens, modellen, tools en andere content die u op de server wilt gebruiken.
6. Publiceer de collectie.

Noteer het nummer in de URL van uw collectie. Dit is het Collection ID dat u nodig heeft. Bijvoorbeeld, als de URL steamcommunity.com/sharedfiles/filedetails/?id=1234567890 is, dan is het ID 1234567890.

Stap 3: Collectie koppelen aan de server

Voeg de volgende parameters toe aan het startcommando van uw server:

+host_workshop_collection COLLECTION_ID -authkey UW_API_KEY

Vervang COLLECTION_ID door het nummer van uw collectie en UW_API_KEY door de Steam Web API Key uit stap 1. Bij het starten downloadt de server automatisch alle addons uit de collectie.

Stap 4: Spelers de addons laten downloaden

Standaard downloadt de server de addons voor zichzelf, maar spelers moeten ze ook ontvangen. Voeg hiervoor een resource.AddWorkshop-regel toe voor elke individuele addon in een Lua-bestand op de server:

1. Maak het bestand garrysmod/lua/autorun/server/workshop.lua aan.
2. Voeg voor elke addon een regel toe:
   resource.AddWorkshop("ADDON_ID")

Het ADDON_ID vindt u op de Workshop-pagina van de betreffende addon. Heeft u veel addons, dan is het handig om een script te gebruiken dat automatisch alle ID's uit de collectie omzet naar resource.AddWorkshop-regels.

Collectie bijwerken

Wanneer u een addon toevoegt aan of verwijdert uit de collectie op Steam, downloadt de server de wijzigingen bij de volgende herstart. Vergeet niet om ook de resource.AddWorkshop-regels in het Lua-bestand bij te werken voor nieuwe addons.

Veelgemaakte fouten

• Addons laden niet: controleer of de API Key correct is en of het Collection ID klopt.
• Spelers zien ontbrekende content: de resource.AddWorkshop-regels ontbreken of zijn niet compleet. Voeg elke addon individueel toe.
• Server start traag op: bij veel grote addons duurt de eerste download langer. Na de eerste keer worden ze gecachet en start de server sneller.

Hoeveel addons kan mijn server aan?

Er is geen harde limiet, maar houd rekening met de download-grootte voor spelers. Een collectie van 2 tot 3 GB is gebruikelijk. Bij meer dan 5 GB kunnen spelers met een trage verbinding lang moeten wachten.

Moet ik de server herstarten na het aanpassen van de collectie?

Ja. De server downloadt nieuwe addons alleen bij het starten. Herstart de server na elke wijziging aan de collectie.

Tip: bij HostValues kunt u direct een Garry's Mod server huren met Workshop-ondersteuning.