Ez az útmutató bemutatja, hogyan telepítsd az Oxide/uMod vagy Carbon modding keretrendszert a Rust szerveredre, hogyan adj hozzá közösségi pluginokat, és hogyan kezeld őket a konzolon keresztül. Az általános szerver konfigurációhoz és indítási változókhoz tekintsd meg a Rust szerver konfigurációs útmutatót.

Oxide/uMod vagy Carbon telepítése

Az Oxide (amelyet jelenleg uMod néven tartanak karban) és a Carbon modding keretrendszerek a Rust-hoz, amelyek lehetővé teszik közösség által készített pluginok telepítését. Ezek a keretrendszerek olyan funkciókat adnak hozzá, mint gazdasági rendszerek, egyéni kitek, szavazási jutalmak, PvE védelmi zónák és még sok más.

Nem kell manuálisan fájlokat feltöltened. A modding keretrendszer automatikusan települ egyetlen indítási változó beállításával:

1. Állítsd le a szerveredet a GPanel Console fülről.
2. Jelentkezz be a GPanel-be és menj a Startup fülre.
3. Keresd meg a FRAMEWORK változót és állítsd be a következőre:
   • oxide — az Oxide/uMod-hoz (a legszélesebb körben használt keretrendszer, a legnagyobb plugin könyvtárral)
   • carbon — a Carbon keretrendszerhez (egy alternatíva saját plugin ökoszisztémával)
   • vanilla — modding keretrendszer nélküli futtatáshoz
4. Indítsd el a szervert. A keretrendszer fájlok automatikusan letöltődnek és alkalmazásra kerülnek. Az első Oxide-dal történő indításkor az oxide/ könyvtárszerkezet jön létre.
5. Ellenőrizd a konzol naplót egy ilyen sorért: Loaded plugin Oxide.Core, ami megerősíti, hogy az Oxide aktív.

Pluginok telepítése

A pluginok .cs (C# forráskód) fájlokként kerülnek terjesztésre. Az Oxide futásidőben fordítja le őket a szerveren — nincs szükség előzetes fordításra.

1. Töltsd le a plugin .cs fájlt a umod.org oldalról vagy más megbízható forrásból.
2. Töltsd fel a .cs fájlt az oxide/plugins/ könyvtárba a szerveredre SFTP-n vagy a GPanel fájlkezelőn keresztül. SFTP-vel kapcsolatos segítségért tekintsd meg a Fájlok feltöltése SFTP-n keresztül útmutatót.
3. Ha a szerver fut, a plugin automatikusan észlelésre és fordításra kerül néhány másodpercen belül. A konzolon egy megerősítő üzenet jelenik meg, pl. Loaded plugin MyPlugin v1.2.3 by Author.
4. Ha a szerver nem fut, a plugin a következő indításkor töltődik be.

Oxide könyvtárszerkezet

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

Pluginok konfigurálása

A legtöbb plugin az első betöltéskor automatikusan létrehoz egy JSON konfigurációs fájlt az oxide/config/ könyvtárban. Egy plugin testreszabásához:

1. Hagyd, hogy a plugin legalább egyszer betöltődjön, hogy létrehozza az alapértelmezett konfigurációs fájlját.
2. Állítsd le a szerveredet (vagy vedd figyelembe, hogy egyes pluginok támogatják az élő konfiguráció újratöltést).
3. Nyisd meg a plugin konfigurációs fájlját az oxide/config/PluginName.json helyen a GPanel fájlkezelővel vagy SFTP-n keresztül.
4. Szerkeszd a beállításokat és mentsd el a fájlt.
5. Töltsd újra a plugint az oxide.reload PluginName paranccsal vagy indítsd újra a szervert.

Pluginok kezelése konzolon keresztül

Ezek a parancsok a GPanel konzolból vagy RCON kliensen keresztül futtathatók. Az RCON beállításhoz tekintsd meg a Rust RCON hozzáférés és admin parancsok útmutatót.

Pluginok frissítése

Egy plugin újabb verzióra frissítéséhez:

1. Töltsd le a frissített .cs fájlt a plugin oldaláról a umod.org-on.
2. Töltsd fel az új fájlt az oxide/plugins/ könyvtárba, felülírva a meglévő fájlt.
3. Ha a szerver fut, az Oxide észleli a fájl változást és automatikusan újrafordítja és újratölti a plugint. Alternatívaként futtasd az oxide.reload PluginName parancsot.
4. Ellenőrizd a konzolt hibákért. Egyes plugin frissítések módosításokat igényelhetnek a konfigurációs fájlban az oxide/config/ könyvtárban.

Pluginok eltávolítása

Egy plugin teljes eltávolításához:

1. Futtasd az oxide.unload PluginName parancsot a plugin eltávolításához, amíg a szerver fut.
2. Töröld a .cs fájlt az oxide/plugins/ könyvtárból.
3. Opcionálisan töröld a plugin konfigurációs fájlját az oxide/config/ és az adatfájlokat az oxide/data/ könyvtárból, ha már nincs rájuk szükséged.

Népszerű pluginok

Plugin problémák hibaelhárítása

Ha a pluginjaid nem töltődnek be, ellenőrizd a következőket:

• Győződj meg róla, hogy az Oxide telepítve van és aktív. A GPanel Startup fülén a FRAMEWORK változónak oxide-ra kell beállítva lennie. A konzol naplóban az indítás során meg kell jelennie a Loaded plugin Oxide.Core bejegyzésnek.
• A plugin fájloknak közvetlenül az oxide/plugins/ könyvtárban kell lenniük, pontosan .cs kiterjesztéssel. Az alkönyvtárakban lévő vagy rossz kiterjesztésű fájlok figyelmen kívül lesznek hagyva.
• Ellenőrizd a konzolt és az oxide/logs/ könyvtárat fordítási hibákért. Egy szintaktikai hibát tartalmazó plugin nem töltődik be, és a hibaüzenet leírja a problémát.
• Egyes pluginok más pluginoktól függenek (pl. sok bolt plugin az Economics-ot igényli). Először telepítsd az összes szükséges függőséget.

További gyakori szerver problémákért tekintsd meg a Rust szerver hibaelhárítás útmutatót.

Segítségre van szükséged?

Ha olyan problémába ütközöl, amelyet ez az útmutató nem tárgyal, támogatási csapatunk készséggel áll rendelkezésedre. Küldj egy támogatási jegyet és mellékeld a szerver azonosítódat, a probléma leírását és a releváns konzol kimenetet.