AzureLib — techniczna biblioteka modów wspierająca animacje i modele 3D w Minecraft
AzureLib to biblioteka dla Minecrafta obsługująca animacje w stylu Bedrock w modach, sama nie dodając przedmiotów ani mobów.
AzureLib to biblioteka dla Minecrafta obsługująca animacje w stylu Bedrock w modach, sama nie dodając przedmiotów ani mobów.
AzureLib — techniczna biblioteka modów wspierająca animacje i modele 3D w Minecraft
Wersja Minecrafta, na której przetestowano i napisano artykuł: 1.21.1
Zakres obsługiwanych wersji: 1.15.2 – 1.21.1
Zależności: Fabric API (dla wersji na Fabric)
AzureLib to biblioteka narzędziowa Minecrafta, bez której nie uruchomi się cały szereg modów ze złożoną animacją modeli. Sama biblioteka nie dodaje do gry żadnych przedmiotów, mobów ani struktur — jej zadaniem jest obsługa renderowania i odtwarzania animacji modeli w formacie Bedrock, których silnik waniliowy nie potrafi przetworzyć.
Jeśli w opisie danego moda widnieje pozycja Requires AzureLib, autor oparł się na jej systemie animacji zamiast pisać własny. Bez biblioteki taki mod wywali błąd przy wczytywaniu albo nie wyrenderuje poprawnie swoich modeli.
Co zapewnia biblioteka
U podstaw leży system klatek kluczowych dla modeli trójwymiarowych. Animacja jest definiowana w pliku JSON, opisującym pozycje części modelu w konkretnych momentach czasu; ruch między tymi momentami jest interpolowany automatycznie, bez potrzeby ręcznego rysowania każdej klatki pośredniej.
Możliwości animacyjne
Biblioteka obsługuje:
jednoczesne uruchamianie kilku animacji na tym samym modelu — mob może iść, obracać głową i machać ogonem jednocześnie, ponieważ każda animacja działa na własnym kontrolerze;
ponad 30 funkcji wygładzania przejść między klatkami kluczowymi, które określają, jak jedna poza modelu przechodzi w kolejną — gwałtownie, płynnie, z przyspieszeniem lub z odbiciem;
klatki kluczowe z dźwiękiem — w wybranym momencie animacji odtwarzany jest wskazany dźwięk;
klatki kluczowe z cząsteczkami — pojawienie się efektów jest przypisane do konkretnej klatki modelu;
klatki kluczowe zdarzeń — w wybranym momencie animacji wywoływany jest kod moda, dzięki czemu obrażenia trafiają ofiarę dokładnie w klatce zamachu modelu, a nie w dowolnym momencie ataku.
Jakich obiektów dotyczy
Biblioteka działa z czterema typami obiektów w grze:
jednostki — moby, NPC, oswojone stworzenia z pełną animacją szkieletową stanów spoczynku, ruchu i ataku;
przedmioty — broń i narzędzia z animowanymi modelami w rękach postaci oraz w ekwipunku;
pancerz — renderowanie modelu pancerza na szkielecie gracza lub moba;
bloki — bloki funkcyjne, takie jak mechanizmy, które się otwierają lub obracają.
Wydajność
Sama biblioteka obciąża pamięć umiarkowanie — około 1 MB miejsca na dysku i niewielki narzut przy starcie. Rzeczywiste obciążenie zależy od modów, które z niej korzystają: złożony animowany model moba z wieloma kośćmi i jednoczesnymi animacjami zużywa więcej CPU niż prosty, statyczny. Jeśli w modpacku jest kilkadziesiąt takich mobów i liczba FPS spada w miejscach ich skupienia, to koszt szczegółowości animacji konkretnych modów, a nie problem samej biblioteki.
Podsumowanie
AzureLib rozwiązuje jedno wąskie zadanie — daje autorom modów gotowy silnik animacji Bedrock, dlatego często pojawia się w modpackach jako wymagana zależność. Sprawdzi się u tych, którzy tworzą lub instalują modpack z drobiazgowo animowanymi mobami, pancerzami czy blokami funkcyjnymi.
Instalacja
Typowa instalacja zajmuje około 5 minut. Procedura jest taka sama; różni się tylko loader i odpowiedni build.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











