العربية Беларуская Български Č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 Українська 简体中文 繁體中文

Plugin Browser

Plugin Browser

Vollständige Anleitung zum Plugin Browser — Suchen, Durchblättern, Filtern, Plugin-Details, Installation, Abhängigkeitsauflösung und anbieterspezifisches Verhalten.

Browser-Oberfläche

Tab Zweck
Durchsuchen Neue Plugins über alle Anbieter suchen und entdecken
Installiert Installierte Plugins verwalten (siehe Anleitung „Plugins verwalten")

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

Anbieter Leere Suche Mit Suchbegriff Hinweise
SpigotMC Sortiert nach -downloads Volltext über Spiget Gesamtzahl aus X-Total Header
CurseForge Popularität (ID 2, abst.) Empfohlen (ID 1, abst.) Dynamische Sortierung
Modrinth Beliebt mit Facetten Volltext mit Facetten Plugin-Typ-Facetten
Hangar Alle durchblättern Volltextsuche Owner/Slug-Format für IDs
GeyserMC 6 feste Projekte Keine Suche Feste Projektliste

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

Filter

Filter Beschreibung Standard
Minecraft Version Nur kompatible Plugins Automatisch erkannte Version
Anbieter Plattform-Tab-Wechsel SpigotMC

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

15 Einträge von 1.21 bis 1.7 mit speziellen Labels:

  • 1.21.x — „Latest"
  • 1.12.x — „Popular"
  • 1.8.x — „Legacy"

Plugin-Karten

Element Beschreibung
Icon Plugin-Logo vom Anbieter-CDN
Name Plugin-Titel
Autor Ersteller-Benutzername
Zusammenfassung Kurzbeschreibung
Downloads Gesamte Download-Anzahl
Aktualisiert Datum der letzten Veröffentlichung
🟢 Installiert Grüner Indikator wenn bereits installiert

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

Label Bedeutung
🟢 installed Diese Version ist installiert
(Current) Neueste Version
(Popular) Meistgeladene Version
(Legacy) Ältere Version

Versionen werden 1 Stunde pro Plugin pro Anbieter gecacht.

Ein Plugin installieren

Schritt-für-Schritt-Prozess

Schritt Detail
1. Validierung Download-URL wird überprüft
2. Alte Version prüfen Bestehende Installation wird nach plugin_id gesucht
3. Download DaemonFileRepository::pull() nach /plugins/
4. Dateiname erkennen 3 Versuche: 200ms → 300ms → 500ms. Prüft plugin_id in Dateinamen → Fallback zum mitgelieferten Dateinamen. UUID-Präfix wird bereinigt
5. JAR-Metadaten Öffnet JAR, liest plugin.yml → name Feld für Anzeigename. Fallback: Dateiname mit Versions-Regex-Bereinigung
6. Datenbank Speichert im MinecraftInstalledPlugin Model
7. Alte Version aufräumen Wenn Auto-Ersetzung an → deleteFiles() entfernt alte Version
8. Fertig Erfolg: „Plugin installation started"

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
Konfiguration Plugins verwalten