Mods en modpacks op een Minecraft-server (Fabric, Forge, NeoForge)

Mods veranderen het spel zelf: ze voegen blokken, voorwerpen, mobs, dimensies of complete spelsystemen toe. Anders dan bij plugins moeten spelers ze meestal ook hebben. We laten zien hoe je mods op de server installeert, hoe je een kant-en-klaar modpack aan de praat krijgt en hoe je de meest voorkomende fouten oplost.

Hoe mods werken#

Mods worden in het spel geladen door een loader: Fabric, Forge of NeoForge. Elke mod is geschreven voor een bepaalde loader en een bepaalde Minecraft-versie. Een mod voor Fabric werkt niet op NeoForge en een mod voor 1.21.1 werkt meestal niet op 26.1. Sommige mods brengen aparte bestanden uit voor meerdere loaders, download daarom altijd het bestand voor jouw loader en jouw versie.

Afhankelijk van waar een mod draait, onderscheiden we drie soorten:

De meeste mods voor Fabric hebben de bibliotheek Fabric API nodig. Dat is een aparte mod die in de map mods hoort, op de server en bij de spelers. Op dezelfde manier vereisen veel mods andere bibliotheken. De pagina van de mod noemt ze altijd als afhankelijkheden (Dependencies).

Een mod installeren via het tabblad Mods#

1. Open Mijn diensten, klik op de server en ga naar het tabblad Mods.
2. Klik op Bladeren. De catalogus haalt zijn aanbod van Modrinth en toont alleen mods voor jouw loader en Minecraft-versie.
3. Typ in het veld “Mods zoeken” een naam en klik op Zoeken.
4. Klik bij de mod op Installeren.
5. Controleer in het dialoogvenster de Vereiste afhankelijkheden. Je klantaccount installeert ze samen met de mod, bijvoorbeeld Fabric API. Vink alleen de afhankelijkheden uit die je al handmatig hebt geüpload.
6. Klik op Installeren en daarna op Herstarten. Mods worden alleen geladen bij het starten van de server.

Het bijwerken, uitschakelen en verwijderen van mods werkt hetzelfde als bij plugins, zie Plugins installeren.

Een mod handmatig installeren#

1. Download de mod van zijn pagina op Modrinth of CurseForge. Controleer of het bestand voor jouw loader en jouw Minecraft-versie is (beide zie je op het tabblad Software in het gedeelte Geïnstalleerde software).
2. Download ook alle afhankelijkheden die de pagina van de mod als vereist noemt (Required).
3. Open op het tabblad Bestanden de map mods. Bestaat die niet, start de server dan één keer zonder mods, of maak de map aan met de knop Nieuwe map.
4. Klik op Uploaden en kies de .jar-bestanden. Je kunt er meerdere tegelijk selecteren. Eén bestand mag maximaal 100 MB groot zijn.
5. Herstart de server.

Handmatig geüploade mods verschijnen op het tabblad Mods met het label Handmatig geüpload, en je klantaccount houdt voor die mods geen updates bij.

Wat spelers nodig hebben#

Om met een gemodde server te verbinden, heeft een speler nodig:

• dezelfde Minecraft-versie als de server,
• dezelfde loader, het liefst in dezelfde versie als de server,
• alle contentmods van de server in dezelfde versies (servermods niet, clientmods naar eigen smaak).

Het eenvoudigst is om spelers het hele modpack te geven. Draait de server op een openbaar modpack, dan hoeven spelers alleen dezelfde versie van het modpack te installeren in de CurseForge-app, de Modrinth App of Prism Launcher. Maak bij een eigen set mods een lijst van de mods met hun versies, of stel in een van deze apps een eigen modpack samen en deel het.

Modpacks#

Een modpack is een kant-en-klare set mods met configuratie. Je zet het op de server door de juiste loader in te stellen en daarna de mods en de configuratie te uploaden. Een modpack met één klik installeren kan in je klantaccount nog niet, de stappen hieronder werken voor modpacks van zowel CurseForge als Modrinth.

Hoeveel RAM een modpack nodig heeft#

Het betrouwbaarst is de aanbeveling van de maker van het modpack op de pagina ervan. Staat die er niet, gebruik dan de richttabel. Tel er een reserve bij op voor het aantal spelers en de grootte van de wereld.

Crasht de server door te weinig geheugen, stap dan over op een groter pakket op het tabblad Pakket wijzigen.

Stap 1: Zoek de versie van Minecraft en van de loader op#

Je hebt drie gegevens nodig: de Minecraft-versie, de loader en de versie van de loader. Je vindt ze hier:

• Modrinth: op de pagina van het modpack bij de betreffende versie (Versions). In het .mrpack-bestand staan ze in het bestand modrinth.index.json, in de sectie dependencies (de sleutels minecraft, fabric-loader, forge of neoforge).
• CurseForge: op de pagina van het modpack, op het tabblad Files bij het betreffende bestand, of in de handleiding van de maker. De server pack bevat vaak een installer van de loader, waarvan de naam de versie verraadt.

Stap 2: Bereid de server voor#

1. Stop de server op het tabblad Console met de knop Stoppen. Na een softwarewijziging start je klantaccount de server alleen als hij vóór de wijziging draaide. Een gestopte server genereert dus geen nieuwe wereld terwijl de mods er nog niet zijn (in zo'n wereld zouden bij de spawn de ertsen, biomen en bouwwerken uit de mods ontbreken).
2. Kies op het tabblad Software het Servertype dat bij de loader van het modpack hoort.
3. Kies de Minecraft-versie en in het veld Versie van de loader dezelfde versie als die van het modpack.
4. Kies in het gedeelte Serverbestanden de optie Alles verwijderen en vink Ik ga akkoord met de Minecraft EULA aan.
5. Klik op Software wijzigen, bevestig door de schuifregelaar te verslepen en wacht tot de voortgang Voltooid toont. De server blijft uit.

Stap 3: Haal de serverbestanden van het modpack op#

CurseForge: makers leveren de serverbestanden als Server Pack. Dat is een apart bestand dat als zogeheten aanvullend bestand (Additional Files) aan een versie van het modpack hangt. Download de server pack van dezelfde versie als die de spelers gaan gebruiken en pak hem uit op je computer. Niet elk modpack heeft een server pack. Ontbreekt die, ga dan te werk zoals bij Modrinth, via de app.

Modrinth: een .mrpack-bestand is een ZIP die de mods zelf niet bevat, alleen verwijzingen ernaar en de configuratie. De serverbestanden krijg je op een van deze manieren:

• Via de Modrinth App (eenvoudiger): installeer het modpack in de app, open de map van de instantie en neem daaruit de mappen mods en config en de andere mappen van het modpack. Verwijder uit de map mods de zuivere clientmods (op Modrinth staat bij hun omgeving alleen Client).

• Voor gevorderden, met de tool mrpack-install: Modrinth noemt deze opdrachtregeltool als een van de manieren om een modpack op een server te zetten. Download hem voor jouw systeem van de pagina Releases in de repository van mrpack-install (opent in een nieuw venster) en voer in de map met het programma dit uit:

  mrpack-install <FILE>.mrpack --server-dir server-modpack

  • mrpack-install – het programma dat de serverbestanden van het modpack downloadt aan de hand van de lijst ervan (modrinth.index.json). Het gedownloade bestand heeft het systeem in de naam, bijvoorbeeld mrpack-install-windows.exe of mrpack-install-linux. In Windows start je het in PowerShell als .\mrpack-install-windows.exe, in Linux en macOS maak je het eerst uitvoerbaar met het commando chmod +x mrpack-install-linux en start je het als ./mrpack-install-linux.
  • <FILE>.mrpack – het pad naar het gedownloade modpack, bijvoorbeeld Downloads/mijn-pack.mrpack.
  • --server-dir server-modpack – de map waarin de bestanden worden gedownload. Die wordt vanzelf aangemaakt.

  Het programma downloadt naast de mods en de configuratie ook de server zelf met de loader. Upload die niet naar onze server, de loader wordt geïnstalleerd via het tabblad Software (stap 2).

Stap 4: Upload de bestanden naar de server#

Upload alleen deze onderdelen (als het modpack ze heeft):

• de map mods met alle .jar-bestanden,
• de map config,
• andere mappen van het modpack, bijvoorbeeld defaultconfigs, kubejs of resourcepacks, als de maker ze als onderdeel van de server noemt.

Zo doe je dat op het tabblad Bestanden:

1. Maak met de knop Nieuwe map in de hoofdmap van de server een map met dezelfde naam aan, bijvoorbeeld mods.
2. Open de map, klik op Uploaden en selecteer alle bestanden uit de overeenkomstige map op je computer. Je kunt meerdere bestanden tegelijk selecteren.
3. Doe hetzelfde voor submappen (bijvoorbeeld config en de mappen daarin).

Upload niet de server-.jar van het modpack, de map libraries, installers en startscripts (run.sh, run.bat, start.sh, user_jvm_args.txt). De loader is in stap 2 al door je klantaccount geïnstalleerd. Het bestand user_jvm_args.txt wordt op onze hosting niet gebruikt: het geheugen en de startparameters stelt het tabblad Opstarten in op basis van de grootte van het pakket en het aantal mods (Startflags en geheugen).

Upload ook de server.properties van het modpack niet. De server maakt het bestand zelf aan, met het adres en de poort die wij hem hebben toegewezen. Vereist de maker van het modpack eigen waarden (bijvoorbeeld het wereldtype bij skyblock-modpacks), stel die dan nog vóór de eerste start in: klik op het tabblad Serverinstellingen op Aanmaken met standaardwaarden, pas de nodige opties aan en sla op. Het wereldtype wordt alleen gebruikt bij het aanmaken van een nieuwe wereld, na de eerste start zou het geen effect meer hebben. Een eigen wereldtype dat door een mod wordt toegevoegd, weigert het formulier als onbekende waarde. Schrijf zo'n waarde rechtstreeks in het bestand server.properties op het tabblad Bestanden (Bewerken, opslaan met Ctrl+S).

Stap 5: Start de server en verbind#

1. Klik op het tabblad Console op Starten. De eerste start van een groot modpack duurt enkele minuten.
2. Wacht op de regel Done (…)! For help, type "help".
3. Verbind vanuit het spel met hetzelfde modpack in dezelfde versie.

Mods configureren#

Pas de instellingen aan op het tabblad Bestanden terwijl de server uit staat, en start de server na de wijziging. Bestanden met de extensie .toml hebben de vorm sleutel = waarde, bestanden met de extensie .json moeten geldige JSON-syntaxis hebben (komma's tussen de items, aanhalingstekens om tekst).

Controle#

1. Wacht op het tabblad Console tot de server bij de regel Done (…)! For help, type "help" komt. Eindigt hij in plaats daarvan met een fout, ga dan verder met het gedeelte Als iets niet werkt.
2. Controleer op het tabblad Mods, op het subtabblad Geïnstalleerd, of de mod is ingeschakeld. Handmatig geüploade mods hebben het label Handmatig geüpload.
3. Verbind vanuit het spel met een client die dezelfde loader, dezelfde Minecraft-versie en dezelfde mods heeft. De server mag de verbinding niet verbreken met een lijst van mods.
4. Controleer in het spel of de inhoud van de mod werkt (bijvoorbeeld of je een nieuw blok of voorwerp vindt in de inventaris van de creatieve modus).

Als iets niet werkt#

Zoek fouten in de console en in het bestand logs/latest.log. Als de server crasht, wordt er een rapport aangemaakt in de map crash-reports. Het belangrijkst daarin zijn de regel Description: en de eerste regel die begint met Caused by:.

Spelers worden bij het verbinden losgekoppeld met een lijst van mods#

De speler heeft niet dezelfde mods als de server (er ontbreekt een mod, hij heeft een andere versie, of hij heeft een extra contentmod die de server niet heeft). De melding noemt meestal de betreffende mods. Maak de versies gelijk, het liefst doordat de spelers dezelfde versie van het modpack gebruiken.

Mod resolution encountered an incompatible mod set! (Fabric)#

Fabric heeft bij het starten vastgesteld dat de mods niet samengaan. Onder de melding staat een lijst: een ontbrekende afhankelijkheid (bijvoorbeeld Fabric API), een te oude versie van de loader, of een mod voor een andere Minecraft-versie. Vul de genoemde mods aan of vervang ze. Vereist een mod een nieuwere Fabric loader, kies die dan op het tabblad Software in het veld Versie van de loader.

Attempted to load class … for invalid dist DEDICATED_SERVER (Forge, NeoForge) of Cannot load class … in environment type SERVER (Fabric)#

Op de server staat een clientmod. In de uitvoer boven de melding staat meestal de naam ervan. Verwijder hem uit de map mods.

UnsupportedClassVersionError#

De mod vereist een nieuwere Java en is dus bedoeld voor een nieuwere Minecraft-versie dan die waarop de server draait. Download de versie van de mod voor jouw Minecraft-versie.

De server crasht met OutOfMemoryError, of stopt vanzelf zonder fout#

De server heeft te weinig geheugen. Stopt hij zonder fout en staat in de Console Out of memory: true, dan heeft hij de geheugenlimiet van het pakket overschreden. Controleer op het tabblad Opstarten de meldingen bij de startflags en klik zo nodig op Aanbevolen gebruiken. Het helpt ook om zware mods te verwijderen, de weergaveafstand te verkleinen of over te stappen op een groter pakket. Meer details staan in het artikel Prestaties en optimalisatie.

Na de overstap van Paper worden de mods niet geladen#

Controleer op het tabblad Software of het servertype Fabric, Forge of NeoForge is. Mods moeten in de map mods staan, niet in plugins.

Het bestand is groter dan 100 MB#

Het bestand kan niet via je klantaccount worden geüpload. Vraag support om toegang via SFTP.

Andere meldingen worden beschreven in het artikel Veelvoorkomende fouten van een Minecraft-server. Kom je er niet uit, stuur ons dan het bestand uit crash-reports of logs/latest.log.

Meer bronnen#

• Fabric: mods installeren (opent in een nieuw venster)
• NeoForge: server (opent in een nieuw venster)
• Modrinth: modpacks op een server (opent in een nieuw venster)
• Modrinth: het .mrpack-formaat (opent in een nieuw venster)
• mrpack-install (opent in een nieuw venster)