Mody i modpacki na serwerze Minecraft (Fabric, Forge, NeoForge)

Mody zmieniają samą grę: dodają bloki, przedmioty, moby, wymiary albo całe systemy rozgrywki. W przeciwieństwie do pluginów zwykle muszą je mieć także gracze. Pokażemy, jak zainstalować mody na serwerze, jak uruchomić gotowy modpack i jak naprawić najczęstsze błędy.

Jak działają mody#

Mody wczytuje do gry loader: Fabric, Forge albo NeoForge. Każdy mod jest napisany dla konkretnego loadera i konkretnej wersji Minecrafta. Mod dla Fabrica nie działa na NeoForge, a mod dla 1.21.1 zwykle nie działa na 26.1. Niektóre mody wydają osobne pliki dla kilku loaderów, dlatego zawsze pobieraj plik dla swojego loadera i swojej wersji.

W zależności od tego, gdzie mod działa, rozróżniamy trzy rodzaje:

Większość modów dla Fabrica potrzebuje biblioteki Fabric API. To osobny mod, który trafia do folderu mods zarówno na serwerze, jak i u graczy. Podobnie wiele modów wymaga innych bibliotek. Strona moda zawsze podaje je jako zależności (Dependencies).

Instalacja moda przez zakładkę Mody#

1. Otwórz Moje usługi, kliknij serwer i przejdź do zakładki Mody.
2. Kliknij Przeglądaj. Katalog korzysta z Modrinth i pokazuje tylko mody dla Twojego loadera i wersji Minecrafta.
3. W polu „Szukaj modów” wpisz nazwę i kliknij Szukaj.
4. Przy modzie kliknij Zainstaluj.
5. W oknie dialogowym sprawdź Wymagane zależności. Strefa klienta zainstaluje je razem z modem, na przykład Fabric API. Odznacz tylko te, które masz już przesłane ręcznie.
6. Kliknij Zainstaluj, a potem Zrestartuj. Mody wczytują się tylko przy starcie serwera.

Aktualizacja, wyłączanie i usuwanie modów działa tak samo jak przy pluginach, zobacz Instalacja pluginów.

Ręczna instalacja moda#

1. Pobierz mod z jego strony w Modrinth lub CurseForge. Sprawdź, czy plik jest dla Twojego loadera i Twojej wersji Minecrafta (oba widzisz w zakładce Oprogramowanie w części Zainstalowane oprogramowanie).
2. Pobierz też wszystkie zależności, które strona moda podaje jako wymagane (Required).
3. W zakładce Pliki otwórz folder mods. Jeśli nie istnieje, uruchom serwer raz bez modów albo utwórz go przyciskiem Nowy folder.
4. Kliknij Prześlij i wybierz pliki .jar. Możesz zaznaczyć kilka naraz. Jeden plik może mieć najwyżej 100 MB.
5. Zrestartuj serwer.

Mody przesłane ręcznie pojawią się w zakładce Mody z etykietą Przesłano ręcznie, a strefa klienta nie śledzi ich aktualizacji.

Czego potrzebują gracze#

Aby połączyć się z serwerem z modami, gracz potrzebuje:

• tej samej wersji Minecrafta co serwer,
• tego samego loadera, najlepiej w tej samej wersji co serwer,
• wszystkich modów z zawartością z serwera w tych samych wersjach (modów serwerowych nie; klienckie według uznania).

Najprościej dać graczom cały modpack. Jeśli serwer działa na publicznym modpacku, wystarczy, że gracze zainstalują tę samą wersję modpacka w aplikacji CurseForge, Modrinth App lub Prism Launcher. Przy własnym zestawie modów przygotuj listę modów z wersjami albo zbuduj własny modpack w jednej z tych aplikacji i go udostępnij.

Modpacki#

Modpack to gotowy zestaw modów z konfiguracją. Na serwer przenosisz go tak, że ustawiasz właściwy loader, a potem przesyłasz mody i konfigurację. Instalacji modpacka jednym kliknięciem w strefie klienta jeszcze nie ma; poniższa procedura działa dla modpacków z CurseForge i z Modrinth.

Ile RAM potrzebuje modpack#

Najpewniejszym wyznacznikiem jest zalecenie autora modpacka na jego stronie. Jeśli go nie podaje, skorzystaj z orientacyjnej tabeli. Dolicz zapas na liczbę graczy i wielkość świata.

Jeśli serwer pada z braku pamięci, przejdź na większy pakiet w zakładce Zmiana pakietu.

Krok 1: Sprawdź wersję Minecrafta i loadera#

Potrzebujesz trzech informacji: wersji Minecrafta, loadera i wersji loadera. Znajdziesz je:

• Modrinth: na stronie modpacka przy konkretnej wersji (Versions). W pliku .mrpack są w pliku modrinth.index.json w sekcji dependencies (klucze minecraft, fabric-loader, forge lub neoforge).
• CurseForge: na stronie modpacka w zakładce Files przy konkretnym pliku albo w instrukcji autora. Server pack często zawiera instalator loadera, którego nazwa zdradza wersję.

Krok 2: Przygotuj serwer#

1. W zakładce Konsola zatrzymaj serwer przyciskiem Stop. Strefa klienta uruchamia serwer po zmianie oprogramowania tylko wtedy, gdy działał przed zmianą. Zatrzymany serwer nie wygeneruje więc nowego świata jeszcze bez modów (w takim świecie w pobliżu spawnu brakowałoby rud, biomów i struktur z modów).
2. W zakładce Oprogramowanie wybierz Typ serwera zgodny z loaderem modpacka.
3. Wybierz Wersję Minecrafta, a w polu Wersja loadera tę samą wersję, której używa modpack.
4. W części Pliki serwera wybierz Usuń wszystko i zaznacz Akceptuję Minecraft EULA.
5. Kliknij Zmień oprogramowanie, potwierdź przesunięciem suwaka i poczekaj, aż postęp pokaże Zakończono. Serwer pozostanie zatrzymany.

Krok 3: Zdobądź pliki serwerowe modpacka#

CurseForge: autorzy udostępniają pliki serwerowe jako Server Pack. To osobny plik dołączony do wersji modpacka jako tak zwany plik dodatkowy (Additional Files). Pobierz server pack tej samej wersji, którą będą mieli gracze, i rozpakuj go na komputerze. Nie każdy modpack ma server pack. Jeśli go brakuje, postępuj jak przy Modrinth, przez aplikację.

Modrinth: plik .mrpack to ZIP, który nie zawiera modów, tylko linki do nich i konfigurację. Pliki serwerowe zdobędziesz w jeden z tych sposobów:

• Przez Modrinth App (prościej): zainstaluj modpack w aplikacji, otwórz folder instancji i weź z niego foldery mods, config oraz inne foldery modpacka. Z folderu mods usuń mody czysto klienckie (w Modrinth mają w polu środowiska tylko Client).

• Dla zaawansowanych, narzędziem mrpack-install: to narzędzie wiersza poleceń Modrinth wymienia wśród sposobów wdrożenia modpacka na serwer. Pobierz je dla swojego systemu ze strony Releases w repozytorium mrpack-install (otwiera się w nowym oknie) i w folderze z programem uruchom:

  mrpack-install <PLIK>.mrpack --server-dir server-modpack

  • mrpack-install – program, który pobiera pliki serwerowe modpacka według jego listy (modrinth.index.json). Pobrany plik ma w nazwie system, na przykład mrpack-install-windows.exe albo mrpack-install-linux. W Windows uruchomisz go w PowerShellu jako .\mrpack-install-windows.exe; w Linuxie i macOS najpierw nadaj mu prawo uruchamiania poleceniem chmod +x mrpack-install-linux i uruchom go jako ./mrpack-install-linux.
  • <PLIK>.mrpack – ścieżka do pobranego modpacka, na przykład Downloads/muj-pack.mrpack.
  • --server-dir server-modpack – folder, do którego zostaną pobrane pliki. Utworzy się sam.

  Oprócz modów i konfiguracji program pobiera też sam serwer z loaderem. Tego nie przesyłaj na nasz serwer; loader instaluje zakładka Oprogramowanie (krok 2).

Krok 4: Prześlij pliki na serwer#

Prześlij tylko te części (jeśli modpack je zawiera):

• folder mods ze wszystkimi plikami .jar,
• folder config,
• inne foldery modpacka, na przykład defaultconfigs, kubejs lub resourcepacks, jeśli autor podaje je jako część serwera.

W zakładce Pliki:

1. Przyciskiem Nowy folder utwórz w katalogu głównym serwera folder o tej samej nazwie, na przykład mods.
2. Otwórz go, kliknij Prześlij i zaznacz wszystkie pliki z odpowiedniego folderu na komputerze. Możesz zaznaczyć kilka plików naraz.
3. Tak samo postępuj z podfolderami (na przykład config i folderami w nim).

Nie przesyłaj serwerowego .jar modpacka, folderu libraries, instalatorów ani skryptów startowych (run.sh, run.bat, start.sh, user_jvm_args.txt). Loader zainstalowała strefa klienta w kroku 2. Plik user_jvm_args.txt nie jest u nas używany: pamięć i parametry startowe ustawia zakładka Uruchamianie na podstawie wielkości pakietu i liczby modów (Flagi startowe i pamięć).

Nie przesyłaj też server.properties z modpacka. Serwer sam utworzy ten plik z adresem i portem, które mu przydzieliliśmy. Jeśli autor modpacka wymaga własnych wartości (na przykład typu świata w modpackach skyblock), ustaw je jeszcze przed pierwszym startem: w zakładce Ustawienia serwera kliknij Utwórz z wartości domyślnych, zmień potrzebne opcje i zapisz. Typ świata jest używany tylko przy tworzeniu nowego świata; po pierwszym starcie nie miałby już wpływu. Własny typ świata dodawany przez mod formularz odrzuci jako nieznaną wartość. Taką wartość wpisz bezpośrednio do pliku server.properties w zakładce Pliki (Edytuj, zapisz Ctrl+S).

Krok 5: Uruchom serwer i połącz się#

1. W zakładce Konsola kliknij Start. Pierwszy start dużego modpacka trwa kilka minut.
2. Poczekaj na linię Done (…)! For help, type "help".
3. Połącz się z gry z tym samym modpackiem w tej samej wersji.

Konfiguracja modów#

Ustawienia edytuj przy zatrzymanym serwerze w zakładce Pliki, a po zmianie uruchom serwer. Pliki .toml mają postać klucz = wartość; pliki .json muszą mieć poprawną składnię JSON (przecinki między elementami, cudzysłowy wokół tekstu).

Weryfikacja#

1. W zakładce Konsola poczekaj, aż serwer dojdzie do linii Done (…)! For help, type "help". Jeśli zamiast tego zakończy się błędem, przejdź do części Rozwiązywanie problemów.
2. W zakładce Mody w podzakładce Zainstalowane sprawdź, czy mod jest włączony. Mody przesłane ręcznie mają etykietę Przesłano ręcznie.
3. Połącz się z gry klientem, który ma ten sam loader, tę samą wersję Minecrafta i te same mody. Serwer nie może Cię rozłączyć z listą modów.
4. W grze sprawdź, czy zawartość moda działa (na przykład czy nowy blok lub przedmiot znajdziesz w ekwipunku trybu kreatywnego).

Rozwiązywanie problemów#

Błędów szukaj w konsoli i w pliku logs/latest.log. Gdy serwer się wysypie, w folderze crash-reports powstaje raport. Najważniejsza jest w nim linia Description: i pierwsza linia zaczynająca się od Caused by:.

Graczy przy łączeniu rozłącza z listą modów#

Gracz nie ma tych samych modów co serwer (brakuje mu moda, ma inną wersję albo ma dodatkowy mod z zawartością, którego serwer nie ma). Komunikat zwykle wymienia konkretne mody. Ujednolić wersje najłatwiej tak, że gracze użyją tej samej wersji modpacka.

Mod resolution encountered an incompatible mod set! (Fabric)#

Fabric wykrył przy starcie, że mody do siebie nie pasują. Pod komunikatem jest lista: brakująca zależność (na przykład Fabric API), zbyt stara wersja loadera albo mod dla innej wersji Minecrafta. Dodaj lub wymień wymienione mody. Jeśli mod wymaga nowszego loadera Fabric, wybierz go w zakładce Oprogramowanie w polu Wersja loadera.

Attempted to load class … for invalid dist DEDICATED_SERVER (Forge, NeoForge) lub Cannot load class … in environment type SERVER (Fabric)#

Na serwerze jest mod kliencki. Jego nazwa zwykle widnieje w wyniku nad komunikatem. Usuń go z folderu mods.

UnsupportedClassVersionError#

Mod wymaga nowszej Javy, więc jest przeznaczony dla nowszej wersji Minecrafta, niż ta, na której działa serwer. Pobierz wersję moda dla swojej wersji Minecrafta.

Serwer pada z OutOfMemoryError albo wyłącza się sam bez błędu#

Serwerowi brakuje pamięci. Jeśli wyłącza się bez błędu, a w Konsoli jest Out of memory: true, przekroczył limit pamięci pakietu. W zakładce Uruchamianie sprawdź ostrzeżenia przy flagach startowych i w razie potrzeby kliknij Użyj zalecanych. Pomoże też usunięcie wymagających modów, zmniejszenie zasięgu widzenia albo przejście na większy pakiet. Szczegóły w artykule Wydajność i optymalizacja.

Po przejściu z Papera mody się nie wczytują#

Sprawdź w zakładce Oprogramowanie, czy typ serwera to Fabric, Forge lub NeoForge. Mody muszą być w folderze mods, nie plugins.

Plik jest większy niż 100 MB#

Pliku nie da się przesłać przez strefę klienta. Skontaktuj się z pomocą techniczną w sprawie dostępu przez SFTP.

Inne komunikaty opisuje artykuł Częste błędy serwera Minecraft. Jeśli nie wiesz, co dalej, wyślij nam plik z crash-reports lub logs/latest.log.

Dalsza lektura#

• Fabric: instalacja modów (otwiera się w nowym oknie)
• NeoForge: serwer (otwiera się w nowym oknie)
• Modrinth: modpacki na serwerze (otwiera się w nowym oknie)
• Modrinth: format .mrpack (otwiera się w nowym oknie)
• mrpack-install (otwiera się w nowym oknie)