Questa guida illustra come installare il framework di modding Oxide/uMod o Carbon sul tuo server Rust, aggiungere plugin della community e gestirli tramite la console. Per la configurazione generale del server e le variabili di avvio, consulta la Guida alla configurazione del server Rust.

Installazione di Oxide/uMod o Carbon

Oxide (ora mantenuto come uMod) e Carbon sono framework di modding per Rust che ti permettono di installare plugin sviluppati dalla community. Questi framework aggiungono funzionalità come sistemi economici, kit personalizzati, ricompense per il voto, zone di protezione PvE e molto altro.

Non è necessario caricare manualmente alcun file. Il framework di modding viene installato automaticamente impostando una singola variabile di avvio:

1. Arresta il server dalla scheda Console di GPanel.
2. Accedi a GPanel e vai alla scheda Startup.
3. Trova la variabile FRAMEWORK e impostala su:
   • oxide — per Oxide/uMod (il framework più utilizzato, con la più ampia libreria di plugin)
   • carbon — per il framework Carbon (un'alternativa con un proprio ecosistema di plugin)
   • vanilla — per eseguire il server senza alcun framework di modding
4. Avvia il server. I file del framework vengono scaricati e applicati automaticamente. Al primo avvio con Oxide, viene generata la struttura della directory oxide/.
5. Controlla il log della console per una riga come Loaded plugin Oxide.Core per confermare che Oxide sia attivo.

Installazione dei plugin

I plugin vengono distribuiti come file .cs (codice sorgente C#). Oxide li compila sul server in fase di esecuzione, senza richiedere alcuna pre-compilazione.

1. Scarica il file .cs del plugin da umod.org o da un'altra fonte affidabile.
2. Carica il file .cs nella directory oxide/plugins/ del tuo server utilizzando SFTP o il file manager di GPanel. Per assistenza con SFTP, consulta Come caricare i file tramite SFTP.
3. Se il server è in esecuzione, il plugin verrà rilevato e compilato automaticamente entro pochi secondi. Vedrai un output nella console che conferma il caricamento, ad esempio Loaded plugin MyPlugin v1.2.3 by Author.
4. Se il server non è in esecuzione, il plugin verrà caricato al successivo avvio.

Struttura della directory Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Configurazione dei plugin

La maggior parte dei plugin genera un file di configurazione JSON in oxide/config/ al primo caricamento. Per personalizzare un plugin:

1. Lascia che il plugin venga caricato almeno una volta in modo che generi il suo file di configurazione predefinito.
2. Arresta il server (o tieni presente che alcuni plugin supportano il ricaricamento della configurazione a caldo).
3. Apri il file di configurazione del plugin in oxide/config/PluginName.json utilizzando il file manager di GPanel o SFTP.
4. Modifica le impostazioni e salva il file.
5. Ricarica il plugin con oxide.reload PluginName o riavvia il server.

Gestione dei plugin tramite console

Questi comandi possono essere eseguiti dalla console di GPanel o tramite un client RCON. Per la configurazione di RCON, consulta Accesso RCON di Rust e comandi di amministrazione.

Aggiornamento dei plugin

Per aggiornare un plugin a una versione più recente:

1. Scarica il file .cs aggiornato dalla pagina del plugin su umod.org.
2. Carica il nuovo file in oxide/plugins/, sovrascrivendo il file esistente.
3. Se il server è in esecuzione, Oxide rileva la modifica del file e ricompila e ricarica automaticamente il plugin. In alternativa, esegui oxide.reload PluginName.
4. Controlla la console per eventuali errori. Alcuni aggiornamenti dei plugin potrebbero richiedere modifiche al file di configurazione in oxide/config/.

Rimozione dei plugin

Per rimuovere completamente un plugin:

1. Esegui oxide.unload PluginName per scaricare il plugin mentre il server è in esecuzione.
2. Elimina il file .cs da oxide/plugins/.
3. Opzionalmente, elimina il file di configurazione del plugin da oxide/config/ e i file di dati da oxide/data/ se non ti servono più.

Plugin popolari

Risoluzione dei problemi dei plugin

Se i tuoi plugin non vengono caricati, controlla quanto segue:

• Conferma che Oxide sia installato e attivo. Nella scheda Startup di GPanel, la variabile FRAMEWORK deve essere impostata su oxide. Il log della console dovrebbe mostrare Loaded plugin Oxide.Core durante l'avvio.
• I file dei plugin devono essere collocati direttamente in oxide/plugins/ con l'estensione esatta .cs. I file nelle sottodirectory o con estensioni errate vengono ignorati.
• Controlla la console e oxide/logs/ per errori di compilazione. Un plugin con un errore di sintassi non verrà caricato e il messaggio di errore descriverà il problema.
• Alcuni plugin hanno dipendenze da altri plugin (ad es. molti plugin di negozi richiedono Economics). Installa prima tutte le dipendenze richieste.

Per altri problemi comuni del server, consulta Risoluzione dei problemi del server Rust.

Hai bisogno di aiuto?

Se incontri un problema non trattato in questa guida, il nostro team di supporto è disponibile per aiutarti. Apri un ticket di supporto e includi l'ID del tuo server, una descrizione del problema e qualsiasi output rilevante della console.