JamLib — eine technische Bibliothek für andere Minecraft-Mods

JamLib — eine technische Bibliothek für andere Minecraft-Mods

JamLib ist ein Bibliotheks-Mod für Minecraft, der von sich aus weder Items noch Blöcke, Mobs oder Strukturen zum Spiel hinzufügt. Es ist ein Utility-Wrapper, der Autoren anderer Mods Folgendes bietet: eine Plattformabstraktion zwischen den Loadern, ein fertiges Konfigurationsdateisystem und einen Detektor für neu verpackte Jar-Dateien. Ohne diese Bibliothek starten Mods, die sie voraussetzen, einfach nicht.

Was der Mod macht

Die Bibliothek löst gleichzeitig drei Aufgaben für den Entwickler:

• Plattformabstraktionen auf Basis von Architectury — derselbe Code läuft auf Fabric, Forge, NeoForge und Quilt ohne separate Zweige.

• Eine Konfigurations-API im JSON5-Format mit automatischem Einstellungsbildschirm im Spiel.

• Prüfung der Jar-Datei eines Mods auf Anzeichen von Neuverpackung durch Piraten-«Spiegel».

Aus Sicht des Spielers fügt die Bibliothek dem Gameplay nichts hinzu. Das Einzige, was auffallen könnte, ist ein neuer Eintrag im Mod-Menü für jeden Mod, der JamLib für seine Einstellungen verwendet. Wenn solche Mods in der Modpack vorhanden sind, erscheint im entsprechenden Fenster eine automatisch generierte Seite mit Schiebereglern, Schaltern und Eingabefeldern.

JSON5-Konfigurationen

Standard-JSON erlaubt keine Kommentare im Code. JSON5, mit dem die Bibliothek über die Abhängigkeit Jankson arbeitet, erlaubt das. In der Praxis bedeutet das, dass die Einstellungsdateien von Mods, die auf JamLib basieren, wie .json5 aussehen und bereits Kommentare enthalten, die jeden Parameter zusammen mit seinem Standardwert direkt darüber beschreiben.

Die Dateien behalten Benutzeränderungen beim Neuschreiben bei: Wenn du eine eigene Notiz mit einer //-Zeile hinzufügst, bleibt sie nach dem nächsten Speichern der Konfiguration erhalten. Standard-JSON-Bibliotheken können das nicht.

Einstellungsbildschirme werden separat generiert. Auf Fabric und Quilt wird die Oberfläche über das Standard-Mod-Menü eingebunden, auf Forge und NeoForge über die eingebaute Konfigurationsbildschirm-API des Loaders. Mod-Autoren müssen keine GUI von Hand schreiben: JamLib übernimmt die Felder aus der Konfigurationsklasse und erstellt dafür Widgets mit Validierung — Zahlenbereiche, ein regulärer Ausdruck für Strings, Warnungen zur Notwendigkeit eines Spielneustarts.

Erkennung neu verpackter Mods

Eine separate Funktion prüft, ob die .jar-Datei des installierten Mods aus einer offiziellen Quelle heruntergeladen wurde. Manche Websites verpacken Mods unter eigenem Namen neu und bündeln manchmal Drittanbieter-Software damit. JamLib vergleicht den tatsächlichen Dateinamen mit dem Feld JamLib-File-Name in seinem Manifest. Stimmen sie nicht überein, wird nach dem Laden der Welt eine Warnung im Chat ausgegeben. Die Meldung wird einmal pro verdächtiger Datei angezeigt, danach wird der Name dieser .jar-Datei gemerkt.

Die Prüfung betrifft nur Mods, deren Autoren JamLib-File-Name absichtlich in ihr Manifest aufgenommen haben (also Mods desselben Entwicklers oder solche, die diese Funktion manuell integriert haben). Die Bibliothek scannt nicht jede .jar-Datei im mods-Ordner auf Viren oder Schadcode — sie ist kein Antivirenprogramm.

Fazit

JamLib befreit einen Mod-Entwickler davon, ein Konfigurationssystem und eine Plattformabstraktion für vier Loader gleichzeitig von Hand zu schreiben. JamLib zu installieren ergibt nur zusammen mit einem abhängigen Mod Sinn, der es voraussetzt. Enthält eine Modpack keinen Mod von JamCoreModding oder einem Drittanbieter, der auf dieser Bibliothek aufbaut, liegt die .jar-Datei von JamLib einfach ohne aktive Rolle im mods-Ordner.