Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Základní práce s módy a modpacky

Základní informace

Pokud není mód určený pouze pro server, mód musí být nainstalovaný jak na serveru, tak i u klienta (hráče). Z toho vyplývá, že to stejné platí i pro modpacky - hráč se nepřipojí s Vanillou, musí se připojit s modpackem nainstalovaným u sebe (proč tomu tak je se dočtete zde).

Módy určené pouze pro klienta nesmí být nainstalovány na serveru (někdy to vadit nemusí, u Forge to obvykle způsobí zhroucení serveru).

Fabric a Forge jsou dvě naprosto odlišné platformy, tím pádem nejsou módy vzájemně kompatibilní a mezi platformami nelze přecházet “jen tak”.

Pokud módy přidávají nové věci do hry jako bloky, moby apod., z módovaného serveru nelze bez ztráty dat přejít na Vanillu (proč tomu tak je se dočtete zde).

Když instalujete mód, vždy si na jeho stránce přečtěte popis se základními informacemi. Můžete se tak často vyhnout zbytečnému zjišťování problému.

Módované platformy nepodporují pluginy, ale pouze módy (viz zde).

Platformy

Jakou platformu módovaného serveru zvolit se dočtete zde. Fabric a Forge módy nejsou vzájemně kompatibilní.

Níže jsou uvedeny základní informace, které se při správě serveru na dané platformě můžou hodit.

Fabric

FabricAPI

Mnoho Fabric módů vyžaduje FabricAPI. Pokud se rozhodnete Fabric s módy využívat, na server jej automaticky nainstalujte a v případě změny verze verzi FabricAPI aktualizujte.

Je to mód jako každý jiný, tím pádem se nainstaluje nahráním do složky /mods/ a následným restartem serveru.

Forge

V případě, kdy server po delší době po startu píše ‘Server is still starting! Please wait before reconnecting.’, zkuste do konzole napsat /fml confirm (i s lomítkem).

Správa módů na serveru

Tato část je o správě módů, nikoli modpacku. Jak nahrát modpack se dočtete zde.

Instalace

Mód nainstalujete nahráním módu (což je .jar soubor) do složky /mods/ a následným restartem serveru. Samozřejmě server musí běžet na platformě, která módy podporuje, a pro kterou je mód určen.

Změna verze módu

Pokud chcete aktualizovat mód, stačí starou verzi módu smazat a novou nahrát, a to ideálně při vypnutém serveru. Změny se aplikují při dalším startu serveru (tzn. pokud server běží, je zapotřebí server restartovat).

Odstranění

Mód (samotný mód je .jar soubor) odstraníte smazáním módu ze složky /mods/ a následným restartem serveru.

Konfigurace módu

V případě, kdy chcete mód nějakým způsobem nastavit, můžete tak udělat buď pomocí příkazů, které naleznete v dokumentaci módu, nebo pomocí konfiguračních souborů (které se vygenerují při prvním spuštění módu), pokud mód konfigurační soubory má.

Na novějších verzích se jak u Fabricu tak Forge konfigurační soubory módů obvykle nachází ve složce /config/, nicméně tomu tak nemusí vždy být. Nacházet se můžou například i v kořenové složce serveru, nebo složce (hlavního) světa. Více se dočtete v dokumentaci pluginu konkrétního módu.

Správa modpacku

Co je to modpack

Modpack není nic víc než kolekce módů a jejich nastavení.

Jak modpack nainstalovat - klient

Nejjednodušší a standardní variantou instalace modpacku u klienta je za pomoci launcheru uvedeném na stránce, na kterém je modpack nahrán. Pokud je tedy modpack nahrán na CurseForge, modpack jednoduše nainstalujete přes CurseForge launcher, pokud na Modrinthu tak Modrinth launcher atd.

Není to však podmínka. Řada ostatních launcherů (jako např. ATLauncher, MultiMC, nebo Prism Launcher) různé formáty modpacků podporují. Pro většinu ale bude použití “oficálního” launcheru modpacku nejjednodušší variantou.

Jak modpack nainstalovat - server

Modpack na server jednoduše nainstalujete nahráním souborů ze server packu do souborů serveru (do jeho kořenové složky). Server pack je archiv, obvykle .zip, takže abyste se k souborům v server packu dostali, musíte jej rozbalit.

Pokud se v kořenové složce serveru nachází složka /mods/ se všemi módy, server pack jste nahráli správně.

V případě, kdy k systému máte plný přístup a spravujete jej sami (Váš počítač, VPS, dedikovaný server), server pack obvykle obsahuje startovací skript (na Linuxu/macOS .sh soubor, na Windows .bat), přes který můžete server jednoduše spustit.

Pokud startovací skript využít nemůžete (zejména u “managed”, sdíleného hostingu), jednoduše nainstalujte modpackem požadovanou verzi platformy.

Co je server pack

Server pack je soubor, obvykle .zip archiv, který obsahuje veškeré soubory modpacku. Jedná se o zejména módy, které se nachází ve složce /mods/. Pokud stažený soubor /mods/ neobsahuje, nejedná se o server pack, ale stažení určené pro klienta (v takovém případě bude archiv pravděpodobně obsahovat ’manifest“ soubor (nejpravděpodobněji manifest.json) a složku /overrides/).

Tento soubor má obvykle stovky MB. Pokud má velikost souboru pouze jednotky MB nebo méně, téměř jistě se nejedná o server pack, ale stažení určené pro klienta (u klienta se totiž (většinou) stáhne pouze soubor se seznamem módů a módy následně stáhne launcher, což server neumí, proto se poskytuje server pack).

Na CurseForge server pack můžete stáhnout po rozkliknutí dané verze modpacku v záložce Additional Files (pokud je server pack poskytnut).

Po extrahování (rozbalení) tohoto souboru a přemístění/nahrání do souborů serveru bude modpack na serveru nainstalován (za předpokladu, že máte správnou verzi platformy, kterou modpack vyžaduje).

Jak vytvořit server pack

Postupujete-li dle nějakého návodu, v kterém potřebujete pracovat se server packem modpacku, avšak modpack takový pack nemá, níže je vysvětleno, jak si takový server pack vytvořit. Postup je následující:

  1. Klientskou verzi modpacku stáhněte a nainstalujte přes launcher, který to podporuje (CurseForge, Modrinth, ATLauncher, …). Standardně tedy launcher, přes který budete modpack hrát (zjednodušeně řečeno to prostě znamená, ať modpack zapnete, počkáte, než se hra zapne, a poté jej vypnete)
  2. Po nainstalování modpacku u klienta otevřete složku se soubory modpacku

Složku se soubory modpacku otevřete (její lokaci zjistíte v každém launcheru jinak, ale prakticky vždy launcher tuto možnost má. Návod, kde složku modpacku u většinu launcherů najít, naleznete zde). Když složku modpacku otevřete, měli byste v ní vidět složku /mods/. Pokud tomu tak není, modpack není nainstalovaný, nebo jste ve špatné složce.

  1. Všechny soubory v této složce označte a vytvoř z nich .zip soubor

Tím vytvoříte “server pack” (ten .zip soubor), s kterým můžete pracovat stejně, jako v návodu. Úplně na konci je ale potřeba krok navíc: Po nahrání a rozbalení server packu je potřeba ze složky /mods/ odstranit všechny módy, které jsou určené pouze pro klienta (viz zde resp. u Fabricu to problém být nemusí, u Forge skoro jistě bude, pokud tam nějaký takový mód necháte)

Co když modpack nemá server pack

V případě, kdy vývojář modpacku neposkytuje server pack, je potřeba postupovat následovně:

  1. Klientskou verzi modpacku stáhněte a nainstalujte přes launcher, který to podporuje (CurseForge, Modrinth, ATLauncher, …), standardně tedy launcher, přes který budete modpack hrát
  2. Po nainstalování modpacku u klienta otevřete složku se soubory modpacku
  3. Nainstalujte příslušnou verzi platformy serveru, pro kterou je modpack určen

Složku se soubory modpacku otevřete/zjistíte její lokaci v každém launcheru jinak, ale prakticky vždy launcher tuto možnost má. Návod, kde složku modpacku u většinu launcherů najít, naleznete zde. Když složku modpacku otevřete, měli byste v ní vidět složku /mods/. Pokud tomu tak není, modpack není nainstalovaný, nebo jste ve špatné složce.

  1. Všechny soubory modpacku zkopírujte a přemistěte/nahrajte do souborů serveru
  2. Ze složky /mods/ odstraňte všechny módy, které jsou určené pouze pro klienta (viz zde)

Jak poznat, zda je mód určený pouze pro klienta

Pokud se setkáváte s crashováním serveru a (zejména na Forge) v logu vidíte chyby s textem ‘net/minecraft/client’, je pravděpodobné, že server crashuje kvůli tomu, že je na serveru nainstalovaný mód určený pouze pro klienta. Z této chyby se dá vyčíst, jaký konkrétní mód chybu způsobuje.

Například ze stacktracu této chyby se dá jednoznačně vyčíst, že problém způsobuje mód MouseTweaks (předpolední řádek).

[13:16:00] [Server thread/ERROR]: Encountered an unexpected exception
cpw.mods.fml.common.LoaderException: java.lang.NoClassDefFoundError: net/minecraft/client/entity/EntityClientPlayerMP
	at cpw.mods.fml.common.LoadController.transition(LoadController.java:163) ~[LoadController.class:?]
	at cpw.mods.fml.common.Loader.initializeMods(Loader.java:739) ~[Loader.class:?]
	at cpw.mods.fml.server.FMLServerHandler.finishServerLoading(FMLServerHandler.java:97) ~[FMLServerHandler.class:?]
	at cpw.mods.fml.common.FMLCommonHandler.onServerStarted(FMLCommonHandler.java:319) ~[FMLCommonHandler.class:?]
	at net.minecraft.server.dedicated.DedicatedServer.func_71197_b(DedicatedServer.java:210) ~[lt.class:?]
	at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:387) [MinecraftServer.class:?]
	at net.minecraft.server.MinecraftServer$2.run(MinecraftServer.java:685) [li.class:?]
Caused by: java.lang.NoClassDefFoundError: net/minecraft/client/entity/EntityClientPlayerMP
	at yalter.mousetweaks.loaders.MouseTweaksForge.init(Unknown Source) ~[MouseTweaksForge.class:2.4.4]
	... pokračování

Na Fabricu je informace o nesprávném použití módu pouze pro klienta obvykle jednoznačně uvedena v prvních řádcích logu, ale nemusí tomu tak vždy (naštěstí Fabric obvykle módy pouze nezapne a žádný problém nezpůsobí, narozdíl od Forge).

V moment, kdy z chyby vyčtete, o jaký mód se jedná, zjistěte, zda je mód určen pouze pro klienta. Pokud tomu tak je, ze serveru jej odstraňte.

Ale jak to zjistit?

Měli byste přibližně tušit, jaké módy na server nepatří. Např. mód který pracuje se shadery se serverem nijak nesouvisí, nijak s ním neiteraguje, jelikož shadery se starají pouze o vykreslování u klienta, z čehož si dokážete vyvodit, že mód na server nepatří. To stejné platí pro uvedené MouseTweaks. Popis na stránce módu je: “Mouse Tweaks replaces the standard RMB dragging mechanic, adds two new LMB dragging mechanics and an ability to quickly move items with the scroll wheel.” To taktéž se serverem nijak nesouvisí a ovlivňuje pouze chování klienta.

Pokud je mód na Modrinthu, na stránce módu napsáno, zda je určen pouze pro klienta, nebo i server.

Pokud si nejste jistí a mód na Modrinthu není, jednoduše mód zkuste odstranit a zjistěte, zda problém přetrvává (to, že se server opět nezapne automaticky neznamená, že daný mód problém nebyl. Takových módů můžete mít nainstalováno více).

Nejčastější problémy a jejich řešení

Ať řešíte problém na serveru s pluginy nebo módy, prakticky vždy se dá vyčíst z logu. Fabric má obvykle chyby velmi dobřé popsané a vysvětlené. U Forge to může být horší, ale standardně lze z logu taktéž vyčíst příčinu bez větších potíží.

Když instalujete mód, vždy si na jeho stránce přečtěte popis se základními informacemi. Můžete se tak často vyhnout zbytečnému zjišťování problému.

Níže jsou uvedeny nejčastější problémy, se kterými se správci módovaného serveru potýkají.

Špatná verze módu

Když stahujete mód, vždy stahujte verzi určenou pro Vaši platformu a verzi Minecraftu (Fabricu/Forge).

Špatná platforma

Fabric a Forge nejsou vzájemně kompatibilní, tím pádem pokud je platforma serveru Fabric, musíte stáhnout verzi módu pro Fabric, pokud pro Forge tak verzi Forge. Verze určená pro NeoForge na Forge fungovat nebude (naopak obvykle ano, jelikož NeoForge je Forge fork)

Špatná Minecraft verze

Jak je psáno výše, vždy si při stahování módu dejte , pro jakou Minecraft verzi je mód určen. Pokud nahrajete verzi nekompatibilní s verzí serveru, server se obvykle zhroutí. Více informací o konkrétní chybě vždy dokážete vyčíst z logu.

Například na Forge může chybová zpráva (v logu) vypadat následovně:

[09pro2023 12:50:41.954] [main/ERROR] net.minecraftforge. fml. loading-ModSorter/LOADING]: Missing or unsupported mandatory dependencies:
Mod ID: 'minecraft', Requested by: 'naturalist', Expected range: '[1.20.1,)', Actual version: '1.19.2'
Mod ID: 'minecraft', Requested by: 'immersive_armors', Expected range: '[1.18.1,1.18.1]', Actual version: '1.19.2'

Módy jsou narozdíl od pluginů na verze velmi “citlivé”, tudíž mód s jinou “subverzí” (např. 1.20.1 vs 1.20.2) obvykle nebude vůbec fungovat. Je potřeba použít verzi určenou pro přesnou verzi serveru.

Chybějící závislosti

Stejně jako pluginy můžou módy k fungování vyžadovat jiný mód. Narozdíl od pluginů se mód nevypne, ale zhroutí (vypne) se celý server.

Z logu lze téměř vždy na Fabricu i Forge informace o chybějících závislostech jednoduše vyčíst.

Taková zpráva může na Fabricu vypadat následovně (’fabric“ v ’requires any version of fabric“ označuje FabricAPI):

[20:34:13] [main/INFO]: Loading Minecraft 1.20.4 with Fabric Loader 0.15.11
[20:34:13] [main/WARN]: Mod resolution failed
[20:34:13] [main/INFO]: Immediate reason: [HARD_DEP_NO_CANDIDATE biomesoplenty 19.0.0.89 {depends fabric @ [*]}, ROOT_FORCELOAD_SINGLE biomesoplenty 19.0.0.89]
[20:34:13] [main/INFO]: Reason: [HARD_DEP biomesoplenty 19.0.0.89 {depends fabric @ [*]}, HARD_DEP biomesoplenty 19.0.0.89 {depends glitchcore @ [>=1.0.0.51]}, HARD_DEP biomesoplenty 19.0.0.89 {depends terrablender @ [>=3.3.0.9]}]
[20:34:13] [main/INFO]: Fix: add [add:fabric 1 ([(-∞,∞)]), add:glitchcore 1.0.0.51 ([[1.0.0.51,∞)]), add:terrablender 3.3.0.9 ([[3.3.0.9 ∞)])], remove [], replace []
[20:34:13] [main/ERROR]: Incompatible mods found!
net.fabricmc.loader.impl.FormattedException: Some of your mods are incompatible with the game or each other!
A potential solution has been determined, this may resolve your problem:
	 - Install fabric, any version.
	 - Install glitchcore, version 1.0.0.51 or later.
	 - Install terrablender, version 3.3.0.9 or later.
More details:
	 - Mod 'BiomesOPlenty' (biomesoplenty) 19.0.0.89 requires any version of fabric, which is missing!
	 - Mod 'BiomesOPlenty' (biomesoplenty) 19.0.0.89 requires version 1.0.0.51 or later of glitchcore, which is missing!
	 - Mod 'BiomesOPlenty' (biomesoplenty) 19.0.0.89 requires version 3.3.0.9 or later of terrablender, which is missing!
	at net.fabricmc.loader.impl.FormattedException.ofLocalized(FormattedException.java:51) ~[fabric-loader-0.15.11.jar:?]
	at net.fabricmc.loader.impl.FabricLoaderImpl.load(FabricLoaderImpl.java:195) ~[fabric-loader-0.15.11.jar:?]
	at net.fabricmc.loader.impl.launch.knot.Knot.init(Knot.java:146) ~[fabric-loader-0.15.11.jar:?]
	at net.fabricmc.loader.impl.launch.knot.Knot.launch(Knot.java:68) ~[fabric-loader-0.15.11.jar:?]
	at net.fabricmc.loader.impl.launch.knot.KnotServer.main(KnotServer.java:23) ~[fabric-loader-0.15.11.jar:?]
	at net.fabricmc.loader.impl.launch.server.FabricServerLauncher.main(FabricServerLauncher.java:69) ~[fabric-loader-0.15.11.jar:?]
	at net.fabricmc.installer.ServerLauncher.main(ServerLauncher.java:69) ~[server.jar:1.0.1]

A na Forge následovně:

[09pro2023 12:50:41.954] [main/ERROR] Inet.minecraftforge. fml. loading-ModSorter/LOADING]: Missing or unsupported mandatory dependencies:
Mod ID: 'geckolib', Requested by: 'naturalist', Expected range: '[4.0.0,)', Actual version: '[MISSING]'
Mod ID: 'moonlight', Requested by: 'supplementaries', Expected range: '[1.19.2-2.3.0,1', Actual version: '[MISSING]'

U obou platforem je jasně uvedeno, jaký mód vyžaduje jakou závislost včetně její verze.

Když instalujete mód samostatně, vždy si na jeho stránce přečtěte jeho popis se základními informacemi. Pokud mód nějakou závislost potřebuje, bude to tam uvedeno. Navíc na Modrinthu jsou po rozkliknutí verze módu závislosti uvedeny viz např. zde.

Na serveru je mód určený pouze pro server

Více se dočtete zde.