Plugin Browser

Eranio

Plugin Browser

Vollständige Anleitung zum Plugin Browser, Suchen, Durchblättern, Filtern, Plugin-Details, Installation, Abhängigkeitsauflösung und anbieterspezifisches 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 (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 Plugins mit Update. Die gewählte Ansicht wird im Browser gespeichert und gilt auch in Hytale Admin und im jeweils anderen Plugin.

Browser-Oberfläche

Der Installiert-Tab zeigt ein oranges Badge mit der Anzahl verfügbarer Updates. Klicken auf den Tab wendet automatisch den has_updates-Filter an.

Plugins suchen

Wie die Suche funktioniert

1. Gib einen Plugin-Namen oder Suchbegriff in die Suchleiste ein
2. Ergebnisse laden nach einer Verzögerung (Debounce)
3. Gesucht wird nur beim aktuell ausgewählten Anbieter
4. Abfrage wird bereinigt: < > { } ' " entfernt
5. Ergebnisse werden als Plugin-Karten angezeigt

Such-Wiederholung

Wenn die Suche mit MC-Versionsfilter null Ergebnisse liefert, wiederholt das Plugin automatisch ohne Versionsfilter, du siehst dann Ergebnisse für alle MC-Versionen anstatt einer leeren Seite.

Anbieterspezifische Suche

GeyserMC: Zeigt immer genau 6 Projekte an. Die Suchleiste hat keine Auswirkung. Dies sind die offiziell gepflegten Geyser-Ökosystem-Plugins.

Filter

Versionsfilter-Sichtbarkeit

• Angezeigt bei: SpigotMC, CurseForge, Modrinth
• Ausgeblendet bei: PaperMC/Hangar, GeyserMC (versionsunabhängige Anbieter)

Die automatisch erkannte Version wird mit einem „🟢 Detected" Präfix angezeigt.

Häufige Versionen Dropdown

Live aus Mojangs Versionsliste (Ausweichliste von 26.3 bis 1.7) mit speziellen Labels:

• 26.3.x, „Latest" (immer die neueste Version)
• 1.12.x, „Popular"
• 1.8.x, „Legacy"

Plugin-Karten

Plugin-Detailansicht

Klicke auf eine Plugin-Karte um zu sehen:

• Vollständige Beschreibung, CurseForge: HTML-Anreicherung. Modrinth: Markdown
• Autor und Plattform-Link
• Gesamte Downloads
• „Auf [Anbieter] ansehen" Button

Versionsauswahl

Versionen werden 1 Stunde pro Plugin pro Anbieter gecacht.

Ein Plugin installieren

Schritt-für-Schritt-Prozess

GeyserMC Spezieller Download-Ablauf

GeyserMC umgeht den normalen Download:

1. cURL lädt JAR in Temp-Datei herunter (benutzerdefinierter User-Agent)
2. Upload via DaemonFileRepository::putContent()
3. Kein pull() verwendet, komplett anderer Ablauf

Abhängigkeitsauflösung

CurseForge

• relationType=3 = erforderliche Abhängigkeit
• Rekursiv: Abhängigkeiten von Abhängigkeiten werden auch aufgelöst
• Jede Abhängigkeit löst eine separate Filament-Benachrichtigung aus
• Abhängigkeiten werden vor dem Hauptplugin installiert

Modrinth

• dependency_type === 'required' → automatische Installation
• Spezifische version_id → exakte Version
• Keine version_id → neueste kompatible suchen

SpigotMC

• Keine Abhängigkeits-API, Abhängigkeiten müssen manuell installiert werden

PaperMC/Hangar

• pluginDeps mit required: true → automatische Installation
• Nur Paper-Plattform-Abhängigkeiten

GeyserMC

• Keine Abhängigkeits-API, Geyser ist typischerweise eine Abhängigkeit für Floodgate

Benachrichtigung

„X additional library plugins will be installed that are required for this plugin"

Fehlerbehebung

Keine Suchergebnisse

1. Internetverbindung prüfen
2. Überprüfe ob die Anbieter-API online ist
3. Cache leeren Button
4. Für CurseForge: API-Schlüssel gesetzt?
5. Anderen Anbieter-Tab versuchen
6. Automatische Wiederholung ohne Versionsfilter sollte greifen, wenn immer noch leer, Suche erweitern
7. storage/logs/laravel.log prüfen

„Plugin download failed"

• URL abgelaufen: Cache leeren, erneut suchen, nochmals versuchen
• CDN nicht erreichbar: Anbieter-CDN vorübergehend offline
• SpigotMC Premium: HEAD-Check lieferte HTML → manueller Download erforderlich
• GeyserMC: Erreichbarkeit von download.geysermc.org prüfen
• Festplatte voll: Kein Speicherplatz auf dem Spielserver

„Installation failed"

• /plugins/-Verzeichnis nicht beschreibbar → Berechtigungen prüfen
• Speicherplatz voll
• Dateiname-Erkennung nach 3 Versuchen fehlgeschlagen → Log: „Failed to detect filename after download"
• Datenbank-Schreibfehler

„Plugin identification not found!"

• Leere pluginId beim Installieren/Verwalten
• Plugin erneut suchen für aktuelle Metadaten
• Cache leeren und erneut versuchen

Plugin-Name zeigt Dateinamen statt Name

• JAR-Metadatenextraktion fehlgeschlagen (kein plugin.yml in JAR oder Datei zu groß)
• Nur kosmetisch, Plugin funktioniert korrekt

CurseForge zeigt „Manual download required"

• Autor hat direkte Downloads eingeschränkt
• downloadUrl leer in der API-Antwort
• Manuell von der CurseForge-Website herunterladen und per SFTP hochladen

SpigotMC zeigt „Manual download required"

• HEAD-Request lieferte text/html statt JAR
• Plugin ist Premium oder Download-eingeschränkt
• Von SpigotMC kaufen/herunterladen und per SFTP hochladen