Game Mods Installer Dokumentation

Über den Game Mods Installer

Game Mods Installer ist ein Pelican-Panel-Plugin von Eranio, mit dem Serveradministratoren Game-Mods direkt über das Panel durchsuchen, installieren, aktualisieren und verwalten können — ohne Kommandozeile, ohne SFTP, ohne manuelle Dateioperationen.

Unterstützte Plattformen

Unterstützte Spiele

Das Plugin erkennt automatisch den Spieltyp anhand von Egg-Tags, Egg-Name oder Nest-Name (in dieser Reihenfolge):

Hauptfunktionen

• Visueller Mod-Browser — Durchsuche Mods mit Icons, Beschreibungen, Downloadzahlen und Autorinformationen
• One-Click-Installation — Wähle eine Version und installiere mit einem Klick direkt auf den Server
• Automatische Minecraft-Versionserkennung — Nutzt 11 verschiedene Erkennungsmethoden (JAR-Analyse, version.json, server.properties u.v.m.)
• Update-Tracking — Prüft regelmäßig die Quellplattform auf neuere Versionen und zeigt Update-Badges (Cache: 24 Stunden)
• Automatische Versionsersetzung — Entfernt alte Mod-Versionen automatisch bei der Installation neuer (konfigurierbar)
• Mods aktivieren/deaktivieren — Mods ein- und ausschalten ohne sie zu löschen (Umbenennung mit -bak-Suffix)
• Abhängigkeitsauflösung — Erkennt und installiert automatisch benötigte Bibliotheks-Mods (z.B. Fabric API)
• ZIP-Export — Alle installierten Mods als ZIP-Archiv herunterladen (JWT-signierte URLs, 30 Minuten gültig)
• Konsolen-Widget — Zeigt Update-Benachrichtigungen direkt auf der Server-Konsolenseite
• Intelligentes Caching — Dateibasierter Cache mit GM_-Präfix und konfigurierbaren TTLs
• Upload-Erkennung — Manuell per SFTP installierte Mods werden automatisch erkannt und erfasst
• JAR-Metadaten-Extraktion — Liest plugin.yml, fabric.mod.json und META-INF/mods.toml aus JARs

Funktionsweise

1. Das Plugin lädt die Mod-Datei via DaemonFileRepository::pull() herunter — mit cURL-Fallback (60s Timeout) bei Fehler
2. Der Dateiname wird mit bis zu 3 Versuchen erkannt (200ms → 300ms → 500ms Verzögerung)
3. JAR-Metadaten werden extrahiert (bis 30 MB, 256 MB Speicherlimit) für den Anzeigenamen
4. Die Installation wird in der server_installed_mods-Datenbanktabelle erfasst
5. Bei aktivierter Auto-Ersetzung werden alte Versionen gelöscht

Voraussetzungen

• Pelican Panel 1.0.0 oder neuer
• PHP 8.1, 8.2 oder 8.3
• Das mods-Feature auf deinem Egg
• CurseForge-API-Schlüssel (nur bei CurseForge-Nutzung — kostenlos auf console.curseforge.com)
• storage/ und bootstrap/cache/ beschreibbar (Berechtigung 0755)