Acest ghid acoperă modul de instalare a framework-ului de modding Oxide/uMod sau Carbon pe serverul tău Rust, adăugarea de plugin-uri create de comunitate și gestionarea acestora prin consolă. Pentru configurarea generală a serverului și variabilele de pornire, consultă Ghidul de configurare a serverului Rust.

Instalarea Oxide/uMod sau Carbon

Oxide (acum întreținut sub numele de uMod) și Carbon sunt framework-uri de modding pentru Rust care îți permit să instalezi plugin-uri create de comunitate. Aceste framework-uri adaugă funcții precum sisteme de economie, kituri personalizate, recompense pentru vot, zone de protecție PvE și multe altele.

Nu trebuie să încarci manual niciun fișier. Framework-ul de modding este instalat automat prin setarea unei singure variabile de pornire:

1. Oprește serverul din tab-ul Console din GPanel.
2. Autentifică-te în GPanel și mergi la tab-ul Startup.
3. Găsește variabila FRAMEWORK și seteaz-o la:
   • oxide — pentru Oxide/uMod (framework-ul cel mai utilizat, cu cea mai mare bibliotecă de plugin-uri)
   • carbon — pentru framework-ul Carbon (o alternativă cu propriul ecosistem de plugin-uri)
   • vanilla — pentru a rula fără niciun framework de modding
4. Pornește serverul. Fișierele framework-ului sunt descărcate și aplicate automat. La prima pornire cu Oxide, este generată structura de directoare oxide/.
5. Verifică log-ul consolei pentru o linie precum Loaded plugin Oxide.Core pentru a confirma că Oxide este activ.

Instalarea plugin-urilor

Plugin-urile sunt distribuite ca fișiere .cs (cod sursă C#). Oxide le compilează pe server în timpul rulării — nu este necesară nicio precompilare.

1. Descarcă fișierul .cs al plugin-ului de pe umod.org sau o altă sursă de încredere.
2. Încarcă fișierul .cs în directorul oxide/plugins/ de pe serverul tău folosind SFTP sau managerul de fișiere din GPanel. Pentru ajutor cu SFTP, consultă Cum să încarci fișiere prin SFTP.
3. Dacă serverul rulează, plugin-ul va fi detectat și compilat automat în câteva secunde. Vei vedea în consolă un mesaj care confirmă încărcarea, de ex. Loaded plugin MyPlugin v1.2.3 by Author.
4. Dacă serverul nu rulează, plugin-ul se va încărca la următoarea pornire.

Structura directoarelor Oxide

oxide/
  plugins/
    MyPlugin.cs       <- plasează fișierele plugin-urilor aici
    AnotherPlugin.cs
  config/             <- fișiere de configurare ale plugin-urilor generate automat
  data/               <- fișiere de date ale plugin-urilor
  logs/               <- fișiere log ale plugin-urilor

Configurarea plugin-urilor

Majoritatea plugin-urilor generează un fișier de configurare JSON în oxide/config/ prima dată când se încarcă. Pentru a personaliza un plugin:

1. Lasă plugin-ul să se încarce cel puțin o dată pentru ca acesta să își genereze fișierul de configurare implicit.
2. Oprește serverul (sau ține cont că unele plugin-uri acceptă reîncărcarea configurației în timp real).
3. Deschide fișierul de configurare al plugin-ului din oxide/config/PluginName.json folosind managerul de fișiere din GPanel sau SFTP.
4. Editează setările și salvează fișierul.
5. Reîncarcă plugin-ul cu oxide.reload PluginName sau repornește serverul.

Gestionarea plugin-urilor prin consolă

Aceste comenzi pot fi rulate din consola GPanel sau printr-un client RCON. Pentru configurarea RCON, consultă Accesul RCON și comenzile de administrare pentru Rust.

Actualizarea plugin-urilor

Pentru a actualiza un plugin la o versiune mai nouă:

1. Descarcă fișierul .cs actualizat de pe pagina plugin-ului de pe umod.org.
2. Încarcă noul fișier în oxide/plugins/, suprascriind fișierul existent.
3. Dacă serverul rulează, Oxide detectează modificarea fișierului și recompilează și reîncarcă automat plugin-ul. Alternativ, rulează oxide.reload PluginName.
4. Verifică consola pentru eventuale erori. Unele actualizări ale plugin-urilor pot necesita modificări ale fișierului de configurare din oxide/config/.

Eliminarea plugin-urilor

Pentru a elimina complet un plugin:

1. Rulează oxide.unload PluginName pentru a descărca plugin-ul în timp ce serverul rulează.
2. Șterge fișierul .cs din oxide/plugins/.
3. Opțional, șterge fișierul de configurare al plugin-ului din oxide/config/ și fișierele de date din oxide/data/ dacă nu mai ai nevoie de ele.

Plugin-uri populare

Depanarea problemelor cu plugin-urile

Dacă plugin-urile tale nu se încarcă, verifică următoarele:

• Confirmă că Oxide este instalat și activ. În tab-ul Startup din GPanel, variabila FRAMEWORK trebuie setată la oxide. Log-ul consolei ar trebui să afișeze Loaded plugin Oxide.Core în timpul pornirii.
• Fișierele plugin-urilor trebuie plasate direct în oxide/plugins/ cu extensia exactă .cs. Fișierele din subdirectoare sau cu extensii greșite sunt ignorate.
• Verifică consola și oxide/logs/ pentru erori de compilare. Un plugin cu o eroare de sintaxă nu se va încărca, iar mesajul de eroare va descrie problema.
• Unele plugin-uri au dependențe de alte plugin-uri (de ex. multe plugin-uri de magazin necesită Economics). Instalează mai întâi toate dependențele necesare.

Pentru alte probleme comune ale serverului, consultă Depanarea serverului Rust.

Ai nevoie de ajutor?

Dacă întâmpini o problemă care nu este acoperită în acest ghid, echipa noastră de suport îți stă la dispoziție. Trimite un tichet de suport și include ID-ul serverului tău, o descriere a problemei și orice rezultat relevant din consolă.