Minecraft Modpacks Dokumentation
Durchsuche, installiere und verwalte Minecraft-Modpacks von 6 Anbietern mit automatischem Egg-Wechsel, Backup-Verwaltung, Konfigurations-Merging und Plugin-übergreifender Bereinigung.
Über Minecraft Modpacks
Minecraft Modpacks ist ein Pelican-Panel-Plugin von TimVida & Eranio, mit dem Serveradministratoren komplette Minecraft-Modpacks direkt über das Panel durchsuchen, installieren, aktualisieren und verwalten können. Es unterstützt 6 Modpack-Anbieter, übernimmt den komplexen Installationsprozess automatisch (einschließlich Egg-Wechsel, Dateibewahrung, Backup-Erstellung und Konfigurationszusammenführung) und integriert sich mit den Game Mods und Minecraft Plugins Plugins für Plugin-übergreifende Bereinigung.
Unterstützte Anbieter
| Anbieter | Suche | Direkte Installation | Benötigt Launcher | API-Schlüssel | Versionsfilter |
|---|---|---|---|---|---|
| Modrinth | Volltextsuche | Ja | Nein | Nein | Ja |
| CurseForge | Volltextsuche | Ja | Nein | Ja (kostenlos) | Ja |
| ATLauncher | Volltextsuche | Nein | Ja | Nein | Nein |
| FeedTheBeast | Volltextsuche | Nein | Ja | Nein | Nein |
| Technic | Volltextsuche | Nein | Ja | Nein | Nein |
| VoidsWrath | Nur Browsen | Ja (Server-Pack) | Nein | Nein | Nein |
Wie die Modpack-Installation funktioniert
Im Gegensatz zur einzelnen Mod-Installation erfordern Modpacks einen komplexen mehrstufigen Prozess:
| Schritt | Name | Was passiert |
|---|---|---|
| 1 | Bewahren | Wichtige Dateien (server.properties, eula.txt, ops.json, Ban-Listen, Whitelist, Usercache, /config/, /plugins/) im Speicher gesichert |
| 2 | Backup | ZIP-Backup mit deutschem Namen basierend auf Installationstyp erstellt |
| 3 | Löschen | Alle Serverdateien gelöscht außer geschützte Verzeichnisse (Welten, Plugins, Logs) |
| 4 | Download | Server gestoppt → Installer-Egg gewechselt → Neuinstallation → Warten auf Download (300s Timeout) |
| 5 | Entpacken | Dateistabilität überwacht — 3 aufeinanderfolgende stabile Prüfungen = Dekompression abgeschlossen |
| 6 | Wiederherstellen | Bewahrte Dateien wiederhergestellt (überspringt bedingt /config/ und /plugins/ für späteres Merging) |
| 7 | Zusammenführen | Bis zu 45s Warten auf Erscheinen der Mods/Config-Verzeichnisse, dann Konfigurations-Merge (JSON, YAML, Properties, TOML) |
| 8 | Abschließen | Zurück zum Runtime-Egg wechseln, Tracking-Datei (.installed_modpack.json) speichern |
Installationstypen
| Typ | Bedingung | Emoji | Verhalten |
|---|---|---|---|
| Erstinstallation | Kein .installed_modpack.json gefunden |
🟢 | Vollständige Installation |
| Update | Gleiches Modpack, andere Version | 🟠 | Optionen: Konfigurationen behalten oder löschen |
| Wechsel | Andere modpack_id | 🔴 | Vollständige Bereinigung + Installation |
| Neuinstallation | Gleiches Modpack + gleiche Version | 🔵 | Aktuelle Version neu installieren |
Hauptfunktionen
- 6-Anbieter-Unterstützung — Modrinth, CurseForge, ATLauncher, FeedTheBeast, Technic, VoidsWrath
- Automatischer Egg-Wechsel — Wechselt zwischen Installer-Egg (mit Download-Variablen) und Runtime-Egg
- Intelligentes Backup — Automatische Backup-Erstellung vor jeder Installation mit konfigurierbaren Limits
- Konfigurationszusammenführung — Bewahrt deine Anpassungen über Modpack-Updates hinweg (JSON, YAML, Properties, TOML)
- Plugin-Konfig-Zusammenführung — Scannt
/plugins/PluginName/und führt einzelne Konfigurationsdateien zusammen - Plugin-übergreifende Bereinigung — Leert Game Mods und Minecraft Plugins Daten bei Modpack-Änderungen
- Fortschritts-Widget — Echtzeit-8-Schritte-Anzeige mit Auto-Weiterleitung bei Abschluss
- Direkte Installation — Modrinth (.mrpack) und CurseForge (manifest.json) können direkt ohne Launcher installieren
- Tracking-Datei —
.installed_modpack.jsonverfolgt was installiert ist für Update-Erkennung
Voraussetzungen
- Pelican Panel 1.0.0 oder neuer
- PHP 8.1, 8.2 oder 8.3
- Das
modpacks-Feature auf deinem Egg - Ein Installer-Egg (automatisch durch Seeder erstellt) und ein Runtime-Egg
- CurseForge-API-Schlüssel (nur für CurseForge — kostenlos unter console.curseforge.com)
storage/undbootstrap/cache/beschreibbar (Berechtigungen0755)
API Referenz
CurseForge API
https://api.curseforge.com/v1
CurseForge Modpacks API (classId=4471) — Suche, Details und Datei-Downloads.
Modrinth API
https://api.modrinth.com/v2
Modrinth Modpack-Suche mit project_type:modpack Facette.
FeedTheBeast API
https://api.feed-the-beast.com/v1
FTB Modpack-Auflistung — zweistufiges Laden: IDs abrufen, dann Details pro Pack.
Technic API
https://api.technicpack.net
Technic Platform Modpack-Suche und Details — benötigt Build-Parameter.
ATLauncher API
https://api.atlauncher.com/v2/graphql
ATLauncher GraphQL-API — Pack-Auflistung mit Typ-Filterung und Versions-Metadaten.
VoidsWrath API
https://www.voidswrath.com
VoidsWrath statischer JSON-Katalog — alle Packs in einer einzigen Anfrage.
Anleitungen
Installation & Einrichtung
# Installation & Einrichtung Vollständige Schritt-für-Schritt-Anleitung zur I...
Konfiguration
# Konfiguration Vollständige Referenz zu allen Einstellungen, Umgebungsvariab...
Modpack Browser
# Modpack Browser Vollständige Anleitung zum Durchsuchen, Suchen und Filtern...
Modpacks installieren
# Modpacks installieren Vollständige Anleitung zum 8-Schritte-Installationspr...
Modpacks verwalten
# Modpacks verwalten Installiertes Modpack anzeigen, auf neue Versionen aktua...