Wat is Oxide/uMod?

Wat is Oxide/uMod?

Als je een Rust server draait, wil je vroeg of laat meer doen dan alleen het standaard spel aanbieden. Misschien wil je de gather rates aanpassen, een teleportatie systeem toevoegen of een chatsysteem met kleuren en rangen instellen. Dat kan allemaal met plugins, maar daarvoor heb je eerst een plugin framework nodig. En dat framework heet Oxide, ook wel bekend als uMod.

Wat is Oxide precies?

Oxide (officieel uMod genaamd) is een modding framework dat bovenop de Rust Dedicated Server wordt geinstalleerd. Het is als het ware een tussenlaag die ervoor zorgt dat plugins kunnen communiceren met de game. Zonder Oxide kun je geen plugins draaien op je Rust server.

Oxide biedt onder andere:

• Een plugin systeem -- Plugins zijn kleine stukjes code (geschreven in C#) die extra functies aan je server toevoegen.
• Een permission systeem -- Hiermee bepaal je welke spelers of groepen toegang hebben tot bepaalde functies van plugins.
• Configuratiebestanden -- Elke plugin kan zijn eigen instellingen opslaan in een JSON-bestand, zodat je alles naar wens kunt aanpassen.
• Hot reload -- Plugins worden automatisch geladen zodra je ze in de juiste map plaatst. Je hoeft je server niet te herstarten!
• Een enorme community -- Er zijn duizenden gratis plugins beschikbaar op umod.org, de officiele plugin repository.

Oxide installeren op je HytaleNode server

Bij HytaleNode is Oxide in de meeste gevallen al voorgeinstalleerd op je Rust server. Als dat niet het geval is, kun je het eenvoudig zelf activeren:

1. Ga naar mijn.hytalenode.nl en log in op je account.
2. Klik op je Rust server in het overzicht.
3. Ga naar het tabblad Startup in het linkermenu.
4. Zoek de instelling Mod Framework (of Oxide).
5. Selecteer Oxide in het dropdown-menu.
6. Ga terug naar de Console tab en klik op Herstarten.
7. De server downloadt en installeert Oxide automatisch bij het opstarten. Dit duurt meestal slechts een paar seconden extra.

Afbeelding: hier moet afbeelding komen met screenshot van de Startup tab in het HytaleNode paneel met de Mod Framework instelling op Oxide

Tip: Na het herstarten zie je in de console berichten verschijnen die beginnen met [Oxide]. Dit bevestigt dat Oxide correct is geinstalleerd en actief is.

De Oxide mapstructuur

Zodra Oxide is geinstalleerd, wordt er automatisch een map genaamd oxide aangemaakt in de hoofdmap van je server. Deze map bevat alles wat met plugins te maken heeft. Hier is een overzicht van de belangrijkste submappen:

• oxide/plugins/ -- Dit is de map waar al je plugins naartoe gaan. Plugins zijn .cs bestanden (C# broncode). Zodra je een plugin in deze map plaatst, wordt deze automatisch geladen door Oxide.
• oxide/config/ -- Hier worden de configuratiebestanden van je plugins opgeslagen. Elke plugin maakt automatisch een eigen .json bestand aan wanneer deze voor het eerst wordt geladen. In deze bestanden pas je de instellingen van je plugins aan.
• oxide/data/ -- In deze map slaan plugins hun data op. Denk aan spelergegevens, economie-gegevens, teleportatie-locaties en andere informatie die bewaard moet blijven tussen server herstarts.
• oxide/logs/ -- Hier vind je logbestanden van Oxide en je plugins. Handig als je problemen wilt opsporen of wilt zien wat er op je server gebeurt.
• oxide/lang/ -- Bevat taalbestanden van plugins. Hiermee kun je de berichten die plugins naar spelers sturen vertalen of aanpassen.

Afbeelding: hier moet afbeelding komen met screenshot van de oxide map in de Bestanden tab van het HytaleNode paneel met de submappen zichtbaar

Hoe weet ik of Oxide werkt?

Om te controleren of Oxide correct draait op je server, kun je het volgende doen:

1. Ga naar de Console tab van je server in het HytaleNode paneel.
2. Typ het commando oxide.version in het invoerveld en druk op Enter.
3. Als Oxide correct is geinstalleerd, zie je een bericht met het versienummer van Oxide, bijvoorbeeld: Oxide version 2.0.XXXX.

Je kunt ook het commando oxide.plugins gebruiken om een lijst te zien van alle geladen plugins. Als Oxide net is geinstalleerd en je nog geen plugins hebt toegevoegd, is deze lijst leeg -- en dat is prima. In het volgende artikel leggen we uit hoe je je eerste plugin installeert!

Samengevat: Oxide/uMod is de motor achter alle Rust plugins. Het is gratis, wordt actief onderhouden en is essentieel voor elke Rust server die meer wil bieden dan het standaard spel. Bij HytaleNode is het eenvoudig te activeren via de Startup tab, en zodra het draait kun je aan de slag met het installeren van plugins.