Jak zainstalować modpack na serwerze Minecraft: pełny poradnik

Modpack na serwerze stawiasz na plikach serwerowych dokładnie tej samej wersji packa, którą twoi gracze mają w launcherze, uruchomionych na wersji Javy pasującej do wersji Minecrafta: Java 21 dla 1.21 i nowszych wydań 26.x, Java 17 dla 1.17 do 1.20.4 oraz Java 8 dla 1.12.2 i starszych. Ciężki pack pokroju All the Mods 10 (NeoForge, Minecraft 1.21.1, od 400 do ponad 500 modów) potrzebuje minimum 10 GB RAM i ładuje się na dysku SSD w 2 do 3 minut, wobec 10 minut lub więcej na dysku talerzowym. Jeśli coś się sypie, prawie zawsze chodzi o pięć rzeczy: złą Javę, za mało pamięci, mody client-only na serwerze, złą wersję loadera albo świat z innego packa.

Czym różni się clientpack od serverpacka?

Pack, który instalujesz w CurseForge, na Modrinth, w FTB App albo w ATLauncherze, to clientpack. Zawiera wszystko, czego potrzebuje twój komputer, łącznie z modami, które na serwerze nie mają czego szukać: shadery, minimapy, rozszerzenia HUD-u i przeróbki menu. Jeśli wrzucisz taki folder na serwer bez zmian, zwykle wywali się jeszcze zanim świat zdąży się załadować.

Serverpack to ten sam pack, tylko odchudzony: twórcy wycinają mody client-only, zostawiają configi i dokładają skrypty startowe albo instalator. Nie każdy pack go potrzebuje. Fabulously Optimized jest czysto wydajnościowy (Sodium, Lithium i pokrewne, ponad 12 milionów pobrań na Modrinth) i nie zmienia świata gry, więc spokojnie zagrasz na zwykłym serwerze Paper. Jeśli dokładasz prawdziwą zawartość, jak All the Mods 10 czy RLCraft, serwer z definicji musi ją mieć u siebie. Jeśli nie wiesz jeszcze, jak zbudowane są packi, przeczytaj najpierw, czym jest modpack i jak zainstalować go jako gracz.

Skąd pobrać pliki serwerowe?

• CurseForge: otwórz stronę packa, wejdź w zakładkę Files i sprawdź, czy przy pliku, który chcesz uruchomić, wisi osobne pobranie Server Pack. Należy ono do tego jednego pliku, więc zawsze bierz pliki serwerowe z tej samej wersji co klient.
• Modrinth: packi są w formacie .mrpack. Część twórców dokłada obok plik serwerowy; jeśli nie, oddajesz .mrpack instalatorowi, który rozpakuje go i sam pobierze mody.
• FTB App: packi FTB mają własny instalator serwera, który uruchamiasz na serwerze; ściąga on loader i mody samodzielnie.
• ATLauncher: przy większości packów pliki serwerowe pobierzesz bezpośrednio albo wyeksportujesz z launchera.

Jeśli serverpacka nie ma, budujesz go sam: instalujesz loader dokładnie w wersji, którą podaje pack, kopiujesz mods i config z clientpacka, a potem wyrzucasz mody client-only. Licz się z kilkoma podejściami do startu, zanim wyłapiesz ten ostatni.

Jak wgrać pack do panelu Pterodactyl?

Te kroki działają dla Pterodactyl i praktycznie każdego panelu, który na nim bazuje.

1. Wyłącz serwer. Wgrywanie albo rozpakowywanie przy działającym serwerze kończy się plikami zapisanymi w połowie.
2. Wybierz właściwy egg (Forge, NeoForge albo Fabric) i ustaw obraz Dockera na wersję Javy pasującą do twojej wersji Minecrafta. To ustawienie pomijane jest najczęściej.
3. Wgraj archiwum ZIP serverpacka przez menedżer plików, a przy dużych paczkach przez SFTP. Wysyłaj archiwum, a nie pojedyncze mody: wrzucanie ich sztuka po sztuce trwa wieczność.
4. Rozpakuj archiwum w panelu i sprawdź, czy mods, config i pliki loadera leżą w katalogu głównym, a nie w dodatkowym podfolderze. Ten podwójny folder to klasyczna pułapka.
5. Uruchom dołączony instalator, jeśli jakiś jest. Nowoczesne wersje Forge i NeoForge nie startują już z pojedynczego pliku jar, tylko przez plik z argumentami w katalogu libraries (unix_args.txt). Sprawdź w skrypcie startowym, jaka linijka tam stoi, i przenieś ją do swojej komendy startowej.
6. Ustaw eula=true w eula.txt albo zaznacz akceptację EULA w panelu.
7. Odpal serwer i patrz w konsolę. Pierwszy start trwa kilka minut i generuje wszystkie configi; dopiero potem ma sens zmienianie ustawień.

Która wersja Javy pasuje do której wersji Minecrafta?

Zła wersja Javy to powód numer jeden, dla którego serwer z modpackiem wyłącza się od razu po starcie, zwykle z komunikatem UnsupportedClassVersionError w konsoli.

Nowszy nie znaczy tu lepszy: All the Mods 10 wymaga Javy 21 i nie wystartuje na Javie 17, a RLCraft potrzebuje akurat Javy 8. Jeśli twój pack wypada gdzieś pomiędzy wierszami, zajrzyj do jego opisu; wymagana wersja Javy jest tam podana niemal zawsze.

Ile RAM-u potrzebujesz?

Duże packi to pożeracze pamięci, bo każdy mod rejestruje własne bloki, przedmioty i receptury. Schodzenie poniżej zalecanej wartości rzadko wychodzi: serwer wprawdzie wstanie, ale zawiesi się przy ładowaniu albo i tak stanie po godzinie.

Zwróć uwagę na różnicę między wielkością pakietu a stertą Javy (heap): JVM poza stertą zużywa pamięć również na wątki i biblioteki natywne, więc nie ustawiaj -Xmx na wartość równą całemu pakietowi. Mody optymalizacyjne naprawdę pomagają: na NeoForge FerriteCore zbija zużycie pamięci o 30 do 40 procent, a Canary i ModernFix skracają czas ładowania i zdejmują obciążenie z ticków, czyli z pojedynczych cykli obliczeń serwera. Więcej na ten temat znajdziesz w naszym artykule o optymalizacji serwera Minecraft. A jeśli pamięć chcesz po prostu dokupić: w hostingu Minecraft od MC-Node linia budżetowa kosztuje 4,75 zł za GB miesięcznie, a 15 GB dzięki progom cenowym wychodzi na 64,80 zł miesięcznie, razem z dyskiem NVMe, automatycznymi kopiami zapasowymi i panelem Pterodactyl.

Jakie pięć błędów zdarza się najczęściej?

1. Zła wersja Javy. Serwer wyłącza się w ciągu kilku sekund, a konsola zgłasza błąd wersji klasy. Zmień obraz Dockera i uruchom go ponownie.
2. Za mało RAM-u. Ładowanie się zacina albo konsola melduje brak pamięci. Więcej pamięci pomaga, ale nie naprawi moda, który ją przecieka: najpierw zmierz, zanim zaczniesz dokupować w ciemno.
3. Mody client-only w folderze serwera. Shadery, minimapy i mody od HUD-u wywalają serwer podczas ładowania. Crashlog prawie zawsze podaje nazwę; wyrzuć ją z mods i spróbuj jeszcze raz.
4. Zła wersja loadera. Forge, NeoForge i Fabric mają dla każdego packa konkretny build. Nowszy to nie ulepszenie, tylko niezgodność; przepisz dokładnie ten numer builda, który podaje pack.
5. Świat z innego packa. Chunki, czyli fragmenty świata, odwołują się wtedy do ID bloków i przedmiotów, których w twoim packu nie ma, dostajesz missing registry entries, a gracze tracą ekwipunek. Przywracaj tylko światy z tego samego packa i tej samej wersji.

Dlaczego klient i serwer muszą mieć tę samą wersję packa?

Mody działają po obu stronach. Przy łączeniu klient i serwer porównują swoje listy modów; jeśli się różnią, od razu wylatujesz z powrotem. Aktualizacja packa to więc akcja zespołowa: najpierw serwer, potem wszyscy naraz, i nigdy w środku sesji. To właśnie duża różnica względem pluginów, które chodzą wyłącznie po stronie serwera i których gracze nie muszą u siebie instalować; które warto mieć, opisujemy w naszym zestawieniu najlepszych pluginów do Minecrafta.

Jak sprawdzić, czy się udało?

Przejdź przez te cztery punkty, zanim wpuścisz na serwer graczy.

• Konsola. Poszukaj linijki Done z czasem ładowania i For help, type "help". Jeśli jej nie ma, serwer nie wystartował.
• Liczba załadowanych modów. Loader melduje, ile modów wczytał; jeśli jest to znacznie mniej, niż deklaruje pack, część została pominięta.
• Połączenie dokładnie tym samym packiem. Wchodzisz na serwer, a przedmioty i bloki z packa są w kreatywnym ekwipunku?
• Tickrate i pamięć. Pusty serwer powinien chodzić w okolicach 20 TPS, czyli pełnych 20 ticków na sekundę. Jeśli zaraz po starcie pamięć dobija do sufitu, twój pakiet jest za mały.

Jeśli wszystko działa, od razu zrób kopię zapasową, zanim wejdą gracze. Ta pierwsza kopia czystej, sprawnej instalacji to ta, z której najbardziej się później ucieszysz.

Najczęściej zadawane pytania

Ile RAM-u potrzebuję na All the Mods 10? Minimum 10 GB, 12 GB dla małej paczki znajomych oraz 14 do 16 GB przy pięciu graczach lub więcej albo dużej automatyzacji. ATM10 działa na NeoForge dla Minecrafta 1.21.1 z 400 do ponad 500 modami, więc schodzenie poniżej 10 GB nie ma sensu.

Czy Java 17 wystarczy do packa na 1.21? Nie. Do Minecrafta 1.21 i nowszych wersji 26.x potrzebujesz Javy 21; All the Mods 10 nie wystartuje na Javie 17. Java 17 pasuje do 1.17 aż do 1.20.4, a Java 8 do 1.12.2 i starszych, jak RLCraft.

Czy każdy musi zainstalować ten sam modpack? Tak, i to w dokładnie tej samej wersji. Mody dodają bloki, przedmioty i wymiary, które muszą być zarejestrowane po stronie serwera i klienta; jeśli lista modów się różni, przy łączeniu dostaniesz odmowę. Pluginy na Paper czy Purpur działają inaczej: te chodzą wyłącznie po stronie serwera.

Dlaczego pierwszy start trwa tak długo? Pack z 400 do ponad 500 modami buduje przy pierwszym starcie wszystkie configi i rejestry. Na dysku talerzowym zajmuje to 10 minut lub więcej, na dysku NVMe SSD 2 do 3 minuty. FerriteCore, Canary i ModernFix dodatkowo pomagają na NeoForge.

Czy mogę łączyć mody i pluginy? Nie ot tak. Mody działają na Forge, NeoForge albo Fabric, a pluginy na wariantach Bukkita, czyli Paper i Purpur. Hybrydowe oprogramowanie serwerowe istnieje, ale zwykle jest opóźnione i psuje się przy aktualizacjach; dla stabilnego serwera z modpackiem trzymaj się loadera, który narzuca pack.

Warto przeczytać

• Ile RAM potrzebuje serwer z modpackiem? Poradnik
• Forge, NeoForge, Fabric czy Quilt: który modloader wybrać?
• All the Mods 10 na serwerze: RAM, Java 21 i ustawienia