Najważniejsze informacje o bibliotece konfiguracji modów
- Cloth Config tworzy graficzne menu ustawień dla modów.
- Nie dodaje nowych przedmiotów ani mechanik i sam w sobie nie zmienia rozgrywki.
- Trzeba dobrać plik do wersji Minecrafta oraz loadera, na przykład Fabric, Forge albo NeoForge.
- Mod Menu może pokazywać przycisk konfiguracji, ale nie zastępuje Cloth Config.
- W większości przypadków biblioteka jest potrzebna przede wszystkim po stronie klienta.
Czym właściwie jest Cloth Config w Minecraft
Cloth Config to biblioteka dla twórców modów, która pozwala budować ekrany konfiguracji wewnątrz gry. Dzięki niej autor moda może dodać suwaki, pola tekstowe, przełączniki, listy wyboru, opisy i podział ustawień na kategorie.
Dla gracza oznacza to prostą rzecz. Zamiast otwierać folder config i ręcznie edytować plik JSON, JSON5 albo TOML, można zmienić opcję w czytelnym menu. Przykładem jest regulacja zasięgu działania moda, wyłączenie konkretnego efektu, zmiana skrótu klawiszowego albo ograniczenie liczby generowanych obiektów.
Sama biblioteka nie jest modem gameplayowym. Nie dodaje bloków, mobów ani wymiarów. Udostępnia jedynie narzędzia, z których korzystają inne mody. Dlatego po jej instalacji nie należy oczekiwać nowej ikony w ekwipunku ani osobnej zawartości w świecie.
W praktyce traktuję ją jak wspólny panel sterowania. Mod dostarcza opcje, a Cloth Config zapewnia sposób ich prezentacji. Jeśli autor nie zaprogramował konfiguracji z użyciem tej biblioteki, jej obecność nie doda menu automatycznie.
Cloth Config, Mod Menu i Fabric API nie oznaczają tego samego
Te nazwy często występują obok siebie w listach zależności, dlatego łatwo je pomylić. Każda pełni jednak inną funkcję, a poprawne rozróżnienie szybko wyjaśnia większość problemów z instalacją.
| Narzędzie | Do czego służy | Czy zawsze jest potrzebne |
|---|---|---|
| Cloth Config | Tworzy menu ustawień konkretnego moda. | Nie, tylko gdy dany mod go wymaga. |
| Mod Menu | Pokazuje listę zainstalowanych modów i może udostępnić przycisk konfiguracji. | Nie, ale bardzo ułatwia dostęp do ustawień. |
| Fabric API | Udostępnia szersze funkcje potrzebne modom działającym na Fabric. | Często tak, lecz zależy od konkretnego moda. |
| Forge lub NeoForge | Loader uruchamiający mody i zarządzający ich zależnościami. | Tak, jeśli dany mod został przygotowany dla tego loadera. |
Najczęstsze nieporozumienie wygląda tak: gracz instaluje Mod Menu, ale nadal nie widzi ustawień. To normalne, jeśli mod nie ma własnego ekranu albo brakuje biblioteki konfiguracji. Mod Menu jest katalogiem i punktem dostępu, natomiast Cloth Config dostarcza właściwy interfejs opcji.
Trzeba też odróżnić Cloth Config od innych bibliotek konfiguracyjnych, takich jak YetAnotherConfigLib. Nie należy instalować kilku zamienników na zapas. Najbezpieczniej sprawdzić stronę moda i zainstalować dokładnie te zależności, które zostały wymienione przez autora.
Jak zainstalować bibliotekę bez konfliktów
Instalacja zwykle zajmuje kilka minut, ale wymaga dopasowania trzech elementów: wersji Minecrafta, loadera i wersji pliku biblioteki. Najnowszy plik nie zawsze jest właściwy, szczególnie gdy korzystasz z paczki modów przygotowanej dla starszej wersji gry.
- Sprawdź, czy używasz Java Edition, a następnie odczytaj dokładną wersję gry.
- Ustal loader. Plik dla Fabric nie jest zamiennikiem wersji dla Forge lub NeoForge.
- Pobierz Cloth Config z zaufanej strony projektu, na przykład Modrinth albo CurseForge.
- Wybierz wydanie oznaczone tą samą wersją Minecrafta i właściwym loaderem.
- Przenieś plik
.jardo folderu.minecraft/modsalbo do katalogu profilu używanego przez launcher. - Uruchom grę z tym samym profilem, w którym znajduje się mod wymagający biblioteki.
W przypadku launchera z osobnymi profilami sprawdź ścieżkę każdego profilu. Modrinth App, CurseForge i podobne programy często używają oddzielnych folderów instancji, więc włożenie pliku do głównego katalogu Minecrafta może nie przynieść żadnego efektu.
Jeżeli korzystasz z Mod Menu, po uruchomieniu gry otwórz ekran modów i poszukaj przycisku Configure lub polskiego odpowiednika. Gdy go nie ma, nie musi to oznaczać awarii. Autor moda mógł nie dodać integracji z Mod Menu albo konfiguracja może być dostępna wyłącznie przez plik w folderze config.
Gdzie znajdują się ustawienia i co można w nich zmienić
Najwygodniejsza droga prowadzi przez menu modów, ale ustawienia są zwykle zapisywane również w katalogu .minecraft/config. Nazwa pliku zależy od moda. Może to być na przykład plik z rozszerzeniem .json, .json5 albo .toml.
W menu Cloth Config spotkasz kilka typowych elementów:
- przełączniki do włączania i wyłączania funkcji,
- suwaki do regulacji wartości liczbowych,
- pola tekstowe dla nazw, ścieżek lub komend,
- listy wyboru dla kilku przygotowanych wariantów,
- podpowiedzi opisujące skutki danej opcji,
- kategorie, które porządkują rozbudowane konfiguracje.
Zmiana ustawienia nie zawsze działa natychmiast. Część modów odczytuje konfigurację przy uruchamianiu gry, inne stosują nowe wartości po zamknięciu ekranu. Jeżeli opcja nie daje widocznego efektu, zrestartuj świat albo całą grę, zamiast od razu uznawać ją za uszkodzoną.
Przed ręczną edycją pliku zrób kopię zapasową. Błędny przecinek, nieprawidłowa wartość albo usunięty nawias może sprawić, że mod wróci do ustawień domyślnych lub przestanie się uruchamiać. Najbezpieczniej zmieniać jedną opcję naraz i sprawdzać rezultat.
Co ta biblioteka daje twórcom modów
Dla programisty Cloth Config jest gotowym zestawem komponentów interfejsu. Zamiast pisać cały ekran od podstaw, autor tworzy obiekt konfiguracji, dodaje kategorie i rejestruje opcje, a biblioteka zajmuje się ich wyświetleniem.
Podstawowy schemat korzysta z takich elementów jak ConfigBuilder, ConfigCategory i ConfigEntryBuilder. Pierwszy buduje ekran, drugi porządkuje ustawienia, a trzeci tworzy konkretne pola, na przykład przełącznik albo suwak.
ConfigBuilder builder = ConfigBuilder.create()
.setTitle(Text.translatable("title.examplemod.config"));
ConfigCategory general =
builder.getOrCreateCategory(Text.translatable("category.examplemod.general"));
general.addEntry(builder.entryBuilder()
.startBooleanToggle(Text.translatable("option.examplemod.enabled"), true)
.setDefaultValue(true)
.setSaveConsumer(value -> config.enabled = value)
.build());To schemat poglądowy, a nie uniwersalny fragment do wklejenia. Nazwy metod i klas mogą różnić się między głównymi wersjami biblioteki oraz mappingami Minecrafta. Dokumentacja konkretnego wydania ma tu większe znaczenie niż przykład znaleziony w starym poradniku.
Twórca może także użyć systemu Auto Config, który na podstawie klasy konfiguracyjnej generuje część interfejsu automatycznie. Obsługiwane są między innymi wartości logiczne, liczby, tekst i typy wyliczeniowe. Przy bardziej nietypowych potrzebach można zarejestrować własny sposób prezentowania pola.
Jeśli autor chce pokazać ekran w Mod Menu, musi dodać odpowiednią integrację i zwrócić ekran konfiguracji. Sama obecność Cloth Config nie sprawi, że każdy mod pojawi się z przyciskiem ustawień. Integracja musi zostać zaprogramowana przez twórcę moda.
Najczęstsze błędy i szybka diagnoza
| Objaw | Prawdopodobna przyczyna | Co sprawdzić |
|---|---|---|
| Gra zgłasza brak Cloth Config | Biblioteka nie jest zainstalowana albo znajduje się w złym profilu. | Folder mods, wersję pliku i launcher. |
| Mod nie ładuje się po instalacji | Niezgodna wersja Minecrafta lub loadera. | Czy Fabric, Forge albo NeoForge odpowiada wymaganiom moda. |
| Widać Mod Menu, ale nie ma konfiguracji | Mod nie ma integracji z menu lub nie korzysta z Cloth Config. | Opis moda i pliki w katalogu config. |
| Gra się zamyka po dodaniu pliku | Stara, podwójna albo niekompatybilna wersja biblioteki. | Usuń wyłącznie zbędny duplikat po sprawdzeniu nazw plików. |
| Zmiana ustawienia nie działa | Mod odczytuje konfigurację dopiero przy ponownym uruchomieniu. | Zrestartuj świat lub klienta i sprawdź wartość ponownie. |
Komunikat o zależności cloth-config2 również nie powinien zmylić. To zwykle wewnętrzna nazwa modułu używana przez nowsze wydania biblioteki, a nie zupełnie inny dodatek. Mimo to zawsze trzeba pobrać plik zgodny z konkretną wersją gry.
Na serwerze dedykowanym sprawa może wyglądać inaczej. Menu konfiguracji jest zazwyczaj funkcją klienta, ale sam mod może wymagać obecności po stronie serwera albo synchronizować część ustawień. Opis moda ma pierwszeństwo przed ogólną zasadą, szczególnie w paczkach multiplayer.
Nie polecam też pobierania przypadkowych plików z nieznanych stron. Biblioteka jest bardzo popularna, więc duża liczba nieoficjalnych kopii i stron z reklamami nie daje żadnej dodatkowej korzyści. Najlepiej korzystać z projektu wskazanego w opisie moda lub paczki.
Najkrótsza droga do działającej konfiguracji moda
Cloth Config ma sens wtedy, gdy konkretny mod korzysta z jego API. Dla gracza jest to przede wszystkim wygodny ekran ustawień, a dla twórcy gotowy zestaw kontrolek i mechanizmów zapisu. Nie zastępuje loadera, Fabric API ani Mod Menu, lecz uzupełnia je w bardzo konkretnym miejscu.
Gdy pojawia się błąd, zacząłbym od trzech kontroli: wersja Minecrafta, loader i profil launchera. Dopiero później sprawdzałbym duplikaty plików, brakujące zależności oraz ręcznie edytowaną konfigurację. Taka kolejność zwykle pozwala szybko znaleźć problem bez przebudowywania całej paczki modów.
Najważniejsza zasada jest prosta: instaluj nie „najnowszy Cloth Config”, lecz wydanie wymagane przez konkretny mod. Dzięki temu menu konfiguracji będzie działać stabilnie, a aktualizacja jednego dodatku nie wywoła niepotrzebnego konfliktu z resztą instalacji.
