Serwer, który przestał startować zaraz po dodaniu lub aktualizacji dodatku, prawie zawsze zatrzymuje się na jednym konkretnym pliku .jar. Log podaje jego nazwę — a jeśli nie podaje, znajdziesz go metodą połowienia w kilka restartów. Kolejność jest zawsze ta sama: log → nazwa pliku → usunięcie → weryfikacja.
#Czego potrzebujesz
- Zakładka Dzienniki i Pliki w panelu manage.mchost.gg.
- Kopia zapasowa przed usuwaniem czegokolwiek.
#Typowe komunikaty
| Komunikat | Znaczenie | Rozwiązanie |
|---|---|---|
Could not load 'plugins/X.jar' |
Plugin niezgodny z silnikiem lub wersją | pobierz wersję pod swój serwer |
UnsupportedClassVersionError |
Dodatek wymaga nowszej Javy | zmień wersję Javy albo pobierz starsze wydanie dodatku |
NoClassDefFoundError |
Brak zależności | doinstaluj wymagany plugin |
Missing dependency / requires |
Mod wymaga innego moda | dodaj brakujący, np. Fabric API |
Incompatible mod set! |
Rozjazd modów klient–serwer | zrównaj listy modów |
Duplicate mod |
Dwie wersje tego samego moda | usuń starszy plik |
is not compatible with this server version |
Zła wersja gry | pobierz wydanie pod swoją wersję |
#Krok 1: Wskaż winowajcę w logu
W zakładce Dzienniki filtruj po ERROR, potem po Caused by. Nazwa pliku stoi zwykle w cudzysłowie lub nawiasie kwadratowym:
[ERROR]: Could not load 'plugins/StaryPlugin.jar' in folder 'plugins'
Caused by: java.lang.UnsupportedClassVersionError: pl/example/MainPrzy modach spójrz na pakiet w pierwszej linii at ... — com.example.mod wskazuje autora i zwykle nazwę moda.
#Krok 2: Usuń dodatek
- Zatrzymaj serwer przyciskiem Wyłącz.
- W zakładce Pliki wejdź do
/pluginslub/mods. - Usuń wskazany
.jarprzyciskiem Usuń. - Uruchom serwer i sprawdź, czy pojawiło się
Done.
#Krok 3: Gdy log nie wskazuje winowajcy — metoda połowienia
Przy trzydziestu modach sprawdzanie po jednym to trzydzieści restartów. Połowienie załatwia to w pięciu.
- Utwórz katalog
mods-off(lubplugins-off) przyciskiem Utwórz folder. - Przenieś do niego połowę dodatków (zaznacz i użyj Przenieś).
- Uruchom serwer.
- Startuje — winowajca jest w przeniesionej połowie.
- Nie startuje — winowajca został w katalogu aktywnym.
- Weź podejrzaną połowę i podziel ją znowu na pół. Powtarzaj.
Przy 32 dodatkach wystarczy 5 iteracji.
Nie usuwaj dodatków od razu — przenoś je. Katalog konfiguracyjny (np. /plugins/EssentialsX/) zostaje na miejscu, więc po powrocie pliku nie tracisz ustawień.
#Krok 4: Zależności
Część dodatków nie zadziała samodzielnie:
| Dodatek | Wymaga |
|---|---|
| WorldGuard | WorldEdit |
| Mody Fabric | Fabric API |
| Pluginy ekonomiczne | Vault |
| Wiele pluginów uprawnień | LuckPerms |
Brakujące zależności wypisywane są wprost w logu startu — warto przejrzeć go w całości, nawet gdy serwer wystartował.
#Krok 5: Zgodność silnika
Plugin Bukkit/Spigot/Paper nie zadziała na Forge ani Fabric. Mod Forge nie zadziała na Fabric i odwrotnie. Wrzucenie pliku nie do tego silnika blokuje start serwera. Sprawdź typ silnika w zakładce Silniki przed pobraniem dodatku.
#Najczęstsze problemy
#Usunąłem mod, a serwer nadal nie startuje
W logu jest kolejny błąd — pierwszy przesłaniał następne. Powtórz diagnozę od nowa.
#Serwer startuje, ale plugin nie działa
Wczytał się z ostrzeżeniem albo brakuje mu zależności. Sprawdź log startu pod jego nazwą i wpisz plugins w konsoli, żeby zobaczyć jego stan.
#Po aktualizacji moda znikła konfiguracja
Nowa wersja przebudowała pliki. Odtwórz ustawienia z kopii zapasowej — dlatego backup przed aktualizacją nie jest opcjonalny.
#Duplicate mod mimo jednego pliku
Drugi egzemplarz siedzi w podkatalogu /mods albo modpack zawiera go w swojej paczce. Przejrzyj katalog rekurencyjnie.
#Mod działa na kliencie, nie działa na serwerze
Pobrałeś wydanie klienckie. Sprawdź na stronie moda, czy ma wersję serwerową — nie wszystkie mają.