Chyby při načítání modů a pluginů

Odhalte doplněk blokující start Minecraft serveru metodou půlení a naučte se rozpoznat běžné hlášky o nekompatibilitě.

Aktualizováno: 14. srpna 20263 min čtení

Server, který přestal startovat hned po přidání nebo aktualizaci doplňku, se téměř vždy zastaví na jednom konkrétním souboru .jar. Log uvádí jeho název – a pokud ne, najdete ho metodou půlení během několika restartů. Pořadí je vždy stejné: log → název souboru → odstranění → ověření.

#Co budete potřebovat

Záložky Logy a Soubory v panelu manage.mchost.gg.
Zálohu před mazáním čehokoli.

#Typické hlášky

Hláška	Význam	Řešení
`Could not load 'plugins/X.jar'`	Plugin není kompatibilní s jádrem nebo verzí	stáhněte verzi pro svůj server
`UnsupportedClassVersionError`	Doplněk vyžaduje novější Javu	změňte verzi Javy nebo stáhněte starší vydání doplňku
`NoClassDefFoundError`	Chybí závislost	doinstalujte požadovaný plugin
`Missing dependency` / `requires`	Mod vyžaduje jiný mod	přidejte chybějící, např. Fabric API
`Incompatible mod set!`	Nesoulad modů mezi klientem a serverem	sjednoťte seznamy modů
`Duplicate mod`	Dvě verze téhož modu	smažte starší soubor
`is not compatible with this server version`	Špatná verze hry	stáhněte vydání pro svou verzi

#Krok 1: Najděte viníka v logu

V záložce Logy filtrujte podle ERROR, potom podle Caused by. Název souboru bývá obvykle v uvozovkách nebo hranatých závorkách:

[ERROR]: Could not load 'plugins/StaryPlugin.jar' in folder 'plugins'
Caused by: java.lang.UnsupportedClassVersionError: pl/example/Main

U modů se podívejte na balíček na prvním řádku at ... – com.example.mod prozradí autora a obvykle i název modu.

#Krok 2: Odstraňte doplněk

Zastavte server tlačítkem Zastavit.
V záložce Soubory otevřete /plugins nebo /mods.
Smažte označený soubor .jar tlačítkem Smazat.
Spusťte server a zkontrolujte, zda se objevilo Done.

#Krok 3: Když log viníka neukáže – metoda půlení

Při třiceti modech by kontrola po jednom znamenala třicet restartů. Půlení to zvládne za pět.

Vytvořte složku mods-off (nebo plugins-off) tlačítkem Vytvořit složku.
Přesuňte do ní polovinu doplňků (označte je a použijte Přesunout).
Spusťte server.
- Naběhne – viník je v přesunuté polovině.
- Nenaběhne – viník zůstal v aktivní složce.
Vezměte podezřelou polovinu a rozdělte ji znovu napůl. Opakujte.

Při 32 doplňcích stačí 5 kroků.

Doplňky nemažte hned – přesouvejte je. Složka s konfigurací (např. /plugins/EssentialsX/) zůstane na místě, takže po návratu souboru o nastavení nepřijdete.

#Krok 4: Závislosti

Část doplňků nefunguje samostatně:

Doplněk	Vyžaduje
WorldGuard	WorldEdit
Mody pro Fabric	Fabric API
Ekonomické pluginy	Vault
Mnoho pluginů s oprávněními	LuckPerms

Chybějící závislosti se vypisují přímo v logu startu – vyplatí se ho projít celý, i když server naběhl.

#Krok 5: Kompatibilita jádra

Plugin pro Bukkit/Spigot/Paper nefunguje na Forge ani Fabric. Mod pro Forge nefunguje na Fabric a naopak. Nahrání souboru, který na dané jádro nepatří, zablokuje start serveru. Před stažením doplňku zkontrolujte typ jádra v záložce Jádra.

#Nejčastější problémy

#Smazal jsem mod, ale server stále nenaběhne

V logu je další chyba – první zakrývala ty následující. Zopakujte diagnostiku od začátku.

#Server naběhne, ale plugin nefunguje

Načetl se s varováním nebo mu chybí závislost. Zkontrolujte log startu pod jeho názvem a v konzoli zadejte plugins, abyste viděli jeho stav.

#Po aktualizaci modu zmizela konfigurace

Nová verze přestavěla soubory. Obnovte nastavení ze zálohy – proto záloha před aktualizací není volitelná.

#`Duplicate mod` přesto, že je tam jediný soubor

Druhá kopie leží v podsložce /mods, nebo ji obsahuje modpack ve svém balíčku. Projděte složku rekurzivně.

#Mod funguje na klientovi, na serveru ne

Stáhli jste klientské vydání. Na stránce modu ověřte, zda má serverovou verzi – ne všechny ji mají.