Plugins installeren op Paper, Spigot en Purpur

Plugins voegen functies toe aan je server, zoals homes, claims, ranks of minigames, en ze draaien alleen op de server. Je spelers joinen met de gewone game en installeren niets. Plugins werken op Paper, Purpur, Spigot en, voor de paar die het ondersteunen, Folia. Draait je server Fabric, Forge of NeoForge, dan heb je mods nodig. Zie Mods installeren op Forge, Fabric en NeoForge. Lees Minecraft-servertypes uitgelegd om de twee soorten te vergelijken.

Plugins hebben volledige toegang tot je server. Installeer alleen plugins uit bronnen die je vertrouwt en maak eerst een backup. Zie Een backup maken van je Minecraft-wereld, herstellen en resetten.

Een plugin installeren via het tabblad Modding

Het tabblad Modding zoekt in meerdere plugincatalogi tegelijk en zet het bestand voor je in de juiste map.

1. Open je server in het panel en klik op Modding.
2. Klik op het tabblad Plugins. Zie je het niet, dan draait je servertype geen plugins. Het tabblad legt dit uit en noemt de types die dat wel doen.
3. Typ de naam van de plugin in Plugins zoeken en druk op Enter. Met het menu Sorteren op kun je de resultaten ordenen op Meest gedownload of Recent bijgewerkt.
4. Gebruik links de filters als je ze nodig hebt. Bron kan Alle bronnen, Modrinth, CurseForge, Hangar, SpigotMC of Polymart zijn. Minecraft-versie begint op de eigen versie van je server.
5. Klik op Installeren bij de rij die je wilt. Het panel installeert de nieuwste build voor de versie in het filter Minecraft-versie, dat begint op de versie van je server. Wil je een oudere build, wijzig dan dat filter, of download de jar zelf en upload hem, zoals hieronder beschreven. Kies alleen een versie die je server kan laden.
6. Heeft de plugin andere plugins nodig om te werken, dan opent een venster dat ze opsomt, en de knop daarin zegt 2 bestanden installeren of iets dergelijks. Klik erop om de plugin samen met wat hij nodig heeft te installeren.
7. Herstart de server zodat hij de plugin laadt. Het panel herstart hem niet voor je na een enkele installatie. Zie Je server starten, stoppen, herstarten en geforceerd stoppen.

Plugins worden alleen gelezen als de server start, dus een plugin die je hebt geïnstalleerd doet niets tot de herstart.

Wat de badges betekenen

Een plugin waarvan de vermelding je Minecraft-versie niet noemt, wordt gewoon geïnstalleerd, zonder waarschuwing. Vaak werkt hij toch, maar controleer de Console na de herstart.

Een Paper-server accepteert plugins die voor Paper, Spigot of Bukkit staan vermeld. Een Purpur-server accepteert die ook, plus plugins die voor Purpur staan vermeld. Een Spigot-server accepteert plugins die voor Spigot of Bukkit staan vermeld, dus een plugin die alleen voor Paper is gemaakt, wordt er niet op geïnstalleerd.

Een plugin installeren door het bestand te uploaden

Gebruik dit voor een plugin die je zelf hebt gedownload, bijvoorbeeld een die niet in de catalogi staat.

1. Download het .jar-bestand van de plugin van zijn officiële pagina. Hangar, de eigen pluginsite van Paper, is de plek die de documentatie van Paper aanbeveelt. Modrinth is een andere goede.
2. Open je server en klik op Files.
3. Open de map plugins.
4. Klik op Uploaden en kies het .jar-bestand. Gebruik voor veel bestanden SFTP. Zie Met SFTP verbinden met de bestanden van je server.
5. Herstart de server.

Zet de jar direct in plugins. De documentatie van Paper zegt dat plugins in submappen van plugins niet worden geladen. Sommige plugins worden verkocht op sites die geen automatische downloads toestaan. Die moet je in je browser downloaden en zelf uploaden.

Controleren of de plugin is geladen

1. Open het tabblad Console en volg de start. Zoek naar de naam van de plugin en naar regels die als fout zijn gemarkeerd. Het filter Fouten toont alleen die.
2. Typ als de server Online is plugins in de Console en druk op Enter. Het toont de plugins die de server kent. Zie De console gebruiken en commando's uitvoeren.

Ontbreekt de plugin of toont de Console een fout die hem noemt, dan is de plugin waarschijnlijk gebouwd voor een andere Minecraft-versie of heeft hij eerst een andere plugin nodig. Lees de eigen pagina van de plugin om te zien wat hij nodig heeft.

De instellingen van een plugin wijzigen

De meeste plugins maken de eerste keer dat ze draaien een map met hun eigen naam aan in plugins, meestal met een config.yml erin. Open hem via Files, bewerk hem, sla op en herstart de server. De pagina Instellingen van het panel toont geen pluginbestanden. Hij toont de eigen bestanden van de server, zoals Bukkit Settings, Spigot Settings en Purpur Settings, als ze bestaan.

Plugins bijwerken en verwijderen

1. Open Modding, dan Plugins, dan de weergave Geïnstalleerd.
2. Een plugin met een nieuwere build toont beide versies, zoals 2.9.1 → 2.12.1, en een knop Bijwerken. Een balk bovenaan biedt aan ze allemaal tegelijk bij te werken. Bijwerken vervangt alleen het pluginbestand en laat de instellingen met rust. Het oude bestand wordt verwijderd zodra het nieuwe op zijn plek staat.
3. Om er een te verwijderen open je zijn menu ... en klik je op Deïnstalleren. Vink Ook de configuratie en data verwijderen alleen aan als je de plugin niet meer gebruikt. Het verwijdert de eigen map van de plugin, met zijn instellingen en wat hij heeft opgeslagen, zoals homes of claims.
4. Herstart de server zodat de wijziging ingaat.

Bewaar nooit twee versies van dezelfde plugin in plugins. De server kan weigeren er een te laden. Het panel verwijdert het oude bestand voor je als je bijwerkt, maar een bestand dat je met de hand hebt geüpload moet je zelf verwijderen.

Als de server niet start na een plugin

1. Open Files, dan plugins, en verwijder de nieuwste plugin die je hebt toegevoegd. Laat zijn instellingenmap met rust voor het geval je de plugin terug wilt.
2. Start de server. Start hij, dan was de plugin de oorzaak.
3. Faalt het nog steeds, herstel dan de backup die je eerder hebt gemaakt. Zie Backups maken, downloaden en herstellen.

Lees voor een volledige checklist Een server repareren die niet start. Plugins en lag komen aan bod in Lag op je Minecraft-server verminderen.

Goede plugins om mee te beginnen

Dit zijn plugins die al lang bestaan en veel worden gebruikt, elk met een eigen pagina op Modrinth of Hangar:

• LuckPerms beheert ranks en permissies. Zie Jezelf operator maken en permissies beheren.
• EssentialsX voegt de alledaagse commando's toe, zoals homes en warps. Sommige plugins hebben een andere plugin ernaast nodig. Het panel toont die voordat het installeert.
• WorldEdit bewerkt grote delen van de wereld snel, voor bouwers.

Lees de pagina van elke plugin voor de Minecraft-versies die hij ondersteunt voordat je hem installeert.