Plugins en mods installeren op je Minecraft-server

Plugins en mods maken van een kale Minecraft-server jouw eigen server: landclaims, economie, nieuwe mobs, hele nieuwe dimensies. Deze handleiding legt het verschil tussen de twee uit, welk servertype je nodig hebt en hoe je ze installeert zonder je wereld te slopen.

Plugins of mods: wat is het verschil?

Plugins draaien alleen op de server. Spelers joinen met een gewone Minecraft-client en hoeven niets te installeren. Plugins voegen dingen toe zoals rechten, bescherming, minigames en commando's, maar ze kunnen geen nieuwe blokken of items aan de game toevoegen.

Mods veranderen de game zelf. Ze kunnen nieuwe blokken, items, wezens en dimensies toevoegen. Bij de meeste mods heeft elke speler dezelfde mods en dezelfde modloader nodig in zijn eigen game.

Je kunt de twee niet vrij door elkaar gebruiken. Een plugin werkt niet in de map mods, en een mod werkt niet in de map plugins.

Welk servertype heb je nodig?

Je wilt gebruiken	Variant die je nodig hebt	Map
Plugins	Paper, Purpur of Spigot	`plugins`
Fabric-mods	Fabric	`mods`
Forge-mods	Forge	`mods`
NeoForge-mods	Neoforge	`mods`
Een complete modpack	CurseForge	wordt voor je geïnstalleerd

Vanilla draait geen plugins en geen mods. Folia draait plugins, maar alleen die waarbij staat dat ze het ondersteunen.

Draait je server op het verkeerde type?

Je wijzigt de variant met Game wisselen op de serverpagina. Wisselen wist alle bestanden op de server en draait de installatie opnieuw. Download je wereld dus eerst of maak een back-up: zie Back-up maken en terugzetten van je game-server.

Voordat je begint

Maak een back-up. Een kapotte mod kan een wereld beschadigen.
Controleer de Minecraft-versie van je server. Die vind je onder Opstart, bij Variabelen. Staat daar latest, dan tonen de eerste regels in de Console bij het starten de exacte versie.
Download alleen van de officiële pagina van de plugin of mod. Een .jar-bestand is een programma dat op je server draait.

Plugins installeren

Download het .jar-bestand van de plugin voor jouw Minecraft-versie.
Log in op het paneel, open Game-servers en klik op je server.
Klik op Bestanden en open de map plugins.
Klik op Uploaden en kies het bestand, of sleep het naar de bestandenlijst.
Klik op de serverpagina op Herstart onder Serveracties.

Bij de eerste start maken de meeste plugins een eigen map aan in plugins met een config.yml. Open die in Bestanden, pas aan wat je wilt, klik op Opslaan en herstart nog een keer.

Mods installeren

Download het .jar-bestand van de mod voor jouw modloader en jouw Minecraft-versie.
Open Bestanden en open de map mods. Bestaat die nog niet, klik dan op Nieuwe map en noem hem mods.
Klik op Uploaden en kies de bestanden.
Controleer waar de mod van afhangt. De meeste Fabric-mods hebben de mod Fabric API nodig, en veel mods hebben een library-mod nodig die op hun pagina genoemd wordt. Upload die ook.
Klik op Herstart onder Serveracties.
Installeer dezelfde mods in je eigen game, met dezelfde modloader en versie. Je vrienden moeten dat ook doen.

De instellingen van mods staan in de map config.

Sommige mods zijn alleen voor de client, zoals minimaps en shaders. Upload die niet naar de server. Ze kunnen ervoor zorgen dat hij niet start.

Veel of grote bestanden uploaden

In Bestanden kun je bestanden tot 100 MB per stuk uploaden. Voor een hele set mods is SFTP sneller. De verbindingsgegevens staan op de kaart SFTP op je serverpagina. Stap voor stap: Bestanden uploaden naar je game-server met SFTP.

Controleer de console op fouten

Volg na de herstart de Console op de serverpagina terwijl de server start. De server is klaar zodra hij een regel toont die begint met Done.

Regels met ERROR of WARN waarin je plugin of mod genoemd wordt, vertellen je wat er misging.
Typ op een pluginserver plugins in het veld onder de console en druk op Enter. Geladen plugins staan in het groen, mislukte in het rood.
Het volledige log van de laatste start staat in logs/latest.log onder Bestanden.

De meldingen die je het vaakst ziet:

Melding bevat	Wat het betekent
`Could not load 'plugins/...'`	De plugin past niet bij dit servertype of deze versie
`UnsupportedClassVersionError`	De Java-versie is te oud. Kies een nieuwere onder Opstart, bij Container-image
`requires` of `depends on`	Er ontbreekt een andere mod of plugin. Upload die ook

Bijwerken of verwijderen

Om bij te werken verwijder je de oude .jar in Bestanden, upload je de nieuwe en herstart je. Twee versies van dezelfde plugin of mod in één map geven fouten.

Om een plugin te verwijderen, verwijder je zijn .jar en herstart je. Wees voorzichtig met het verwijderen van mods: blokken en items van die mod verdwijnen uit je wereld. Maak eerst een back-up.

Als iets niet werkt

De server start niet meer: verwijder het bestand dat je als laatste hebt toegevoegd en herstart. Lost dat het op, dan lag het aan dat bestand.
De server is traag of heeft te weinig geheugen: kijk naar Live gebruik op de serverpagina. Modded servers hebben veel meer RAM nodig. Meer geef je onder Plan wijzigen.

Nieuw met Minecraft-servers? Begin met Minecraft-server opzetten: zo doe je dat.