UniLib: přehled knihovního modu pro vývojáře a kompatibilitu modpacků v Minecraftu

Multiplatformní vývoj modifikací pro Minecraft nutí autory přizpůsobovat svůj kód různým verzím hry a různým loaderům. Knihovna UniLib tento problém řeší tím, že poskytuje jednotnou sadu nástrojů a sjednocené API, které zjednodušuje interakci s herním enginem. Bere na sebe úkol zajištění kompatibility a umožňuje závislým modům fungovat na více než 50 verzích Minecraftu bez nutnosti přepisovat kód. Díky tomu hráči získávají stabilní modpacky, zatímco vývojáři šetří čas při údržbě jak starších, tak nových verzí hry.

Účel a klíčové funkce knihovny

V enginu Minecraftu se proces registrace nových bloků, předmětů, entit a block entit výrazně liší mezi loadery Fabric a Forge a navíc se neustále mění z verze na verzi. UniLib nabízí vývojářům jednotnou metodu registrace objektů. Místo psaní samostatných tříd pro každý loader autor modu používá standardní funkce UniLib, které se automaticky přizpůsobují aktuálnímu prostředí. To zabraňuje pádům během inicializace hry a zjednodušuje přenášení kódu.

Multiplatformní vykreslování rozhraní

Vykreslování obrazovek menu, tlačítek a dalších grafických prvků rozhraní se při aktualizacích Minecraftu často rozbíjí kvůli změnám ve vnitřních knihovnách hry. UniLib obsahuje vestavěnou sadu nástrojů pro kreslení oken a tlačítek, která funguje stejně jak na velmi starých verzích hry, tak na moderních verzích 1.20 a 1.21. To umožňuje ostatním modům vytvářet komplexní úpravy rozhraní při zachování stejného vzhledu a funkčnosti na jakémkoli systému.

Systém lokalizace a aktualizací

Změny v překladovém systému Minecraftu často způsobují, že se názvy předmětů nebo titulky přestanou správně zobrazovat v různých jazycích. UniLib tento problém řeší pomocí vlastních pomocných tříd pro lokalizaci, které najdou správné soubory překladů bez ohledu na změny ve vanilla kódu. Knihovna navíc obsahuje nástroj pro kontrolu aktualizací, který hráče automaticky upozorní v hlavním menu na vydání nových verzí závislých modů.

Závislé modifikace a praktický význam

Nejznámějším modem, který vyžaduje povinnou přítomnost UniLib, je CraftPresence. Tento mod integruje stav hráče do Discord Rich Presence a předává informace o aktuální dimenzi, biomu, zdraví a odehraném čase. CraftPresence využívá grafické nástroje UniLib ke kreslení vlastního menu nastavení a zároveň se opírá o systém mezi-verzové kompatibility, aby stabilně fungoval i na starších klientech Minecraftu.

Dalším příkladem je mod DropConfirm, který zobrazuje upozornění při náhodném zahození cenných předmětů. Bez nainstalovaného UniLib se hra s těmito mody nespustí a vypíše chybu inicializace.

Závěr

Ve srovnání s vývojem samostatných verzí pro každý loader a aktualizaci hry umožňuje UniLib sloučit logiku a grafické rozhraní pomocných modů do jednoho univerzálního souboru. Hlavním omezením knihovny je, že je zaměřena výhradně na klientskou část hry, a proto nepodporuje serverová rozšíření. Tento mod je vhodný pro hráče, kteří ve svých modpackech využívají integraci s Discord Rich Presence nebo ochranu proti náhodnému zahození předmětů.