Den här guiden beskriver hur du installerar moddningsramverket Oxide/uMod eller Carbon på din Rust-server, lägger till community-plugins och hanterar dem via konsolen. För allmän serverkonfiguration och startvariabler, se Konfigurationsguide för Rust-server.

Installera Oxide/uMod eller Carbon

Oxide (numera underhållet som uMod) och Carbon är moddningsramverk för Rust som låter dig installera community-byggda plugins. Dessa ramverk lägger till funktioner som ekonomisystem, anpassade kit, röstbelöningar, PvE-skyddszoner och mycket mer.

Du behöver inte ladda upp några filer manuellt. Moddningsramverket installeras automatiskt genom att ställa in en enda startvariabel:

1. Stoppa din server från fliken Console i GPanel.
2. Logga in på GPanel och gå till fliken Startup.
3. Hitta variabeln FRAMEWORK och ställ in den på:
   • oxide — för Oxide/uMod (det mest använda ramverket, med det största pluginbiblioteket)
   • carbon — för Carbon-ramverket (ett alternativ med sitt eget pluginekosystem)
   • vanilla — för att köra utan något moddningsramverk
4. Starta servern. Ramverksfilerna laddas ner och tillämpas automatiskt. Vid första starten med Oxide genereras katalogstrukturen oxide/.
5. Kontrollera konsolloggen efter en rad som Loaded plugin Oxide.Core för att bekräfta att Oxide är aktivt.

Installera plugins

Plugins distribueras som .cs-filer (C#-källkod). Oxide kompilerar dem på servern vid körning — ingen förkompilering krävs.

1. Ladda ner plugin-filen .cs från umod.org eller en annan betrodd källa.
2. Ladda upp .cs-filen till katalogen oxide/plugins/ på din server med SFTP eller filhanteraren i GPanel. För hjälp med SFTP, se Så laddar du upp filer via SFTP.
3. Om servern körs upptäcks och kompileras plugin-filen automatiskt inom några sekunder. Du kommer att se utdata i konsolen som bekräftar att den laddades, t.ex. Loaded plugin MyPlugin v1.2.3 by Author.
4. Om servern inte körs laddas plugin-filen vid nästa start.

Oxides katalogstruktur

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

Konfigurera plugins

De flesta plugins genererar en JSON-konfigurationsfil i oxide/config/ första gången de laddas. Så här anpassar du ett plugin:

1. Låt plugin-filen laddas minst en gång så att den genererar sin standardkonfigurationsfil.
2. Stoppa din server (eller observera att vissa plugins stöder omladdning av konfiguration i realtid).
3. Öppna pluginets konfigurationsfil i oxide/config/PluginName.json med filhanteraren i GPanel eller SFTP.
4. Redigera inställningarna och spara filen.
5. Ladda om pluginet med oxide.reload PluginName eller starta om servern.

Hantera plugins via konsolen

Dessa kommandon kan köras från GPanel-konsolen eller via en RCON-klient. För RCON-installation, se Rust RCON-åtkomst och administratörskommandon.

Uppdatera plugins

Så här uppdaterar du ett plugin till en nyare version:

1. Ladda ner den uppdaterade .cs-filen från pluginets sida på umod.org.
2. Ladda upp den nya filen till oxide/plugins/ och skriv över den befintliga filen.
3. Om servern körs upptäcker Oxide filändringen och kompilerar och laddar om pluginet automatiskt. Alternativt kan du köra oxide.reload PluginName.
4. Kontrollera konsolen efter eventuella fel. Vissa plugin-uppdateringar kan kräva ändringar i konfigurationsfilen i oxide/config/.

Ta bort plugins

Så här tar du bort ett plugin helt:

1. Kör oxide.unload PluginName för att avlasta pluginet medan servern körs.
2. Radera .cs-filen från oxide/plugins/.
3. Radera eventuellt pluginets konfigurationsfil från oxide/config/ och datafiler från oxide/data/ om du inte längre behöver dem.

Populära plugins

Felsökning av plugin-problem

Om dina plugins inte laddas, kontrollera följande:

• Bekräfta att Oxide är installerat och aktivt. På fliken Startup i GPanel måste variabeln FRAMEWORK vara inställd på oxide. Konsolloggen bör visa Loaded plugin Oxide.Core under starten.
• Plugin-filer måste placeras direkt i oxide/plugins/ med den exakta filändelsen .cs. Filer i underkataloger eller med fel filändelser ignoreras.
• Kontrollera konsolen och oxide/logs/ efter kompileringsfel. Ett plugin med ett syntaxfel kommer inte att laddas och felmeddelandet beskriver problemet.
• Vissa plugins har beroenden till andra plugins (t.ex. kräver många butiksplugins Economics). Installera alla nödvändiga beroenden först.

För andra vanliga serverproblem, se Felsökning av Rust-server.

Behöver du hjälp?

Om du stöter på ett problem som inte täcks i den här guiden finns vårt supportteam tillgängligt för att hjälpa till. Skicka in ett supportärende och inkludera ditt server-ID, en beskrivning av problemet och eventuell relevant konsolutdata.