Plugins installeren op een Minecraft-server (Paper, Purpur)

Plugins voegen commando's, bescherming van bouwwerken, een economie, minigames en nog veel meer toe aan je server. Spelers hoeven niets te installeren. We laten zien hoe je met één klik installeert in je klantaccount, hoe je een bestand handmatig uploadt, een plugin instelt en bijwerkt, en hoe je de meest voorkomende fouten oplost.

Voordat je begint#

• Plugins werken alleen op Paper, Purpur en Folia. Op Fabric, Forge en NeoForge gebruik je mods in plaats van plugins en heet het tabblad Mods, zie Mods en modpacks. Vanilla ondersteunt geen van beide. Het verschil wordt uitgelegd in het artikel Plugins of mods?.
• De plugin moet jouw Minecraft-versie ondersteunen. Een plugin voor een oudere versie laadt vaak niet of gedraagt zich onvoorspelbaar.
• Op Folia werkt maar een klein deel van de plugins. De plugin moet ondersteuning voor Folia uitdrukkelijk vermelden.
• Een plugin mag alles op de server. De documentatie van Paper wijst erop dat plugins volledige en onbeperkte toegang tot de server hebben. Installeer alleen plugins uit betrouwbare bronnen.

Installeren via je klantaccount#

1. Open Mijn diensten, klik op de server en ga naar het tabblad Plugins.

2. Klik op het subtabblad Bladeren. Zonder te zoeken zie je de meest gedownloade plugins voor het type en de versie van jouw server.

3. Kies bij de schakelaar Bron een catalogus (uitleg hieronder). Begin met Modrinth.

4. Typ in het veld “Plugins zoeken” een naam, bijvoorbeeld LuckPerms, en klik op Zoeken.

5. Klik bij de plugin op Installeren. Wil je een andere versie dan de nieuwste, klik dan eerst op Versies en kies die uit de lijst.

6. Bekijk het dialoogvenster … installeren:

   • Hoofdbestand – het pluginbestand dat naar de map plugins wordt geüpload.
   • Vereiste afhankelijkheden – andere plugins die de plugin nodig heeft om te starten. Het klantaccount installeert ze meteen mee. Vink alleen de plugins uit die je al handmatig op de server hebt gezet.
   • Waarschuwingen voor bestanden met dezelfde naam die door de installatie worden overschreven, en voor plugins waarmee de plugin volgens de maker niet werkt.
   • Te downloaden – de totale grootte.

7. Klik op Installeren.

   Als het klaar is, zie je de melding Geïnstalleerd: met een lijst van bestanden en de waarschuwing “Wijzigingen worden actief na een herstart van de server”.

8. Klik op Herstarten en bevestig. Plugins worden alleen geladen bij het starten van de server.

Bronnen voor plugins#

De controlesom bevestigt dat het bestand precies zo op de server is aangekomen als de maker het heeft gepubliceerd. Een plugin die alleen op SpigotMC of op de website van de maker staat, upload je handmatig, zie Handmatige installatie.

Andere labels in de resultaten:

• Alleen extern – de maker host het bestand ergens anders (vaak bij betaalde plugins). Automatisch installeren kan niet, download het van de pagina van de maker en upload het handmatig.
• Niet getest op … – de maker vermeldt bij deze versie geen ondersteuning voor jouw Minecraft-versie. Het kan werken, maar dat is niet gegarandeerd.
• Stabiel, Beta, Alpha – het releasekanaal. Installeer op een server met spelers stabiele versies.

Handmatige installatie#

Gebruik handmatig uploaden voor plugins die niet in de catalogus staan, bijvoorbeeld betaalde plugins.

1. Download de plugin naar je computer vanaf de officiële pagina van de maker of uit een catalogus (Modrinth, Hangar, SpigotMC). Het bestand moet de extensie .jar hebben. Heb je een .zip gedownload, pak die dan uit op je computer en zoek de .jar erin.
2. Ga in je klantaccount naar het tabblad Bestanden en open de map plugins.
3. Klik op Uploaden en kies het .jar-bestand. Je kunt het ook met de muis naar de lijst slepen. Eén bestand mag maximaal 100 MB groot zijn.
4. Herstart de server op het tabblad Console met de knop Herstarten.

De plugin moet direct in de map plugins staan. Submappen leest de server niet. Op het tabblad Plugins verschijnt een handmatig geüploade plugin met het label Handmatig geüpload. Van zo'n plugin houdt het klantaccount de versie en updates niet bij.

Controle#

1. Houd na de herstart de console in de gaten. Een plugin die goed is geladen, meldt zich met een regel zoals deze:

   [12:00:08 INFO]: [LuckPerms] Enabling LuckPerms v<VERSION>

   In plaats van <VERSION> zie je het versienummer van de plugin.

2. Typ in de console het commando plugins. Dat toont de lijst met plugins. In het spel zie je kleuren: groen voor plugins die draaien, rood voor plugins die niet konden worden ingeschakeld.

3. Details over een bepaalde plugin toont het commando version <PLUGIN_NAME>, bijvoorbeeld version LuckPerms.

Een plugin instellen (config.yml)#

De meeste plugins maken bij de eerste start de map plugins/<PLUGIN_NAME> aan met daarin het bestand config.yml. LuckPerms heeft zijn instellingen bijvoorbeeld in plugins/LuckPerms/config.yml.

1. Stop de server op het tabblad Console met de knop Stoppen. Sommige plugins overschrijven hun bestand bij het afsluiten en dan zouden je wijzigingen verloren gaan.
2. Open op het tabblad Bestanden het bestand plugins/<PLUGIN_NAME>/config.yml en klik op Bewerken.
3. Pas de waarden aan en sla op (Ctrl+S).
4. Start de server.

.yml-bestanden gebruiken het YAML-formaat. Dat is gevoelig voor kleine details:

# Een regel met een hekje is een opmerking, de server negeert hem.
nastaveni:
  zprava: "&aWelkom op de server!"
  max-domovu: 3
  zapnuto: true
  zakazane-svety:
    - world_nether
    - world_the_end

• Spring alleen in met spaties, nooit met een tab. Een tab veroorzaakt een laadfout. De inspringing bepaalt wat waaronder valt (zprava valt onder nastaveni).
• Na de dubbele punt altijd een spatie: max-domovu: 3, niet max-domovu:3.
• Zet tekst met speciale tekens tussen aanhalingstekens. Vooral tekst die begint met & of die : of # bevat.
• Een lijst is een reeks regels die beginnen met een streepje en een spatie, ingesprongen onder de sleutel.
• true en false betekenen aan en uit.

Plugins bijwerken#

1. Blijf op het tabblad Plugins op het subtabblad Geïnstalleerd.
2. Klik op Controleren op updates. Je ziet dan “Alles is up-to-date.” of “Beschikbare updates:” met het aantal.
3. Klik bij de plugin op Bijwerken naar …, controleer het dialoogvenster en bevestig met Bijwerken.
4. Herstart de server.

Lees voor het bijwerken de lijst met wijzigingen op de pagina van het project (de link Projectpagina). Hoofdversies (bijvoorbeeld van 2.x naar 3.x) kunnen de configuratie veranderen. Maak voor een grotere update een back-up, zie Back-ups van gameservers. Handmatig geüploade plugins werk je bij door de oude .jar te verwijderen en de nieuwe te uploaden. Twee bestanden van dezelfde plugin in één map veroorzaken een fout.

Een plugin uitschakelen en verwijderen#

• Uitschakelen – de plugin wordt bij de volgende start niet geladen, maar blijft met zijn instellingen op de schijf staan. Het bestand wordt hernoemd naar <bestand>.jar.disabled. Met de knop Inschakelen zet je hem weer aan.
• Verwijderen – verwijdert het pluginbestand uit de map plugins. De instellingen en gegevens van de plugin in de map plugins/<PLUGIN_NAME> blijven staan, zodat de plugin ze na een nieuwe installatie terugvindt.

Wijzigingen worden actief na een herstart van de server.

Veiligheid#

• Download plugins alleen uit catalogi (Modrinth, Hangar, SpigotMC) of van de officiële pagina van de maker.
• Installeer nooit “gecrackte” of “gelekte” betaalde plugins. Ze zijn vaak zo aangepast dat een aanvaller de controle over de server of operatorrechten krijgt.
• Installeer geen plugins die al jaren door niemand zijn bijgewerkt. Ze werken vaak niet met nieuwe versies en bevatten bekende fouten.
• Installeer geen plugins naast elkaar die hetzelfde doen (bijvoorbeeld twee plugins voor rechten).

Beproefde tips voor plugins vind je in het artikel Aanbevolen plugins.

Als iets niet werkt#

Zoek fouten van plugins in de console tijdens het starten van de server. Het volledige logboek staat in het bestand logs/latest.log (tabblad Bestanden).

Could not load 'plugins/….jar' in folder 'plugins' en UnknownDependencyException#

[00:00:00] [Server thread/WARN] Could not load 'plugins/MyAwesomePlugin-1.0.0.jar' in folder 'plugins'
[00:00:00] [Server thread/WARN] org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MyAwesomePlugin'.

De plugin mist een andere plugin waarvan hij afhankelijk is. De naam daarvan staat tussen de vierkante haken (hier Vault). Installeer die plugin en herstart de server.

Invalid plugin.yml#

Het bestand is geen plugin voor Paper. Meestal gaat het om een mod voor Fabric of Forge, of om een onvolledig gedownload bestand. Download het juiste bestand opnieuw.

Ambiguous plugin name#

In de map plugins staan twee versies van dezelfde plugin. Verwijder het oudere bestand.

UnsupportedClassVersionError … class file version 69.0#

De plugin vereist een nieuwere Java dan waarop de server draait. Het versienummer van de klasse komt overeen met een Java-versie: 65 = Java 21, 69 = Java 25. De plugin is waarschijnlijk bedoeld voor een nieuwere Minecraft-versie. Download de versie van de plugin voor jouw Minecraft-versie, of werk de server bij, zie Versie en software wijzigen.

Error occurred while enabling … (Is it up to date?)#

De plugin is geladen, maar crashte bij het inschakelen. Onder deze regel staat de foutuitvoer. De meest voorkomende oorzaken zijn een niet-ondersteunde Minecraft-versie, een ontbrekende afhankelijkheid of een fout in de configuratie van de plugin. Controleer de versie van de plugin en loop zijn config.yml na.

De plugin meldt een fout in config.yml#

In de console zie je een YAML-fout met een regelnummer, vaak InvalidConfigurationException, mapping values are not allowed here of een vermelding van een tab. Open het bestand en controleer die regel: een tab in plaats van spaties, een ontbrekende spatie na de dubbele punt of tekst met speciale tekens zonder aanhalingstekens.

De server start niet na het installeren van een plugin en je weet niet welke het is#

Schakel plugins in groepen uit. Schakel op het tabblad Plugins de helft uit, herstart en ga op basis van het resultaat verder met de helft waarin het probleem zit. Handmatig schakel je een plugin uit door het bestand te hernoemen, bijvoorbeeld naar Plugin.jar.disabled.

“Op de server wordt nu de software gewijzigd of een modpack geïnstalleerd”#

Wacht tot de wijziging op het tabblad Software klaar is. Daarna kun je plugins weer aanpassen.

Lukt het niet om de fout op te lossen, stuur ons dan het bestand logs/latest.log, zie contact met support.

Meer bronnen#

• Paper: plugins toevoegen (opent in een nieuw venster)
• Paper: eenvoudige probleemoplossing (opent in een nieuw venster)
• Hangar (opent in een nieuw venster)
• Modrinth: plugins (opent in een nieuw venster)