Plugins configureren

De meeste Rust plugins werken direct na installatie, maar de echte kracht zit in het configureren ervan. Door de instellingen van een plugin aan te passen, maak je jouw server uniek. In dit artikel leggen we uit hoe configuratiebestanden werken, hoe je ze bewerkt en waar je op moet letten.

Hoe werken configuratiebestanden?

Elke Oxide plugin die configureerbare instellingen heeft, maakt automatisch een configuratiebestand aan wanneer de plugin voor het eerst wordt geladen. Dit bestand wordt opgeslagen in de map oxide/config/ en heeft dezelfde naam als de plugin, met de extensie .json.

Bijvoorbeeld:

De plugin GatherManager.cs maakt het configuratiebestand oxide/config/GatherManager.json aan.
De plugin NTeleportation.cs maakt het configuratiebestand oxide/config/NTeleportation.json aan.

Belangrijk: Het configuratiebestand wordt pas aangemaakt nadat de plugin voor het eerst succesvol is geladen. Als je geen configuratiebestand ziet, controleer dan eerst of de plugin correct is geinstalleerd en zonder fouten draait.

Een configuratiebestand openen en bewerken

Je kunt configuratiebestanden bewerken via de ingebouwde bestandseditor in het HytaleNode paneel:

Ga naar mijn.hytalenode.nl en log in.
Klik op je Rust server.
Ga naar het tabblad Bestanden.
Navigeer naar oxide > config.
Klik op het .json bestand van de plugin die je wilt configureren.
Het bestand opent in de ingebouwde teksteditor waar je de instellingen kunt aanpassen.

JSON basics: hoe lees je een configuratiebestand?

Configuratiebestanden zijn geschreven in JSON (JavaScript Object Notation). Dat klinkt technisch, maar het is eigenlijk heel simpel. Hier is een voorbeeld van hoe een configuratiebestand eruit kan zien:

{
  "Gather Rates": {
    "Wood": 2.0,
    "Stone": 2.0,
    "Metal Ore": 3.0,
    "Sulfur Ore": 3.0
  },
  "Enable Pickup Messages": true,
  "Message Color": "#ffffff"
}

Laten we de basis van JSON doornemen:

Accolades { } -- Groeperen instellingen bij elkaar. Elk configuratiebestand begint en eindigt met accolades.
Aanhalingstekens " " -- Tekst (strings) staat altijd tussen dubbele aanhalingstekens. Dit geldt voor zowel de naam van een instelling als de waarde (als het tekst is).
Komma's , -- Elke instelling wordt gescheiden door een komma, behalve de laatste instelling in een groep.
Getallen -- Getallen staan zonder aanhalingstekens. Decimalen gebruik je met een punt (niet een komma): 2.5.
true / false -- Dit zijn aan/uit waarden (booleans). Ze staan zonder aanhalingstekens en altijd in kleine letters.
Dubbele punt : -- Scheidt de naam van een instelling van de waarde: "Naam": waarde.

Veelgemaakte JSON fouten

Een kleine typfout in een JSON-bestand kan ervoor zorgen dat de hele configuratie niet meer wordt ingelezen. Let op deze veelgemaakte fouten:

Ontbrekende komma -- Vergeet geen komma te plaatsen na elke instelling, behalve de allerlaatste.
Extra komma -- Een komma na de laatste instelling in een groep veroorzaakt een fout. Dit is een van de meest voorkomende fouten.
Ontbrekende aanhalingstekens -- Tekst moet altijd tussen dubbele aanhalingstekens staan.
Verkeerde haakjes -- Zorg dat elke { een bijbehorende } heeft, en elke [ een bijbehorende ].

Tip: Als je twijfelt of je JSON correct is, kun je een gratis online JSON validator gebruiken. Ga naar jsonlint.com, plak je configuratie erin en klik op "Validate JSON". De tool laat precies zien waar eventuele fouten zitten.

Wijzigingen doorvoeren: plugin herladen

Nadat je een configuratiebestand hebt aangepast en opgeslagen, moet je de plugin herladen zodat de nieuwe instellingen worden ingelezen. Dit doe je via de console:

Sla het configuratiebestand op door op de Opslaan knop te klikken in de bestandseditor.
Ga naar de Console tab van je server.
Typ het commando oxide.reload PluginNaam en druk op Enter.

Vervang PluginNaam door de exacte naam van de plugin. Bijvoorbeeld:

oxide.reload GatherManager -- Herlaadt de Gather Manager plugin.
oxide.reload NTeleportation -- Herlaadt de NTeleportation plugin.
oxide.reload BetterChat -- Herlaadt de BetterChat plugin.

Belangrijk: Je hoeft je server niet volledig te herstarten om configuratiewijzigingen door te voeren. Het herladen van een individuele plugin is voldoende en veel sneller. Spelers merken hier niets van.

Standaardconfiguratie herstellen

Heb je per ongeluk een configuratiebestand verpest en wil je terug naar de standaardinstellingen? Dat kan eenvoudig:

Ga naar Bestanden > oxide > config.
Verwijder het configuratiebestand van de plugin (bijvoorbeeld GatherManager.json).
Ga naar de Console tab en herlaad de plugin met oxide.reload PluginNaam.
Oxide maakt automatisch een nieuw configuratiebestand aan met de standaardinstellingen.

Tip: Maak altijd een backup van je configuratiebestand voordat je grote wijzigingen aanbrengt. Je kunt het bestand kopieren of de inhoud in een tekstbestand op je computer opslaan. Zo kun je altijd terug naar een werkende versie.

Voorbeeld: Gather Manager configureren

Laten we als voorbeeld de populaire Gather Manager plugin configureren om de gather rates te verhogen. Open het bestand oxide/config/GatherManager.json en zoek naar de gather rate instellingen:

{
  "Options": {
    "Use Permission": false
  },
  "Gather Rates": {
    "Wood": 1.0,
    "Stones": 1.0,
    "Metal Ore": 1.0,
    "Sulfur Ore": 1.0,
    "HQM Ore": 1.0
  }
}

Wil je dat spelers drie keer zoveel resources verzamelen? Verander dan alle waarden naar 3.0:

{
  "Options": {
    "Use Permission": false
  },
  "Gather Rates": {
    "Wood": 3.0,
    "Stones": 3.0,
    "Metal Ore": 3.0,
    "Sulfur Ore": 3.0,
    "HQM Ore": 3.0
  }
}

Sla het bestand op en typ oxide.reload GatherManager in de console. De nieuwe gather rates zijn direct actief!

Plugins configureren