Plugins configureren

De meeste plugins werken direct na installatie met standaardinstellingen. Maar om het maximale uit je plugins te halen, wil je ze configureren naar jouw wensen. In dit artikel leggen we uit hoe config bestanden werken en hoe je ze aanpast via het HytaleNode panel.

Wat zijn config bestanden?

Wanneer een plugin voor het eerst wordt geladen, maakt deze automatisch een eigen map aan in de plugins directory. In die map staan de configuratiebestanden van de plugin. De structuur ziet er zo uit:

plugins/
├── EssentialsX/
│   ├── config.yml
│   ├── messages.properties
│   └── ...
├── LuckPerms/
│   ├── config.yml
│   └── ...
├── EssentialsX.jar
├── LuckPerms.jar
└── ...

Het belangrijkste bestand is bijna altijd config.yml. Dit is een tekstbestand in YAML-formaat waarin alle instellingen van de plugin staan. Sommige plugins hebben meerdere configuratiebestanden voor verschillende onderdelen.

Config bestanden bewerken via het panel

Je kunt configuratiebestanden direct bewerken in de bestandsbeheerder van het HytaleNode panel. Dit is de makkelijkste manier en je hebt geen extra programma nodig.

Log in op mijn.hytalenode.nl en selecteer je server.
Ga naar de Bestanden tab.
Open de plugins map.
Klik op de map van de plugin die je wilt configureren (bijvoorbeeld EssentialsX).
Klik op het bestand config.yml. Het bestand opent nu in de ingebouwde teksteditor.
Pas de instellingen aan die je wilt wijzigen.
Klik op "Opslaan" rechtsboven.
Herstart je server zodat de wijzigingen worden geladen.

YAML syntax: de basis

YAML is het formaat dat vrijwel alle Minecraft plugins gebruiken voor hun configuratie. Het is ontworpen om makkelijk leesbaar te zijn, maar er zijn een paar regels waar je je aan moet houden. Als je een fout maakt in de syntax, laadt de plugin niet correct!

De belangrijkste regels:

Gebruik spaties, NOOIT tabs – Dit is de meest voorkomende fout. YAML gebruikt spaties (meestal 2) voor inspringen. Tabs zien er hetzelfde uit maar zorgen voor errors. De teksteditor in het panel gebruikt automatisch spaties, dus als je daar bewerkt zit je goed.
Let op de dubbele punt – Elke instelling heeft het formaat sleutel: waarde. Er moet altijd een spatie staan na de dubbele punt.
Tekst met speciale tekens – Als een waarde speciale tekens bevat (zoals & voor kleurcodes), zet deze dan tussen aanhalingstekens: prefix: "&6[Admin]"
Waar/onwaar – Gebruik true of false (zonder aanhalingstekens) voor aan/uit instellingen.
Lijsten – Items in een lijst beginnen met een streepje en een spatie: - item

Voorbeeld van correcte YAML:

# Dit is een commentaarregel
server-naam: "Mijn Minecraft Server"
max-spelers: 20
pvp-ingeschakeld: true
welkomstbericht: "&aWelkom op de server!"
geblokkeerde-commando's:
  - /op
  - /deop
  - /stop

Voorbeeld van FOUTIEVE YAML:

# FOUT: tab gebruikt in plaats van spaties
server-naam:	"Mijn Server"

# FOUT: geen spatie na dubbele punt
max-spelers:20

# FOUT: speciale tekens zonder aanhalingstekens
welkomstbericht: &aWelkom!

Wijzigingen toepassen

Na het opslaan van een config bestand moet je de wijzigingen activeren. Er zijn twee manieren:

Server herstarten (aanbevolen) – Dit is de veiligste manier. Alle plugins worden opnieuw geladen met de nieuwe instellingen. Typ restart in de console of gebruik de herstart-knop.
/reload commando (niet altijd betrouwbaar) – Het commando /reload of /reload confirm herlaadt alle plugins zonder de server volledig te herstarten. Dit is sneller, maar kan bij sommige plugins problemen veroorzaken zoals geheugenlekkage of incomplete herlaadacties. Gebruik dit alleen als je snel iets wilt testen.
Plugin-specifieke reload – Sommige plugins hebben hun eigen reload commando, zoals /essentials reload of /lp reload. Dit herlaadt alleen die specifieke plugin en is veiliger dan een volledige /reload.

Tip: Maak een backup van je config.yml voordat je grote wijzigingen doorvoert. In de bestandsbeheerder kun je het bestand downloaden of kopiëren. Zo kun je altijd terug naar de vorige instellingen als iets niet werkt.

Tip: Veel plugins hebben een wiki of documentatiepagina waar alle configuratie-opties worden uitgelegd. Zoek op de SpigotMC of GitHub pagina van de plugin naar links naar de documentatie.

Plugins configureren