Puzzles Lib — Minecraft Java Edition 1.21.1

Puzzles Lib je základní technická knihovna pro mody Minecraftu, kterou vytvořil vývojář Fuzs. Nepřidává do herního světa žádné nové bloky, předměty, moby ani herní mechaniky přímo. Její hlavní funkcí je poskytovat společné programové rozhraní (API), které umožňuje ostatním modifikacím běžet stejně stabilně na různých loaderech tím, že abstrahuje specifický kód Forge, Fabric a NeoForge. Mod Puzzles Lib je třeba stáhnout výhradně kvůli zajištění chodu souvisejících doplňků.

Ekosystém závislých modifikací

Tato knihovna je povinným požadavkem pro spuštění více než třiceti různých projektů. Obsahuje společný kód pro zpracování událostí, vykreslování modelů a synchronizaci dat mezi klientem a serverem.

Nejpopulárnější technické mody pro Minecraft, které tento framework využívají:

• Změny rozhraní a bloků: Easy Magic, Easy Anvils, Visual Workbench. Knihovna zodpovídá za uchování předmětů v inventářích těchto bloků po jejich zavření a za vizualizaci kořisti přímo na textuře bloku.

• Magická a obchodní rozšíření: Enchanting Infuser, Trading Post, Universal Enchants. Puzzles Lib zajišťuje logiku interakce těchto modů s vanilkovým generátorem náhodných čísel a s algoritmy generování obchodů vesničanů.

• Klientská rozšíření: kompasy, hodiny a další informační doplňky, kde API zajišťuje výpis dat na obrazovku bez poklesu FPS.

Konfigurace modů od Fuzs

Sjednocení formátů nastavení je klíčovým úkolem této knihovny. Místo podpory JSON pro Fabric a TOML pro Forge zavedl vývojář jednotný standard.

Puzzles Lib nuceně převádí všechny na ní závislé mody na používání formátu .toml. Samotná knihovna má rovněž vlastní konfigurační soubor puzzleslib-client.toml ve složce config.

checkIncompatibleMods

enableOptifineWarning

forceResourcePacks

Řešení problémů se spuštěním a konflikty

Protože je Puzzles Lib multiplatformní, chyby při sestavování klienta se vyskytují často. Analýza logů odhaluje tři hlavní příčiny pádů hry (crash) spojených s touto knihovnou.

Chybějící port konfigurací na Fabric

Chyba, která způsobí okamžité zavření hry ve fázi inicializace. Protože Fabric nativně nepodporuje konfigurační systém Forge (formát TOML), Puzzles Lib nemůže přečíst soubory nastavení. Pro nápravu situace je třeba do složky mods stáhnout pomocný mod Forge Config API Port.

Nekompatibilita verzí loaderu

Hráči často kopírují .jar soubor Puzzles Lib pro Forge do sestavy na Fabricu, nebo naopak. Soubory na platformách CurseForge a Modrinth mají odpovídající štítky (fabric, forge, neoforge v názvu). Spuštění souboru pro jiný loader zaručeně vyvolá chybu Mod resolution failed nebo java.lang.NoClassDefFoundError.

Desynchronizace serverových tagů

Pokud je knihovna nainstalována na serveru, ale chybí na klientu (nebo se verze liší), hráč při pokusu o připojení dostane chybu Connection closed - mismatched mod channel list. Puzzles Lib vyžaduje instalaci na obou stranách s identickou verzí souboru.

Kompatibilita

• Povinné závislosti: Pro hru na Fabric/Quilt jsou kriticky nezbytné Fabric API a Forge Config API Port. Pro Forge/NeoForge není třeba stahovat žádné další soubory — třídy jsou zabudovány v loaderu.

• Nekompatibilita: Integrace s OptiFine funguje nestabilně kvůli konfliktům ve vykreslovacím řetězci. Vývojář doporučuje používat alternativy: Sodium nebo Embeddium.

Závěr

Puzzles Lib je čistě technický nástroj, který zefektivňuje vývoj a umožňuje aktualizovat velký seznam modifikací na všech aktuálních loaderech najednou. V porovnání s rozsáhlými frameworky typu Architectury API je tento mod úzce zaměřený a obsluhuje výhradně ekosystém jediného autora. Omezením je poněkud přetížená struktura závislostí pro hráče na Fabricu, kteří musí stahovat cizí porty konfigurací. Přítomnost tohoto modu je povinná pro všechny, kdo sestavují technické nebo RPG modpacky s využitím nástrojů od Fuzs.