Denne veiledningen beskriver hvordan du installerer modding-rammeverket Oxide/uMod eller Carbon på Rust-serveren din, legger til community-plugins og administrerer dem via konsollen. For generell serverkonfigurasjon og oppstartsvariabler, se Konfigurasjonsveiledning for Rust-server.

Installere Oxide/uMod eller Carbon

Oxide (som nå vedlikeholdes som uMod) og Carbon er modding-rammeverk for Rust som lar deg installere plugins bygget av community-et. Disse rammeverkene legger til funksjoner som økonomisystemer, egendefinerte kits, stemmebelønninger, PvE-beskyttelsessoner og mye mer.

Du trenger ikke laste opp noen filer manuelt. Modding-rammeverket installeres automatisk ved å sette en enkelt oppstartsvariabel:

1. Stopp serveren din fra fanen Console i GPanel.
2. Logg inn på GPanel og gå til fanen Startup.
3. Finn variabelen FRAMEWORK og sett den til:
   • oxide — for Oxide/uMod (det mest brukte rammeverket, med det største plugin-biblioteket)
   • carbon — for Carbon-rammeverket (et alternativ med sitt eget plugin-økosystem)
   • vanilla — for å kjøre uten noe modding-rammeverk
4. Start serveren. Rammeverkfilene lastes ned og tas i bruk automatisk. Ved første oppstart med Oxide genereres katalogstrukturen oxide/.
5. Sjekk konsolloggen etter en linje som Loaded plugin Oxide.Core for å bekrefte at Oxide er aktiv.

Installere plugins

Plugins distribueres som .cs-filer (C#-kildekode). Oxide kompilerer dem på serveren ved kjøretid — ingen forhåndskompilering er nødvendig.

1. Last ned plugin-filen .cs fra umod.org eller en annen pålitelig kilde.
2. Last opp .cs-filen til katalogen oxide/plugins/ på serveren din ved hjelp av SFTP eller filbehandleren i GPanel. For hjelp med SFTP, se Slik laster du opp filer via SFTP.
3. Hvis serveren kjører, oppdages og kompileres pluginen automatisk i løpet av noen sekunder. Du vil se utdata i konsollen som bekrefter at den ble lastet inn, f.eks. Loaded plugin MyPlugin v1.2.3 by Author.
4. Hvis serveren ikke kjører, lastes pluginen inn ved neste oppstart.

Katalogstruktur for Oxide

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

Konfigurere plugins

De fleste plugins genererer en JSON-konfigurasjonsfil i oxide/config/ første gang de lastes inn. Slik tilpasser du en plugin:

1. La pluginen lastes inn minst én gang slik at den genererer sin standard konfigurasjonsfil.
2. Stopp serveren din (eller merk at enkelte plugins støtter live config-omlasting).
3. Åpne pluginens konfigurasjonsfil i oxide/config/PluginName.json ved hjelp av filbehandleren i GPanel eller SFTP.
4. Rediger innstillingene og lagre filen.
5. Last pluginen på nytt med oxide.reload PluginName eller start serveren på nytt.

Administrere plugins via konsollen

Disse kommandoene kan kjøres fra GPanel-konsollen eller via en RCON-klient. For RCON-oppsett, se RCON-tilgang og admin-kommandoer for Rust.

Oppdatere plugins

Slik oppdaterer du en plugin til en nyere versjon:

1. Last ned den oppdaterte .cs-filen fra pluginens side på umod.org.
2. Last opp den nye filen til oxide/plugins/, og overskriv den eksisterende filen.
3. Hvis serveren kjører, oppdager Oxide filendringen og rekompilerer og laster pluginen på nytt automatisk. Alternativt kan du kjøre oxide.reload PluginName.
4. Sjekk konsollen for eventuelle feil. Enkelte plugin-oppdateringer kan kreve endringer i konfigurasjonsfilen i oxide/config/.

Fjerne plugins

Slik fjerner du en plugin fullstendig:

1. Kjør oxide.unload PluginName for å laste ut pluginen mens serveren kjører.
2. Slett .cs-filen fra oxide/plugins/.
3. Eventuelt kan du slette pluginens konfigurasjonsfil fra oxide/config/ og datafiler fra oxide/data/ hvis du ikke lenger trenger dem.

Populære plugins

Feilsøking av plugin-problemer

Hvis pluginene dine ikke lastes inn, sjekk følgende:

• Bekreft at Oxide er installert og aktiv. I fanen Startup i GPanel må variabelen FRAMEWORK være satt til oxide. Konsolloggen skal vise Loaded plugin Oxide.Core under oppstart.
• Plugin-filer må plasseres direkte i oxide/plugins/ med den nøyaktige filtypen .cs. Filer i underkataloger eller med feil filtype ignoreres.
• Sjekk konsollen og oxide/logs/ for kompileringsfeil. En plugin med en syntaksfeil vil ikke lastes inn, og feilmeldingen vil beskrive problemet.
• Enkelte plugins har avhengigheter til andre plugins (f.eks. krever mange shop-plugins Economics). Installer alle nødvendige avhengigheter først.

For andre vanlige serverproblemer, se Feilsøking av Rust-server.

Trenger du hjelp?

Hvis du støter på et problem som ikke dekkes i denne veiledningen, er supportteamet vårt tilgjengelig for å hjelpe. Send inn en supportsak og inkluder server-ID-en din, en beskrivelse av problemet og eventuell relevant konsollutdata.