Hoe installeer ik een plugin op mijn Minecraft-server?

Plugins voegen functies toe aan je server zonder dat spelers iets hoeven te installeren: permissies, economie, claims, teleports, minigames. Ze werken op serversoftware met de Bukkit-API: Paper, Purpur en Spigot. Op een vanilla-, Fabric- of Forge-server laden plugins niet; daar heb je mods nodig. Het verschil leggen we uit in ons blogartikel mods of plugins.

Stap 1: controleer je serversoftware

Typ in de console about. Zie je Paper of Purpur, dan kun je plugins installeren. Zie je vanilla, wissel dan eerst via de versiekiezer in het paneel naar Paper (maak vooraf een backup; je wereld blijft behouden).

De snelste route: de Plugin installer in het paneel

Ons paneel heeft een ingebouwde Plugin installer: open die pagina bij je server, typ de naam van de plugin, druk op Enter en klik op Install. De plugin wordt direct in de map plugins gezet; herstart daarna de server. Staat de plugin er niet tussen of wil je een specifieke versie, dan upload je het bestand zelf via de stappen hieronder.

Stap 2: download de plugin

Download het .jar-bestand van een betrouwbare bron: Hangar (van PaperMC), Modrinth of SpigotMC. Let op de ondersteunde Minecraft-versies op de pluginpagina; een plugin voor 1.20 werkt zelden op 26.x. Download nooit plugins van onbekende sites of uit Discord-berichten: een .jar draait met volledige serverrechten en een kwaadaardige plugin kan je hele server overnemen.

Stap 3: upload naar de map plugins

1. Ga naar het gamepaneel en klik op je server.
2. Open Bestandsbeheer en ga naar de map plugins. Bestaat die niet, dan is de server nog nooit met Paper gestart; start hem eenmaal en de map verschijnt.
3. Klik op Upload en kies het .jar-bestand, of sleep het bestand in het venster.
4. Grote bestanden of veel plugins tegelijk? Gebruik SFTP; dat is sneller en betrouwbaarder dan de browser.

Stap 4: herstart en controleer

Herstart de server (niet /reload: dat laat plugins half geladen achter en veroorzaakt geheugenlekken). Kijk in de console naar regels als [PluginNaam] Enabling PluginNaam v1.2.3. Typ daarna in het spel /plugins: geladen plugins staan groen, plugins met een fout rood. Veel plugins maken bij de eerste start een configuratiemap aan in plugins/PluginNaam/ met een config.yml die je daarna kunt aanpassen.

Afhankelijkheden

Sommige plugins hebben een andere plugin nodig om te werken: economieplugins hebben Vault nodig, veel plugins vragen om PlaceholderAPI, en ProtocolLib is een veelvoorkomende basis. De pluginpagina noemt dit onder dependencies; installeer die eerst, anders zie je in de console Unknown dependency en laadt de plugin niet.

Als een plugin niet laadt

• UnsupportedClassVersionError: de plugin verwacht een nieuwere Java. Wissel de Java-versie in het paneel.
• Could not load 'plugins/x.jar' met NoClassDefFoundError: de plugin is gebouwd voor een andere Minecraft-versie of mist een dependency.
• Een .zip in plaats van een .jar: pak het uit; alleen het .jar-bestand hoort in de map plugins.
• De server start helemaal niet meer: verwijder de laatst toegevoegde plugin en start opnieuw; voeg plugins altijd één voor één toe.

Plugins verwijderen of updaten

Verwijderen: stop de server, verwijder het .jar-bestand (de configuratiemap mag blijven als je de instellingen wilt bewaren) en start opnieuw. Updaten: vervang het .jar-bestand door de nieuwe versie en herstart; lees eerst de changelog, want grote updates kunnen een nieuwe config vereisen. Maak voor elke update een backup.

Een goede basisset

Voor een nieuwe survival-server: LuckPerms (permissies), EssentialsX (basiscommando's, homes, warps), een claimplugin (GriefPrevention of Lands), CoreProtect (griefing terugdraaien) en Chunky (chunks pregenereren). Welke je daarna nog nodig hebt, hangt af van je server; hoe je ze combineert staat in moderatie en bescherming.

Kom je er niet uit, open dan een ticket en noem de naam van de plugin en de foutmelding uit de console.