Konfiguration
Eranio
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_KEYvon 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: truemarkiert - 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"