Risposta rapida: dopo un aggiornamento di Rust, controlla prima di tutto quale framework è effettivamente in esecuzione. Con Oxide ti aiutano oxide.version, oxide.plugins e il log di avvio. Se manca un solo plugin, distingui tra errore del compilatore, dipendenza mancante ed errore di configurazione. Il fatto che i plugin siano caricati non esclude un errore del framework. Salva i file e i progressi di gioco prima di apportare modifiche; un wipe o l'eliminazione di tutte le config non è un primo passo diagnostico sensato.

Questa guida vale per i Rust Dedicated Server della versione PC, sia in self-hosting sia presso un qualsiasi provider. Per i passaggi amministrativi ti serve l'accesso alla vera console del server o a un RCON autorizzato e, se necessario, ai file del server. Non è richiesto un account cliente presso SupremeTier. Se giochi soltanto sul server interessato, inizia dalla prossima sezione.

Aggiornato al: 6 novembre 2026; nostri test sugli errori: 29 ottobre 2026. I comandi della procedura principale si riferiscono a Oxide. Carbon viene trattato separatamente. I casi di errore “un singolo plugin non viene compilato” e “manca una dipendenza” sono stati provocati in modo controllato e risolti su un nostro server di test isolato. Questi test simulano stati di errore; non sono l'osservazione di un plugin di terze parti che ha smesso di funzionare dopo l'aggiornamento. Anche uno stato volutamente misto del framework è stato verificato in isolamento: in quel caso i plugin si caricavano mentre un hook del framework falliva. Gli output originali riportati di seguito provengono da test controllati sugli errori e non vengono presentati come un incidente reale sul server di un cliente.

Se sei un giocatore: cosa puoi fare?

La scomparsa del menu /kit non dimostra che il tuo inventario sia stato cancellato. Forse manca soltanto il plugin che fornisce il comando. Chiedi innanzitutto se anche altri giocatori non trovano la stessa funzione e se sono coinvolte più funzioni indipendenti tra loro. Annota l'orario, il comando inserito e la risposta visualizzata. Uno screenshot del messaggio è utile; prima di condividerlo puoi coprire i nomi privati dei giocatori.

Per esempio, puoi segnalare: “Dal riavvio delle 19 circa il mio comando kit non dà alcuna risposta. Nemmeno il teletrasporto funziona. La normale costruzione funziona. Prima del riavvio andavano entrambi.” Così gli amministratori possono cercare in modo mirato l'avvio corrispondente. Dire “È stato wipato tutto” sarebbe un'affermazione eccessiva senza una verifica.

Non installare file client offerti a caso come presunta riparazione di un plugin del server. Da giocatore non puoi ricaricare il framework lato server. Se mancano funzioni di protezione, per esempio le regole PvE promesse su quel server, non farci affidamento finché la situazione non è chiarita. Spetta agli amministratori decidere se si può continuare a giocare normalmente in sicurezza.

Prima distingui i tre livelli

Ai fini di questa diagnosi, un server Rust modificato è composto da tre livelli. Rust stesso fornisce il mondo di gioco e le meccaniche. Il framework, in questo caso Oxide o in alternativa Carbon, rende possibili le estensioni. I singoli plugin implementano per esempio kit, teletrasporto, funzioni di amministrazione o modifiche alle regole di gioco. Alcuni plugin richiedono altri plugin o estensioni.

Se manca un livello inferiore, molte funzioni dei livelli superiori sembrano guaste contemporaneamente. Se si blocca una singola estensione, le altre possono continuare a funzionare. Questa distinzione è il punto di partenza, ma non è ancora una prova: anche più plugin possono avere bisogno della stessa libreria mancante. Al contrario, un framework può rispondere e avere comunque problemi con determinati eventi di gioco.

“File presente”, “compilato”, “caricato” e “funzionante” sono quattro stati diversi. Un file .cs nella cartella giusta dimostra soltanto che lì si trova del codice sorgente. Compilare significa che da quel codice è stato generato codice eseguibile. Il caricamento comprende l'inizializzazione. Solo un test mirato della funzione mostra se il comportamento desiderato opera davvero con le tue impostazioni e i tuoi permessi.

La documentazione ufficiale di Oxide sull'installazione dei plugin descrive i file .cs, la compilazione automatica e la directory dei plugin. Non confondere questo livello dei file con il risultato visibile in gioco.

Il percorso decisionale rapido

Una volta completato l'avvio del server, inizia dalla console del server, non dalla normale chat di gioco. Questo primo controllo non modifica alcun plugin:

oxide.version
oxide.plugins

oxide.version richiede la versione del framework. oxide.plugins elenca i plugin, compresi i tentativi di caricamento non riusciti. Il riferimento ufficiale dei comandi descrive l'elenco dei plugin e i comandi di caricamento mirato; la guida ai comandi per i proprietari spiega console e chat.

Osservazione
Prima ipotesi di lavoro
Controllo successivo
Oxide non risponde, mancano molte funzioni
Il framework manca, non si avvia oppure il contesto della console è sbagliato
Controlla il log di avvio, il framework effettivamente scelto e l'installazione
Oxide risponde, diversi plugin funzionano, uno fallisce
Problema di quel plugin o dei suoi requisiti
Leggi il primo messaggio di errore completo e la versione del plugin
Più plugin interessati citano la stessa dipendenza
Si è bloccata una dipendenza comune
Esamina prima questa dipendenza
Il plugin è caricato, manca solo una funzione
Permessi, impostazioni, hook o problema di runtime
Verifica la funzione specifica in condizioni controllate
Nuove config, mondo diverso o dati apparentemente vuoti
Forse un'altra istanza del server o un altro percorso dei dati
Confronta identità, parametri di avvio e mount con lo stato precedente

Un comando sconosciuto è un indizio, non una diagnosi definitiva. Verifica di aver davvero aperto la console del server interessato, che l'avvio sia completato e che quel server usi effettivamente Oxide. Con Carbon, un test specifico per Oxide non è di per sé una base sufficiente.

Prima di ogni riparazione: metti al sicuro le prove e la via del ritorno

Una buona diagnosi inizia con un breve inventario della situazione. Annota quando l'errore è stato notato per la prima volta, quale aggiornamento del gioco o riavvio lo ha preceduto e cosa è già stato modificato da allora. Salva il log di avvio completo, dall'inizio del processo al primo messaggio di errore. Uno screenshot dell'ultima riga rossa spesso non basta, perché mostra soltanto l'errore conseguente.

Oxide scrive inoltre gli errori di caricamento e di compilazione in appositi file di log nella cartella oxide/logs della tua installazione del server. Lì un messaggio è spesso più completo rispetto alla porzione visibile della console, per esempio quando la console mostra solo le ultime righe. Scegli il file la cui data corrisponde all'avvio interessato e salvalo insieme al log della console.

Annota la versione di Rust o le informazioni sulla build, il ramo di release utilizzato, il sistema operativo, la versione del framework e quelle dei plugin interessati. Conserva la fonte da cui hai scaricato i file installati. “Ultima versione” non è un'indicazione riproducibile: il file può essere stato sostituito dopo il tuo download, oppure il tuo script di avvio può caricare una versione diversa da quella prevista.

Cosa deve contenere il backup?

Salva uno stato coerente dei dati del mondo e dei giocatori, della configurazione di avvio e dei file di modding. Con Oxide devono rientrare nell'inventario soprattutto oxide/plugins, oxide/config e oxide/data; considera anche i dati dei permessi e le tue estensioni personalizzate. La struttura di archiviazione concreta dipende dall'installazione. Controlla i percorsi che usi davvero, invece di adottare alla cieca una directory di esempio.

Distingui le impostazioni dai dati utente. Una config determina per esempio il comportamento di un plugin; i suoi dati possono contenere ricompense già assegnate, posizioni salvate o altri stati permanenti. Il contenuto dipende dal plugin. Svuotare indiscriminatamente oxide/data può quindi cambiare molto più della sola funzione difettosa.

Per un salvataggio coerente, usa la procedura di backup documentata della tua installazione. Una copia eseguita durante scritture in corso può risultare incoerente. Verifica che il backup sia davvero completato e recuperabile. Estrailo o controllalo in una posizione separata, senza sovrascrivere il server attuale. Il solo nome di un backup visualizzato non è ancora una via del ritorno verificata.

Stabilisci il limite del tuo intervento

Prima di intervenire, scrivi: “Sostituisco solo questo file del plugin” oppure “Reinstallo il pacchetto Oxide compatibile con la versione attuale di Rust”. A questo vanno aggiunti il vecchio file salvato, il nuovo file e il criterio di successo. Non modificare contemporaneamente framework, più plugin, config e parametri della mappa. Altrimenti, alla fine, non saprai quale intervento ha aiutato o causato danni.

Se un plugin di protezione, di economia o di controllo degli accessi smette di funzionare, decidi prima del test se il server deve restare disponibile. Un mondo tecnicamente raggiungibile non è automaticamente giocabile con le regole promesse. Annuncia l'eventuale interruzione necessaria e usa la normale procedura di arresto della tua installazione. Ripetere arresti forzati non sostituisce una diagnosi.

Caso A: il framework non funziona

Situazione tipica: il server si avvia dopo un aggiornamento del gioco, ma mancano numerose funzioni di plugin indipendenti tra loro. Nel log di avvio attuale non risulta che Oxide sia stato caricato correttamente, oppure la richiesta della versione, eseguita nel contesto di console corretto, non restituisce alcuna versione del framework.

La causa da verificare non è soltanto «Oxide troppo vecchio». L'aggiornamento del gioco può sostituire i file modificati; uno script di avvio può ripristinare successivamente i file vanilla; il framework può essere stato estratto nella directory del server sbagliata. Possono entrare in gioco anche un pacchetto per il sistema operativo sbagliato, un ramo del gioco non corrispondente o un caricamento incompleto.

Nella guida al Dedicated Server, Facepunch sottolinea esplicitamente che un aggiornamento del gioco può richiedere una nuova installazione di Oxide e che SteamCMD, durante la procedura di avvio, può riportare i file allo stato vanilla. Da qui deriva l'ordine da rispettare: aggiorna il gioco, installa la versione corrispondente del framework e poi avvia il server. Un'ulteriore verifica dei file di gioco dopo l'installazione del framework può vanificare il lavoro svolto.

Ordine delle operazioni in self-hosting

Su un server in self-hosting con SteamCMD, l'ordine è il seguente. Il percorso è un esempio; sostituiscilo con la directory effettiva del tuo server:

steamcmd +force_install_dir /pfad/zum/rustserver +login anonymous +app_update 258550 validate +quit

258550 è l'App ID del Rust Dedicated Server. validate controlla i file di gioco e, così facendo, ripristina la versione vanilla. Proprio per questo Oxide va installato solo dopo: scarica dalla release ufficiale di Oxide.Rust l'archivio per il tuo sistema operativo, Oxide.Rust-linux.zip per Linux oppure Oxide.Rust.zip per Windows. Estrailo mantenendo la sua struttura di cartelle nella directory principale del server, cioè dove si trova anche RustDedicated o RustDedicated.exe, e lascia sovrascrivere i file esistenti. Solo a questo punto avvia il server e controlla oxide.version.

Se il tuo script di avvio richiama SteamCMD prima di ogni avvio, sovrascriverà i file di Oxide a ogni riavvio. In tal caso devi inserire anche l'installazione di Oxide nello script di avvio, tra l'aggiornamento e l'avvio del server, oppure rimuovere l'aggiornamento automatico dallo script. Con un hosting gestito, usa invece la funzione per i framework offerta dal tuo provider.

Distinguere la release attuale dalla combinazione storica di test

Al momento della nostra verifica delle release, il 6 novembre 2026, la release ufficiale di Oxide.Rust 2.0.7894 era la più recente pubblicata. È stata pubblicata il 6 novembre 2026 alle 10:11:56 UTC e indica il primo hotfix di Rust di quel giorno per la 2636.290.1. Il dato relativo a Rust non è un numero di versione del pacchetto Oxide. Questo aggiornamento documenta la release pubblicata, non un nostro test funzionale della nuova combinazione.

Le nostre prove di errore restano aggiornate al 29 ottobre 2026: il changelog di uMod per Rust indica per l'aggiornamento del 22 ottobre la 2635.289.1; la corrispondente release ufficiale di Oxide.Rust 2.0.7839 è stata pubblicata il 22 ottobre 2026 alle 18:02:03 UTC. Sul nostro server di test isolato, version e oxide.version hanno effettivamente riportato il protocollo Rust 2635.289.1 e Oxide.Rust 2.0.7839. Si tratta di una combinazione storica di test, non di un invito a mantenere questi numeri anche dopo gli aggiornamenti successivi.

Quando intervieni davvero, controlla di nuovo la release attuale e la versione di Rust del tuo server. L'esistenza di una nota di release corrispondente non dimostra che il tuo provider o il tuo script di avvio abbiano già installato quella versione. Ciò che conta è la versione letta in seguito dall'istanza in esecuzione, insieme al log di avvio attuale.

Nostra prova A: errore del framework nonostante i plugin caricati

Il nostro punto di partenza era il protocollo Rust 2635.289.1 con il relativo Oxide.Rust 2.0.7839. Dopo un arresto regolare e un backup del nostro mondo di test, inclusa la directory di Oxide, abbiamo inserito di proposito, solo sul server di test isolato, la vecchia Oxide.Rust.dll della release ufficiale 2.0.7072 del 19 febbraio 2026. Il resto dell'installazione attuale è rimasto invariato. Questo simula uno stato misto e incoerente del framework; non è un test di un pacchetto server storico completo.

La modifica è stata verificata tramite lo SHA-256 della DLL effettivamente utilizzata. All'avvio è comparso questo messaggio reale:

Failed to call hook 'IOnServerCommand' on plugin 'RustCore v2.0.7072' (MissingFieldException: Field not found: string .Arg.FullString Due to: Could not find field in class)

Allo stesso tempo, i nostri plugin di test hanno raggiunto i rispettivi marcatori di inizializzazione. Anche il processo del server ha continuato a funzionare. Ecco la differenza importante rispetto a una regola empirica troppo semplice: un problema del framework non impedisce necessariamente il caricamento di tutti i plugin. Un elenco di plugin caricati correttamente o un processo in esecuzione non costituiscono una verifica completa della compatibilità.

Il messaggio cita RustCore, cioè un componente del framework, e un accesso a un campo non trovato. Non è un errore JSON nella configurazione di un kit. In questa combinazione creata di proposito, la causa è lo stato incoerente del framework. Lo stesso tipo di errore con un altro nome può invece avere origine in un singolo plugin; leggi sempre insieme componente, hook e contesto.

Per il ripristino minimo abbiamo rimesso la DLL 2.0.7839 corrispondente, fissata in precedenza, e abbiamo riavviato in modo controllato. Dopodiché oxide.version ha risposto di nuovo con 2.0.7839, oxide.plugins ha elencato tutti e quattro i nostri plugin di test e la MissingFieldException osservata in precedenza non era più presente nel nuovo buffer di console disponibile. Il ritorno al framework corrispondente è quindi verificato per questa prova specifica. Per il tuo server di produzione, questo non significa che ti consigliamo di mettere insieme singole DLL prese da archivi qualsiasi: usa la procedura completa di installazione del framework corrispondente, così da mantenere uno stato coerente.

La prova usa volutamente una release molto più vecchia. Non sostiene né che ogni versione precedente fallisca allo stesso modo, né che questo preciso quadro di errore si presenti a ogni aggiornamento di ottobre. Un guasto del framework può anche significare semplicemente un server vanilla senza Oxide caricato. Per questo restano necessari la versione effettiva, la prima diagnosi dai log e un test funzionale, considerati insieme.

Riparazione minima

  1. Salva lo stato iniziale e il log. Controlla se è in corso un aggiornamento automatico. Non avviare una seconda installazione in conflitto.
  2. Confronta la versione di Rust, il ramo di release, il sistema operativo e la release del framework prevista per questa combinazione.
  3. Arresta regolarmente il server se l'installazione richiede modifiche ai file del framework.
  4. Usa la procedura di installazione documentata. In self-hosting, estrai l'archivio affidabile e corrispondente nell'installazione corretta, mantenendo la sua struttura di directory e rispettando l'ordine descritto sopra. Con un hosting gestito, usa la sua funzione per i framework; non dare per scontato che i menu del pannello di altri provider valgano anche per il tuo.
  5. Controlla l'ordine degli aggiornamenti ed esegui un solo avvio controllato. Leggi il nuovo log di avvio.
  6. Verifica la versione del framework, l'elenco dei plugin e almeno una funzione che prima non era disponibile.

Esito positivo: il framework previsto risponde dall'istanza corretta, i plugin previsti vengono caricati e la funzione verificata è operativa. Ripristino: conserva lo stato precedente all'intervento. Non ripristinare alla cieca un vecchio file del framework su una versione nuova del gioco. Se era compatibile solo un pacchetto completo più vecchio, la possibilità di ripristinarlo va verificata separatamente, compresi il formato del mondo e la compatibilità con i client. Se non è chiaro, tieni il server fuori servizio in modo controllato finché non sarà disponibile una versione adatta.

Caso B: un plugin non viene compilato

Situazione tipica: Oxide risponde e gli altri plugin vengono caricati, ma un plugin specifico risulta non riuscito. Il log riporta un errore del compilatore, spesso con file, riga, colonna e un simbolo mancante o un metodo non più compatibile.

Un errore del compilatore significa, in prima battuta, solo questo: il codice sorgente presente non può essere compilato con i riferimenti disponibili. Un aggiornamento del gioco potrebbe aver modificato un'interfaccia utilizzata. Ma le cause possono essere anche un download danneggiato, codice modificato da te o una dipendenza hard mancante. “Failed to compile” non significa quindi automaticamente “l'autore deve solo pubblicare una nuova versione”.

Test B: un errore del compilatore

Sul nostro server di test isolato con protocollo Rust 2635.289.1 e Oxide.Rust 2.0.7839, soltanto il plugin di test Guide7CompileBroken.cs conteneva una riga #error intenzionale. Il plugin di controllo Guide7Probe, già caricato, è rimasto separato. L'output reale della console è stato:

Error while compiling Guide7CompileBroken: #error: 'GUIDE7_INTENTIONAL_COMPILE_FAILURE' | Line: 1, Pos: 8

Per la riparazione minima abbiamo rimosso solo la riga di errore inserita di proposito. A quel punto la console ha riportato:

Guide7CompileBroken was compiled successfully in 362ms
Loaded plugin Guide7CompileBroken v1.0.0 by Guide7 isolated test fixture

Per tornare indietro in questo test controllato basta ripristinare il file difettoso originale, che riprodurrebbe lo stesso errore intenzionale del compilatore. Per un vero plugin di terze parti, “cancellare una riga a caso” non è assolutamente una procedura di riparazione. Il nostro test dimostra la separazione tra framework e compilatore dei plugin, non una specifica rottura delle API causata dall'aggiornamento di ottobre. I 362 ms osservati descrivono solo questo singolo test, non un tempo di caricamento generale.

Nel log reale, nella console o in oxide/logs, cerca prima il nome del file interessato e la prima diagnostica del compilatore. Un successivo “impossibile caricare il plugin” spesso non fa che ripetere il risultato. Controlla se più plugin citano esattamente lo stesso simbolo mancante: in tal caso il problema potrebbe riguardare una modifica comune alle API o un riferimento condiviso, anziché più difetti indipendenti.

Scarica un aggiornamento esclusivamente dalla fonte documentata del plugin. Leggi le note di rilascio: risolvono il tuo problema, richiedono una nuova dipendenza o modificano il formato dei dati? Un numero di versione più alto, da solo, non garantisce la compatibilità con la tua combinazione.

Riparazione minima

Fai un backup del file .cs attuale e dei relativi config e dati. Per prima cosa sostituisci solo il plugin interessato con la versione corretta prevista. Oxide di norma monitora le modifiche nella cartella dei plugin, quindi evita caricamenti doppi e reload aggiuntivi frettolosi. Segui l'operazione nella console e poi verifica lo stato effettivo.

Se serve un ricaricamento mirato, la forma è questa:

oxide.reload Pluginname

Qui Pluginname indica il nome effettivo del file del plugin senza .cs, non il titolo commerciale di un download. La documentazione ufficiale dei comandi descrive questo reload mirato. Mentre circoscrivi il problema, non usare un reload con wildcard di tutti i plugin: altera inutilmente molti stati e può generare nuovi errori.

Successo: la diagnostica del compilatore scompare, viene caricata la versione del plugin attesa e la funzione interessata supera il test. Ritorno allo stato precedente: se l'aggiornamento non riesce, salva anche questo nuovo log. Ripristina la vecchia versione del plugin con i dati necessari solo se questa combinazione è compatibile con il gioco attuale. Un vecchio file che era già rotto dopo l'aggiornamento del gioco non è un rollback funzionante.

Se non esiste una correzione compatibile, può avere senso disattivare temporaneamente solo il plugin interessato. Prima controlla quali altri plugin e regole di gioco dipendono da esso. Con il server arrestato regolarmente, sposta il file sorgente salvato dalla directory dei plugin monitorata a una cartella di backup separata. Non cancellare né i config né i dati utente. Annota quale funzione mancherà fino alla riparazione.

Caso C: manca una dipendenza

Situazione tipica: un plugin segnala un requisito mancante. Altre funzioni continuano a lavorare, oppure più plugin fuori uso dipendono dalla stessa libreria. Il file che risulta mancante può persino essere presente, ma non riuscire a caricarsi.

Le linee guida di Oxide sulle dipendenze distinguono tra dipendenze opzionali, richieste e hard. Un'integrazione opzionale estende il comportamento. Un requisito necessario serve al funzionamento. Una dipendenza hard può impedire già la compilazione. Questi termini spiegano perché “dipendenza mancante” ed “errore del compilatore” possono sovrapporsi.

Test C: una dipendenza mancante

Sullo stesso server di test abbiamo caricato il nostro plugin di test Guide7Consumer.cs con il requisito dichiarato // Requires: Guide7Dependency. All'inizio la dipendenza corrispondente non era installata, di proposito. Questi sono gli output reali del test controllato:

Guide7Consumer plugin requires missing dependency: Guide7Dependency
Ignored unexpected plugin compilation failure: Guide7Consumer
Error while compiling Guide7Consumer: Missing dependency: Guide7Dependency

Anche qui compare “Error while compiling”. Il dettaglio decisivo, però, è la dipendenza mancante indicata esplicitamente. Abbiamo installato solo Guide7Dependency.cs e poi ricaricato in modo mirato il plugin che la utilizza. A quel punto sono comparsi entrambi i marcatori di inizializzazione ed entrambe le conferme di caricamento:

[Guide7Dependency] GUIDE7_DEPENDENCY_READY
Loaded plugin Guide7Dependency v1.0.0 by Guide7 isolated test fixture
[Guide7Consumer] GUIDE7_CONSUMER_READY
Loaded plugin Guide7Consumer v1.0.0 by Guide7 isolated test fixture

I marcatori attestano l'inizializzazione dei due plugin di test, non un test delle funzioni di shop, teletrasporto o protezione di un plugin di terze parti. Per annullare questo test, dopo aver scaricato il plugin che la utilizza, basterebbe rimuovere solo la nostra dipendenza. Ricaricare ripetutamente il plugin da solo non installa il suo requisito. Se nel tuo log reale è la dipendenza stessa a fallire per prima, correggi prima il suo primo errore. Una libreria con un nome simile, presa da una fonte di download qualsiasi, non è un sostituto.

Controlla nella pagina del plugin e nella documentazione il nome esatto, il tipo di dipendenza ed eventuali versioni richieste. Un altro plugin .cs e un'estensione compilata sono cose diverse: possono avere percorsi di installazione e requisiti di riavvio differenti. Per le estensioni segui la loro guida di installazione specifica e non copiare una DLL in oxide/plugins tanto per provare.

Riparazione minima

Traccia una piccola catena: plugin interessato → requisito necessario → stato di questo requisito. Controlla il requisito nell'elenco dei plugin e nel log di avvio. Se manca davvero, installa esattamente quello dalla sua fonte ufficiale. Se è già presente, correggi il suo primo errore invece di caricare lo stesso file più e più volte.

Con una normale dipendenza tra plugin puoi poi caricare in modo mirato prima il requisito e poi il plugin che lo utilizza, se la loro documentazione supporta questa procedura. Con un'estensione o un'inizializzazione di avvio modificata può essere necessario un riavvio controllato. Considera il riavvio un passaggio verificabile con un nuovo log, non un rimedio automatico.

Successo: il requisito e il plugin che lo utilizza si caricano nelle versioni previste e la funzione che li collega è operativa. Un semplice elenco con due plugin caricati non basta. Ritorno allo stato precedente: ripristina la combinazione compatibile salvata oppure disattiva il plugin finché manca il suo requisito. Prima di un downgrade, controlla se la nuova versione ha già riscritto config o dati.

Caricato, ma senza funzionare

Se un plugin risulta caricato, passa dalla diagnosi dell'installazione al test funzionale. Per prima cosa verifica di testare la funzione giusta con l'account giusto. Un admin può avere permessi diversi da un normale giocatore, quindi l'esito di un singolo tentativo da admin non vale automaticamente per tutti i giocatori.

Controlla poi i permessi e le impostazioni documentati. La funzione, il mondo, la zona o il gruppo di utenti necessari sono abilitati? Esistono condizioni come cooldown, stato di combattimento o un requisito di gioco? Questi esempi sono possibili aree da controllare, non un'affermazione valida per ogni plugin. Ciò che conta è la documentazione della tua specifica estensione.

Un avvio riuscito, inoltre, non dimostra che ogni hook funzioni. Un hook è un punto di aggancio a un evento di gioco messo a disposizione dal framework. Se questa interfaccia cambia, un plugin può caricarsi e fallire o smettere di reagire solo quando si verifica l'evento interessato. Ripeti quindi l'azione che innesca davvero il problema e osserva il log proprio in quel momento.

In caso di eccezione a runtime, salva lo stack trace completo rilevante e annota l'azione che l'ha preceduta. Modificare molti permessi «per fare una prova» non è una buona alternativa: puoi estendere gli accessi e mascherare l'errore originale. Un confronto pulito usa un account definito e permessi documentati.

Perché eliminare le config raramente è il primo passo giusto

Un file di configurazione può effettivamente essere difettoso. Tra gli indizi ci sono, ad esempio, un errore di parsing JSON segnalato esplicitamente o un errore che compare subito durante la lettura di un'impostazione. Un errore del compilatore relativo a un metodo di gioco mancante, invece, non si risolve ripristinando tutte le config.

La guida di Oxide sulle configurazioni mette in guardia anche dai plugin che riscrivono le impostazioni quando vengono scaricati. Le modifiche fatte mentre il plugin è in esecuzione possono quindi essere sovrascritte. Fai un backup del file, segui le istruzioni del plugin e, se necessario, scaricalo prima di modificarlo.

Controlla prima il JSON in locale con un validatore adatto. I valori riservati, come credenziali o indirizzi webhook, non vanno inseriti nei validatori online pubblici. Un JSON valido, però, supera solo il controllo della sintassi: un campo scritto correttamente può comunque contenere un valore non ammesso o seguire uno schema obsoleto.

Se ti serve una config nuova per fare un confronto, lavora possibilmente su una copia isolata. Conserva il file originale senza modificarlo. Confronta poi le singole impostazioni e applica solo le modifiche di cui capisci il motivo. Un reset completo può alterare regole, prezzi, riferimenti ai permessi o altri parametri specifici del plugin, senza che te ne accorga al primo test di funzionamento.

Il wipe non serve a riparare i plugin

Un wipe riguarda il salvataggio del gioco o determinati dati di progresso. Un errore di compilazione di un plugin riguarda il codice e i suoi requisiti. Sono due livelli diversi. Un nuovo mondo non rende di nuovo disponibile un metodo API rimosso e non installa una libreria mancante.

Il fatto che un errore si presenti nel giorno del wipe non dimostra un legame con dati di mondo danneggiati. Aggiornamento del gioco, aggiornamento del framework, aggiornamento dei plugin e wipe avvengono spesso nella stessa finestra di manutenzione. Separa questi eventi nella tua cronologia. Controlla anche se dopo il riavvio sono state usate un'altra identità del server o un'altra directory dei dati.

Se sospetti davvero un problema del mondo o dei dati, trattalo come un'attività di diagnosi a parte, con un proprio backup e un proprio criterio di successo. Non eseguirla come ultimo passaggio secondario della riparazione di un plugin. Prima di ripristinare un backup più vecchio, devi sapere con chiarezza quali progressi fatti nel frattempo andrebbero persi e se quello stato è effettivamente compatibile.

Carbon: stessa logica di diagnosi, installazione diversa

Se il server usa Carbon, inizia interrogandone la versione:

c.version

La configurazione di Carbon e le release note ufficiali documentano le funzioni specifiche di Carbon e le informazioni sulle versioni. Usa i comandi e i percorsi della tua effettiva installazione di Carbon. In quel contesto, un comando Oxide non riuscito non dimostra da solo un guasto del framework.

Le domande di base restano le stesse: il framework è in esecuzione? Quali estensioni sono effettivamente caricate? A fallire è un singolo plugin che usa la dipendenza o un requisito comune? Quale funzione è stata davvero verificata? Da questo non consegue però che ogni plugin Oxide funzioni senza modifiche con qualsiasi versione di Carbon, né che cambiare framework sia una riparazione immediata priva di rischi.

Durante la ricerca del problema, non passare di sfuggita da Oxide a Carbon o viceversa. Una migrazione cambia più requisiti contemporaneamente. Pianificala separatamente, fai un backup di dati e permessi e testa i plugin che ti servono. Per un singolo errore di compilazione, la modifica più piccola adatta è di solito più facile da seguire rispetto a un cambio completo di piattaforma.

Tre casi a confronto diretto

Caso
Riscontro decisivo
Intervento minimo sensato
Cosa resta esplicitamente intatto
Verifica successiva
Il framework manca o non è compatibile
Avvio del framework non confermato; molte funzioni colpite
Installare correttamente la versione adatta del framework dopo l'aggiornamento del gioco
Mondo, config dei plugin e dati utente
Versione, log di avvio, elenco dei plugin, funzione
Un singolo plugin non viene compilato
Il framework è in esecuzione; la prima diagnosi indica questo plugin
Installare una versione compatibile del plugin o disattivarlo in modo isolato
Altri plugin e dati salvati
Verificare separatamente compilazione, caricamento e funzione
Manca una dipendenza
Il plugin che la usa indica il requisito, che manca o fallisce
Riparare il requisito, poi verificare il plugin che lo usa
Estensioni non coinvolte
Dipendenza e funzione comune operative

Questo confronto illustra il processo di diagnosi, non tempi di riparazione misurati. Non tutti gli errori rientrano chiaramente in una riga. Un riferimento a una DLL mancante, ad esempio, può causare un errore di compilazione. Classifica in base alla prima causa documentata, non in base all'ultimo messaggio rosso.

Come verificare la riparazione in modo affidabile

Prima della modifica, stabilisci un piccolo test che renda visibile il malfunzionamento originale. Con un plugin per i kit potrebbe essere, ad esempio, un riscatto documentato con un account di prova dedicato e un kit di test noto. Con un plugin di protezione devi verificare in condizioni controllate la protezione promessa. Non usare costruzioni altrui o beni economici reali.

Confronta poi lo stesso test prima e dopo una singola modifica. Annota tipo di account, permessi rilevanti, versione del plugin, impostazioni, azione e risultato. Controlla anche una funzione correlata che non era guasta. In questo modo ti accorgi se una riparazione risolve il problema visibile, ma altera un'altra regola centrale.

Una conclusione sensata comprende cinque domande:

  • Il framework previsto risponde dall'istanza del server corretta?
  • Le versioni dei plugin effettivamente caricate corrispondono a quelle previste?
  • Il primo errore è sparito dal nuovo log senza generarne un altro?
  • Il caso d'uso concreto funziona con l'account utente adatto?
  • Il risultato resta valido dopo il prossimo avvio controllato pianificato?

L'ultimo punto verifica in particolare l'ordine di installazione e l'avvio automatico. Non forzare inutilmente un altro riavvio mentre si gioca. Se questa verifica è ancora in sospeso, documenta la riparazione come verificata a livello funzionale, con verifica dell'avvio ancora aperta.

Una segnalazione di errore utile

Non inviare una raccolta di screenshot disordinati. Una segnalazione breve e riproducibile accelera la ricerca del problema. Le indicazioni di Oxide per la segnalazione dei problemi consigliano di includere dati sull'ambiente, passaggi, risultato atteso ed effettivo e log rilevanti.

Warning: This command deletes or removes game content. Create a backup first and check the command’s target.

Funzione interessata:
Primo errore osservato con data e fuso orario:
Versione di Rust e ramo di rilascio:
Framework e versione effettivamente rilevata:
Nome del plugin, versione e fonte del download:
Dipendenze richieste e relativo stato:
Ultima modifica prima dell'errore:
Primo messaggio di errore completo:
Passaggi per riprodurre il problema:
Risultato atteso / risultato effettivo:
Singola modifica già tentata e risultato:
Backup disponibile e procedura di ripristino:

Rimuovi dalla copia password, token, indirizzi webhook e dati personali non necessari. Conserva l'originale non modificato in un posto protetto. Una copia del log ripulita deve mantenere la causa tecnica: non eliminare per sbaglio il nome del file del plugin o il messaggio di errore necessario per la diagnosi.

Invia la richiesta al destinatario giusto. In caso di ordine di installazione errato o di framework non selezionabile, può aiutarti il supporto dell'hosting. Per un errore riproducibile in un singolo plugin, il referente giusto è spesso il suo sviluppatore. Se più livelli non sono chiari, invia i riscontri invece di attribuire colpe affrettatamente.

Prima del prossimo aggiornamento di Rust

Tieni un piccolo inventario dei tuoi plugin critici e delle loro dipendenze. Annota quali regole di gioco non valgono più senza di essi e quali funzioni offrono soltanto comodità. In questo modo, dopo un aggiornamento potrai controllare prima ciò che conta davvero per la vostra community, invece di mettere mano a ogni estensione in ordine alfabetico.

Prima delle modifiche programmate, salva uno stato ricostruibile e conserva le relative informazioni sulle versioni. Controlla gli avvisi attuali del progetto del framework e degli sviluppatori dei plugin più importanti. Non fare affidamento su un tempo di attesa fisso: una release può uscire in fretta, ma un determinato plugin può continuare a richiedere un adattamento.

Verifica inoltre che cosa automatizzano il tuo script di avvio o il tuo provider. Aggiorna Rust, il framework, entrambi o nessuno dei due? In quale ordine? Un provider di hosting può occuparsene a ogni avvio, un altro tramite una funzione di aggiornamento separata. La guida di un altro pannello non descrive automaticamente il tuo server.

Per le community più grandi conviene una procedura di test separata con dati di prova noti. Una prova deve usare le stesse versioni e impostazioni rilevanti, altrimenti il suo esito positivo ha un valore limitato. Documenta i limiti del test, invece di ricavare da un server di prova vuoto promesse generali di stabilità.

FAQ

Devo riavviare l'intero server dopo ogni aggiornamento di un plugin?

Non necessariamente. Oxide supporta il rilevamento automatico delle modifiche ai plugin e il ricaricamento mirato. I file del framework, le estensioni e determinate procedure di inizializzazione possono invece richiedere un riavvio. Ciò che conta è la documentazione del componente interessato. Dopo un reload controlla il log e la funzione: un comando accettato correttamente non basta.

Mancano tutti i plugin. La colpa è sicuramente di Oxide?

No. È un indizio forte, ma controlla il contesto della console, l'avvio completo, la scelta del framework, l'istanza del server e le dipendenze comuni. Anche una directory dei dati errata o più plugin con lo stesso requisito possono sembrare un guasto totale. Solo la combinazione dei riscontri permette di circoscrivere l'errore in modo affidabile.

Un riavvio aiuta appena esce un nuovo framework?

Solo se la tua procedura di installazione installa effettivamente quel framework durante il riavvio o se lo hai già aggiornato correttamente prima. In caso di self-hosting, un riavvio da solo non scarica nulla. Confronta la versione del framework letta dopo il riavvio con quella prevista. Se resta invariata, esamina il percorso di aggiornamento.

Posso cancellare la config e farla ricreare?

Una nuova config può aiutarti a fare un confronto in una copia di prova con backup. Non è adatta come riparazione generica e può azzerare le tue regole personalizzate. Cerca prima un errore di configurazione concreto. Salva l'originale e i dati e verifica se il plugin riscrive le impostazioni quando viene scaricato.

Perché dopo l'aggiornamento un plugin risulta caricato ma non funziona?

Il caricamento è solo una fase. La funzione specifica può fallire a causa di permessi, impostazioni, una dipendenza richiesta solo in seguito o un hook modificato. Verifica l'evento che la attiva in condizioni controllate e leggi il log relativo allo stesso momento. Non dichiarare riparata la funzione solo perché il plugin compare nell'elenco.

Quanto devo aspettare Oxide o una correzione del plugin?

Non si può promettere seriamente una durata fissa. Controlla il canale di release attuale e lo stato del plugin interessato. Se una protezione critica non è disponibile, decidi quale sia lo stato operativo sicuro del server, invece di affidarti a un orario stimato.

Posso semplicemente tornare a una versione precedente?

Solo con una combinazione compatibile verificata e un percorso di ritorno protetto da backup. Un vecchio framework con un Rust nuovo può fallire di nuovo. Una nuova versione di un plugin può aver modificato dati che la versione precedente non comprende. Salva anche lo stato attuale e verifica la compatibilità dei dati prima di ripristinare.

Termini che compaiono spesso nel log

Framework: base per le estensioni, per esempio Oxide o Carbon. Plugin: singola estensione con una funzione specifica. Compilatore: traduce il codice sorgente del plugin in codice eseguibile. Dipendenza: un ulteriore componente di cui un'estensione ha bisogno. Extension: estensione aggiuntiva del framework, spesso sotto forma di libreria compilata con una propria procedura di installazione. Hook: aggancio a un evento di gioco. RCON: accesso remoto autorizzato alla console del server. Rollback: ripristino verificato di uno stato precedente coerente. Wipe: azzeramento di determinati salvataggi; non è una riparazione generica dei plugin.

Il passo successivo più sensato sul server interessato è piccolo: salva il log di avvio attuale, verifica il framework effettivamente in esecuzione e risali al primo messaggio di errore. Solo allora potrai decidere quale singolo componente va modificato.

Fonti e stato delle verifiche

Stato delle verifiche: dati delle release verificati il 6 novembre 2026; nessun nuovo test funzionale con Oxide.Rust 2.0.7894. Le tre prove di errore sono state eseguite il 29 ottobre 2026 su un nostro server di prova isolato con protocollo Rust 2635.289.1 e Oxide.Rust 2.0.7839; il server di prova è stato poi eliminato. Dopo gli ulteriori aggiornamenti di Rust, i numeri di versione di queste prove storiche valgono ormai solo come esempio.