Plugins installeren

Nu Oxide draait op je Rust server, is het tijd om je eerste plugin te installeren. Plugins voegen extra functies toe aan je server, van aangepaste gather rates tot teleportatie en chatsystemen. In dit artikel leggen we stap voor stap uit hoe je plugins vindt, downloadt en installeert op je HytaleNode Rust server.

Methode 1: Via de Plugins-browser (aanbevolen)

De snelste manier is de ingebouwde plugin-browser in het panel. Die doorzoekt de uMod-bibliotheek en installeert plugins met één klik.

Ga naar mijn.hytalenode.nl en open je Rust-server
Klik in het linkermenu op Plugins (route /plugins)
Op het tabblad Bibliotheek zoek je een plugin op naam of blader je door populaire plugins
Klik op Installeren naast de gewenste plugin - het .cs-bestand wordt automatisch geplaatst in oxide/plugins/
Oxide laadt de plugin direct (hot reload) - herstarten is meestal niet nodig

Op het tabblad Geïnstalleerd zie je alle plugins op je server. Per plugin kun je de config bewerken, updaten, uitschakelen of verwijderen.

Let op: gratis plugins van uMod.org kun je direct installeren. Betaalde plugins moet je zelf uploaden via de Bestanden tab.

Stap 1: Een plugin zoeken op umod.org (handmatig)

Alle Oxide plugins voor Rust zijn te vinden op umod.org, de officiele plugin repository. Hier vind je duizenden gratis plugins die door de community zijn gemaakt.

Open je browser en ga naar umod.org.
Klik bovenin op Plugins en selecteer het spel Rust.
Gebruik de zoekbalk om een specifieke plugin te zoeken (bijvoorbeeld "Teleportation" of "Gather Manager").
Je kunt ook door de categorieeen bladeren of sorteren op populariteit, downloads of datum.

Op de pagina van elke plugin vind je belangrijke informatie:

Beschrijving -- Wat de plugin precies doet.
Permissions -- Welke permissions de plugin gebruikt (nodig voor het instellen van rechten).
Configuratie -- Welke instellingen je kunt aanpassen.
Commands -- Welke commando's de plugin toevoegt.
Downloads -- Het totale aantal downloads, een goede indicatie van de populariteit en betrouwbaarheid.

Tip: Kies bij voorkeur plugins die recent zijn bijgewerkt en veel downloads hebben. Dit betekent dat ze actief worden onderhouden en goed getest zijn.

Stap 2: De plugin downloaden

Als je een plugin hebt gevonden die je wilt gebruiken:

Ga naar de pagina van de plugin op umod.org.
Klik op de Download knop.
Er wordt een .cs bestand gedownload naar je computer. Dit is het plugin-bestand.

Let op: Download plugins alleen van umod.org. Plugins van onbekende bronnen kunnen schadelijke code bevatten die je server of spelergegevens in gevaar brengt.

Stap 3: De plugin uploaden via de Bestanden tab

Nu ga je het gedownloade plugin-bestand uploaden naar je server:

Ga naar mijn.hytalenode.nl en log in.
Klik op je Rust server.
Ga naar het tabblad Bestanden in het linkermenu.
Navigeer naar de map oxide en open daarna de map plugins.
Klik op de Uploaden knop bovenaan de pagina.
Selecteer het .cs bestand dat je zojuist hebt gedownload.
Wacht tot de upload is voltooid.

En dat is het! Zodra het bestand is geupload, detecteert Oxide automatisch de nieuwe plugin en laadt deze in. Dit noemen we hot reload -- je hoeft je server niet te herstarten. De plugin is direct actief.

Stap 4: Controleren of de plugin werkt

Na het uploaden wil je natuurlijk weten of de plugin correct is geladen. Dit kun je op twee manieren controleren:

Via de console

Ga naar de Console tab van je server.
Bekijk de console-output. Als de plugin succesvol is geladen, zie je een bericht zoals: [Oxide] Loaded plugin PluginNaam v1.0.0 by Auteur.
Als er een fout is opgetreden, zie je een rode foutmelding. Lees deze goed door -- vaak geeft het aan wat er mis is (bijvoorbeeld een ontbrekende dependency of een verouderde plugin).

Via het oxide.plugins commando

Ga naar de Console tab.
Typ het commando oxide.plugins en druk op Enter.
Je ziet nu een lijst van alle geladen plugins met hun versienummer en status.

Meerdere plugins tegelijk installeren via SFTP

Als je meerdere plugins tegelijk wilt installeren, is de Bestanden tab in het paneel niet de snelste methode. In dat geval kun je SFTP gebruiken om bestanden rechtstreeks naar je server te uploaden.

Download een SFTP-client zoals FileZilla (gratis) of WinSCP.
In het HytaleNode paneel, ga naar Instellingen in het linkermenu.
Hier vind je je SFTP-gegevens: het serveradres, de poort, je gebruikersnaam en wachtwoord.
Open je SFTP-client en maak verbinding met deze gegevens.
Navigeer naar de map /oxide/plugins/.
Sleep al je .cs bestanden naar deze map.
Alle plugins worden automatisch geladen zodra ze zijn geupload.

Tip: SFTP is ook handig voor het maken van backups van je plugins en configuratiebestanden. Sleep de mappen oxide/plugins/ en oxide/config/ naar je computer om alles veilig op te slaan.

Een plugin verwijderen

Wil je een plugin verwijderen? Dat is net zo eenvoudig als installeren:

Ga naar Bestanden > oxide > plugins.
Zoek het .cs bestand van de plugin die je wilt verwijderen.
Klik op de drie puntjes rechts naast het bestand en kies Verwijderen.
De plugin wordt direct uitgeladen door Oxide.

Let op: Het configuratiebestand in oxide/config/ en eventuele data in oxide/data/ worden niet automatisch verwijderd. Dit is handig als je de plugin later opnieuw wilt installeren met dezelfde instellingen. Wil je alles opruimen? Verwijder dan ook het bijbehorende config- en databestand handmatig.

Veelvoorkomende problemen

Plugin laadt niet: Controleer of het bestand de extensie .cs heeft en niet per ongeluk .cs.txt is geworden bij het downloaden.
Foutmelding in console: Lees de foutmelding goed. Vaak ontbreekt een dependency (een andere plugin die vereist is). Installeer de ontbrekende plugin en probeer het opnieuw.
Plugin is verouderd: Als een plugin niet compatibel is met de nieuwste versie van Rust of Oxide, kan deze fouten veroorzaken. Controleer op umod.org of er een update beschikbaar is.
Oxide niet geinstalleerd: Als je geen oxide map ziet, is Oxide waarschijnlijk niet actief. Ga terug naar het vorige artikel om Oxide te activeren.