Ovaj vodič pokriva kako instalirati Oxide/uMod ili Carbon okvir za modiranje na vaš Rust server, dodati pluginove zajednice i upravljati njima putem konzole. Za opću konfiguraciju servera i varijable pokretanja pogledajte Rust vodič za konfiguraciju servera.

Instalacija Oxide/uMod ili Carbon

Oxide (sada održavan kao uMod) i Carbon su okviri za modiranje Rust koji vam omogućuju instalaciju pluginova koje je izgradila zajednica. Ovi okviri dodaju značajke poput ekonomskih sustava, prilagođenih kitova, nagrada za glasanje, PvE zaštitnih zona i mnogo više.

Ne trebate ručno prenositi nikakve datoteke. Okvir za modiranje se automatski instalira postavljanjem jedne varijable pokretanja:

1. Zaustavite server s GPanel kartice Console.
2. Prijavite se u GPanel i idite na karticu Startup.
3. Pronađite varijablu FRAMEWORK i postavite je na:
   • oxide — za Oxide/uMod (najšire korišteni okvir s najvećom bibliotekom pluginova)
   • carbon — za Carbon okvir (alternativa s vlastitim ekosustavom pluginova)
   • vanilla — za pokretanje bez okvira za modiranje
4. Pokrenite server. Datoteke okvira se automatski preuzimaju i primjenjuju. Pri prvom pokretanju s Oxide, struktura direktorija oxide/ se generira.
5. Provjerite konzolni zapis za redak poput Loaded plugin Oxide.Core kako biste potvrdili da je Oxide aktivan.

Instalacija pluginova

Pluginovi se distribuiraju kao .cs (C# izvorni kod) datoteke. Oxide ih kompajlira na serveru tijekom izvođenja — nije potrebna prethodna kompilacija.

1. Preuzmite .cs datoteku plugina s umod.org ili drugog pouzdanog izvora.
2. Prenesite .cs datoteku u direktorij oxide/plugins/ na vašem serveru koristeći SFTP ili GPanel upravitelj datoteka. Za pomoć s SFTP pogledajte Kako prenijeti datoteke putem SFTP.
3. Ako server radi, plugin će biti detektiran i automatski kompajliran unutar nekoliko sekundi. Vidjet ćete ispis u konzoli koji potvrđuje učitavanje, npr. Loaded plugin MyPlugin v1.2.3 by Author.
4. Ako server ne radi, plugin će se učitati pri sljedećem pokretanju.

Struktura Oxide direktorija

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

Konfiguracija pluginova

Većina pluginova generira JSON konfiguracijsku datoteku u oxide/config/ pri prvom učitavanju. Za prilagodbu plugina:

1. Dopustite da se plugin učita barem jednom kako bi generirao svoju zadanu konfiguracijsku datoteku.
2. Zaustavite server (ili imajte na umu da neki pluginovi podržavaju ponovno učitavanje konfiguracije uživo).
3. Otvorite konfiguracijsku datoteku plugina u oxide/config/PluginName.json koristeći GPanel upravitelj datoteka ili SFTP.
4. Uredite postavke i spremite datoteku.
5. Ponovno učitajte plugin s oxide.reload PluginName ili ponovo pokrenite server.

Upravljanje pluginovima putem konzole

Ove naredbe mogu se pokrenuti iz GPanel konzole ili putem RCON klijenta. Za postavljanje RCON pogledajte Rust RCON pristup i administratorske naredbe.

Ažuriranje pluginova

Za ažuriranje plugina na noviju verziju:

1. Preuzmite ažuriranu .cs datoteku sa stranice plugina na umod.org.
2. Prenesite novu datoteku u oxide/plugins/, prepisujući postojeću datoteku.
3. Ako server radi, Oxide detektira promjenu datoteke i automatski rekompajlira i ponovno učitava plugin. Alternativno, pokrenite oxide.reload PluginName.
4. Provjerite konzolu za greške. Neka ažuriranja pluginova mogu zahtijevati promjene u konfiguracijskoj datoteci u oxide/config/.

Uklanjanje pluginova

Za potpuno uklanjanje plugina:

1. Pokrenite oxide.unload PluginName za istovarivanje plugina dok server radi.
2. Izbrišite .cs datoteku iz oxide/plugins/.
3. Po želji izbrišite konfiguracijsku datoteku plugina iz oxide/config/ i datoteke podataka iz oxide/data/ ako vam više nisu potrebne.

Popularni pluginovi

Rješavanje problema s pluginovima

Ako se vaši pluginovi ne učitavaju, provjerite sljedeće:

• Potvrdite da je Oxide instaliran i aktivan. Na GPanel kartici Startup, varijabla FRAMEWORK mora biti postavljena na oxide. Konzolni zapis trebao bi prikazati Loaded plugin Oxide.Core tijekom pokretanja.
• Datoteke pluginova moraju biti smještene izravno u oxide/plugins/ s točnom ekstenzijom .cs. Datoteke u poddirektorijima ili s pogrešnim ekstenzijama se ignoriraju.
• Provjerite konzolu i oxide/logs/ za greške kompilacije. Plugin s greškom u sintaksi neće se učitati, a poruka o grešci opisat će problem.
• Neki pluginovi imaju zavisnosti o drugim pluginovima (npr. mnogi pluginovi za trgovine zahtijevaju Economics). Prvo instalirajte sve potrebne zavisnosti.

Za ostale česte probleme sa serverom pogledajte Rust rješavanje problema sa serverom.

Trebate pomoć?

Ako naiđete na problem koji nije pokriven u ovom vodiču, naš tim za podršku je dostupan za pomoć. Pošaljite zahtjev za podršku i uključite ID svog servera, opis problema i sve relevantne ispise konzole.