Plugin e mod ampliano molti giochi, ma tendono a rompersi dopo un aggiornamento del gioco o quando manca un file. Le sezioni qui sotto trattano i messaggi tipici di CS2 con CounterStrikeSharp, Valheim con BepInEx, Conan Exiles, SCP: Secret Laboratory, Project Zomboid e The Forest, oltre agli errori generici dei plugin .NET. Ogni sezione mostra un messaggio, lo spiega e indica i passi successivi.

Il messaggio completo si trova nella Console e nei file di log del gioco, nella sezione File. Molti errori occupano più righe. Lo stack trace sottostante, cioè l'elenco delle parti di programma richiamate, indica spesso il plugin interessato; un'eccezione è un errore di programma segnalato da .NET o Unity. Prima di sostituire plugin, mod o file di configurazione, crea un backup nella sezione Backup.

Il plugin delle skin di CS2 non trova weapons.json

Ecco come appare il messaggio:

System.InvalidOperationException: Missing required weapons definition file: <Plugin-Ordner>/weapons.json

Cosa c'è dietro: i plugin delle skin per CS2 hanno bisogno di un elenco di tutte le armi e dei relativi identificativi. Questo elenco si trova nel file obbligatorio weapons.json, nella cartella dati del plugin. Se il file manca, il plugin non riesce a inizializzarsi, quindi non parte nemmeno: la funzione delle skin smette del tutto di funzionare. Succede, per esempio, quando durante il caricamento viene trasferito solo il file del programma del plugin e non l'intero pacchetto.

Come risolvere:

  1. Leggi il percorso nel messaggio. Indica in quale cartella il plugin si aspetta il file.
  2. Scarica di nuovo il plugin nella stessa versione e reinstallalo completamente, con tutte le cartelle del pacchetto.
  3. In alternativa, copia weapons.json dal pacchetto della stessa versione del plugin nella cartella indicata, usando la sezione File. Non usare un file di un'altra versione.
  4. Riavvia il server e controlla nella Console che il plugin venga caricato senza errori.

Buono a sapersi: per approfondire i plugin di CS2: Plugin di CS2: MetaMod, CounterStrikeSharp e MatchZy.

WeaponPaints: gamedata.json non è compatibile con l'aggiornamento di CS2

Ecco come appare il messaggio:

Method CAttributeList_SetOrAddAttributeValueByName not found in gamedata.json

Cosa c'è dietro: WeaponPaints individua determinate funzioni nel programma di CS2 tramite le firme, cioè tratti identificativi riportati nel file gamedata.json. Dopo un aggiornamento di CS2, una di queste firme non è più valida e il plugin non trova la funzione, quindi non riesce ad avviarsi. Il problema non dipende dalle tue impostazioni, ma dal fatto che gioco e plugin non sono più compatibili.

Come risolvere:

  1. Controlla se CS2 ha ricevuto di recente un aggiornamento. È la causa più comune.
  2. Aggiorna insieme CounterStrikeSharp e WeaponPaints all'ultima versione e adotta anche il gamedata.json aggiornato di WeaponPaints.
  3. Se non esiste ancora una versione adattata, rimuovi temporaneamente WeaponPaints finché l'autore non pubblica l'aggiornamento.
  4. Riavvia il server e controlla che il messaggio sia scomparso.

Buono a sapersi: dopo i grandi aggiornamenti di CS2, a volte passa un po' di tempo prima che gli autori dei plugin pubblichino versioni adattate. Per saperne di più sugli aggiornamenti del gioco: Aggiornare un server CS2: riconoscere il build drift e riavviare in sicurezza.

«PreLogin failure»: Conan Exiles rifiuta un elenco di mod diverso

Ecco come appare il messaggio:

[<Datum>-<Uhrzeit>][<Nr>]LogNet: PreLogin failure: <Mod A> (<Workshop-ID>), <Mod B> (<Workshop-ID>), <Mod C> (<Workshop-ID>).

Cosa c'è dietro: un giocatore ha provato a entrare ed è stato respinto perché le sue mod attive non corrispondono esattamente all'elenco di mod del tuo server. Importante: le mod riportate nella riga sono l'elenco richiesto dal server, non le mod sbagliate del giocatore. Quali mod abbia davvero attive il giocatore non compare nel log. Conan Exiles richiede una corrispondenza esatta: una mod mancante blocca l'accesso esattamente come una in più. Il giocatore non vede alcun motivo: il suo gioco resta fermo su «Tentativo di accesso alla partita». Sembra un timeout, ma in realtà è un rifiuto immediato.

Come risolvere:

  1. Confronta l'elenco nel log con le mod che il giocatore ha attivato nel launcher di Conan. La composizione deve essere identica, senza aggiunte.
  2. Se il giocatore disattiva ogni mod non presente nell'elenco e attiva quelle mancanti, potrà connettersi di nuovo.
  3. Se vuoi consentire una mod aggiuntiva, installala sul server nella sezione Mod e riavvia il server.
  4. Dopo ogni modifica alle mod del server, tutti i giocatori devono allineare il proprio elenco di mod.

CounterStrikeSharp: errore in un evento del plugin («Error invoking callback»)

Ecco come appare il messaggio:

<Uhrzeit> [EROR] (cssharp:…) Error invoking callback

Cosa c'è dietro: CounterStrikeSharp è una piattaforma di plugin per CS2. I plugin si agganciano a eventi come «il giocatore si connette» o «inizia il round»; la funzione richiamata in quel momento si chiama callback. In una di queste callback un plugin ha generato un errore, una cosiddetta eccezione. Il server continua a funzionare, ma la funzione del plugin interessata non è andata a buon fine. Quale plugin sia stato e perché è indicato nello stack trace sottostante, cioè l'elenco delle parti di programma richiamate.

Come risolvere:

  1. Leggi lo stack trace completo sotto il messaggio. Il nome del plugin compare di solito come parte dei nomi delle classi o come nome di file.
  2. Aggiorna questo plugin e CounterStrikeSharp a versioni compatibili tra loro. La pagina del plugin indica la versione di CounterStrikeSharp supportata.
  3. Riavvia completamente il server, non solo il plugin.
  4. Se l'errore si ripresenta, rimuovi il plugin e segnala il problema al suo autore.

CS2-SimpleAdmin: il database non è compatibile con la versione del plugin

Ecco come appare il messaggio:

A parameterless default constructor or one matching signature (…) is required for CS2_SimpleAdmin.<Klasse> materialization

Cosa c'è dietro: CS2-SimpleAdmin salva ban, mute e cronologia degli IP in un database MySQL. Il messaggio significa che le colonne delle tabelle non corrispondono alla versione che il plugin si aspetta. Capita tipicamente dopo un aggiornamento del plugin in cui la migrazione del database (l'adeguamento automatico delle tabelle) non è stata completata, oppure quando si continua a usare un database di una vecchia installazione. Le funzioni di amministrazione del plugin non sono più affidabili, mentre il server CS2 continua a funzionare.

Come risolvere:

  1. Salva il contenuto del database prima di modificare qualcosa, per esempio con un'esportazione.
  2. Aggiorna CS2-SimpleAdmin all'ultima versione e riavvia il server una volta, così da eseguire la migrazione.
  3. Se il messaggio persiste, confronta le tabelle del tuo database con lo schema, cioè la struttura delle tabelle, della versione del plugin installata.
  4. Se puoi rinunciare ai vecchi dati dei ban, crea un nuovo database nella sezione Database, inserisci le relative credenziali nella configurazione del plugin e riavvia.

WeaponPaints non si avvia («TypeInitializationException»)

Ecco come appare il messaggio:

TypeInitializationException: The type initializer for 'WeaponPaints.WeaponPaints' threw an exception.
 ---> <innere Exception>: <Ursache>

Cosa c'è dietro: al primo accesso, WeaponPaints esegue una routine di avvio statica (type initializer). Questa routine non è riuscita, perciò il plugin non si avvia. Il messaggio in sé è solo un involucro: la vera causa è indicata dall'eccezione interna subito dopo, per esempio una configurazione errata, un file di dati mancante o una dipendenza non compatibile.

Come risolvere:

  1. Leggi la prima inner exception sotto questo messaggio, di solito introdotta da --->.
  2. Aggiorna insieme WeaponPaints e CounterStrikeSharp a versioni compatibili tra loro.
  3. Dopodiché correggi solo ciò che la inner exception indica concretamente: il file di configurazione, un file di dati mancante come weapons.json o la connessione al database. Trovi le credenziali del tuo database in Database.
  4. Riavvia il server e controlla la Console.

Plugin .NET: dipendenza mancante («Could not load file or assembly»)

Ecco come appare il messaggio:

System.IO.FileNotFoundException: Could not load file or assembly '<Name>, Version=<Version>, Culture=neutral, PublicKeyToken=<…>' or one of its dependencies. The system cannot find the file specified.

Cosa c'è dietro: molti giochi caricano i plugin tramite .NET, ad esempio CS2 con CounterStrikeSharp, Valheim con BepInEx o SCP: Secret Laboratory. Un assembly è un file di programma .NET, di solito una .dll. Il messaggio significa che un plugin ha bisogno di un determinato assembly che non è installato, oppure che le versioni delle sue dipendenze non sono compatibili tra loro. Il plugin interessato quindi non si avvia o si avvia solo in parte.

Come risolvere:

  1. Leggi il nome e la versione tra virgolette: quella è la dipendenza mancante.
  2. Controlla sulla pagina del plugin quali dipendenze servono e in quale versione. Spesso si trovano come file .dll aggiuntivi nel pacchetto scaricato.
  3. Installa la dipendenza nella versione richiesta da File, nella cartella indicata sulla pagina del plugin.
  4. Riavvia il server e controlla che il messaggio sia sparito.

TargetInvocationException / TypeInitializationException: errore di un componente .NET

Ecco come appare il messaggio:

System.TypeInitializationException: The type initializer for '<Klasse>' threw an exception
System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.

Cosa c'è dietro: un componente .NET, cioè un plugin, una mod o una parte del loader, ha riscontrato un errore nella sua routine di avvio o in una callback. Una callback è una funzione che viene chiamata quando si verifica un determinato evento. Questi messaggi sono solo involucri attorno all'errore vero e proprio: la causa si trova nella inner exception che segue subito dopo. Da quel momento il componente interessato non funziona o funziona solo in parte.

Come risolvere:

  1. Individua il componente interessato. Il nome della classe tra virgolette e lo stack trace, cioè l'elenco delle chiamate sotto l'errore, ti aiutano a identificarlo.
  2. Aggiorna questo componente e il loader di mod o plugin che usi, ad esempio BepInEx o CounterStrikeSharp.
  3. Riavvia il server e leggi nel log la prima inner exception, di solito introdotta da --->. Nei giochi Unity l'eccezione originale si trova spesso subito sopra una riga con Rethrow as.
  4. Risolvi ciò che indica questa inner exception, ad esempio un file mancante o un'impostazione errata.

Il plugin .NET non riesce a caricare le sue classi

Ecco come appare il messaggio:

System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
System.Exception: Unable to find plugin in assembly

Cosa c'è dietro: il loader dei plugin ha aperto il file del plugin, ma non è riuscito a caricarne le classi o a trovarne l'entry point, cioè il punto da cui avvia il plugin. O il file del plugin non è compatibile con la versione installata del loader o del gioco, oppure nella cartella dei plugin si trova il file sbagliato, ad esempio una semplice libreria di supporto al posto del plugin vero e proprio. Il plugin resta quindi inattivo.

Come risolvere:

  1. Aggiorna insieme plugin e loader, in modo che entrambi siano compatibili con la versione attuale del gioco.
  2. Controlla in File che il file corretto del plugin si trovi nella cartella indicata sulla pagina del plugin.
  3. Elimina le copie più vecchie dello stesso plugin, così viene caricata una sola versione.
  4. Riavvia il server e controlla la Console.

Valheim: la mod non è compatibile con la versione del gioco e resta senza effetto

Ecco come appare il messaggio:

Rethrow as TypeInitializationException: The type initializer for '<Mod-Klasse>' threw an exception.

Cosa c'è dietro: BepInEx, il loader di mod per Valheim, ha caricato la mod, ma questa è andata subito in crash durante l'inizializzazione. La mod cerca di accedere a qualcosa che nella versione di Valheim in uso non esiste o non esiste più. Il server si avvia comunque normalmente ed è pienamente giocabile. La mod continua a risultare installata, ma non fa nulla, e nel gioco non compare alcun messaggio di errore. La causa più frequente è un aggiornamento di Valheim: il server si aggiorna da solo a ogni avvio, mentre la mod resta alla sua versione. Il nome della mod è indicato nella riga precedente.

Come risolvere:

  1. Annota il nome della mod dalla riga sopra il messaggio.
  2. Controlla in Mod se esiste una versione più recente compatibile con la versione attuale di Valheim. Se c'è, installala e riavvia il server.
  3. Se non esiste una versione compatibile, disinstalla la mod per il momento. Altrimenti occupa solo spazio e dà l'impressione di essere attiva.
  4. Riattiva le mod importanti per il tuo server solo quando il loro autore le avrà aggiornate alla nuova versione del gioco.

Per approfondire: Valheim 1.0: aggiornare il server e controllare in sicurezza il vecchio mondo e le mod

Una mod di Valheim cerca il campo rimosso «ZRoutedRpc.Everybody»

Ecco come appare il messaggio:

MissingFieldException: Field not found: .ZRoutedRpc.Everybody

Cosa c'è dietro: ZRoutedRpc è la parte di Valheim attraverso cui server e giocatori si scambiano messaggi. Una mod BepInEx è stata creata per un'altra versione di Valheim e si aspetta il campo Everybody, che nella versione installata non esiste. In questo punto la mod non può svolgere la sua funzione e non funziona o funziona solo in parte.

Come risolvere:

  1. Cerca la prima mod nello stack trace, l'elenco delle parti di programma chiamate che si trova sotto il messaggio. È quella interessata.
  2. Aggiornala da Mod a una versione per la build attuale di Valheim, cioè la versione del gioco in uso.
  3. Se non è ancora disponibile, disinstalla la mod per il momento e riavvia il server.
  4. Se la mod è in uso anche tra gli altri giocatori, tutti dovrebbero avere la stessa versione.

Per approfondire: Valheim 1.0: aggiornare il server e controllare in sicurezza il vecchio mondo e le mod

SCP: Secret Laboratory: impossibile caricare il plugin

Ecco come appare il messaggio:

[LabApi] System.BadImageFormatException: <Details zur Plugin-Datei>

Cosa c'è dietro: LabApi è l'interfaccia per i plugin di SCP: Secret Laboratory. Non è riuscita a caricare un file di plugin perché il suo formato non è compatibile con la versione del server. Succede tipicamente dopo un aggiornamento del gioco, quando un plugin è ancora compilato per la versione precedente, oppure quando il file si è danneggiato durante il caricamento. Il plugin interessato resta inattivo e il server si avvia senza di esso.

Come risolvere:

  1. Controlla se il messaggio indica il nome del file del plugin.
  2. Carica di nuovo il plugin in una versione adatta alla tua versione attuale di SCP:SL e riavvia il server. La pagina del plugin indica le versioni supportate.
  3. Se non sai di quale plugin si tratta, rimuovi da File l'ultimo file aggiunto alla cartella dei plugin e riavvia.
  4. Dopo il caricamento, confronta la dimensione del file con quella dell'originale. Se è diversa, il trasferimento è stato incompleto.

Buono a sapersi: trovi le nozioni di base sul server in Configurare un server di SCP Secret Laboratory.

Project Zomboid: una mappa o una mod usa una proprietà delle tile sconosciuta

Ecco come appare il messaggio:

IsoPropertyTypeNotFoundException: Property Name not found: <Eigenschaft>

Qual è la causa: le mappe di Project Zomboid sono composte da tile (riquadri). Ogni tile ha delle proprietà che stabiliscono, per esempio, se un elemento è un contenitore, una porta o un ostacolo. In questo caso, una mappa o una mod usa una proprietà che la tua versione di Project Zomboid non conosce. Gli oggetti interessati possono mancare o funzionare male, ma di solito il server continua a girare. Spesso la mappa o la mod è stata creata per un'altra versione del gioco, per esempio dopo il passaggio alla Build 42.

Come risolvere:

  1. Scopri quale mappa o mod è coinvolta. Se il messaggio è nuovo, il primo sospetto è l'ultima che hai installato o aggiornato.
  2. Aggiorna la mappa o la mod a una versione compatibile con la versione di Project Zomboid che hai installato.
  3. Se il problema è iniziato dopo l'aggiornamento di una mod, ripristina la precedente versione compatibile della mod.
  4. Se vuoi rimuovere del tutto una mod di mappa, crea prima un backup in Backup. Se manca una mappa già usata dal tuo salvataggio, il mondo può cambiare.

Buono a sapersi: per il passaggio alla Build 42 trovi la guida Project Zomboid Build 42 sul tuo server.

The Forest: «Bolt is already running» dopo un riavvio

Ecco come appare il messaggio:

BoltException: Bolt is already running, you must call BoltLauncher.Shutdown() before starting a new instance of Bolt.
  at BoltCore.BeginStart (…)

Qual è la causa: per il multiplayer, The Forest usa la libreria di rete Bolt. Il messaggio significa che il server ha provato ad avviare una seconda istanza di Bolt mentre la prima era ancora in esecuzione. Può succedere dopo un soft restart non riuscito, cioè un riavvio all'interno del programma in esecuzione anziché un vero riavvio del processo. In questo modo la nuova sessione non riesce ad avviarsi correttamente.

Come risolvere:

  1. Arresta il server dal pannello e aspetta che sia completamente spento.
  2. Poi avvialo di nuovo. Un processo nuovo avvia Bolt una sola volta.
  3. Per riavviare non usare funzioni di gioco né ricaricamenti a server acceso, ma sempre il riavvio dal pannello.
  4. Per i riavvii regolari, imposta un riavvio programmato in Attività.

Buono a sapersi: trovi la procedura nella guida Programmare i riavvii automatici del tuo server.

The Forest non riesce a leggere le schede di rete

Ecco come appare il messaggio:

NetworkInformationException: File not found.
  at CoopDedicatedServerStarter.getMachineIp ()

Qual è la causa: all'avvio, il server dedicato di The Forest cerca di rilevare le proprie schede di rete e quindi il proprio indirizzo IP. L'interfaccia del sistema operativo che interroga per farlo non è disponibile nell'ambiente del server. Se il server è comunque raggiungibile, il messaggio non ha altri effetti.

Come risolvere:

  1. Controlla se il server è raggiungibile: compare nella lista dei server e i giocatori riescono a entrare?
  2. Se sì, puoi ignorare il messaggio.
  3. Se no, porta il server alla build attuale, cioè alla versione più recente del server di gioco, e riavvialo.
  4. Se resta irraggiungibile, apri un ticket e indica l'orario del messaggio. Non puoi modificare da solo l'ambiente di avvio del server.

Buono a sapersi: trovi le basi sul server nella guida Configurare un server di The Forest.

Una mod segnala «CS0246: tipo o spazio dei nomi non trovato»

Ecco come appare il messaggio:

<Datei>.cs(<Zeile>,<Spalte>): error CS0246: The type or namespace name '<Typ>' could not be found

Qual è la causa: il compilatore, che traduce il codice sorgente C# in componenti eseguibili, non trova un tipo utilizzato. Il nome non può essere risolto né nel codice sorgente presente né tramite le librerie incluse. Di conseguenza, la mod interessata non può essere caricata. Nel caso di file di mod inclusi o personalizzati, codice sorgente e librerie devono essere compatibili con la versione del gioco.

Come risolvere:

  1. Leggi il messaggio di errore completo nella Console. Indica il file, la riga e il tipo mancante.
  2. Salva le tue modifiche in File prima di sostituire i file delle mod.
  3. Installa una versione della mod interessata compatibile con la versione del gioco, insieme alle dipendenze necessarie. Se usi codice sorgente tuo, controlla l'ortografia, lo spazio dei nomi e i riferimenti alle librerie.
  4. Riavvia il server e controlla se il compilatore segnala altri errori.

RustCore non trova i campi necessari nei file del server di Rust

Ecco come appare il messaggio:

Failed to initialize plugin 'RustCore v<Version>' (MissingFieldException: Field not found: <Feld>)
Failed to call hook '<Hook>' on plugin 'RustCore v<Version>' (MissingFieldException: Field not found: <Feld>)

Qual è la causa: Oxide collega Rust ai plugin installati. Il suo componente principale, RustCore, si aspetta dei campi, cioè elementi interni dei dati, che mancano nelle librerie di Rust caricate. Per questo la sua inizializzazione o l'elaborazione dei comandi del server non riesce e le funzioni dei plugin interessate smettono di funzionare.

Come risolvere:

  1. Crea in Backup un backup del tuo mondo e dei dati dei plugin. Poi arresta completamente il server.
  2. Controlla se la release di Oxide in uso corrisponde alla versione del server di Rust. Aggiorna i file del server di Rust e poi installa per intero la release di Oxide corrispondente.
  3. Riavvia il server. Controlla nella Console se ora RustCore si carica e se i comandi interessati funzionano.
  4. Se l'errore persiste, apri un ticket e indica l'orario e le versioni di Rust e Oxide in uso.

DayZ non riesce a sostituire un oggetto dell'inventario

Ecco come appare il messaggio:

ReplaceItemWithNewLambdaBase Step D) ABORT - wanted to create=<Gegenstand> at loc={<Platz>}, but failed

Qual è la causa: DayZ interrompe la sostituzione di un oggetto dell'inventario; nell'esempio dettagliato, un componente danneggiato di un veicolo non può essere creato nella posizione prevista. La modifica all'inventario interessata non riesce, mentre il server continua a girare. La riga breve OnAbort è il relativo messaggio di interruzione; la riga dettagliata che la precede indica il passaggio non riuscito.

Come risolvere:

  1. Controlla nella console le righe precedenti all'interruzione e annota quale mod di veicoli o di inventario è coinvolta.
  2. Crea un backup in Backup e confronta le mod installate e le loro dipendenze con le relative indicazioni di compatibilità.
  3. Dopo un aggiornamento adatto della mod e un riavvio completo, prova di nuovo la stessa azione di inventario; se l'errore persiste, segnalalo agli sviluppatori della mod allegando il log completo.

MatchZy: il comando di pausa non riesce a causa di una sequenza di dati vuota

Ecco come appare il messaggio:

System.InvalidOperationException: Sequence contains no elements
   at System.Linq.ThrowHelper.ThrowNoElementsException()
   at MatchZy.MatchZy.IsTacticalTimeoutActive()

Qual è la causa: quando metti in pausa, MatchZy controlla se è già attivo un timeout tattico. Il plugin si aspetta di trovare una voce in una sequenza di dati, ma non ne trova nessuna. Il comando di pausa viene interrotto con un errore, mentre il server di CS2 continua a girare. Le righe di chiamata che seguono si chiamano stack trace e mostrano il percorso che ha portato all'errore.

Come risolvere:

  1. Leggi lo stack trace completo nella Console. Annota il comando che ha causato l'errore e lo stato della partita, ad esempio se era già attiva una pausa.
  2. Fai un backup delle impostazioni di MatchZy in File. Controlla che MatchZy e CounterStrikeSharp supportino la build di CS2 in uso e aggiornali a versioni compatibili tra loro.
  3. Riavvia completamente il server e prova di nuovo la pausa. Se l'errore persiste, invia all'autore di MatchZy lo stack trace ripulito dai dati sensibili, le versioni e i passaggi per riprodurre il problema.

Il tuo messaggio non è nell'elenco?

Leggi l'intero messaggio nella Console o nel file di log del gioco, comprese le righe precedenti. Nei giochi .NET e Unity la vera causa si trova spesso nella inner exception. I nomi di cartelle e file nello stack trace rivelano quale plugin o mod è coinvolta. Prima di ogni sostituzione, crea un backup in Backup. Crash e aggiornamenti non riusciti sono trattati in Il game server va in crash o l'aggiornamento Steam non riesce. Se non riesci a risolvere, apri un ticket e indica l'orario del messaggio.