Jak udržet módovanou Valheim partu na stejných módech: postav jeden r2modman profil, exportuj ho, nech všechny importovat totéž - a pak zkopíruj pluginy a konfigurace tohoto profilu na server. Kód profilu je rychlý a hodí se pro první instalaci; exportovaný soubor .r2z je to, co si máš uschovat, protože je trvalý a nese přesné verze. Pokazit se nemůže export, ale to, co přijde potom: jeden klikne na „update all“, další přidá mód, který se mu líbil, a o tři týdny později půlku party vyhazuje při připojení. Tento článek popisuje stavbu profilu, jeho sdílení, zafixování verzí, aby sdílený zůstal, a přenos stejné sady na dedicated server, což r2modman za tebe neudělá.
Pokud jsi na server ještě nenainstaloval BepInEx, začni článkem Módy na Valheim serveru s BepInEx. Tento článek je o distribuci seznamu módů, ne o samotném loaderu.
Co r2modman a Thunderstore doopravdy dělají#
Thunderstore je repozitář módů, který používá komunita Valheimu. Každý balíček na něm má název ve tvaru Author-ModName, číslo verze a manifest.json, který vypisuje jeho závislosti s přesnou verzí - například ValheimModding-Jotunn-2.20.0 nebo denikson-BepInExPack_Valheim-5.4.2202. Právě tyto řetězce správce módů řeší.
r2modman je open-source desktopový správce módů pro hry z Thunderstore. Pro Valheim dělá čtyři užitečné věci:
- Udržuje profily, každý jako samostatnou složku s vlastní instalací
BepInEx, takže módovaný profil a vanilla hra se nikdy nepletou. - Instaluje módy se závislostmi do
BepInEx/plugins/<Author>-<ModName>/, takže každý mód má vlastní složku a vlastnímanifest.json. - Spouští hru s načteným profilem („Start modded“) a instalaci ve Steamu nechává nedotčenou.
- Exportuje a importuje profily, což je funkce, o které tento článek je.
Thunderstore Mod Manager je stejný kód zabalený s Overwolfem a Gale je novější nezávislý správce, který čte stejné balíčky a umí importovat kódy profilů z r2modmanu. Postup níže je psaný pro r2modman, ale myšlenky platí pro oba.
Na Windows r2modman ukládá data do %APPDATA%\r2modmanPlus-local\ a profil Valheimu leží tady:
%APPDATA%\r2modmanPlus-local\Valheim\profiles\<profile name>\ BepInEx\ config\ mod settings core\ BepInEx itself patchers\ e.g. HookGenPatcher plugins\ one folder per modTuto cestu málokdy potřebuješ psát. Otevře ji Settings, potom „Browse profile folder“.
Stavba profilu pro partu#
Seznam vlastní jeden člověk. U party šesti kamarádů to zní byrokraticky, ale každá skupina, která bez toho funguje, nakonec po patchi rekonstruuje seznam ze screenshotů. Majitel profil staví; ostatní ho importují a nic do něj nepřidávají.
- V r2modmanu vyber Valheim, vytvoř nový profil a dej mu název, který obsahuje datum nebo číslo -
Longship-2026-10místoModded. Názvy se přenášejí s exportem a hned je vidět, když je někdo na starém. - Nainstaluj módy z karty online. Závislosti se doinstalují automaticky: nainstaluješ jeden obsahový mód a obvykle se vedle něj objeví BepInExPack Valheim, Jotunn a HookGenPatcher.
- Jednou spusť hru přes „Start modded“ a dojdi do hlavního menu. Tím se vygenerují konfigurační soubory všech módů v
BepInEx/config. Bez tohoto kroku export konfigurace neobsahuje a všichni začnou s výchozími hodnotami. - Uprav konfigurace, na kterých ti záleží, v konfiguračním editoru r2modmanu nebo přímo ve složce. Pokud budeš měnit hodnoty synchronizované se serverem, udělej to později na serveru - viz níže.
- Připoj se do testovacího světa, ověř, že každý mód dělá, co čekáš, a pak exportuj.
Seznam veď poctivě podle toho, k čemu který mód je. Módy jen pro klienta - minimapy, úpravy HUD, módy kamery - mohou být ve sdíleném profilu pro pohodlí, ale server je nepotřebuje a parta má vědět, že jsou volitelné. Módy, které mění pravidla nebo obsah, musí být všude identické.
Sdílení: kód profilu nebo soubor#
r2modman nabízí dva exportní formáty v Settings, „Export profile as a code“ a „Export profile as a file“. Znění se mezi verzemi mírně liší; obojí najdeš v sekci profilů v Settings.
| Kód profilu | Soubor profilu (.r2z) | |
|---|---|---|
| Co to je | Krátký kód odkazující na nahrání | Zip na tvém disku |
| Sdílí se | Vložením do chatu | Odesláním souboru |
| Životnost | Dočasná; kódy vyprší | Trvalý |
| Obsahuje konfigurace | Ano | Ano |
| Přesné verze | Ano | Ano |
.r2z je obyčejný zip. Uvnitř je export.r2x, malý YAML soubor, který vypisuje každý mód podle jména s verzí a informací, zda je zapnutý, plus kopie složky BepInEx/config. Díky tomu je to užitečný záznam i způsob distribuce: můžeš ho otevřít a seznam přečíst.
Při importu všichni ostatní vyberou v r2modmanu Valheim, přejdou na obrazovku výběru profilu, zvolí „Import / Update“, potom „Import new profile“ a buď „From code“, nebo „From file“. r2modman stáhne uvedené módy v uvedených verzích a zkopíruje konfigurace. Import vytvoří nový profil; stávající profily nechá být.
Kódy se nahrávají do služby Thunderstore pro sdílení profilů a nezůstávají tam navždy, takže kód vložený na Discordu v březnu může v červnu nedělat nic. Kód pošli pro pohodlí a vedle něj připni soubor .r2z jako trvalou kopii. Když se seznam změní, exportuj nový soubor s novým názvem a připnutý nahraď.
Zafixování verzí, aby všichni zůstali sladění#
Import dá všem první den identické verze. Udržet je identické je samostatný problém a r2modman je stavěný tak, aby módy držel aktuální, což tady jde proti tobě.
- Nepoužívej „Update all“. r2modman označí nainstalované módy, pro které existuje novější verze, a nabídne jejich aktualizaci jedním kliknutím. Na sdíleném profilu toto jedno kliknutí posune jednoho hráče před server i všechny ostatní. Udělejte z toho pravidlo party: aktualizuje jen majitel profilu a jen tím, že exportuje nový profil.
- Když potřebuješ konkrétní verzi, nainstaluj ji. Na stránce módu v r2modmanu ti dialog stahování dovolí vybrat verzi místo nejnovější. Použij to, abys vrátil jeden mód zpět, když aktualizace něco rozbije.
- Jotunn a BepInExPack ber jako součást seznamu. Jsou to závislosti, ne šum na pozadí. Novější Jotunn u jednoho klienta než na serveru může způsobit přesně takovou neshodu jako obsahový mód - proč, vysvětluje Jotunn vysvětlen.
- Aktualizuj v jedné dávce. Když vyjde patch Valheimu, majitel počká, až se módy dotáhnou, postaví novou verzi profilu, otestuje ji, aktualizuje server a teprve potom zveřejní nový soubor. Všichni importují nový profil; nikdo neaktualizuje na místě.
Fixování má svou cenu: občas týden poběžíš na verzi módu se známou chybou, protože aktualizace uprostřed týdne znamená znovu sdílet profil. Obvykle je to správný kompromis. Obecný argument podává článek Fixace verzí herního serveru a rollbacky.
Instalace stejné sady na server#
r2modman spravuje herního klienta. Neinstaluje na dedicated server, takže kopii na server děláš ručně - ale protože je složka profilu jen složka BepInEx, je to přímočaré.
Nejdřív nainstaluj BepInExPack Valheim přímo na server podle průvodce BepInEx pro server. Nekopíruj BepInEx/core ani soubory Windows injektoru z windowsového profilu na linuxový server; balíček má vlastní linuxový startovací skript a knihovny a server je potřebuje. Z profilu kopíruješ módy a jejich nastavení:
| Složka v profilu | Kopírovat na server? | Poznámky |
|---|---|---|
BepInEx/plugins | Ano, bez módů jen pro klienta | Jedna složka na mód |
BepInEx/patchers | Ano | Sídlí tu HookGenPatcher a spol. |
BepInEx/config | Ano | Potom uprav hodnoty jen pro server |
BepInEx/core | Ne | Pochází z vlastního balíčku serveru |
Módy jen pro klienta ze serverové kopie odeber. Většina z nich na serveru prostě nedělá nic, ale některé se pokoušejí sahat na rozhraní nebo kameru a v procesu, který nemá ani jedno, hážou chyby, a každý zbytečný mód znamená delší start.
Samotné nahrání je přenos souborů: zabal plugins, patchers a config ze složky profilu, nahraj zip do adresáře BepInEx na serveru přes správce souborů nebo SFTP a rozbal ho na místě. Údaje k připojení má článek SFTP a správce souborů. Na RE:NODE správce souborů rozbaluje archivy na místě, takže stačí jedno nahrání zipu; u hostingu, který to neumí, nahraj složky přes SFTP.
Potom spusť server a přečti si startovní log. Chceš jeden řádek Loading [ModName version] na mód a verze by měly odpovídat profilu. Rychlý způsob porovnání je vytáhnout seznam z obou stran:
# On the server, from the server root$ grep -o 'Loading \[[^]]*\]' BepInEx/LogOutput.log | sortNa windowsovém klientovi je stejný soubor ve složce BepInEx profilu po jednom módovaném startu. Pokud jsou oba seznamy identické, parta je sladěná.
Konfigurace: která strana vyhrává#
Zkopírováním BepInEx/config na server dostaneš všechny na stejný výchozí bod. Potom se konfigurace módů dělí na dva druhy a záleží na tom, který je který.
- Nastavení synchronizovaná se serverem. Módy postavené na synchronizaci konfigurace v Jotunn nebo na ServerSync posílají svá nastavení ze serveru každému klientovi při připojení. U nich je pravdou soubor serveru a úpravy klienta se přepíšou nebo ignorují. Mnoho takových módů má nastavení
Lock Configuration, které to vynucuje; je-li zapnuté, počítají se jen hodnoty serveru. - Lokální nastavení. Všechno ostatní se čte z vlastního souboru každého počítače. Pokud hráč změní hodnotu nosnosti v módu, který nesynchronizuje, hraje podle jiných pravidel než všichni ostatní a nic mu to neřekne.
Praktické pravidlo: synchronizovaná nastavení měň na serveru a restartuj; lokální nastavení měň v profilu, exportuj novou verzi a nech všechny znovu importovat. Nežádej lidi, aby ručně upravovali konfigurační soubory, aby seděly, protože někdo vždycky jeden přehlédne.
Profile: Longship-2026-10b (file attached, code expires)Valheim (server patch noted here), BepInExPack 5.4.2202, Jotunn 2.x.xServer updated: 2026-10-12Do not press Update all. Ask in #mods first.Řešení problémů se sdílenými profily#
Kód nic neimportuje nebo hlásí, že je neplatný. Vypršel. Použij soubor .r2z.
Import projde, ale jeden mód se nestáhne. Uvedená přesná verze byla na Thunderstore odstraněna nebo označena jako zastaralá. Majitel musí vybrat aktuální verzi, znovu exportovat a znovu sdílet.
Jednoho hráče vyhazuje při připojení, ostatní jsou v pořádku. Jeho profil se rozešel - aktualizace, přidaný mód, nebo spustil špatný profil. Ať naimportuje aktuální soubor jako nový profil místo opravování starého. Vyhození kvůli neshodě verzí módů ukazuje, jak z hlášky vyčíst konkrétní mód.
Hra se spustí jako vanilla. Klikli na Play ve Steamu místo na „Start modded“ v r2modmanu. Instalace ve Steamu nemá BepInEx; profil ano.
Server má módy, ale nic nedělají. Server se spustil bez injektoru, takže se složka plugins nečte. Zkontroluj, zda je nahoře v logu banner BepInEx; pokud chybí, startovací příkaz BepInEx nepoužívá.
Konfigurace na serveru se po restartu resetují. Mód při startu přepíše svůj soubor a zahodí klíče, které nezná. Obvykle byl klíč zkopírován z jiné verze módu. Vygeneruj soubor ve verzi serveru a pak ho uprav.
FAQ#
Instaluje r2modman módy na dedicated server?
Ne. Spravuje profil herního klienta. Nainstaluj BepInExPack Valheim na server a pak do něj zkopíruj složky plugins, patchers a config z profilu.
Jak dlouho platí kód profilu v r2modmanu?
Ne dost dlouho, aby se na něj dalo spolehnout. Kódy odkazují na dočasné nahrání a vyprší. Kód sdílej pro pohodlí a exportovaný soubor .r2z si uchovej jako trvalou kopii.
Umí Thunderstore Mod Manager nebo Gale importovat profil z r2modmanu?
Thunderstore Mod Manager je postavený na r2modmanu a používá stejný formát. Gale umí importovat kódy i soubory profilů z r2modmanu. Míchání správců v jedné partě funguje, ale majitel profilu by měl testovat s tím, který používá většina lidí.
Musí být módy jen pro klienta ve skupinovém profilu?
Ne. Jsou jen pro pohodlí. Když je vynecháš, profil je menší a všem je jasné, které módy se doopravdy musí shodovat.
Co se stane, když někdo aktualizuje jeden mód na vlastní pěst?
Pokud ten mód vynucuje kontrolu verze, při připojení ho odmítnou. Pokud ne, může se připojit a hrát s nepatrně jinými pravidly nebo s předměty, které se nesynchronizují, což se diagnostikuje hůř. V obou případech je řešením znovu naimportovat aktuální profil party.
