LibJF — Technická knihovna a jádro pro podporu módů třetích stran v Minecraftu

LibJF — Technická knihovna a jádro pro podporu módů třetích stran v Minecraftu

LibJF je modulární knihovna od autora JFronny, která obsahuje sadu sdílených komponent pro jeho vlastní módy. Na počítač hráče se tento mód obvykle neinstaluje sám o sobě, ale jako povinná závislost — bez něj se příslušné módy nespustí. LibJF do Minecraftu nepřidává žádné recepty, moby ani nové bloky. Její úkol je jiný: vyčlenit opakující se funkcionalitu — formát konfigurací, překladový systém, lokální HTTP server, dva pomocné tagy — do samostatného projektu a znovu ji použít napříč různými módy stejného vývojáře.

Účel v Modpacku

Knihovna je rozdělena na samostatné moduly, z nichž každý odpovídá za svůj úkol: formát konfiguračních souborů a jejich herní menu, tagy předmětů, překlad, síťové komponenty. Módy závislé na LibJF načítají pouze ty moduly, které skutečně používají. Po prvním spuštění hry se proto ve složce config/ neobjeví pouze jeden soubor, ale hned několik (jeden za každý aktivní modul).

Jedním ze základních efektů, kterého si hráč hned všimne, je automatické znovunačítání konfigurací. Parametr watchForChanges je ve výchozím nastavení povolen: pokud změníte jakýkoli konfigurační soubor fungující přes LibJF, změny se projeví bez restartování hry.

Univerzální Tagy pro Předměty a Zbroj

LibJF přidává dva tagy, které jsou dostupné jak pro jiné módy, tak pro vanilla datapacky:

Samotné tagy jsou prázdné — plní je datapack nebo mód třetí strany. Chcete-li například v survivalu učinit kompletní koženou sadu "neprůraznou", stačí vytvořit malý datapack, který přidá minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings a minecraft:leather_boots do souboru tagu libjf:overpowered.

Překladový subsystém

Modul libjf-translate-v1 poskytuje dalším módům vývojáře přístup ke službě překladu řetězců. Samotná knihovna v chatu ani v rozhraní nic nepřekládá — pouze určuje, přes jakou externí službu budou požadavky probíhat, pokud je spotřebitelský mód zavolá. Podporovány jsou čtyři možnosti poskytovatelů:

• Google — veřejné rozhraní Google Translate (výchozí hodnota).

• DeepLX — otevřená implementace DeepL API.

• LibreTranslate — open-source řešení s vlastním hostováním; vyžaduje ruční zadání adresy instance.

• Noop — záslepka, která vrací zadaný text beze změny; užitečné pro testy a k úplnému vypnutí překladu.

Samostatný parametr throttleMillis nastavuje minimální pauzu mezi voláními služby. Toto omezení je nutné, aby se předešlo dočasným zákazům bezplatného API při častých požadavcích z módu.

Lokální Webový Server

Modul libjf-web-v1 spouští uvnitř hry malý HTTP server. Využívají ho ostatní módy autora, když je nutné klientovi poskytnout něco víc než jen běžný síťový paket (např. statickou stránku nebo soubor s náhledem). Ve standardním prostředí hráče je tento modul obvykle potichu: port je otevřen pouze lokálně (127.0.0.1) a sdílení souborů je zakázáno.

Administrátoři soukromých serverů mohou povolit sdílení libovolných souborů ze složky config/wwwroot jako statických prostředků prostřednictvím samostatného konfiguračního parametru — jedná se o volitelnou funkci, která není ve výchozím nastavení aktivována.

Závěr

LibJF je knihovna závislostí nutná tehdy, když modpack obsahuje mód od stejného vývojáře nebo datapack, který používá tagy libjf:overpowered nebo libjf:shulker_boxes_illegal. Na pozadí jiných knihoven této třídy vyniká modulární architekturou a přítomností lokálního HTTP serveru spolu s překladovou vrstvou, což většina pomocných knihoven nenabízí. Pro běžný vanilla Minecraft Java Edition modpack nemá smysl LibJF instalovat; pro modpacky s módy JFronny je to povinná součást.