JamLib — technická knihovna pro další mody v Minecraftu

JamLib — technická knihovna pro další mody v Minecraftu

JamLib je knihovní mod pro Minecraft, který sám o sobě do hry nepřidává žádné předměty, bloky, moby ani struktury. Jde o pomocný obal, který autorům dalších modů poskytuje následující: abstrakci platformy mezi loadery, hotový systém konfiguračních souborů a detektor přebalených jar souborů. Bez této knihovny se mody, které ji vyžadují, jednoduše nespustí.

Co mod dělá

Knihovna řeší pro vývojáře najednou tři úkoly:

• Platformní abstrakce založené na Architectury — stejný kód běží na Fabric, Forge, NeoForge a Quilt bez samostatných větví.

• API pro konfigurace ve formátu JSON5 s automatickou obrazovkou nastavení ve hře.

• Kontrola jar souboru modu na známky přebalení z pirátských «zrcadel».

Z pohledu hráče knihovna do hratelnosti nic nepřidává. Jediné, čeho si lze všimnout, je nová položka v menu modů u každého modu, který používá JamLib pro svá nastavení. Pokud jsou takové mody v balíčku přítomny, v příslušném okně se zobrazí automaticky vygenerovaná stránka s posuvníky, přepínači a poli pro zadávání.

Konfigurace JSON5

Standardní JSON neumožňuje komentáře v kódu. JSON5, se kterým knihovna pracuje přes závislost Jankson, to umožňuje. V praxi to znamená, že konfigurační soubory modů postavených na JamLib vypadají jako .json5 a už obsahují komentáře popisující každý parametr spolu s výchozí hodnotou přímo nad ním.

Soubory při přepisu zachovávají úpravy uživatele: pokud přidáte vlastní poznámku na řádku začínajícím //, po dalším uložení konfigurace zůstane na místě. Standardní JSON knihovny toto neumí.

Obrazovky nastavení se generují samostatně. Na Fabric a Quilt se rozhraní zobrazuje přes standardní menu modů, na Forge a NeoForge přes vestavěné API konfiguračních obrazovek loaderu. Autoři modů nemusí GUI psát ručně: JamLib bere pole z konfigurační třídy a staví pro ně widgety s validací — rozsah čísel, regulární výraz pro řetězce, upozornění na nutnost restartu hry.

Detektor přebalených modů

Samostatná funkce kontroluje, zda byl .jar soubor nainstalovaného modu stažen z oficiálního zdroje. Některé weby mody přebalují pod vlastními jmény a někdy do nich přidávají software třetích stran. JamLib porovnává skutečný název souboru s polem JamLib-File-Name v jeho manifestu. Pokud se neshodují, po načtení světa se v chatu zobrazí upozornění. Zpráva se zobrazí jednou pro každý podezřelý soubor, poté se název tohoto .jar zapamatuje.

Kontrola se týká pouze modů, jejichž autoři záměrně přidali JamLib-File-Name do svého manifestu (tedy modů stejného vývojáře nebo těch, kdo tuto funkci integrovali ručně). Knihovna neskenuje každý .jar ve složce mods na viry nebo škodlivý kód — není to antivirus.

Závěr

JamLib osvobozuje vývojáře modu od ručního psaní konfiguračního systému a platformní abstrakce hned pro čtyři loadery najednou. Instalace JamLib dává smysl pouze společně se závislým modem, který ji vyžaduje. Pokud balíček neobsahuje žádný mod od JamCoreModding ani jiného autora třetí strany postavený na této knihovně, .jar soubor JamLib prostě zůstane ve složce mods bez aktivní role.