Denne guide dækker, hvordan du installerer Oxide/uMod eller Carbon modding-frameworket på din Rust-server, tilføjer community-plugins og administrerer dem via konsollen. For generel serverkonfiguration og opstartsvariabler, se Rust Serverkonfigurationsguide.

Installation af Oxide/uMod eller Carbon

Oxide (nu vedligeholdt som uMod) og Carbon er modding-frameworks til Rust, der giver dig mulighed for at installere community-byggede plugins. Disse frameworks tilføjer funktioner som økonomisystemer, brugerdefinerede kits, afstemningsbelønninger, PvE-beskyttelseszoner og meget mere.

Du behøver ikke at uploade nogen filer manuelt. Modding-frameworket installeres automatisk ved at indstille en enkelt opstartsvariabel:

1. Stop din server fra GPanel-fanen Console.
2. Log ind på GPanel og gå til fanen Startup.
3. Find variablen FRAMEWORK og sæt den til:
   • oxide — for Oxide/uMod (det mest udbredte framework med det største plugin-bibliotek)
   • carbon — for Carbon-frameworket (et alternativ med sit eget plugin-økosystem)
   • vanilla — for at køre uden noget modding-framework
4. Start serveren. Framework-filerne downloades og anvendes automatisk. Ved første start med Oxide genereres mappestrukturen oxide/.
5. Tjek konsolloggen for en linje som Loaded plugin Oxide.Core for at bekræfte, at Oxide er aktiv.

Installation af plugins

Plugins distribueres som .cs (C# kildekode) filer. Oxide kompilerer dem på serveren under kørsel — ingen forudkompilering er nødvendig.

1. Download plugin .cs-filen fra umod.org eller en anden betroet kilde.
2. Upload .cs-filen til mappen oxide/plugins/ på din server ved hjælp af SFTP eller GPanel filhåndtering. For hjælp med SFTP, se Sådan uploader du filer via SFTP.
3. Hvis serveren kører, vil pluginet blive registreret og kompileret automatisk inden for få sekunder. Du vil se output i konsollen, der bekræfter indlæsningen, f.eks. Loaded plugin MyPlugin v1.2.3 by Author.
4. Hvis serveren ikke kører, vil pluginet indlæses ved næste opstart.

Oxide mappestruktur

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

Konfiguration af plugins

De fleste plugins genererer en JSON-konfigurationsfil i oxide/config/, første gang de indlæses. For at tilpasse et plugin:

1. Lad pluginet indlæse mindst én gang, så det genererer sin standardkonfigurationsfil.
2. Stop din server (eller bemærk, at nogle plugins understøtter genindlæsning af konfiguration under kørsel).
3. Åbn pluginets konfigurationsfil i oxide/config/PluginName.json ved hjælp af GPanel filhåndtering eller SFTP.
4. Rediger indstillingerne og gem filen.
5. Genindlæs pluginet med oxide.reload PluginName eller genstart serveren.

Administration af plugins via konsol

Disse kommandoer kan køres fra GPanel-konsollen eller via en RCON-klient. For RCON-opsætning, se Rust RCON-adgang og admin-kommandoer.

Opdatering af plugins

For at opdatere et plugin til en nyere version:

1. Download den opdaterede .cs-fil fra pluginets side på umod.org.
2. Upload den nye fil til oxide/plugins/ og overskriv den eksisterende fil.
3. Hvis serveren kører, registrerer Oxide filændringen og genkompilerer og genindlæser automatisk pluginet. Alternativt kan du køre oxide.reload PluginName.
4. Tjek konsollen for eventuelle fejl. Nogle plugin-opdateringer kan kræve ændringer i konfigurationsfilen i oxide/config/.

Fjernelse af plugins

For at fjerne et plugin helt:

1. Kør oxide.unload PluginName for at fjerne indlæsningen af pluginet, mens serveren kører.
2. Slet .cs-filen fra oxide/plugins/.
3. Slet eventuelt pluginets konfigurationsfil fra oxide/config/ og datafiler fra oxide/data/, hvis du ikke længere har brug for dem.

Populære plugins

Fejlfinding af plugin-problemer

Hvis dine plugins ikke indlæses, tjek følgende:

• Bekræft, at Oxide er installeret og aktiv. I GPanel's Startup-fane skal variablen FRAMEWORK være sat til oxide. Konsolloggen bør vise Loaded plugin Oxide.Core under opstart.
• Plugin-filer skal placeres direkte i oxide/plugins/ med den præcise .cs-filendelse. Filer i undermapper eller med forkerte filendelser ignoreres.
• Tjek konsollen og oxide/logs/ for kompileringsfejl. Et plugin med en syntaksfejl vil ikke kunne indlæses, og fejlmeddelelsen vil beskrive problemet.
• Nogle plugins har afhængigheder af andre plugins (f.eks. kræver mange butiksplugins Economics). Installer alle nødvendige afhængigheder først.

For andre almindelige serverproblemer, se Rust Server-fejlfinding.

Brug for hjælp?

Hvis du støder på et problem, der ikke er dækket i denne guide, er vores supportteam klar til at hjælpe. Indsend en supportbillet og inkluder dit server-ID, en beskrivelse af problemet og relevant konsoloutput.