Deze gids behandelt hoe je het Oxide/uMod of Carbon moddingframework op je Rust server installeert, communityplugins toevoegt en ze beheert via de console. Voor algemene serverconfiguratie en opstartvariabelen, zie de Rust Server Configuratiegids.

Oxide/uMod of Carbon Installeren

Oxide (nu onderhouden als uMod) en Carbon zijn moddingframeworks voor Rust waarmee je door de community gebouwde plugins kunt installeren. Deze frameworks voegen functies toe zoals economiesystemen, aangepaste kits, stembeloningen, PvE-beschermingszones en nog veel meer.

Je hoeft geen bestanden handmatig te uploaden. Het moddingframework wordt automatisch geïnstalleerd door één opstartvariabele in te stellen:

1. Stop je server vanuit het GPanel Console-tabblad.
2. Log in op GPanel en ga naar het tabblad Startup.
3. Zoek de FRAMEWORK variabele en stel deze in op:
   • oxide — voor Oxide/uMod (het meest gebruikte framework, met de grootste pluginbibliotheek)
   • carbon — voor het Carbon framework (een alternatief met een eigen plugin-ecosysteem)
   • vanilla — om zonder moddingframework te draaien
4. Start de server. De frameworkbestanden worden automatisch gedownload en toegepast. Bij de eerste start met Oxide wordt de oxide/ mapstructuur aangemaakt.
5. Controleer het consolelog op een regel zoals Loaded plugin Oxide.Core om te bevestigen dat Oxide actief is.

Plugins Installeren

Plugins worden gedistribueerd als .cs (C# broncode) bestanden. Oxide compileert ze op de server tijdens runtime — er is geen pre-compilatie vereist.

1. Download het plugin .cs-bestand van umod.org of een andere vertrouwde bron.
2. Upload het .cs-bestand naar de map oxide/plugins/ op je server via SFTP of de GPanel bestandsbeheerder. Voor hulp met SFTP, zie Bestanden Uploaden via SFTP.
3. Als de server draait, wordt de plugin automatisch binnen enkele seconden gedetecteerd en gecompileerd. Je ziet uitvoer in de console die bevestigt dat deze is geladen, bijv. Loaded plugin MyPlugin v1.2.3 by Author.
4. Als de server niet draait, wordt de plugin bij de volgende opstart geladen.

Oxide Mapstructuur

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

Plugins Configureren

De meeste plugins genereren een JSON-configuratiebestand in oxide/config/ de eerste keer dat ze laden. Om een plugin aan te passen:

1. Laat de plugin minstens één keer laden zodat het zijn standaard configuratiebestand aanmaakt.
2. Stop je server (of let op dat sommige plugins live config-herlaadbeurt ondersteunen).
3. Open het configuratiebestand van de plugin in oxide/config/PluginName.json via de GPanel bestandsbeheerder of SFTP.
4. Bewerk de instellingen en sla het bestand op.
5. Herlaad de plugin met oxide.reload PluginName of herstart de server.

Plugins Beheren via Console

Deze commando's kunnen worden uitgevoerd vanuit de GPanel console of via een RCON-client. Voor RCON-configuratie, zie Rust RCON Toegang en Admin Commando's.

Plugins Bijwerken

Om een plugin bij te werken naar een nieuwere versie:

1. Download het bijgewerkte .cs-bestand van de pluginpagina op umod.org.
2. Upload het nieuwe bestand naar oxide/plugins/, waarbij het bestaande bestand wordt overschreven.
3. Als de server draait, detecteert Oxide de bestandswijziging en hercompileert en herlaadt de plugin automatisch. Je kunt ook oxide.reload PluginName uitvoeren.
4. Controleer de console op fouten. Sommige pluginupdates vereisen mogelijk wijzigingen in het configuratiebestand in oxide/config/.

Plugins Verwijderen

Om een plugin volledig te verwijderen:

1. Voer oxide.unload PluginName uit om de plugin te ontladen terwijl de server draait.
2. Verwijder het .cs-bestand uit oxide/plugins/.
3. Verwijder optioneel het configuratiebestand van de plugin uit oxide/config/ en gegevensbestanden uit oxide/data/ als je ze niet meer nodig hebt.

Populaire Plugins

Problemen met Plugins Oplossen

Als je plugins niet laden, controleer dan het volgende:

• Bevestig dat Oxide is geïnstalleerd en actief is. In het GPanel Startup-tabblad moet de FRAMEWORK variabele zijn ingesteld op oxide. Het consolelog zou Loaded plugin Oxide.Core moeten tonen tijdens het opstarten.
• Pluginbestanden moeten direct in oxide/plugins/ worden geplaatst met exact de .cs extensie. Bestanden in submappen of met verkeerde extensies worden genegeerd.
• Controleer de console en oxide/logs/ op compilatiefouten. Een plugin met een syntaxfout zal niet laden en het foutbericht beschrijft het probleem.
• Sommige plugins hebben afhankelijkheden van andere plugins (bijv. veel winkelplugins vereisen Economics). Installeer eerst alle vereiste afhankelijkheden.

Voor andere veelvoorkomende serverproblemen, zie Rust Server Probleemoplossing.

Hulp Nodig?

Als je een probleem tegenkomt dat niet in deze gids wordt behandeld, staat ons supportteam klaar om te helpen. Dien een supportticket in en vermeld je server-ID, een beschrijving van het probleem en eventuele relevante console-uitvoer.