Przegląd biblioteki Bookshelf dla Minecrafta: funkcje i komendy

Modyfikacja Bookshelf to systemowa biblioteka (mod-core) autorstwa dewelopera Darkhax, która upraszcza rozwój i optymalizuje działanie innych modyfikacji. Nie dodaje ona nowych dekoracyjnych półek na książki ani innych bloków do gry. Zamiast tego biblioteka oferuje wspólny szkielet kodu, funkcje rejestracji zawartości oraz zdarzenia międzyplatformowe. Wykorzystanie wspólnego kodu zmniejsza liczbę błędów w kompatybilnych modach oraz obciążenie systemu podczas gry.

Podstawowa funkcjonalność dla deweloperów

Biblioteka Bookshelf zawiera zestaw narzędzi, które upraszczają tworzenie modyfikacji dla różnych loaderów:

• Zdarzenia międzyplatformowe (Events): Pozwalają deweloperom napisać kod raz i uruchamiać go na Forge, NeoForge, Fabric lub Quilt bez konieczności przepisywania obsługi zdarzeń dla każdego loadera z osobna.

• Rozszerzone kodeki (Codecs): Ułatwiają serializację i deserializację złożonych obiektów danych w grze.

• Uproszczona rejestracja: Zmniejsza ilość kodu potrzebnego do rejestracji nowych bloków, przedmiotów, dźwięków i jednostek. Zamiast pisać osobne metody inicjalizacji dla każdego loadera (jak Forge RegistryEvents czy Fabric Registry), biblioteka udostępnia jedną metodę rejestracji, która samodzielnie dostosowuje się do wybranego środowiska uruchomieniowego.

• Obliczenia matematyczne: Oferuje gotowe formuły do obliczania doświadczenia gracza, obsługi kolorów oraz manipulacji czcionkami.

Narzędzia dla autorów datapacków i graczy

Chociaż Bookshelf powstał głównie jako biblioteka systemowa, zawiera kilka przydatnych funkcji dla administratorów serwerów i autorów datapacków:

Komendy debugowania

• /bookshelf hand: Pokazuje szczegółowe informacje o przedmiocie trzymanym w ręce. Ta komenda wypisuje techniczną nazwę, poziom wytrzymałości, tagi oraz dane NBT przedmiotu bezpośrednio na czacie. Automatycznie kopiuje też wygenerowany kod JSON przedmiotu do schowka, co pozwala autorom datapacków natychmiast wklejać go w receptury craftingu lub tabele łupów bez ręcznego wpisywania długich linii kodu.

• /bookshelf font: Pozwala konfigurować i zmieniać czcionki dla elementów tekstowych gry. Możesz stosować różne style wyświetlania dla książek, tabliczek czy interfejsów użytkownika, co pomaga stworzyć unikalną atmosferę na serwerach lub w mapach przygodowych.

Rozszerzenie możliwości receptur

Biblioteka pozwala wykorzystywać unikalne warunki craftingu w datapackach. Na przykład możesz tworzyć receptury, które zużywają wytrzymałość narzędzi zamiast całkowitego zniszczenia przedmiotu (np. użycie młota do kruszenia materiałów).