LibJF — Techniczny mod-biblioteka i rdzeń wspierający modyfikacje w Minecraft

LibJF — Techniczny mod-biblioteka i rdzeń wspierający modyfikacje w Minecraft

LibJF to modułowa biblioteka autorstwa JFronny, zawierająca zestaw wspólnych komponentów dla jego modów. Na komputerze gracza ten mod zwykle nie jest instalowany samodzielnie, ale jako obowiązkowa zależność — bez niej odpowiednie mody się nie uruchomią. LibJF nie dodaje receptur, mobów ani nowych bloków do gry Minecraft. Jej zadanie jest inne: wyodrębnić powtarzającą się funkcjonalność — format konfiguracji, system tłumaczeń, lokalny serwer HTTP, dwa tagi użytkowe — do osobnego projektu i używać ich ponownie w różnych modach tego samego programisty.

Przeznaczenie w paczce modów

Biblioteka jest podzielona na osobne moduły, z których każdy odpowiada za swoje zadanie: format plików konfiguracyjnych i ich menu w grze, tagi przedmiotów, tłumaczenie, komponenty sieciowe. Mody zależne od LibJF ładują tylko te moduły, których faktycznie używają. Dlatego po pierwszym uruchomieniu gry w folderze config/ pojawia się nie jeden plik, ale kilka — po jednym na aktywny moduł.

Jednym z podstawowych efektów, które gracz zauważy od razu, jest automatyczne przeładowywanie konfiguracji. Parametr watchForChanges jest domyślnie włączony: jeśli zmienisz jakikolwiek plik konfiguracyjny działający przez LibJF, zmiany zostaną zastosowane bez ponownego uruchamiania gry.

Uniwersalne tagi dla przedmiotów i zbroi

LibJF dodaje dwa tagi dostępne zarówno dla innych modów, jak i waniliowych datapacków:

Same tagi są puste — wypełnia je datapack lub mod zewnętrzny. Aby na przykład sprawić, by pełny skórzany zestaw na przetrwaniu był "nieprzebijalny", wystarczy stworzyć mały datapack, który doda minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings i minecraft:leather_boots do pliku tagu libjf:overpowered.

Podsystem tłumaczeń

Moduł libjf-translate-v1 daje innym modom programisty dostęp do usługi tłumaczenia ciągów znaków. Sama biblioteka nie tłumaczy niczego na czacie ani w interfejsie — określa jedynie, przez którą usługę zewnętrzną przejdą żądania, jeśli zażąda ich modyfikacja. Obsługiwane są cztery opcje dostawców:

• Google — publiczny interfejs Google Translate (wartość domyślna).

• DeepLX — otwarta implementacja API DeepL.

• LibreTranslate — samodzielnie hostowane rozwiązanie open-source; wymaga oddzielnego określenia adresu instancji.

• Noop — atrapa, która zwraca wprowadzony tekst w postaci niezmienionej; przydatne do testów i całkowitego wyłączenia tłumaczenia.

Osobny parametr throttleMillis ustala minimalną przerwę między wywołaniami usługi. Ograniczenie to jest konieczne, aby uniknąć tymczasowych blokad ze strony darmowego API przy częstych żądaniach od moda.

Lokalny serwer WWW

Moduł libjf-web-v1 uruchamia wewnątrz gry mały serwer HTTP. Jest on używany przez inne mody autora, gdy trzeba przekazać klientowi coś więcej niż zwykły pakiet sieciowy — na przykład stronę statyczną lub plik podglądu. W standardowym środowisku gracza moduł ten zwykle milczy: port jest otwarty tylko lokalnie (127.0.0.1), a udostępnianie plików jest wyłączone.

Administratorzy prywatnych serwerów mogą włączyć udostępnianie dowolnych plików z folderu config/wwwroot jako zasobów statycznych poprzez oddzielny parametr konfiguracji — jest to opcjonalna funkcja, domyślnie wyłączona.

Podsumowanie

LibJF to biblioteka zależna wymagana, gdy paczka zawiera mod tego samego programisty lub datapack używający tagów libjf:overpowered lub libjf:shulker_boxes_illegal. Na tle innych bibliotek tej klasy wyróżnia się modułową architekturą i lokalnym serwerem HTTP wraz z warstwą tłumaczeniową, czego większość bibliotek pomocniczych nie oferuje. W przypadku zwykłej waniliowej paczki Minecraft Java Edition nie ma sensu instalować LibJF; w przypadku paczek z modami JFronny jest to obowiązkowy element.