Plugins installeren op je Minecraft server

Stap 1: zorg dat je de juiste serversoftware draait

Een plugin heeft de Bukkit API nodig onder de motorkap, en dat is een eigenschap van de serversoftware en niet van Minecraft zelf. Paper, Purpur, Spigot hebben hem. Fabric, Forge, NeoForge, Vanilla niet, en een plugin jar die je daarop laat vallen doet helemaal niets. Weet je niet zeker welke je draait, dan noemt het opstarttabblad in het paneel de jar bij naam. Paper is wat wij standaard installeren: het is Spigot met een lange lijst prestatieverbeteringen erbovenop, en het gebruikt dezelfde plugins.

Stap 2 tot en met 6: vinden, uploaden, herstarten, controleren

1. Zoek je plugin

   SpigotMC is de oudste en grootste opslagplaats, Modrinth is de nieuwere en leunt meer open source, en Hangar is die van Paper zelf. Die drie en de eigen GitHub releases van de ontwikkelaar zijn de hele lijst. Een jar van een chat server of een file locker kan iemand operatorrechten op je server geven, de wereld wissen, of de machine gebruiken om anderen aan te vallen, en dat terwijl hij er precies zo uitziet als de echte plugin.

2. Download het .jar bestand

   Pluginpagina's noemen de versies die ze ondersteunen. Een plugin die voor een andere hoofdversie is gebouwd weigert meestal te starten, en soms start hij wel en breekt hij halverwege. Komt een plugin als zip met meerdere jars erin, dan staat op de pagina welke daarvan op de server hoort.

3. Upload naar de /plugins map

   In de bestandsbeheerder staat de hoofdmap van de server, met daarin world, logs en plugins. De jar gaat los in plugins, niet in een eigen mapje. Slepen en neerzetten in het browservenster werkt ook.

   /plugins/YourPlugin.jar

4. Herstart je server, en gebruik nooit /reload

   Het is verleidelijk omdat niemand eruit wordt gegooid, maar een reload laat de oude classes in het geheugen staan en de oude event listeners geregistreerd, en de bugs die daaruit voortkomen zijn bijna niet te debuggen. Stop de server netjes en laat het paneel hem weer opstarten.

   stop

5. Controleer en configureer

   Een plugin die geladen is meldt dat bij naam. Rode tekst met een stack trace eronder noemt meestal in de eerste twee regels een ontbrekende dependency of een verkeerde versie. Na de eerste geslaagde start schrijft de plugin zijn eigen config, en wijzigingen in dat bestand vragen om nog een herstart of het eigen reload commando van de plugin.

   /plugins/YourPlugin/config.yml

Veelvoorkomende problemen en hoe je ze oplost

Twee dingen gaan vaker mis dan al het andere samen. Het eerste is Java. Een UnsupportedClassVersionError in de console betekent altijd hetzelfde: de jar is gebouwd voor een nieuwere Java dan waarmee de server opstart. Van de 16 Minecraft versies die wij aanbieden willen er 9 Java 21 en 7 iets ouders, en op het opstarttabblad stel je dat in.

Het tweede is een ontbrekende dependency. Plugins leunen op elkaar: de meeste economy plugins willen Vault als brug naar je permissieplugin, en alles wat met packets werkt wil ProtocolLib. De pluginpagina noemt wat hij nodig heeft, en de console noemt het op de regel boven de stack trace.

Aanbevolen plugins om mee te beginnen

Vijf is een werkende server. Voeg er telkens twee of drie toe en herstart ertussendoor: twintig jars in één keer vertelt je niets over welke ervan het opstarten sloopte.

Vragen die mensen stellen tijdens het installeren