Game Mods Installer Documentatie

Over Game Mods Installer

Game Mods Installer is een Pelican Panel-plugin van Eranio waarmee serverbeheerders game-mods kunnen zoeken, installeren, updaten en beheren rechtstreeks vanuit het panel — geen command line, geen SFTP, geen handmatig bestandsbeheer.

Ondersteunde Platformen

Ondersteunde Games

De plugin detecteert automatisch je gametype aan de hand van de Egg Tags, Egg Name of Nest Name (in die volgorde gecontroleerd):

Belangrijkste functies

• Visuele modbrowser — Blader door mods met pictogrammen, beschrijvingen, downloadaantallen en auteursinformatie op alle platformen
• Eén-klik-installatie — Selecteer een versie en installeer met één klik rechtstreeks op de server
• Automatische Minecraft-versiedetectie — Gebruikt 11 verschillende detectiemethoden (JAR-analyse, version.json, server.properties en meer)
• Updatetracking — Controleert periodiek bronplatformen op nieuwere versies en toont updatebadges (24 uur gecachet)
• Automatisch versies vervangen — Verwijdert automatisch oude modversies bij het installeren van nieuwe (configureerbaar)
• Mods in-/uitschakelen — Schakel mods aan en uit zonder ze te verwijderen door hernoemen met een -bak-achtervoegsel
• Afhankelijkheidsresolutie — Detecteert en installeert automatisch vereiste bibliotheekmods (bijv. Fabric API)
• ZIP-export — Download alle geïnstalleerde mods als één ZIP-archief met JWT-ondertekende URL's (30 minuten geldig)
• Consolewidget — Toont updatemeldingen rechtstreeks op de serverconsole-pagina
• Slimme caching — Bestandsgebaseerde cache met GM_-prefix en configureerbare TTL's per bewerking
• Uploaddetectie — Mods die handmatig via SFTP zijn geïnstalleerd, worden automatisch gedetecteerd en bijgehouden
• JAR-metadata-extractie — Leest plugin.yml, fabric.mod.json en META-INF/mods.toml uit JAR-bestanden

Hoe het werkt

1. De plugin downloadt het modbestand via DaemonFileRepository::pull() — met een cURL-fallback (60s timeout) als dat mislukt
2. De bestandsnaam wordt gedetecteerd met maximaal 3 pogingen (200ms → 300ms → 500ms vertraging) voor latentie van het bestandssysteem
3. JAR-metadata wordt geëxtraheerd (tot 30 MB, 256 MB geheugenlimiet) om de weergavenaam van de mod te lezen
4. De installatie wordt bijgehouden in de server_installed_mods-databasetabel
5. Als automatisch vervangen is ingeschakeld, worden oude versies verwijderd

Vereisten

• Pelican Panel 1.0.0 of nieuwer
• PHP 8.1, 8.2 of 8.3
• De mods-feature op je Egg
• CurseForge API-sleutel (alleen als je CurseForge gebruikt — gratis op console.curseforge.com)
• storage/ en bootstrap/cache/ schrijfbaar (permissies 0755)