LibJF — Technische Mod-Bibliothek und Kern für Third-Party Mods in Minecraft

LibJF — Technische Mod-Bibliothek und Kern für Third-Party Mods in Minecraft

LibJF ist eine modulare Bibliothek des Autors JFronny, die eine Reihe gemeinsamer Komponenten für dessen eigene Mods enthält. Auf dem PC eines Spielers wird diese Mod normalerweise nicht einzeln installiert, sondern als zwingende Abhängigkeit — ohne sie starten die entsprechenden Mods nicht. LibJF fügt Minecraft keine Rezepte, Mobs oder neue Blöcke hinzu. Ihre Aufgabe ist eine andere: wiederkehrende Funktionen — Konfigurationsformat, Übersetzungssystem, lokaler HTTP-Server, zwei Hilfs-Tags — in ein separates Projekt auszulagern und in verschiedenen Mods desselben Entwicklers wiederzuverwenden.

Zweck in einem Modpack

Die Bibliothek ist in separate Module unterteilt, die jeweils für eine eigene Aufgabe zuständig sind: Format von Konfigurationsdateien und deren In-Game-Menü, Item-Tags, Übersetzung, Netzwerkkomponenten. Mods, die von LibJF abhängig sind, laden nur die Module, die sie tatsächlich verwenden. Daher erscheint nach dem ersten Spielstart nicht nur eine Datei im config/-Ordner, sondern mehrere — eine pro aktivem Modul.

Einer der grundlegenden Effekte, den der Spieler sofort bemerken wird, ist das automatische Neuladen von Konfigurationen. Der watchForChanges Parameter ist standardmäßig aktiviert: Wenn du eine Konfigurationsdatei änderst, die über LibJF funktioniert, werden die Änderungen ohne Neustart des Spiels übernommen.

Universelle Tags für Items und Rüstungen

LibJF fügt zwei Tags hinzu, die sowohl für andere Mods als auch für Vanilla-Datapacks verfügbar sind:

Die Tags selbst sind leer — sie werden von einem Datapack oder einer Third-Party Mod befüllt. Um beispielsweise ein komplettes Lederset im Überlebensmodus "undurchdringlich" zu machen, reicht es aus, ein kleines Datapack zu erstellen, das minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings und minecraft:leather_boots zur Tag-Datei libjf:overpowered hinzufügt.

Übersetzungs-Subsystem

Das libjf-translate-v1 Modul gibt den anderen Mods des Entwicklers Zugriff auf einen String-Übersetzungsdienst. Die Bibliothek selbst übersetzt nichts im Chat oder Interface — sie bestimmt nur, über welchen externen Dienst die Anfragen gehen, wenn eine Consumer-Mod sie aufruft. Vier Provider-Optionen werden unterstützt:

• Google — öffentliche Google Translate-Schnittstelle (Standardwert).

• DeepLX — offene Implementierung der DeepL-API.

• LibreTranslate — selbstgehostete Open-Source-Lösung; erfordert die separate Angabe der Instanzadresse.

• Noop — ein Platzhalter, der den eingegebenen Text unverändert zurückgibt; nützlich für Tests und um die Übersetzung komplett zu deaktivieren.

Ein separater throttleMillis Parameter legt die minimale Pause zwischen Dienstaufrufen fest. Diese Einschränkung ist notwendig, um temporäre Sperren durch die kostenlose API bei häufigen Anfragen einer Consumer-Mod zu vermeiden.

Lokaler Webserver

Das libjf-web-v1 Modul startet einen kleinen HTTP-Server innerhalb des Spiels. Er wird von den anderen Mods des Autors verwendet, wenn es notwendig ist, dem Client mehr als nur ein reguläres Netzwerkpaket zu übergeben — zum Beispiel eine statische Seite oder eine Vorschaudatei. Auf dem Standard-Arbeitsplatz eines Spielers ist dieses Modul normalerweise stumm: Der Port ist nur lokal geöffnet (127.0.0.1) und die Dateifreigabe ist deaktiviert.

Administratoren von privaten Servern können die Freigabe beliebiger Dateien aus dem config/wwwroot Ordner als statische Ressourcen über einen separaten Konfigurationsparameter aktivieren — dies ist eine optionale Funktion, die standardmäßig nicht aktiviert ist.

Fazit

LibJF ist eine Abhängigkeitsbibliothek, die erforderlich ist, wenn ein Modpack eine Mod desselben Entwicklers oder ein Datapack enthält, das die Tags libjf:overpowered oder libjf:shulker_boxes_illegal verwendet. Vor dem Hintergrund anderer Bibliotheken dieser Klasse zeichnet sie sich durch eine modulare Architektur und das Vorhandensein eines lokalen HTTP-Servers zusammen mit einer Übersetzungsschicht aus, was die meisten Hilfsbibliotheken nicht bieten. Für ein normales Vanilla Minecraft Java Edition Modpack macht es keinen Sinn, LibJF zu installieren; für Modpacks mit JFronny-Mods ist es eine zwingende Komponente.