Konfiguration

Vollständige Referenz zu allen Einstellungen, Umgebungsvariablen, Cache-Verhalten und detaillierter Anbieter-Dokumentation mit Fehlerbeschreibungen.

Admin-Panel-Einstellungen

Öffne die Einstellungen über das Zahnrad-Symbol auf der Modpack-Browser-Seite.

Einstellungsreferenz

Einstellung	Standard	Bereich	Umgebungsvariable	Beschreibung
Cache-Dauer	30 Min.	0–1440 Min.	`MODPACKS_CACHE_DURATION` (Sekunden, Standard `1800`)	Wie lange API-Antworten gecacht werden
Request-Timeout	10 Sek.	1–30 Sek.	`MODPACKS_REQUEST_TIMEOUT`	Max. Wartezeit auf API-Antwort
Modpacks pro Seite	20	5–100	`MODPACKS_PER_PAGE`	Ergebnisse pro Browse-Seite
CurseForge-API-Schlüssel	—	Text	`CURSEFORGE_API_KEY`	Erforderlich für CurseForge (Passwortfeld)

Anbieter: Modrinth (Detailliert)

Übersicht

Keine Konfiguration erforderlich. Direkte serverseitige Installation unterstützt.

Technische Details

Eigenschaft	Wert
API-Basis	`https://api.modrinth.com/v2`
Authentifizierung	Keine erforderlich
Facetten	`[["project_type:modpack"], ["server_side:required","server_side:optional"]]`
Download	Direkte URL mit SHA-1-Hash

Direkter Installationsprozess

Lädt .mrpack-Datei herunter → umbenannt in .zip
Parst modrinth.index.json für Abhängigkeiten
Loader-Auflösung: fabric → fabricmc.net, quilt → quiltmc.org
forge/neoforge → als nicht unterstützt für direkte Installation protokolliert
Kopiert overrides/-Verzeichnis zum Server-Root
Generiert run.sh + run.bat

Modrinth-spezifische Fehler

Fehler	Ursache	Lösung
Keine Suchergebnisse	API vorübergehend nicht verfügbar	status.modrinth.com prüfen
Download fehlgeschlagen	CDN-URL abgelaufen	Cache leeren, erneut suchen
Forge/NeoForge nicht unterstützt	Direkte Installation unterstützt diese Loader nicht	Egg-basierte Installation verwenden

Anbieter: CurseForge (Detailliert)

Übersicht

Erfordert kostenlosen API-Schlüssel. Direkte serverseitige Installation unterstützt.

Technische Details

Eigenschaft	Wert
API-Basis	`https://api.curseforge.com/v1`
Authentifizierung	`x-api-key`-Header
Class-ID	4471 (Modpacks)
Game-ID	432 (Minecraft)
Max. Seitengröße	50, Gesamtlimit 10.000

CurseForge-spezifische Fehler

Fehler	Ursache	Lösung
„CurseForge API key not set"	Kein Schlüssel konfiguriert	Schlüssel in Einstellungen eingeben
HTTP 403	Schlüssel ungültig	Schlüssel auf console.curseforge.com neu generieren
HTTP 429	Rate-Limit überschritten	Cache-Dauer erhöhen, warten

Anbieter: ATLauncher (Detailliert)

Benötigt Launcher — kein direkter Server-Download.

Eigenschaft	Wert
API	GraphQL unter `https://api.atlauncher.com/v2/graphql`
Icons-CDN	`https://cdn.atlcdn.net/`
`requires_launcher`	`true` — Kann nicht direkt auf dem Server installiert werden

Anbieter: FeedTheBeast (Detailliert)

Benötigt Launcher — kein direkter Server-Download.

Eigenschaft	Wert
API	`https://api.feed-the-beast.com/v1/modpacks/public/modpack`
Übersprungen	`packId=81` (Platzhalter/Test-Pack, automatisch ausgeschlossen)
`requires_launcher`	`true`

Anbieter: Technic (Detailliert)

Benötigt Launcher — kein direkter Server-Download.

Eigenschaft	Wert
API	`https://api.technicpack.net`
Build-Nummer	Aus `/launcher/version/stable4` geholt (Fallback: `'822'`)
Suche	Benötigt Suchbegriff — Fallback zu `'Technic'` wenn leer
`requires_launcher`	`true`

Anbieter: VoidsWrath (Detailliert)

Direkter Server-Pack-Download verfügbar. Nur Browsen (keine Suchfunktion).

Eigenschaft	Wert
API	Statisches JSON unter `https://www.ric-rac.org/minecraft-modpack-server-installer/voidswrath.json`
Versionen	Nur „neueste" Version pro Modpack
Download	`serverPackUrl` für direkten Server-Download
`supportsSearch()`	`false` — Nur Browsen, keine Suche
Paginierung	Clientseitig (alle Daten auf einmal geladen)

Cache-Verhalten

Cache-Präfix: MP_

Was gecacht wird	TTL	Schlüsselmuster
Browse-Suche	Konfigurierte Dauer (1800s)	`modpacks:{operation}:{provider}:{md5}`
Versionsliste	Konfigurierte Dauer	Gleiches Muster
Modpack-Details	Konfigurierte Dauer	Gleiches Muster
Download-Info	Konfigurierte Dauer	Gleiches Muster
Installationsfortschritt	10 Min.	Schritt-/Fortschrittstracking
Widget-Update-Check	5 Min.	`modpack_widget_update_{uuid}`

⚠️ Globale Cache-Flush-Warnung

ModpackManager::clearCache() verwendet Cache::flush() — das ALLE gecachten Daten löscht — nicht nur Modpack-Daten. Dies betrifft alle Plugins und den gesamten Panel-Cache.

Den „Cache leeren"-Button sparsam verwenden.

Fehlerbehebung

Einstellungen werden nicht gespeichert

storage/-Verzeichnis-Schreibrechte prüfen
php artisan config:clear
Browser-Konsole (F12) auf JS-Fehler prüfen

CurseForge funktioniert nicht

API-Schlüssel muss gesetzt sein — kostenlos unter console.curseforge.com erhältlich
Gleicher Schlüssel wird von Game Mods und Minecraft Plugins verwendet