Farbthema
العربية Беларуская Български Čeština Dansk Deutsch Ελληνικά English Español Suomi Français עברית Magyar Bahasa Indonesia Italiano 日本語 한국어 Lietuvių Nederlands Norsk ☠ Pirate Polski Português (BR) Português (PT) Română Русский Slovenčina Српски Svenska Türkçe Українська 简体中文 繁體中文

Mod Browser

Eranio

Mod Browser

Vollständige Anleitung zum Mod Browser, Suche, Browsen, Filtern, Mod-Details, Installation, Abhängigkeitsauflösung und plattformspezifisches Verhalten.

Auf dem Handy

Auf kleinen Bildschirmen wandern Reiter und Aktionsknöpfe aus dem Kopf in eine von zwei Ansichten:

  • Leiste unten: „Durchsuchen“, „Installiert“, die Aktionen (ZIP, Ordner, Cache und Version, wenn angezeigt) und „Auswahlfeld“ zum Umschalten. Es passen bis zu fünf Felder. Sind es mehr, rutschen die letzten in „Mehr“.
  • Auswahlfeld: Unter dem Titel steht der aktuelle Reiter. Ein Tippen zeigt beide Reiter, die Aktionen und den Wechsel zurück zur Leiste.

Die Aktionen verhalten sich genau wie die Knöpfe am Computer, Bestätigungsfenster eingeschlossen. Die Zahl der Updates an „Installiert“ erscheint als kleiner Punkt, ein Tippen öffnet die Liste direkt gefiltert auf Mods mit Update. Die gewählte Ansicht wird im Browser gespeichert und gilt auch in Hytale Admin und im jeweils anderen Plugin.

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

  1. Modname oder Stichwort in die Suchleiste eingeben
  2. Ergebnisse laden nach 300ms Debounce (verhindert übermäßige API-Aufrufe)
  3. Sucht nur auf der aktuell ausgewählten Plattform
  4. Suchanfragen werden bereinigt: < > { } ' " werden entfernt
  5. 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: 26.3"
  • Gängige Versionen: live aus Mojangs Versionsliste, aktuell 26.3 (Aktuell), 26.2, 26.1, 1.21 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

  1. Internetverbindung prüfen: curl -I https://api.modrinth.com
  2. Plattform-Status prüfen (Website direkt besuchen)
  3. Cache leeren klicken
  4. Breitere Suchbegriffe verwenden
  5. Versionsfilter prüfen, falsche Version versteckt Ergebnisse
  6. Anderen Plattform-Tab versuchen
  7. storage/logs/laravel.log prüfen
  8. 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
Konfiguration Mods verwalten