Plugins zijn de snelste manier om je Minecraft-server uit te breiden: van teleporteren en claims tot economie en anti-cheat. In deze handleiding installeer je er een via het Pterodactyl-paneel, en zie je wat je moet doen als het misgaat.
Wat je vooraf moet weten
Vanilla Minecraft ondersteunt geen plugins. Draait je server op de standaard Minecraft-software, dan is er geen plugins-map en gebeurt er niets als je een plugin uploadt. Je hebt Paper, Spigot, Purpur of Bukkit nodig.
Weet je niet welke software je draait? Kijk in Pterodactyl op het tabblad Startup, of start je server en let op de eerste regels in de console — daar staat de naam en versie.
Wij raden Paper aan. Die draait alle Spigot- en Bukkit-plugins, is een stuk sneller bij drukte, en is de standaard waar de meeste plugins tegenwoordig op getest worden.
Stap 1 — Download de plugin
Download plugins alleen van betrouwbare bronnen. Losse download-sites bevatten regelmatig aangepaste jar-bestanden met malware.
- Modrinth — overzichtelijk en modern
- SpigotMC — de grootste verzameling
- Hangar — de officiële bron van PaperMC
Let op de versie. Een plugin voor 1.20 werkt zelden op 1.21. Op elke downloadpagina staat welke Minecraft-versies ondersteund worden — controleer dat vóór je downloadt. Je krijgt een .jar-bestand. Is het een .zip, pak die dan eerst uit; daar zit de jar in.
Stap 2 — Upload de plugin via Pterodactyl
- Log in op je serverpaneel en kies je Minecraft-server.
- Klik bovenin op het tabblad Files.
- Open de map plugins. Zie je die niet? Start de server dan één keer — Paper en Spigot maken de map bij de eerste start automatisch aan.
- Klik rechtsboven op Upload en kies je
.jar-bestand. Je kunt het bestand ook direct in het venster slepen. - Wacht tot de upload klaar is en het bestand in de lijst staat.
Stap 3 — Herstart de server
Gebruik geen /reload. Dat commando laadt plugins half opnieuw en veroorzaakt geheugenlekken en vage fouten die pas uren later opvallen. Een echte herstart duurt tien seconden en voorkomt een hoop gedoe.
Ga naar het tabblad Console en klik op Restart. Kijk tijdens het opstarten mee in de console: je ziet een regel als [Server] Enabling PluginNaam v1.2.3. Staat die er, dan is de plugin geladen.
Wil je het zeker weten, typ dan /plugins in de console of in de game. Groen betekent actief, rood betekent dat er iets mis is.
Stap 4 — Instellingen aanpassen
Na de eerste start maakt de plugin een eigen map aan onder plugins/PluginNaam/. Daarin staat meestal een config.yml die je in Pterodactyl direct kunt openen en bewerken.
Twee dingen om op te letten bij het bewerken van YAML-bestanden: gebruik spaties, geen tabs, en houd de inspringing precies zoals hij is. Eén verkeerd teken en de plugin start niet meer. Herstart de server na elke wijziging.
Het werkt niet — wat nu?
| Wat je ziet | Wat er aan de hand is |
|---|---|
Unsupported API version |
De plugin is voor een andere Minecraft-versie. Download de juiste versie. |
Unknown dependency |
De plugin heeft een andere plugin nodig, bijvoorbeeld Vault of ProtocolLib. Installeer die er ook bij. |
Geen plugins-map |
Je draait vanilla. Schakel over naar Paper of Spigot. |
| Server start niet meer op | Meestal een fout in een config.yml. Hernoem de map van de plugin en herstart om het te bevestigen. |
Could not load 'plugins/...' |
Het bestand is beschadigd of het is geen echte plugin-jar. Download opnieuw. |
Weet je niet wat er in je console staat? Kopieer de foutmelding en stuur ons een ticket — we kijken met je mee.
Nog geen server?
Bij HostMajority draai je een Minecraft-server met Paper vooraf geïnstalleerd, dus plugins werken meteen. Je server staat binnen vijf minuten online en je beheert alles vanuit je browser.
