Puzzles Lib — Minecraft Java Edition 1.21.1

Puzzles Lib to podstawowa biblioteka techniczna dla modów do Minecrafta, stworzona przez dewelopera Fuzs. Mod nie dodaje nowych bloków, przedmiotów, mobów ani mechanik rozgrywki bezpośrednio do świata gry. Jego główną funkcją jest udostępnianie wspólnego interfejsu programistycznego (API), który pozwala innym modyfikacjom działać równie stabilnie na różnych loaderach, abstrahując specyficzny kod Forge, Fabric i NeoForge. Mod Puzzles Lib należy pobrać wyłącznie po to, by zapewnić działanie powiązanych dodatków.

Ekosystem modów zależnych

Ta biblioteka jest obowiązkowym wymogiem do uruchomienia ponad trzydziestu różnych projektów. Zawiera wspólny kod do obsługi zdarzeń, renderowania modeli oraz synchronizacji danych między klientem a serwerem.

Najpopularniejsze techniczne mody do Minecrafta korzystające z tego frameworka:

• Zmiany interfejsów i bloków: Easy Magic, Easy Anvils, Visual Workbench. Biblioteka odpowiada za zachowanie przedmiotów w ekwipunkach tych bloków po ich zamknięciu oraz za wizualizację łupu bezpośrednio na teksturze bloku.

• Rozszerzenia magiczne i handlowe: Enchanting Infuser, Trading Post, Universal Enchants. Puzzles Lib zapewnia logikę interakcji tych modów z waniliowym generatorem liczb losowych oraz algorytmami generowania transakcji mieszkańców wiosek.

• Rozszerzenia klienckie: kompasy, zegary i inne dodatki informacyjne, w których API obsługuje wyświetlanie danych na ekranie bez spadku FPS.

Konfiguracja modów Fuzs

Ujednolicenie formatów ustawień to kluczowe zadanie tej biblioteki. Zamiast obsługiwać JSON dla Fabric i TOML dla Forge, deweloper wprowadził jeden standard.

Puzzles Lib przymusowo przestawia wszystkie zależne od niej mody na korzystanie z formatu .toml. Sama biblioteka również posiada własny plik ustawień puzzleslib-client.toml w folderze config.

checkIncompatibleMods

enableOptifineWarning

forceResourcePacks

Rozwiązywanie problemów z uruchomieniem i konflikty

Ponieważ Puzzles Lib jest wieloplatformowa, błędy podczas budowania klienta zdarzają się często. Analiza logów wskazuje na trzy główne przyczyny, przez które dochodzi do crasha gry, związane z tą biblioteką.

Brak portu konfiguracji dla Fabric

Błąd prowadzący do natychmiastowego zamknięcia gry na etapie inicjalizacji. Ponieważ Fabric natywnie nie obsługuje systemu konfiguracji Forge (formatu TOML), Puzzles Lib nie może odczytać plików ustawień. Aby to naprawić, należy wgrać do folderu mods pomocniczy mod Forge Config API Port.

Niezgodność wersji loaderów

Gracze często kopiują plik .jar Puzzles Lib przeznaczony dla Forge do paczki na Fabric, lub odwrotnie. Pliki na platformach CurseForge i Modrinth mają odpowiednie tagi (fabric, forge, neoforge w nazwie). Uruchomienie pliku przeznaczonego dla innego loadera gwarantuje błąd Mod resolution failed lub java.lang.NoClassDefFoundError.

Desynchronizacja tagów serwerowych

Jeśli biblioteka jest zainstalowana na serwerze, ale brakuje jej na kliencie (lub wersje się różnią), gracz otrzymuje błąd Connection closed - mismatched mod channel list przy próbie połączenia. Puzzles Lib wymaga instalacji po obu stronach z identyczną wersją pliku.

Zgodność

• Wymagane zależności: Do gry na Fabric/Quilt krytycznie niezbędne są Fabric API oraz Forge Config API Port. Dla Forge/NeoForge nie trzeba pobierać dodatkowych plików — klasy są wbudowane w loader.

• Niekompatybilność: Integracja z OptiFine działa niestabilnie z powodu konfliktów w potoku renderowania. Deweloper zaleca korzystanie z alternatyw: Sodium lub Embeddium.

Podsumowanie

Puzzles Lib to wyłącznie narzędzie techniczne, które optymalizuje proces tworzenia i pozwala aktualizować dużą listę modyfikacji na wszystkich aktualnych loaderach jednocześnie. W porównaniu z dużymi frameworkami pokroju Architectury API ten mod jest wąsko ukierunkowany i obsługuje wyłącznie ekosystem jednego autora. Ograniczeniem jest nieco przeładowana struktura zależności dla graczy Fabric, którzy muszą pobierać zewnętrzne porty konfiguracji. Obecność tego moda jest obowiązkowa dla wszystkich, którzy składają techniczne lub RPG-owe paczki z wykorzystaniem narzędzi Fuzs.