Ovaj vodič objašnjava kako da instalirate Oxide/uMod ili Carbon modding okvir na vaš Rust server, dodate dodatke iz zajednice i upravljate njima preko konzole. Za opštu konfiguraciju servera i startne promenljive, pogledajte Vodič za konfiguraciju Rust servera.

Instalacija Oxide/uMod ili Carbon

Oxide (sada održavan kao uMod) i Carbon su modding okviri za Rust koji vam omogućavaju da instalirate dodatke koje je napravila zajednica. Ovi okviri dodaju funkcije kao što su sistemi ekonomije, prilagođeni kompleti (kits), nagrade za glasanje, PvE zaštitne zone i mnogo više.

Ne morate ručno da otpremate nijedan fajl. Modding okvir se instalira automatski postavljanjem jedne startne promenljive:

1. Zaustavite svoj server u kartici Console u GPanel-u.
2. Prijavite se na GPanel i idite na karticu Startup.
3. Pronađite promenljivu FRAMEWORK i postavite je na:
   • oxide — za Oxide/uMod (najšire korišćeni okvir, sa najvećom bibliotekom dodataka)
   • carbon — za Carbon okvir (alternativa sa sopstvenim ekosistemom dodataka)
   • vanilla — za pokretanje bez ikakvog modding okvira
4. Pokrenite server. Fajlovi okvira se preuzimaju i primenjuju automatski. Prilikom prvog pokretanja sa Oxide-om, generiše se struktura direktorijuma oxide/.
5. Proverite log konzole da li postoji linija poput Loaded plugin Oxide.Core kako biste potvrdili da je Oxide aktivan.

Instalacija dodataka

Dodaci se distribuiraju kao .cs (C# izvorni kôd) fajlovi. Oxide ih kompajlira na serveru u toku rada — nije potrebna prethodna kompilacija.

1. Preuzmite .cs fajl dodatka sa umod.org ili drugog pouzdanog izvora.
2. Otpremite .cs fajl u direktorijum oxide/plugins/ na vašem serveru koristeći SFTP ili GPanel menadžer fajlova. Za pomoć sa SFTP-om, pogledajte Kako otpremiti fajlove preko SFTP-a.
3. Ako je server pokrenut, dodatak će biti otkriven i kompajliran automatski u roku od nekoliko sekundi. Videćete izlaz u konzoli koji potvrđuje da je učitan, npr. Loaded plugin MyPlugin v1.2.3 by Author.
4. Ako server nije pokrenut, dodatak će se učitati pri sledećem pokretanju.

Struktura Oxide direktorijuma

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 dodataka

Većina dodataka generiše JSON konfiguracioni fajl u oxide/config/ prilikom prvog učitavanja. Da biste prilagodili dodatak:

1. Dozvolite da se dodatak učita bar jednom kako bi generisao podrazumevani konfiguracioni fajl.
2. Zaustavite svoj server (ili imajte u vidu da neki dodaci podržavaju ponovno učitavanje konfiguracije uživo).
3. Otvorite konfiguracioni fajl dodatka u oxide/config/PluginName.json koristeći GPanel menadžer fajlova ili SFTP.
4. Izmenite podešavanja i sačuvajte fajl.
5. Ponovo učitajte dodatak komandom oxide.reload PluginName ili ponovo pokrenite server.

Upravljanje dodacima preko konzole

Ove komande se mogu pokrenuti iz GPanel konzole ili preko RCON klijenta. Za podešavanje RCON-a, pogledajte Rust RCON pristup i administratorske komande.

Ažuriranje dodataka

Da biste ažurirali dodatak na noviju verziju:

1. Preuzmite ažurirani .cs fajl sa stranice dodatka na umod.org.
2. Otpremite novi fajl u oxide/plugins/, prepisujući postojeći fajl.
3. Ako je server pokrenut, Oxide otkriva promenu fajla i automatski ponovo kompajlira i učitava dodatak. Alternativno, pokrenite oxide.reload PluginName.
4. Proverite konzolu za eventualne greške. Neka ažuriranja dodataka mogu zahtevati izmene u konfiguracionom fajlu u oxide/config/.

Uklanjanje dodataka

Da biste u potpunosti uklonili dodatak:

1. Pokrenite oxide.unload PluginName da biste isključili dodatak dok je server pokrenut.
2. Obrišite .cs fajl iz oxide/plugins/.
3. Opciono obrišite konfiguracioni fajl dodatka iz oxide/config/ i fajlove podataka iz oxide/data/ ako vam više nisu potrebni.

Popularni dodaci

Rešavanje problema sa dodacima

Ako se vaši dodaci ne učitavaju, proverite sledeće:

• Potvrdite da je Oxide instaliran i aktivan. U GPanel kartici Startup, promenljiva FRAMEWORK mora biti postavljena na oxide. Log konzole bi trebalo da prikaže Loaded plugin Oxide.Core tokom pokretanja.
• Fajlovi dodataka moraju biti smešteni direktno u oxide/plugins/ sa tačnom ekstenzijom .cs. Fajlovi u poddirektorijumima ili sa pogrešnim ekstenzijama se ignorišu.
• Proverite konzolu i oxide/logs/ za greške prilikom kompilacije. Dodatak sa sintaksnom greškom neće se učitati, a poruka o grešci će opisati problem.
• Neki dodaci zavise od drugih dodataka (npr. mnogi dodaci za prodavnice zahtevaju Economics). Prvo instalirajte sve potrebne zavisnosti.

Za druge uobičajene probleme sa serverom, pogledajte Rešavanje problema sa Rust serverom.

Potrebna vam je pomoć?

Ako naiđete na problem koji nije obuhvaćen ovim vodičem, naš tim za podršku je dostupan da pomogne. Pošaljite tiket za podršku i navedite ID svog servera, opis problema i sav relevantan izlaz iz konzole.