Como instalar mods de Valheim no Mac, nativamente em Apple Silicon sem Rosetta

Valheim funciona nativamente nos Macs com Apple Silicon, e os seus mods também podem. Os gestores usados pelos jogadores de Windows não funcionam no macOS. No Mac, instalas o carregador de mods uma vez à mão, defines uma opção de arranque de Valheim no Steam e colocas cada mod numa pasta. Depois, Valheim arranca pelo Steam como habitualmente, com todos os mods que adicionaste.

Que gestores de mods funcionam no Mac?

Nenhum dos habituais.

Os mods são os mesmos ficheiros em todos os sistemas, por isso um Mac usa as mesmas transferências dos jogadores de Windows. Thunderstore, onde é publicada a maioria dos mods de Valheim, tem um botão Download na página de cada mod que fornece o mesmo ZIP que um gestor instalaria. Nexus Mods e CurseForge também têm mods de Valheim, cujos ficheiros vão para as mesmas pastas.

Porque é que o BepInEx habitual não funciona em Apple Silicon?

Os mods de Valheim usam o carregador BepInEx. BepInEx Pack Valheim, a cópia instalada por cada gestor, inclui uma biblioteca Mac apenas para processadores Intel. A versão oficial BepInEx 5.4.23.5 carrega num Mac com chip M, mas para antes de carregar qualquer mod: o macOS não permite que altere o código do jogo na memória como no Windows. Executar Valheim com Rosetta contorna isso, mas reduz a velocidade.

BepInEx já corrigiu o problema no código-fonte e na biblioteca de carregamento usada para arrancar, mas nenhuma das correções está numa versão normal ainda. O pacote abaixo é BepInEx compilado a partir desse código, com a biblioteca corrigida e configurado para Valheim. Funciona em Apple Silicon sem Rosetta.

Como instalo BepInEx para Valheim no Mac?

1. Fecha Valheim.
2. Transfere BepInEx_macos_valheim_5.4.23.5-01fd4aa.zip. A soma SHA-256 está em SHA256SUMS.txt.
3. Abre o Terminal e extrai o pacote para a pasta de Valheim:

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

4. Na mesma janela do Terminal, apresenta a opção de arranque para o teu Mac e copia a linha produzida:

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

5. Na Biblioteca do Steam, clica com o botão direito em Valheim, escolhe Propriedades e cola a linha em Opções de arranque, na página Geral.
6. Inicia Valheim pelo Steam. O menu principal mostra «You are playing a modded version of Valheim.» no canto inferior direito, e a pasta de Valheim passa a conter BepInEx/LogOutput.log, o registo do carregador.

Se a tua biblioteca Steam estiver noutra unidade, abre a pasta de Valheim pelo Steam: clica com o botão direito em Valheim, depois em Gerir e Explorar ficheiros locais. Nessa janela do Finder, prime ⌘↑ para subir um nível e arrasta a pasta Valheim para o ícone do Terminal no Dock. Abre-se uma janela do Terminal nessa pasta; continua aí com a linha unzip, sem a linha cd.

Sem Terminal: abre o ZIP, que cria uma pasta com o mesmo nome, e move o seu conteúdo para a pasta de Valheim, ao lado de valheim.app. Escreve depois a opção de arranque: o caminho completo para run_bepinex.sh entre aspas duplas, seguido de %command%. Na biblioteca predefinida do Steam, o caminho começa por /Users/ e pelo teu nome de utilizador; ~ não funciona aí.

Após a instalação, a pasta de Valheim contém:

Como adiciono um mod?

1. Transfere o mod. No Thunderstore, prime Download na respetiva página.
2. Abre o ZIP. Um ZIP do Thunderstore contém manifest.json, README.md, icon.png e os ficheiros do mod.
3. Em BepInEx/plugins, cria uma pasta para o mod, por exemplo BepInEx/plugins/ValheimModding-Jotunn, e move para lá o conteúdo do ZIP. Se o ZIP tiver uma pasta plugins, move antes o conteúdo dessa pasta. Uma pasta config no ZIP vai para BepInEx/config.
4. Instala as dependências do mod. A página do Thunderstore enumera os mods necessários; adiciona cada um da mesma forma. Ignora BepInEx Pack Valheim: o pacote acima substitui-o.
5. Inicia Valheim. BepInEx/LogOutput.log enumera cada mod carregado, com uma linha Loading [...] para cada um.

Estes mods carregaram nativamente num Mac Apple Silicon com este pacote: Jotunn, VNEI, YamlDotNet, Zen.ModLib, ZenSign, PlantEasily, Valheim Configuration Manager, Runic Clock, Auto Stash, LiveExperienceTracker, Remember Server Password, Craft Me Once, Live Seed Map.

As definições de um mod ficam em BepInEx/config, num ficheiro .cfg com o nome do mod, depois de Valheim arrancar com ele.

Como jogo sem mods?

Apaga a opção de arranque no Steam e Valheim inicia sem BepInEx; os ficheiros ficam no mesmo sítio para a próxima vez. Para remover um mod, elimina a sua pasta de BepInEx/plugins.

Exemplo: instalar o mod Live Seed Map

Live Seed Map mostra a tua partida em curso no mapa de sementes: onde estás, as criaturas próximas, os teus marcadores e portais. Também pode assinalar no jogo qualquer lugar do mapa.

1. Transfere LiveSeedMap-1.4.0.zip.
2. Extrai-o para a pasta de Valheim. Este ZIP já está organizado para BepInEx, pelo que o mod fica em BepInEx/plugins/LiveSeedMap:

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

3. Inicia Valheim pelo Steam. BepInEx/LogOutput.log contém agora as linhas Loading [Live Seed Map 1.4.0] e Listening on http://127.0.0.1:45892.
4. Carrega o teu mundo ou entra no servidor.
5. Abre o mapa de sementes no Chrome ou Edge e prime Ligar o jogo. Quando o navegador perguntar se a página pode aceder às aplicações deste dispositivo, permite o acesso.
6. Se o mapa mostrar uma semente diferente, prime Abrir o mapa dela.

Tudo o que o mod mostra e faz, bem como as suas definições, está no guia de Live Seed Map.

E se os mods não carregarem?

• Não aparece o aviso de versão modificada no menu principal nem existe LogOutput.log: verifica a opção de arranque. Tem de ser o caminho completo para run_bepinex.sh entre aspas duplas, seguido de %command%.
• Um ficheiro chamado preloader_ seguido de uma data e terminado em .log, ao lado de run_bepinex.sh ou dentro de valheim.app/Contents/MacOS: BepInEx parou antes de carregar os mods. É o que acontece em Apple Silicon com a versão oficial 5.4.23.5 e os ficheiros BepInEx de BepInEx Pack Valheim. Extrai novamente o pacote acima por cima deles e elimina o registo dentro de valheim.app: a aplicação está assinada e acrescentar um ficheiro dentro dela invalida a assinatura.
• Could not load [...] because it has missing dependencies em LogOutput.log: instala os mods indicados nessa linha.
• Um mod funciona mal no jogo: as suas mensagens estão em BepInEx/LogOutput.log, e as do jogo em ~/Library/Logs/IronGate/Valheim/Player.log.

Se jogas com outras pessoas, o servidor e os outros jogadores precisam das mesmas versões de qualquer mod que altere o mundo, seja qual for o computador de cada um.