Een Minecraft-plugin installeren

Stap voor stap

1. 1.Controleer of je server plugins kan draaien

   Plugins hebben serversoftware op basis van Bukkit nodig: Paper, Spigot, Purpur of Folia voor gameservers, BungeeCord of Velocity voor proxy's. Een vanilla server, of een Fabric- of Forge-server, laadt geen plugins.

2. 2.Controleer de versie van de plugin

   Op de pluginpagina of in het bestand staat welke Minecraft-versies hij ondersteunt. Een plugin die voor een nieuwere versie dan je server is gebouwd, weigert meestal te laden.

3. 3.Stop de server en kopieer de .jar

   Zet het .jar-bestand in de map plugins/ naast de server-.jar. Upload het in een hostingpaneel met de bestandsbeheerder of via SFTP. Pak het niet uit.

4. 4.Installeer de dependencies

   Heeft de plugin andere plugins nodig (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), zet hun .jar-bestanden dan ook in plugins/.

5. 5.Start de server en lees de console

   Zoek de naam van de plugin in het opstartlog. "Enabling <Plugin>" zonder fout erna betekent dat hij geladen is.

6. 6.Controleer hem in de game en configureer hem

   Voer /plugins uit: geladen plugins zijn groen, plugins die niet konden worden ingeschakeld, zijn rood. De instellingen staan in plugins/<PluginName>/config.yml; pas ze aan en herstart.

Waar de bestanden komen

Een gewone servermap ziet er na de eerste start met een plugin zo uit:

• paper.jar (of spigot.jar): de server zelf.
• plugins/MyPlugin.jar: de plugin die je hebt toegevoegd.
• plugins/MyPlugin/: een map die de plugin aanmaakt, met config.yml, berichten en zijn opgeslagen data.
• logs/latest.log: het log van de huidige sessie, waar laadfouten in komen.

Herstarten, niet /reload

/reload ontlaadt en herlaadt elke plugin zonder de server te herstarten. Veel plugins ondersteunen dat niet: listeners worden twee keer geregistreerd, data gaat verloren of er lekt geheugen. Herstart de server altijd na het toevoegen, verwijderen of bijwerken van een plugin. Sommige plugins hebben een eigen reloadcommando (bijvoorbeeld /myplugin reload) alleen voor hun config: dat kun je veilig gebruiken.

Voordat je op de live server installeert

• Maak een back-up van de servermap, of in elk geval van plugins/ en de werelden.
• Probeer het eerst op een kopie: met dezelfde software, versie en andere plugins als de echte server. Zie een plugin testen.
• Eén plugin tegelijk: als er iets stukgaat, weet je welke het was.
• Download van de pagina van de maker (SpigotMC, Hangar, Modrinth, GitHub), niet van herpublicaties.

Plugins gemaakt met Codexe

Een plugin die op Codexe is gemaakt, komt als gebouwde .jar met de naam van het project, gecontroleerd voordat je hem krijgt: hij moet de gecompileerde klassen en een plugin.yml bevatten. Je kunt hem op een privétestserver proberen voordat je hem ergens installeert, gratis op elk abonnement; de testserver installeert de plugins die als dependency zijn opgegeven voor je. Voor het downloaden van de .jar voor je eigen server heb je een abonnement of een downloadpakket nodig.

Vragen