Konfiguration
Konfiguration
Vollständige Referenz zu allen Einstellungen, Umgebungsvariablen, Cache-Verhalten und detaillierter Provider-Dokumentation mit Fehlerbeschreibungen.
Admin-Panel-Einstellungen
Öffne die Einstellungen über das Zahnrad-Symbol auf der Mod-Browser-Seite. Änderungen werden sofort gespeichert.
Einstellungsreferenz
| Einstellung |
Standard |
Bereich |
Umgebungsvariable |
Beschreibung |
| Cache-Dauer |
30 Min. |
0–1440 Min. |
MODS_CACHE_DURATION (Sekunden, Standard 1800) |
Wie lange API-Antworten gecacht werden |
| Request-Timeout |
10 Sek. |
1–30 Sek. |
MODS_REQUEST_TIMEOUT |
Max. Wartezeit auf API-Antwort |
| Mods pro Seite |
20 |
5–100 |
MODS_PER_PAGE |
Ergebnisse pro Browse-Seite |
| Auto-Ersetzung |
An |
Umschalter |
MODS_AUTO_REPLACE_VERSIONS |
Alte Versionen bei Update entfernen |
| CurseForge-API-Schlüssel |
— |
Text |
CURSEFORGE_API_KEY |
Erforderlich für CurseForge (Passwortfeld) |
| Modtale-API-Schlüssel |
— |
Text |
MODTALE_API_KEY |
Optional für Modtale (Passwortfeld) |
Detaillierte Cache-TTLs
| Was wird gecacht |
Cache-Schlüssel-Muster |
TTL |
| Suche/Browse-Ergebnisse |
browse_mods__{uuid}__{provider}__{gameVersion}__{loader}__{hash}__{page} |
15 Minuten |
| Liste installierter Mods |
mods_server_{uuid} |
10 Minuten |
| Versionslisten pro Mod |
mod_versions_cache_{uuid}_{provider}_{modId} |
1 Stunde |
| Update-Metadaten |
mod_update__{uuid}__{modId} |
24 Stunden |
| Erkannte MC-Version |
minecraft_version_{uuid} |
5 Minuten |
| Angereicherte Installationsdaten |
game_mods_data__{uuid} |
24 Stunden |
| Server-Mod-Dateinamen |
server_{uuid}_mod_filenames |
1 Stunde |
| Konsolen-Widget-Updates |
mod_updates_{uuid} |
Widget-spezifisch |
Cache nutzt dateibasiertes System mit Präfix GM_. SafeCacheService erstellt Verzeichnisse automatisch mit 0755.
Alle Umgebungsvariablen
| Variable |
Standard |
Beschreibung |
MODS_CACHE_DURATION |
1800 |
Cache-Dauer in Sekunden |
MODS_REQUEST_TIMEOUT |
10 |
API-Timeout in Sekunden |
MODS_PER_PAGE |
20 |
Mods pro Browse-Seite |
MODS_AUTO_REPLACE_VERSIONS |
true |
Alte Versionen automatisch entfernen |
CURSEFORGE_API_KEY |
— |
CurseForge-API-Schlüssel (geteilt mit Modpacks + Plugins) |
MODTALE_API_KEY |
— |
Modtale-API-Schlüssel (optional) |
Nach Änderungen: php artisan config:clear
Anbieter: Modrinth (Detailliert)
Übersicht
Keine Konfiguration erforderlich. Empfohlene Plattform.
Technische Details
| Eigenschaft |
Wert |
| API-Basis |
https://api.modrinth.com/v2 |
| Authentifizierung |
Keine |
| Suchmethode |
POST /search mit Facetten-JSON |
| Auto-Facetten |
[["project_type:mod"], ["server_side:required","server_side:optional"]] |
| Download |
Direkte CDN-URL aus files[0].url |
| Integrität |
SHA-1-Hash verfügbar |
Suchfunktionen
- Volltextsuche über Namen, Slugs, Beschreibungen
- Minecraft-Versionsfilter: Als Facette übergeben
- Mod-Loader-Filter: Als Facette. Werte
'all' und 'any' werden automatisch ausgeschlossen
- Ergebnisse: Icon-URL, Name, Autor, Beschreibung, Downloads, Erstellungsdatum, Slug
Abhängigkeitsauflösung
dependency_type === 'required' löst Auto-Installation aus- Spezifische
version_id → exakte Version wird geladen
- Keine version_id → neueste kompatible Version wird gesucht
Modrinth-spezifische Fehler
| Fehler / Symptom |
Ursache |
Lösung |
| Keine Suchergebnisse |
API vorübergehend nicht verfügbar |
status.modrinth.com prüfen, später erneut versuchen |
| Download fehlgeschlagen |
CDN-URL abgelaufen oder nicht erreichbar |
Cache leeren, erneut suchen, nochmal versuchen |
| Leere Versionsliste |
Keine Server-Versionen für MC-Version + Loader |
Anderen Versions-/Loader-Filter versuchen |
| Langsame Antworten |
API unter Last |
Timeout auf 20-30s erhöhen |
Anbieter: CurseForge (Detailliert)
Übersicht
Erfordert kostenlosen API-Schlüssel. Größte Mod-Bibliothek. Schlüssel unter console.curseforge.com.
API-Schlüssel erhalten
- console.curseforge.com besuchen
- Konto erstellen (kostenlos) oder einloggen
- Unter „API Keys" → neuen Schlüssel erstellen
- Schlüssel kopieren → im Plugin unter CurseForge-API-Schlüssel einfügen
- Speichern klicken
Dieser Schlüssel wird über CURSEFORGE_API_KEY von Game Mods, Modpacks und Plugins gemeinsam genutzt.
Technische Details
| Eigenschaft |
Wert |
| API-Basis |
https://api.curseforge.com/v1 |
| Authentifizierung |
x-api-key-Header |
| Game-IDs |
Minecraft = 432, Hytale = 70216 |
| Class-ID |
9137 (Mods) |
| Max. Seitengröße |
50 Ergebnisse pro Anfrage |
| Max. Ergebnisse gesamt |
10.000 |
Sortieroptionen (12 verfügbar)
| Sortierfeld |
ID |
Standard-Reihenfolge |
| Featured |
1 |
Absteigend (bei Suchbegriff) |
| Popularity |
2 |
Absteigend (ohne Suchbegriff) |
| LastUpdated |
3 |
Absteigend |
| Name |
4 |
Aufsteigend (einzige aufsteigende Sortierung) |
| TotalDownloads |
6 |
Absteigend |
| Rating |
12 |
Absteigend |
Mod-Loader-Enum
| Loader |
CurseForge-ID |
| Forge |
1 |
| Cauldron |
2 |
| LiteLoader |
3 |
| Fabric |
4 |
| Quilt |
5 |
| NeoForge |
6 |
Abhängigkeitsauflösung
relationType=3 = erforderliche Abhängigkeit- Rekursiv: Abhängigkeiten von Abhängigkeiten werden ebenfalls aufgelöst
Spezialfall: Manueller Download erforderlich
Manche Mod-Autoren beschränken direkte Downloads. Bei leerer downloadUrl:
- Mod als
requires_manual_download: true markiert
- Plugin zeigt Link zur CurseForge-Seite
- CurseForge-Richtlinie, keine Plugin-Einschränkung
CurseForge-spezifische Fehler
| Fehler / Symptom |
Ursache |
Lösung |
| „CurseForge API key not set" |
Kein Schlüssel konfiguriert |
Schlüssel in Einstellungen eingeben oder CURSEFORGE_API_KEY setzen |
| HTTP 403 Verboten |
Schlüssel ungültig oder ohne Berechtigung |
Schlüssel auf console.curseforge.com neu generieren |
| HTTP 429 Zu viele Anfragen |
Rate-Limit überschritten |
Cache-Dauer erhöhen, warten, weniger browsen |
| Leere Download-URL |
Autor hat Downloads beschränkt |
Manuell von CurseForge-Website herunterladen |
| „CurseForge request failed" |
Netzwerk-/API-Fehler |
Verbindung zu api.curseforge.com prüfen, Timeout erhöhen |
| Beschreibung lädt nicht |
Enrichment-API-Aufruf fehlgeschlagen |
Nicht kritisch — Mod funktioniert trotzdem |
| Langsame Antworten |
CurseForge unter hoher Last |
Timeout auf 20-30s erhöhen |
Anbieter: Modtale (Detailliert)
Übersicht
API-Schlüssel optional für erweiterte Rate-Limits.
Technische Details
| Eigenschaft |
Wert |
| API-Basis |
https://api.modtale.net/api/v1 |
| CDN |
https://cdn.modtale.net/ |
| Authentifizierung |
Optional X-MODTALE-KEY-Header |
| Paginierung |
0-basiert (Seite 0 = erste Seite) |
Modtale-spezifische Fehler
| Fehler / Symptom |
Ursache |
Lösung |
| Langsame Ergebnisse |
Modtale-API langsamer als andere |
Timeout erhöhen |
| Rate-Limit |
Zu viele Anfragen ohne Schlüssel |
Modtale-API-Schlüssel hinzufügen |
| CDN-Download fehlgeschlagen |
cdn.modtale.net nicht erreichbar |
Firewall prüfen, erneut versuchen |
| Keine Abhängigkeiten angezeigt |
Modtale-API liefert keine Abhängigkeitsinfos |
Abhängigkeiten manuell installieren |
Suchbereinigung
Alle Plattformen: Zeichen < > { } ' " werden automatisch aus Suchbegriffen entfernt.
Fehlerbehebung
Einstellungen werden nicht gespeichert
storage/-Verzeichnis-Schreibrechte prüfenphp artisan config:clear- Browser-Konsole (F12) auf JS-Fehler prüfen
Cache lässt sich nicht leeren
- SafeCacheService
flush() durchläuft alle erfassten Schlüssel
- Wenn
storage/framework/cache/ fehlt oder nicht beschreibbar → Cache-Operationen schlagen fehl
- Fehlerbenachrichtigung zeigt
$e->getMessage() der gefangenen Exception
- Log: „Error clearing cache and scanning mods"