Een plugin installeren op je Minecraft-server

Plugins breiden de functionaliteit van je Minecraft-server uit. Denk aan economiesystemen, permissiebeheer, minigames of bescherming tegen griefing. In dit artikel leggen we stap voor stap uit hoe je een plugin installeert via het Etheron game panel.

Let op: Plugins werken uitsluitend op Bukkit-, Spigot-, Paper- of vergelijkbare serverversies. Op een vanilla Minecraft-server kun je geen plugins installeren.

Vereisten

Zorg dat je aan de volgende vereisten voldoet voordat je begint:

Je server draait op Spigot, Paper, Purpur of een andere Bukkit-gebaseerde fork.
Je hebt toegang tot je server via het game panel.
Je hebt een .jar-bestand van de plugin klaarstaan.
Je hebt gecontroleerd of de plugin compatibel is met jouw Java-versie (zie de pluginpagina).

Stap 1. Controleer het servertype

Plugins werken alleen op een plugin-compatibele serverversie. Controleer dit als volgt:

Log in op het game panel.
Selecteer je Minecraft-server.
Open het tabblad Startup of Server Details en controleer welk servertype actief is, bijvoorbeeld Paper of Spigot.

Staat er Vanilla? Dan moet je eerst overstappen naar Paper of Spigot voordat je verder gaat.

Stap 2. Download de plugin

Bezoek een betrouwbare pluginbron:
Controleer of de plugin compatibel is met jouw Minecraft-versie.
Download het .jar-bestand naar je computer.

Stap 3. Upload de plugin via het game panel

Log in op het game panel.
Selecteer je server.
Ga naar het tabblad Files (of Bestandsbeheer).
Navigeer naar de map /plugins/.
- Bestaat de map nog niet? Dan is je server nog nooit opgestart met een plugin-compatibel servertype. Start de server eerst één keer op met Paper of Spigot om de map aan te laten maken.
Klik op Upload en selecteer het gedownloade .jar-bestand.
Wacht tot de upload volledig is afgerond.

Stap 4. Herstart de server

Plugins worden uitsluitend geladen op het moment dat de server opstart.

Ga naar het tabblad Console.
Klik op Restart om de server opnieuw op te starten.
Controleer na het opstarten in de console of de plugin correct is geladen. Je ziet dan een melding zoals:

[Paper] Enabling MijnPlugin v1.0.0

Stap 5. Verifieer de installatie

Voer in de serverconsole het volgende commando uit:

plugins

Of gebruik dit commando in de game zelf als je operator-rechten hebt:

/plugins

Je ziet een lijst van actieve plugins. De naam van jouw plugin wordt groen weergegeven als alles correct werkt. Een rode naam betekent dat de plugin niet correct is geladen.

Veelvoorkomende problemen

Probleem	Mogelijke oorzaak	Oplossing
Plugin verschijnt niet in `/plugins`	Bestand staat niet in de `/plugins/` map	Controleer het pad in het bestandsbeheer
Plugin staat rood in `/plugins`	Incompatibele versie of ontbrekende dependency	Controleer de vereiste MC-versie en of afhankelijke plugins aanwezig zijn
Server start niet op na toevoegen plugin	Corrupte of incompatibele `.jar`	Verwijder de plugin en probeer een andere versie
Map `/plugins` bestaat niet	Server draait op Vanilla	Wissel naar Paper of Spigot en herstart
Plugin laadt, maar commando's werken niet	Permissies niet correct ingesteld	Configureer permissies via een permissieplugin, zoals LuckPerms

Tip: Voeg niet meerdere plugins tegelijk toe. Installeer ze één voor één en herstart de server telkens opnieuw. Zo kun je eenvoudig achterhalen welke plugin problemen veroorzaakt als er iets misgaat.

Hulp nodig? Neem contact op via support.etheron.nl