Controlla CounterStrikeSharp dopo l'aggiornamento di settembre

CounterStrikeSharp v1.0.374 del 7 settembre 2026 aggiunge l'API CustomHudLayout, corregge un errore in DropActivePlayerWeapon e aggiorna le definizioni degli schemi alla versione 1.41.7.7. La pubblicazione da sola non conferma la compatibilità di ogni plugin sul tuo server.

Esegui un backup dei file esistenti di framework e plugin e, dopo l'aggiornamento controllato, verifica la catena di caricamento: meta list, poi css_plugins list, quindi le funzioni di MatchZy utilizzate. Testa anche i cambi di mappa e i tuoi plugin HUD o per le armi. Annota la versione del framework testata insieme alle versioni dei plugin.

Non installare senza controlli un pacchetto MatchZy più vecchio che include CounterStrikeSharp sopra un framework già aggiornato. Controlla prima le versioni incluse oppure usa il pacchetto con il solo plugin, se i requisiti sono già soddisfatti. Le release di MatchZy distinguono esplicitamente questi pacchetti.

Cosa si basa su cosa?

L'ordine è importante: MetaMod:Source carica le estensioni native, CounterStrikeSharp fornisce il framework per i plugin C# e MatchZy funziona come plugin di CounterStrikeSharp. Dopo un aggiornamento di CS2, le versioni del framework devono corrispondere alla build attuale del server.

Questa struttura spiega anche perché gli errori si propagano quasi sempre dal basso verso l'alto: se MetaMod non si carica, CounterStrikeSharp non parte nemmeno, e MatchZy non compare in nessuna lista di plugin. Chi in questa situazione reinstalla prima MatchZy sta riparando il livello sbagliato. Procedi quindi sempre dal livello più basso verso l'alto.

Requisiti

Prima di iniziare, controlla tre cose:

  • Accesso al server: hai bisogno dell'accesso al gestore dei plugin nel pannello o alla gestione dei file. Per la variante manuale è necessario un accesso SFTP ai file del gameserver.
  • Un backup aggiornato: le installazioni dei plugin intervengono in game/csgo/addons/. Un backup prima del primo accesso in scrittura ti evita, in caso di errore, una reinstallazione completa.
  • Un server fermato: non scrivere mai in addons/ mentre il server è in esecuzione. I file scritti a metà causano errori di caricamento difficili da distinguere da veri conflitti di versione.

Installazione nel pannello

  1. Crea un backup e ferma il server.
  2. Apri il gestore dei plugin e installa prima MetaMod:Source.
  3. Installa poi CounterStrikeSharp.
  4. Avvia il server una volta. Nel log, MetaMod e CounterStrikeSharp devono comparire senza errori di caricamento.
  5. Ferma di nuovo il server, installa MatchZy e riavvialo.
  6. Verifica con css_plugins list nella console del server se MatchZy è caricato.

Nell'installazione manuale, MetaMod e CounterStrikeSharp vanno posizionati sotto game/csgo/addons/; MatchZy si trova sotto game/csgo/addons/counterstrikesharp/plugins/MatchZy/. Usa il gestore dei plugin quando possibile, in modo che percorsi e versioni compatibili vengano scelti automaticamente.

L'avvio intermedio dopo il passaggio 3 non è un passaggio opzionale in più. Separa nettamente due possibili fonti di errore: se il server si blocca già a questo punto, il problema è nel framework e non in MatchZy. Se installi tutto in un colpo solo e il server non parte più, dopo devi indovinare quale delle tre componenti sia responsabile.

Comandi di base per una partita

I giocatori usano i comandi in chat:

.ready       segnala pronto
.unready     annulla la disponibilità
.pause       metti in pausa la partita
.unpause     riprendi la partita

A seconda della configurazione di MatchZy, gli stessi comandi possono iniziare anche con !. Gli admin caricano una configurazione di partita tramite il comando di caricamento fornito da MatchZy; controlla prima il nome file esatto nella tua configurazione di MatchZy.

Comandi del server utili:

status
mp_warmup_end
mp_restartgame 1
changelevel de_mirage
bot_kick

Se vuoi avviare le partite regolarmente e senza lavorare sulla console, il CS2 Match Center con MatchZy è la via più comoda: lì puoi impostare team, mappa, formato e GOTV tramite un modulo, invece di digitare ogni impostazione con un comando.

Individuare gli errori

I tre sintomi più comuni hanno cause chiaramente distinguibili:

  • css_plugins list non riconosce il comando. In questo caso CounterStrikeSharp non è caricato. Controlla nel log di avvio se MetaMod è stato inizializzato — senza MetaMod non esiste CounterStrikeSharp.
  • css_plugins list funziona, ma MatchZy manca nell'output. Il framework e il livello dei plugin sono a posto, ma MatchZy si trova nella cartella sbagliata o non è compatibile con la versione di CounterStrikeSharp installata.
  • Il server non si avvia più dopo l'installazione. Nella maggior parte dei casi è un conflitto di versione dopo un aggiornamento di CS2. Rimuovi MatchZy per prova, avvia il server e procedi di nuovo verso l'alto.

Leggi sempre il log di avvio dall'alto verso il basso. Il primo blocco Failed, Error o Exception indica il livello interessato; tutto ciò che segue sono di solito errori a cascata che scompaiono da soli non appena la causa viene risolta.

Dopo un aggiornamento di CS2

Se i plugin improvvisamente mancano, non reinstallare l'intero gameserver. Controlla prima se MetaMod e CounterStrikeSharp si caricano ancora, aggiorna entrambi i framework e poi MatchZy. Il primo blocco Failed, Error o Exception nel log di avvio indica di solito il livello interessato.

Valve pubblica gli aggiornamenti di CS2 senza tenere conto dei framework di terze parti. Tra un aggiornamento e la versione corrispondente di MetaMod o CounterStrikeSharp possono quindi passare ore o giorni. Per le partite di lega con una data fissa conviene gestire in modo mirato gli aggiornamenti automatici, in modo che un server non passi a una build immediatamente prima della partita per cui non esistono ancora plugin compatibili.

FAQ

Devo installare anche SourceMod? Per MatchZy no. MatchZy si basa su CounterStrikeSharp. SourceMod è un ecosistema di plugin autonomo e parallelo e non è necessario per questo stack.

In quale ordine devo aggiornare? Sempre dal basso verso l'alto: prima MetaMod:Source, poi CounterStrikeSharp, infine MatchZy. Al contrario, il plugin superiore si carica contro un framework che non corrisponde ancora alla build del server.

Perché i comandi in chat non rispondono? O MatchZy non è caricato — lo mostra css_plugins list — oppure la tua configurazione usa un prefisso di comando diverso. Sono diffusi sia .ready sia !ready.

Posso installare i plugin mentre il server è in esecuzione? No. Ferma prima il server. Gli accessi in scrittura a addons/ mentre il processo è in esecuzione generano file incompleti ed errori di caricamento che sembrano conflitti di versione.

Dove trovo la documentazione ufficiale? I passaggi di installazione e le opzioni di configurazione di MatchZy si trovano nella documentazione di MatchZy. Per le questioni sulle versioni relative alla famiglia Metamod/SourceMod, il riferimento è la panoramica delle versioni richieste su AlliedModders.

Il server funziona, ma le prestazioni calano durante la partita. Questo non è propriamente un problema di plugin. Controlla tickrate e carico del server separatamente dallo stack dei plugin — a riguardo c'è una guida dedicata su tickrate e prestazioni sui server CS2.