Farbthema
v2.1.0

Minecraft Modpacks Dokumentation

Durchsuche, installiere und verwalte Minecraft-Modpacks von 6 Anbietern mit automatischem Egg-Wechsel, Backup-Verwaltung, Konfigurations-Merging und Plugin-übergreifender Bereinigung.

18
Endpunkte
8
Verarbeitung
REST
Architektur
JSON
Format

Über Minecraft Modpacks

Minecraft Modpacks ist ein Pelican-Panel-Plugin von 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 mit passender Java-Version und passendem Startbefehl, installiertes Pack in der Datenbank speichern

Installationstypen

Typ Bedingung Verhalten
Erstinstallation Für den Server ist kein Pack gespeichert 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
  • Java automatisch, Minecraft 26.x bekommt Java 25, ältere Packs das Java, das sie brauchen, siehe Modpacks installieren
  • Startbefehl nach Aikar, G1-Flags mit Heap aus dem Speicherlimit des Servers, auch bei unbegrenztem Speicher
  • Installationsspeicher, jede Installation mit Minecraft-Version, Java-Version und Ergebnis in server_modpack_installs, das installierte Pack in server_installed_modpacks

Voraussetzungen

  • Pelican Panel 1.0.0-rc.1 oder neuer
  • PHP 8.5
  • 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/ und bootstrap/cache/ beschreibbar (Berechtigungen 0755)

API Referenz

Anleitungen