Balm — mod-biblioteka do działania modów na różnych loaderach w Minecraft
Balm to wspólna biblioteka, dzięki której mody do Minecraft działają tak samo na Fabric, Forge i NeoForge. Kiedy jest potrzebna i jak ją…
Balm to wspólna biblioteka, dzięki której mody do Minecraft działają tak samo na Fabric, Forge i NeoForge. Kiedy jest potrzebna i jak ją zainstalować.
Balm — mod-biblioteka do działania modów na różnych loaderach w Minecraft
Wersja Minecraft, na której przetestowano i napisano artykuł: 26.1.2
Zakres obsługiwanych wersji: 1.18.x – 26.2
Balm to biblioteka, od której zależą inne mody do Minecraft; sama w sobie nie dodaje bloków, przedmiotów, mobów ani mechanik. Instalowanie jej osobno nie ma sensu: jest potrzebna tylko wtedy, gdy inny mod wskazuje Balm jako wymaganą zależność. Zadaniem biblioteki jest dać autorom modów wspólny kod, który działa tak samo na Fabric, Forge i NeoForge, bez osobnej wersji dla każdego loadera.
Po co potrzebny jest Balm
Każdy loader modów działa inaczej: rejestracja przedmiotów, obsługa zdarzeń, sieć i ustawienia w Fabric, Forge i NeoForge są realizowane na różne sposoby. Bez warstwy pośredniej autor musiałby pisać osobną wersję kodu dla każdego z nich. Balm bierze tę różnicę na siebie — mod korzysta ze wspólnego zestawu narzędzi biblioteki, a ona tłumaczy wywołania na język konkretnego loadera.
Dla gracza konsekwencja jest prosta: ten sam mod może być wydawany od razu dla trzech loaderów, a zachowanie jest wszędzie takie samo. Jeśli na stronie potrzebnego moda w liście zależności widnieje Balm — wystarczy pobrać oba pliki pod swój loader i wersję Minecraft i umieścić je w folderze mods.
Wersja biblioteki musi odpowiadać wersji Minecraft i loaderowi, dla którego zbudowano główny mod. Plik Balm dla Fabric nie uruchomi się na Forge i odwrotnie.
Za co odpowiada biblioteka
Poza grą Balm nie jest widoczna, ale to właśnie ona odpowiada za część tego, jak zachowują się mody oparte na niej. Biblioteka obejmuje kilka obszarów:
rejestracja zawartości — przedmioty, bloki i inne obiekty moda są dodawane przez wspólny mechanizm;
zdarzenia gry — mod reaguje na działania gracza i świata za pomocą jednego zestawu obsługi zdarzeń;
sieć — przesyłanie danych między klientem a serwerem, otwieranie menu z dodatkowymi informacjami;
ustawienia — system konfiguracji z możliwością wyświetlania ich na osobnym ekranie w grze.
Osobno biblioteka udostępnia wspólne punkty dostępu do zewnętrznych narzędzi: przeglądarek receptur, informacyjnych paneli HUD oraz modów akcesoriów. Dzięki temu autorzy nie muszą ręcznie utrzymywać każdej takiej integracji dla każdego loadera.
Konfiguracja modów przez Balm
Konfiguracja to jedna z niewielu części, które biblioteka realizuje samodzielnie, a nie tylko tłumaczy na loader. Mody oparte na Balm mogą wyświetlać swoje ustawienia na osobnym ekranie konfiguracji, dostępnym z listy modów, więc ręczna edycja plików nie jest konieczna.
Drugą rzeczą zauważalną dla gracza jest synchronizacja. Część ustawień serwer przekazuje klientowi podczas połączenia, dzięki czemu zasady obowiązują jednakowo wszystkich uczestników. Biblioteka pilnuje też zgodności wersji sieciowych: jeśli wersja moda na kliencie i serwerze się różni, połączenie zostaje odrzucone z komunikatem, zamiast prowadzić do ukrytych błędów już w grze.
Podsumowanie
Balm pozwala autorom wydawać mod jednocześnie dla Fabric, Forge i NeoForge ze wspólnego kodu, a graczowi gwarantuje identyczne zachowanie na dowolnym z loaderów. W odróżnieniu od innych warstw abstrakcji, biblioteka korzysta z oficjalnych narzędzi loaderów i nie wprowadza żadnych zewnętrznych zależności. Instalowanie Balm ma sens tylko wtedy, gdy wymaga tego inny mod; w modpackach jest zwykle już dodana automatycznie.
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.











