Mod Browser
Mod Browser
Vollständige Anleitung zum Mod Browser — Suche, Browsen, Filtern, Mod-Details, Installation, Abhängigkeitsauflösung und plattformspezifisches Verhalten.
Browser-Oberfläche
| Tab |
Zweck |
| Durchsuchen |
Neue Mods auf allen Plattformen suchen und entdecken |
| Installiert |
Installierte Mods verwalten (siehe Anleitung „Mods verwalten") |
Mods suchen
So funktioniert die Suche
- Modname oder Stichwort in die Suchleiste eingeben
- Ergebnisse laden nach 300ms Debounce (verhindert übermäßige API-Aufrufe)
- Sucht nur auf der aktuell ausgewählten Plattform
- Suchanfragen werden bereinigt:
< > { } ' " werden entfernt
- Ergebnisse als Mod-Karten-Raster angezeigt
Suchtipps
| Tipp |
Beispiel |
| Nach Modname suchen |
Sodium, Create, JEI |
| Nach Stichwort suchen |
Optimierung, Minimap, Speicher |
| Kurznamen verwenden |
ic2 statt IndustrialCraft 2 |
| Verschiedene Plattformen haben unterschiedliche Inhalte |
Mehrere Tabs probieren |
| Leere Suche |
Zeigt beliebte/empfohlene Mods |
Plattformspezifisches Suchverhalten
| Plattform |
Leere Suche |
Mit Suchbegriff |
Standard-Sortierung |
| Modrinth |
Beliebte Mods mit Facetten |
Volltextsuche mit Facetten |
Relevanz |
| CurseForge |
Sortiert nach Popularity (ID 2, absteigend) |
Sortiert nach Featured (ID 1, absteigend) |
Siehe Konfiguration |
| Modtale |
Alle nach Spiel browsen |
Volltextsuche |
Standardreihenfolge |
Filter
| Filter |
Beschreibung |
Standard |
| Minecraft-Version |
Nur kompatible Mods |
Auto-erkannte Version (🟢 Erkannt: X.X.X) |
| Mod-Loader |
Forge, Fabric, NeoForge, Quilt |
Alle Loader |
| Anbieter |
Plattform-Tabs wechseln |
Modrinth |
Versionen-Dropdown
- Auto-erkannte Version (falls verfügbar) — „🟢 Erkannt: 1.21.4"
- Gängige Versionen: 1.21 (Aktuell) bis 1.7, mit 1.12 (Beliebt) und 1.8 (Legacy)
Mod-Karten
| Element |
Beschreibung |
| Icon |
Mod-Logo von der Plattform-CDN |
| Name |
Mod-Titel |
| Autor |
Benutzername des Erstellers |
| Zusammenfassung |
Kurzbeschreibung |
| Downloads |
Gesamt über alle Versionen |
| Aktualisiert |
Veröffentlichungsdatum der letzten Version |
| 🟢 Installiert |
Grüner Indikator falls bereits installiert |
Mod-Detailansicht
Klicke auf eine Mod-Karte:
- Vollständige Beschreibung — CurseForge: HTML via
/mods/{modId}/description. Modrinth: Markdown
- Autor und Link zur Plattformseite (CurseForge nutzt
getModSlug())
- Gesamtdownloads
- „Auf [Plattform] anzeigen"-Button
Versionsauswahl
| Kennzeichnung |
Bedeutung |
| 🟢 installiert |
Diese Version ist installiert |
| (Aktuell) |
Neueste Version |
| (Beliebt) |
Meistgeladene Version (wenn anders als aktuell) |
| (Legacy) |
Ältere Version |
Versionen 1 Stunde pro Mod pro Anbieter gecacht.
Mod installieren
Was passiert Schritt für Schritt
| Schritt |
Detail |
| 1. Vorprüfung |
Download-URL wird validiert |
| 2. Alte Version prüfen |
Bestehende Installation per Mod-ID in Datenbank gesucht |
| 3. Download |
DaemonFileRepository::pull() nach /mods/ |
| 4. cURL-Fallback |
Bei pull()-Fehler → cURL-Download mit 60s Timeout. Log: „Error downloading mod" |
| 5. Dateinamenerkennung |
3 Versuche: 200ms → 300ms → 500ms. UUID-Präfixe (server uuid_short) werden bereinigt |
| 6. JAR-Metadaten |
JAR öffnen (≤30 MB, 256 MB Speicherlimit). Liest plugin.yml, fabric.mod.json, META-INF/mods.toml. Bei Fehler: „Failed to extract mod name from JAR" |
| 7. Datenbank |
Speichert: provider, mod_id, mod_slug, mod_url, version_id, version_number, version_name, filename, download_url, installed_at |
| 8. Alte Version bereinigen |
Bei Auto-Ersetzung → deleteFiles() entfernt alte Version |
| 9. Fertig |
Erfolg: „Mod installation started". Log: „Successfully installed mod" |
Bei Fehler
- Titel: „Mod installation failed"
- Vollständiger Fehler in
storage/logs/laravel.log
Automatische Abhängigkeitsauflösung
Modrinth
dependency_type === 'required' → Auto-Installation- Spezifische
version_id → exakte Version
- Keine version_id → neueste kompatible Version
CurseForge
relationType=3 (erforderlich) → Auto-Installation- Rekursiv: Auch Abhängigkeiten von Abhängigkeiten
Modtale
- Nicht verfügbar — Keine Abhängigkeitsinfos in der API
- Manuell installieren
Benachrichtigung
„X zusätzliche Bibliotheks-Mods werden installiert, die für diesen Mod erforderlich sind"
Fehlerbehebung
Keine Suchergebnisse
- Internetverbindung prüfen:
curl -I https://api.modrinth.com
- Plattform-Status prüfen (Website direkt besuchen)
- Cache leeren klicken
- Breitere Suchbegriffe verwenden
- Versionsfilter prüfen — falsche Version versteckt Ergebnisse
- Anderen Plattform-Tab versuchen
storage/logs/laravel.log prüfen- CurseForge: API-Schlüssel gesetzt?
„Mod-Download fehlgeschlagen"
- Abgelaufene URL: Cache leeren, erneut suchen, nochmal versuchen
- CDN nicht erreichbar: Plattform-CDN vorübergehend down → warten und erneut versuchen
- cURL-Fallback ausgelöst: Bei
pull()-Fehler 60s cURL-Download. Log: „Error downloading mod"
- Festplatte voll: Kein Speicher auf dem Gameserver
- Großdatei-Timeout: Timeout in Einstellungen erhöhen
„Installation fehlgeschlagen"
/mods/-Verzeichnis nicht beschreibbar → Berechtigungen prüfen- Speicherplatz voll
- Dateinamenerkennung nach 3 Versuchen fehlgeschlagen → Log: „Failed to detect filename after download"
- Datenbankschreibfehler
„Mod-Identifikation nicht gefunden!"
- Leere
pluginId beim Versuch zu installieren/verwalten
- Mod erneut suchen für frische Metadaten
- Cache leeren und nochmals versuchen
Modname zeigt Dateiname statt Namen
- JAR-Metadaten-Extraktion fehlgeschlagen (Datei >30 MB oder kein
plugin.yml/fabric.mod.json/META-INF/mods.toml)
- Log: „Failed to extract mod name from JAR"
- Nur kosmetisch — Mod funktioniert korrekt
CurseForge zeigt „Manueller Download erforderlich"
- Autor hat direkte Downloads beschränkt
downloadUrl ist leer in der API-Antwort- Plugin zeigt Link zur CurseForge-Seite
- Manuell herunterladen und per SFTP/Dateimanager hochladen