Forge Config API Port - do czego służy i jak go zainstalować?

Forge Config API Port to mostek, który przenosi system konfiguracji Forge i NeoForge do innych loaderów, przede wszystkim Fabric. W praktyce przydaje się wtedy, gdy mod ma działać w paczce wieloladowej albo gdy gra zgłasza brak zależności związanej z konfiguracją. Poniżej wyjaśniam, czym to narzędzie jest naprawdę, gdzie trafiają pliki konfiguracyjne i jak uniknąć najczęstszych pomyłek.

Czym naprawdę jest Forge Config API Port

Najprościej mówiąc, to biblioteka dla modów, która pozwala korzystać z tego samego systemu konfiguracji na kilku loaderach naraz. Na kartach Modrinth i CurseForge widać, że projekt jest opisany jako rozwiązanie dla Fabric, Forge i NeoForge, z myślą o architekturze multiloader. Dla twórcy moda oznacza to mniej duplikacji kodu, a dla gracza zwykle tylko jedną dodatkową zależność w paczce.

Z mojego punktu widzenia najważniejsze jest to, że ten port nie tworzy nowej filozofii konfiguracji. On przenosi istniejące API Forge i NeoForge do innych środowisk tak, żeby mod mógł zachowywać się możliwie podobnie na różnych loaderach. Dlatego to rozwiązanie jest cenne przede wszystkim tam, gdzie autor moda chce utrzymać jedną logikę ustawień dla kilku platform. To też tłumaczy, dlaczego często pojawia się w modpackach, a nie jako samodzielny „feature” dla użytkownika. W następnym kroku warto odróżnić tę bibliotekę od portu sieciowego, bo tu najłatwiej o złe założenie.

Dlaczego nie ma tu mowy o porcie sieciowym

Słowo port potrafi zmylić. W tym przypadku nie chodzi o otwieranie ani przekierowywanie portu serwera, tylko o przeniesienie warstwy API. Jeśli ktoś szuka zmiany portu Minecrafta, powinien patrzeć w stronę ustawień serwera, a nie tej biblioteki. To ważne rozróżnienie, bo wiele osób trafia na ten mod z myślą, że naprawi problem z łączeniem się do serwera, a on tego po prostu nie robi.

Forge Config API Port nie sprawia też, że mod napisany pod Forge nagle uruchomi się na Fabric. To nie jest uniwersalna warstwa kompatybilności całych modów. Biblioteka pomaga wyłącznie w obszarze konfiguracji. Jeśli konflikt dotyczy wersji Minecrafta, loadera, renderowania, sieci albo innej zależności, trzeba szukać rozwiązania gdzie indziej. To właśnie dlatego w paczkach modów warto czytać opis zależności bardzo dosłownie, a nie zakładać, że każde „port” oznacza to samo.

W praktyce kolejny krok to poprawna instalacja, bo tu najczęściej pojawia się pierwszy zgrzyt.

Jak poprawnie zainstalować go w paczce modów

Jeśli paczka albo konkretny mod wymaga tej biblioteki, instalacja jest zwykle prosta, ale trzeba zachować kolejność. Na CurseForge projekt jest opisany jako zależność wymagana po stronie klienta i serwera, więc nie warto zakładać, że wystarczy go wrzucić tylko do jednej instancji. Na Fabric dochodzi jeszcze drugi detal: często potrzebny jest również sam Fabric API. To drobiazg, który bardzo często decyduje o tym, czy paczka ruszy od razu, czy zacznie sypać brakującymi wymaganiami.

1. Dobierz wariant do właściwego loadera i wersji Minecrafta.
2. Sprawdź, czy paczka wymaga instalacji po obu stronach, czyli na kliencie i na serwerze.
3. Na Fabric dołóż także wymagane biblioteki pomocnicze, jeśli autor paczki je wskazuje.
4. Włóż plik do folderu mods zamiast go rozpakowywać.
5. Po zmianie uruchom grę lub serwer ponownie, bo sama podmiana pliku nie zawsze wystarcza.

Warto też zwrócić uwagę na gałęzie wersji. Projekt ma aktywne wydania dla bieżących linii Minecrafta, a starsze gałęzie bywają utrzymywane tylko poprawkami krytycznymi albo są już archiwalne. Dla użytkownika oznacza to jedno: nie bierz „prawie pasującej” wersji, tylko dokładnie tę, którą przewiduje paczka. Kiedy plik siedzi już we właściwym miejscu, trzeba jeszcze wiedzieć, jak czytać samą konfigurację.

Gdzie trafiają ustawienia i jak czytać typy konfiguracji

Według dokumentacji Forge konfiguracje są oparte na plikach TOML i czytane przez NightConfig. To dobra wiadomość, bo takie pliki da się edytować ręcznie i zwykle są czytelniejsze niż dziwne binarne ustawienia. Sam system rozróżnia kilka typów konfiguracji, a każdy z nich ma inny zakres działania i inne miejsce zapisu.

Przy ręcznej edycji liczą się też szczegóły, które na pierwszy rzut oka wyglądają jak kosmetyka. comment pozwala dopisać opis wartości, translation porządkuje nazwę w interfejsie, a worldRestart oznacza, że zmiana zacznie działać dopiero po restarcie świata. To właśnie ten ostatni parametr często myli początkujących, bo zapis wygląda poprawnie, ale efektu nie widać od razu. Gdy to ogarniesz, łatwiej odsiać zwykłe błędy od realnego konfliktu konfiguracji.

Najczęstsze błędy przy konfiguracji i jak je rozpoznać

• Zła wersja moda. Objaw: loader krzyczy o niezgodności z wersją Minecrafta. Naprawa: dobierz wydanie dokładnie pod swoją gałąź gry, a nie „najbliższe”.
• Instalacja tylko po jednej stronie. Objaw: klient działa, ale serwer nie startuje albo odwrotnie. Naprawa: sprawdź, czy zależność ma być obecna po obu stronach.
• Oczekiwanie, że biblioteka naprawi kompatybilność całej paczki. Objaw: mod dalej się wysypuje mimo instalacji portu. Naprawa: szukaj prawdziwej przyczyny w innych zależnościach.
• Edycja złego pliku. Objaw: zmiana jest widoczna, ale nie działa w świecie lub na serwerze. Naprawa: sprawdź, czy ustawienie należy do CLIENT, COMMON, czy SERWER.
• Ignorowanie worldRestart. Objaw: wartość została zapisana, lecz mechanika nie reaguje. Naprawa: uruchom ponownie świat albo cały serwer.
• Brak dodatkowych zależności na Fabric. Objaw: komunikat o brakującym Fabric API lub podobnym komponencie. Naprawa: doinstaluj wymagane biblioteki wskazane przez paczkę.

Z mojego doświadczenia właśnie te cztery czy pięć błędów odpowiada za większość zgłoszeń typu „nie działa”, mimo że sama instalacja wydaje się poprawna. To dobry moment, żeby uczciwie powiedzieć, kiedy ten mostek w ogóle ma sens, a kiedy szkoda na niego czasu.

Kiedy ten port jest potrzebny, a kiedy lepiej go pominąć

Ten dodatek ma sens przede wszystkim wtedy, gdy korzystasz z paczki wieloladowej, przenosisz mod między Forge, NeoForge i Fabric albo instalujesz mod, który wyraźnie wskazuje go jako zależność. W takim scenariuszu biblioteka robi dokładnie to, czego od niej oczekujesz: wyrównuje warstwę konfiguracji i ogranicza różnice między platformami.

Nie jest natomiast potrzebny tylko dlatego, że grasz na Forge albo NeoForge. Jeśli mod ma natywną obsługę konfiguracji dla danego loadera, wszystko działa bez pośrednika. Nie jest też rozwiązaniem dla problemów z portem serwera, z połączeniem sieciowym czy z ogólną kompatybilnością paczki. Gdy ktoś pyta mnie, czy „warto doinstalować ten port na wszelki wypadek”, odpowiadam zwykle krótko: tylko wtedy, gdy wymaga tego mod lub paczka. Reszta to niepotrzebny szum w folderze mods.

Na końcu zostaje kilka prostych kontroli, które oszczędzają najwięcej czasu, gdy coś nadal nie działa.

Trzy kontrole, które oszczędzają najwięcej czasu

• Sprawdź dokładną wersję Minecrafta, loadera i samej biblioteki, zanim zaczniesz szukać głębszego błędu.
• Porównaj listę wymaganych zależności z tym, co faktycznie znajduje się w folderze mods.
• Zweryfikuj, czy edytujesz właściwy plik konfiguracyjny i czy zmiana nie wymaga restartu świata albo serwera.

Jeśli po tych trzech krokach problem nadal zostaje, zwykle nie chodzi już o samą konfigurację, tylko o inną zależność, niepasującą gałąź wersji albo konflikt po stronie konkretnego moda. W takiej sytuacji nie szukałbym winy w samym Forge Config API Port, bo on najczęściej jest tylko pośrednikiem, a nie źródłem kłopotu.