Puoi installare correttamente gli addon Workshop di Garry's Mod tramite una Steam Workshop Collection, una Steam Web API Key e, opzionalmente, resource.AddWorkshop() per il download lato client. Così la configurazione del server resta comprensibile, gli addon possono essere sostituiti centralmente e, in caso di problemi, puoi verificare in modo mirato se la Collection, la API Key o singoli ID Workshop sono errati.
Prerequisiti
Ti servono l'accesso ai parametri di avvio del tuo server Garry's Mod, una Steam Workshop Collection e una Steam Web API Key. La fonte ufficiale per i contenuti Workshop di Garry's Mod è lo Steam Workshop per Garry's Mod. Puoi generare la API Key dalla pagina ufficiale di Steam steamcommunity.com/dev/apikey.
Pianifica con attenzione la scelta degli addon. Una Collection grande può allungare l'avvio del server, costringere i client a download più lunghi e rendere gli errori più difficili da trovare. Per i server produttivi conviene testare gli addon prima singolarmente o in piccoli gruppi, prima di inserirli stabilmente nella Collection principale. Con game-serverhosting questo flusso si adatta bene a un modello operativo controllato: le modifiche vengono documentate, verificate e solo dopo rese disponibili ai giocatori.
Creare una Workshop Collection
- Vai allo Steam Workshop
- Crea una nuova Collection
- Aggiungi tutti gli addon desiderati
- Copia l'ID della Collection
L'ID della Collection si trova nell'URL della Steam Collection. Copia solo l'ID numerico, non l'URL completo. Assicurati inoltre che la Collection sia pubblica o accessibile dal server. Se un addon viene rimosso, reso privato o aggiornato dall'autore, questo può influire sull'avvio del server o sui download dei client. Dopo modifiche importanti, controlla quindi sempre la console del server.
Caricare la Collection sul server
Nella riga di avvio del server:
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
Sostituisci <collection_id> con l'ID della tua Workshop Collection e <steam_web_api_key> con la tua Steam Web API Key. Il parametro +host_workshop_collection indica al server di caricare la Collection specificata. Il parametro -authkey fornisce l'accesso ai servizi web di Steam necessari per i download del Workshop.
Dopo aver inserito i parametri di avvio, riavvia il server. Al primo avvio osserva la console o il log. Se i contenuti Workshop non vengono caricati, la causa è spesso un ID Collection errato, una API Key mancante o non valida oppure un addon non più raggiungibile.
Steam Web API Key
Necessaria per i download Workshop:
- Vai su steamcommunity.com/dev/apikey
- Genera la key
- Inseriscila come
-authkeynella riga di avvio
Tratta la API Key come un token di accesso. Non condividerla pubblicamente e non inserirla in forum, screenshot o repository accessibili liberamente. Se sospetti che la key sia stata esposta, dovresti rigenerarla su Steam e non continuare a usare quella vecchia.
I giocatori scaricano automaticamente gli addon
Affinché i giocatori scarichino automaticamente gli addon, aggiungi in lua/autorun/server/workshop.lua:
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() usa singoli ID Workshop. Inserisci qui gli addon che i client devono ottenere automaticamente durante la connessione. È particolarmente importante per mappe, modelli, materiali, suoni o altri contenuti di cui i giocatori hanno bisogno localmente. Gli addon solo server non devono necessariamente essere distribuiti ai client.
Mantieni questo file ben strutturato. Puoi raggruppare gli addon per scopo, ad esempio mappe, armi, playermodel o HUD. Se un addon causa problemi, commenta temporaneamente la relativa voce e riavvia il server. Così trovi i conflitti più rapidamente, senza dover smontare l'intera Collection.
Categorie di addon popolari
| Categoria | Esempi |
|---|---|
| Mappe | ttt_minecraft, ph_office |
| Armi | M9K Weapons, TFA Base |
| Playermodel | PM + Playermodel Selector |
| Strumenti | Wiremod, Precision Tool |
| HUD | DarkRP HUD, TTT HUD |
Queste categorie sono esempi tipici, non una raccomandazione valida per ogni setup. I server DarkRP, TTT, Prop Hunt e Sandbox hanno requisiti diversi. Ciò che conta è che gli addon siano adatti alla modalità di gioco, vengano mantenuti attivamente e non portino funzioni duplicate. Due basi per armi, più HUD o più strumenti di amministrazione possono interferire tra loro.
Se gestisci anche altri giochi con workflow per le mod, ti aiutano i principi della guida al Workshop di Project Zomboid e della guida per installare mod su ARK: chiarire prima le dipendenze, poi inserire correttamente gli ID e infine verificare con log e test client.
Verificare il risultato
Riavvia il server dopo ogni modifica importante e controlla tre punti. Primo: la console non dovrebbe mostrare errori Workshop relativi alla Collection o alla API Key. Secondo: gli addon desiderati dovrebbero essere disponibili lato server, ad esempio le mappe nella lista mappe o gli strumenti nella modalità di gioco corretta. Terzo: un client di test dovrebbe scaricare automaticamente i contenuti necessari durante la connessione o non mostrare problemi di texture mancanti.
Se possibile, testa con un client che non ha già sottoscritto localmente gli addon. Altrimenti rischi di non accorgerti che il download automatico per i nuovi giocatori non funziona. Sui server pubblici vale inoltre la pena inserire un breve avviso nella descrizione del server se devono essere scaricati contenuti molto grandi.
Troubleshooting
- L'addon non si carica: controlla la Steam Web API Key
- Texture mancanti: installa il CSS Content Pack
- Download lento: riduci la Collection all'essenziale
Se l'intera Collection non viene caricata, controlla prima eventuali errori di battitura in +host_workshop_collection e -authkey. Se manca solo un singolo addon, apri la sua pagina Workshop e verifica se è ancora disponibile. In caso di texture mancanti, distingui tra contenuti Workshop e contenuti esterni necessari. I server Garry's Mod usano spesso contenuti che non vengono sostituiti automaticamente da un singolo addon.
In caso di tempi di caricamento lunghi, rimuovi mappe inutilizzate, modelli duplicati, vecchi pacchetti di armi e grandi raccolte di suoni o materiali. Una Collection più piccola è più facile da mantenere e riduce la probabilità che i giocatori abbandonino al primo ingresso.
Verifica, limiti e ritorno sicuro
La guida “Installare gli addon Workshop di Garry's Mod” vale per il tipo di server descritto nell'articolo e per lo stato delle versioni visibile al momento della verifica. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse necessarie possono cambiare dopo gli aggiornamenti. Non trasferire quindi valori a un'altra versione di gioco, loader o server senza verificarli.
Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi modifica solo un passaggio coerente alla volta e verificalo con la stessa versione client e server con cui vuoi giocare in seguito.
| Punto di verifica | Risultato atteso | Interruzione e ritorno |
|---|---|---|
| Avvio del server | Il server raggiunge lo stato operativo senza nuovi messaggi di errore. | In caso di errori di avvio, annulla la modifica e ripristina l'ultimo backup. |
| Test di connessione | Un account di test riesce a connettersi tramite l'indirizzo mostrato nel pannello. | In caso di errori di versione o connessione, ricontrolla versione, porta e autorizzazioni. |
| Test funzionale | La funzione modificata lavora correttamente senza danneggiare dati del mondo o di gioco esistenti. | In caso di effetti collaterali, arresta il server e ripristina i file salvati. |
Un test singolo riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono cambiare il risultato. Documenta versione, modifica e risultato del test, così potrai ricostruire eventuali differenze successive.
FAQ
Mi serve sempre una Workshop Collection?
Per un server con più addon, una Collection è il metodo più pulito perché gestisci la selezione centralmente su Steam. I singoli ID Workshop in resource.AddWorkshop() restano comunque importanti, così i client possono scaricare automaticamente i contenuti necessari.
Qual è la differenza tra ID Collection e ID Workshop?
L'ID Collection rimanda a una raccolta di più addon. Un ID Workshop rimanda a un singolo addon. Nella riga di avvio usi l'ID Collection, mentre in resource.AddWorkshop() inserisci i singoli ID Workshop.
Perché i giocatori vedono texture mancanti?
Le texture mancanti compaiono di solito quando i contenuti client non sono stati caricati o serve contenuto aggiuntivo. Controlla resource.AddWorkshop(), gli ID degli addon e se l'addon interessato rimanda ad altri contenuti.
Devo riavviare il server dopo ogni modifica agli addon?
Per modifiche ai parametri di avvio, alla Workshop Collection o ai file Lua lato server dovresti riavviare. Solo così verifichi in modo affidabile se il server carica correttamente la Collection e registra le risorse client.
Quanto dovrebbe essere grande una Collection?
Il più piccola possibile e grande quanto serve. Rimuovi gli addon che la tua modalità di gioco non usa attivamente. Questo facilita la ricerca degli errori, mantiene i download gestibili e rende le modifiche durante il funzionamento più controllabili.