Guides / Troubleshooting

.mrpack in ein normales Modpack-Zip umwandeln – und warum Entpacker scheitern

Eine .mrpack-Datei ist ein Manifest, kein Archiv von Mods. Beim Entpacken erhält man eine JSON-Datei und keine Jars. Hier erfährst du, was wirklich drin ist und was ein Konverter tun muss.

2026-07-09

Benenne eine .mrpack in .zip um, öffne sie, und du findest fast nichts: eine modrinth.index.json, vielleicht einen overrides/-Ordner. Die Mods fehlen. Das ist keine Beschädigung – das Format funktioniert wie vorgesehen.

Was sich darin befindet

modrinth.index.json     the manifest: name, version, loader, and a list of downloads
overrides/              config files, resource packs, anything not on Modrinth

Jeder Eintrag im Manifest sieht so aus:

{
  "path": "mods/sodium.jar",
  "hashes": { "sha1": "…", "sha512": "…" },
  "downloads": ["https://cdn.modrinth.com/data/…/sodium.jar"],
  "fileSize": 812345
}

Das Pack liefert Referenzen, keine Dateien. Deshalb ist ein 40-Mod-Pack ein 200 KB großer Download und deshalb "scheitert" jeder generische Entpacker – es gibt nichts zu entpacken.

Was eine Konvertierung tun muss

1. modrinth.index.json lesen.
2. Jeden Eintrag von seiner CDN-URL abrufen.
3. Jede Datei gegen den sha512-Hash im Manifest verifizieren. Wenn dies übersprungen wird,

gelangt eine beschädigte oder ersetzte Jar-Datei in ein Pack.

1. Jede Datei an ihrem path platzieren.
2. overrides/ darüber kopieren – Überschreibungen gewinnen, das ist ihr Zweck.
3. Das Ergebnis zippen.

Schritt 3 ist derjenige, den Konverter stillschweigend überspringen. Ein nicht übereinstimmender Hash bedeutet, dass der Download abgebrochen wurde oder die Datei geändert wurde; eine Installation führt trotzdem zu einem Pack, das beim Laden mit einem Fehler abstürzt, der auf den falschen Mod verweist.

Warum das Ganze überhaupt tun

• Launcher, die kein mrpack verstehen. ATLauncher, MultiMC und manuelle Installationen

benötigen einen Ordner mit Jars.

• Serverseitig. Server-Hosts akzeptieren fast nie eine .mrpack; sie wollen den Mods-Ordner.
• Offline-Installation. Einmal konvertiert, benötigt das Pack das CDN nicht mehr.

Das Feld env entscheidet über Client versus Server

Jede Datei enthält:

"env": { "client": "required", "server": "unsupported" }

Ein Server-Pack muss alles, was serverseitig als unsupported markiert ist, überspringen – hauptsächlich Shader, Minimaps und HUD-Mods. Das Kopieren des vollständigen Client-Mods-Ordners auf einen Server ist die übliche Ursache für einen Absturz beim Start, der eine Rendering-Klasse benennt.

Den umgekehrten Weg gehen

Das Erstellen einer .mrpack aus einem Ordner ist das Gegenteil und hat eine Falle: Jeder Mod, der nicht auf Modrinth ist, kann kein Manifest-Eintrag sein. Er muss in overrides/mods/, was das Pack größer macht, aber es funktionsfähig hält. Das stillschweigende Entfernen dieser Mods führt zu einem Pack, das sauber installiert wird und Inhalte fehlen.

Konvertiere in beide Richtungen, mit Hash-Verifizierung und der env-Aufteilung, in den Resource Pack Zip Tools.

Zip-Werkzeuge für Ressourcenpakete →