Како инсталирати модове за Valheim на Mac-у: изворно на Apple Silicon без Rosetta-е

Valheim ради изворно на Mac рачунарима са Apple Silicon, а могу и његови модови. Менаџери модова које користе играчи Windows-а не раде на macOS-у. Зато на Mac-у једном ручно инсталираш програм за учитавање модова, задаш једну опцију покретања Valheim-у у Steam-у и сваки мод ставиш у фасциклу. Након тога Valheim се покреће из Steam-а као и обично, са свим додатим модовима.

Који менаџери модова раде на Mac-у?

Ниједан од уобичајених.

Сами модови су исте датотеке на сваком систему, па Mac користи иста преузимања као играчи Windows-а. Thunderstore, где се објављује већина модова за Valheim, има дугме Download на страници сваког мода које даје исти zip који би менаџер инсталирао. Nexus Mods и CurseForge такође нуде модове за Valheim, а њихове датотеке иду у исте фасцикле.

Зашто уобичајени BepInEx не ради на Apple Silicon?

Модови за Valheim раде на BepInEx-у, програму за учитавање модова. BepInEx Pack Valheim, копија коју сваки менаџер инсталира, садржи Mac библиотеку само за Intel процесоре. Званично издање BepInEx 5.4.23.5 учита се на Mac-у серије M, али стане пре учитавања модова: macOS му не дозвољава да мења код игре у меморији као на Windows-у. Покретање Valheim-а под Rosetta-ом заобилази то ограничење уз губитак брзине.

BepInEx је у међувремену поправио проблем у изворном коду, заједно са библиотеком из које се покреће, али ниједна исправка још није у редовном издању. Пакет испод је BepInEx направљен из тог кода, са исправљеном библиотеком за учитавање и подешавањима за Valheim. Ради на Apple Silicon без Rosetta-е.

Како инсталирати BepInEx за Valheim на Mac-у?

1. Затвори Valheim.
2. Преузми BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. Његова контролна сума SHA-256 налази се у SHA256SUMS.txt.
3. Отвори Terminal и распакуј га у фасциклу Valheim:

cd "$HOME/Library/Application Support/Steam/steamapps/common/Valheim"
unzip -o ~/Downloads/BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip

4. У истом прозору Terminal-а испиши опцију покретања за свој Mac и копирај добијени ред:

echo "\"$PWD/run_bepinex.sh\" %command%"

5. У Steam библиотеци кликни Valheim десним тастером, одабери Properties и налепи ред у Launch options на страници General.
6. Покрени Valheim из Steam-а. У главном менију доле десно пише „You are playing a modded version of Valheim”, а фасцикла Valheim сада садржи BepInEx/LogOutput.log, дневник програма за учитавање.

Ако је Steam библиотека на другом диску, отвори фасциклу Valheim из Steam-а: кликни Valheim десним тастером, затим Manage, па Browse local files. У том прозору Finder-а притисни ⌘↑ да одеш један ниво више, затим превуци фасциклу Valheim на икону Terminal-а у Dock-у. Отвара се прозор Terminal-а у тој фасцикли; настави тамо редом unzip, без реда cd.

Без Terminal-а: отвори zip, чиме добијаш фасциклу истог назива, и премести њен садржај у фасциклу Valheim поред valheim.app. Затим сам упиши опцију покретања: пуну путању до run_bepinex.sh у двоструким наводницима, па %command%. У подразумеваној Steam библиотеци путања почиње са /Users/ и твојим корисничким именом; ~ тамо не ради.

Након инсталације фасцикла Valheim садржи:

Како додати мод?

1. Преузми мод. На Thunderstore-у притисни Download на страници мода.
2. Отвори zip. Thunderstore архив садржи manifest.json, README.md, icon.png и датотеке самог мода.
3. У BepInEx/plugins направи фасциклу за мод, на пример BepInEx/plugins/ValheimModding-Jotunn, и премести садржај архива у њу. Ако zip има фасциклу plugins, премести садржај те фасцикле. Фасцикла config из архива иде у BepInEx/config.
4. Инсталирај оно што моду треба. Његова страница Thunderstore наводи модове од којих зависи; додај сваки на исти начин. Прескочи BepInEx Pack Valheim: пакет изнад заузима његово место.
5. Покрени Valheim. BepInEx/LogOutput.log наводи сваки учитани мод, по један ред Loading [...] за сваки.

Ови модови су се изворно учитали на Mac-у са Apple Silicon уз овај пакет: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once и Live Seed Map.

Када се Valheim покрене са модом, његова подешавања налазе се у BepInEx/config, у датотеци .cfg названој по моду.

Како играти без модова?

Обриши опцију покретања у Steam-у и Valheim се покреће без BepInEx-а; датотеке остају где јесу за следећи пут. Да уклониш један мод, избриши његову фасциклу из BepInEx/plugins.

Пример: инсталација мода Live Seed Map

Live Seed Map приказује покренуту игру на мапи сида: где стојиш, створења око тебе, твоје ознаке и портале, а може да означи било које место са мапе у игри.

1. Преузми LiveSeedMap-1.4.0.zip.
2. Распакуј га у фасциклу Valheim. Овај zip већ има распоред за BepInEx, па мод завршава у BepInEx/plugins/LiveSeedMap:

cd "$HOME/Library/Application Support/Steam/steamapps/common/Valheim"
unzip -o ~/Downloads/LiveSeedMap-1.4.0.zip

3. Покрени Valheim из Steam-а. BepInEx/LogOutput.log сада има редове Loading [Live Seed Map 1.4.0] и Listening on http://127.0.0.1:45892.
4. Учитај свој свет или се придружи серверу.
5. Отвори мапу сида у Chrome-у или Edge-у и притисни Повежи игру. Када прегледач пита сме ли страница да приступи апликацијама на овом уређају, дозволи то.
6. Ако мапа показује други сид, притисни Отвори њену мапу.

Све што мод показује и ради, као и његова подешавања, описује водич за Live Seed Map.

Шта ако се модови не учитају?

• Нема поруке о измењеној верзији у главном менију ни LogOutput.log: провери опцију покретања. То је пуна путања до run_bepinex.sh у двоструким наводницима, затим %command%.
• Датотека са називом preloader_ и датумом, која се завршава са .log, поред run_bepinex.sh или у valheim.app/Contents/MacOS: BepInEx је стао пре учитавања модова. То на Apple Silicon раде званично издање 5.4.23.5 и датотеке BepInEx-а из BepInEx Pack Valheim. Поново распакуј пакет изнад преко њих и избриши дневник унутар valheim.app: апликација је потписана, а датотека додата у њој нарушава потпис.
• Could not load [...] because it has missing dependencies у LogOutput.log: инсталирај модове наведене у том реду.
• Мод се погрешно понаша у игри: његове поруке су у BepInEx/LogOutput.log, а поруке игре у ~/Library/Logs/IronGate/Valheim/Player.log.

Ако играш са другима, сервер и остали играчи треба да имају исте верзије сваког мода који мења свет, без обзира на рачунар на ком играју.