Plugins installeren op je Minecraft-server

Plugins zet je in de map plugins van je server, en daarna herstart je hem. In het gamepanel gaat dat met een paar klikken onder Plugins, of je uploadt het .jar-bestand zelf. Plugins werken op Paper, de software waarop je Minecraft Java-server standaard draait.

Welke serversoftware heb je nodig?

Plugins draaien op Paper, Purpur en Spigot. Je server start op Paper, dus meestal hoef je niets te regelen. Gebruik je Fabric of NeoForge voor mods, dan werken plugins niet. Wisselen doe je onder Versions, zoals in De versie van je server wijzigen.

Hoe installeer je een plugin via het gamepanel?

1. Maak eerst een back-up onder Backups. Valt een plugin tegen, dan zet je die zo terug.
2. Open Plugins, onder het kopje Minecraft. Je komt in de Plugin Manager.
3. Kies bij Providers een bron, zoals Modrinth, Hangar of SpigotMC, en zoek je plugin.
4. Laat Server Loaders op PaperMC staan en kies bij Versions jouw Minecraft-versie. Dan zie je alleen plugins die passen.
5. Klik op Install. Wil je een andere versie van de plugin, klik dan eerst op Versions bij die plugin.
6. Je ziet een melding dat de plugin in je map met plugins staat. Herstart je server.

Sommige plugins zijn alleen op hun eigen website te downloaden. Je ziet dan de knop Download, die die website opent. Haal het bestand daar op en volg de stappen hieronder.

Hoe upload je een plugin met de hand?

1. Download het .jar-bestand. PaperMC raadt Hangar aan; Modrinth is ook een bekende plek.
2. Open File managers en ga naar de map plugins.
3. Klik op Upload en kies je bestand. Veel bestanden tegelijk gaat fijner met SFTP.
4. Herstart je server.

Hoe controleer je of de plugin werkt?

Typ in de console het commando plugins. Groene namen zijn geladen, rode niet. Staat je plugin er niet bij, zoek dan in de console naar een regel met ERROR van rond het opstarten: daar staat meestal waarom. Bij de eerste start maakt een plugin vaak een eigen map met een config.yml, zoals plugins/LuckPerms. Daar pas je de instellingen aan, en daarna herstart je weer.

Hoe werk je een plugin bij of haal je hem weg?

Bijwerken doe je door het oude .jar-bestand te vervangen door de nieuwe versie en te herstarten. Weghalen doe je door je server te stoppen en het bestand uit plugins te verwijderen. De map met instellingen mag blijven staan, voor als je de plugin later terug wilt.

Welke fouten maken mensen vaak?

• /reload gebruiken. Dat laadt plugins maar half opnieuw en geeft vreemde fouten. Herstart je server gewoon.
• Een plugin in een submap. Paper kijkt alleen in de map plugins zelf, niet in mappen daaronder.
• Een plugin voor een andere Minecraft-versie. Kijk op de pluginpagina welke versies hij ondersteunt.
• Een vergeten afhankelijkheid. Sommige plugins hebben een andere plugin nodig, zoals Vault of ProtocolLib. De pluginpagina en de console melden dat.

Wil je dat een plugin zijn gegevens in een database bewaart? Lees dan Een MySQL-database aanmaken voor je server. Liever mods? Kijk bij Mods en modpacks installeren.