Um guia sobre como baixar e instalar mods em PEAK no PC.
PEAK foi feito em Unity, o que significa que o BepInEx cuida do carregamento e o Thunderstore hospeda praticamente toda a cena de mods. Já existem bem mais de dois mil pacotes de PEAK por lá, e o ritmo não desacelerou desde o lançamento.
Instalamos dois mods neste guia em vez de apenas um, porque é ao instalar o segundo mod que as pessoas realmente travam:
- PEAK Unlimited - aumenta o limite de quatro jogadores.
- Piggyback - permite carregar companheiros de equipe que não desmaiaram.
Requisitos
- Um PC com Windows 10 ou superior. Linux via Proton funciona com uma configuração extra, abordada mais abaixo.
- PEAK na Steam.
- Algumas centenas de MB de espaço livre para uma lista de mods normal.
- Uma ferramenta de arquivo como o 7-Zip para instalações manuais.
PEAK não possui anti-cheat, e modificá-lo não apresenta risco de banimento.
Uma Nota Sobre Plataformas
PEAK é um lançamento exclusivo para Windows, exclusivo para Steam. Não há versão para PlayStation, Xbox ou Switch, e nada neste guia se aplica a algo além da build de PC.
Jogadores de Linux podem rodar PEAK através do Proton e os mods funcionam, com uma etapa extra descrita na seção de Solução de Problemas.
As Duas Partes
Toda instalação de mods no PEAK segue as mesmas duas partes, uma sobre a outra.
- BepInExPack for PEAK vai na pasta do jogo. Ele conecta-se ao jogo na inicialização e é o que efetivamente carrega os mods.
- Os mods vão em
BepInEx/plugins, e o BepInEx os detecta quando o jogo é iniciado.
Observe que PEAK usa seu próprio pacote BepInEx, BepInExPack_PEAK, em vez do genérico que você talvez tenha instalado para algum outro jogo. Use o pacote do PEAK.
Além disso, alguns mods dependem de bibliotecas compartilhadas. PEAKLib aparece como dependência em muitos dos mods de conteúdo maiores. Nenhum dos nossos dois exemplos precisa dele, mas você vai encontrá-lo em breve, e é por isso que um gerenciador de mods economiza seu tempo.
Instalando Com o Gale
Gale é pequeno, rápido e não precisa de uma conta Overwolf, o que o torna uma opção padrão fácil para o PEAK.
- Baixe o Gale no Thunderstore ou no GitHub e instale-o.
- Abra o Gale e escolha PEAK.
- Deixe que ele detecte sua instalação da Steam, ou aponte manualmente para a pasta do jogo.
- Abra Browse mods e procure por PEAK Unlimited.
- Clique em Install. O BepInExPack_PEAK é instalado junto como dependência.
- Clique em Launch game (modded).
Adicionando Um Segundo Mod
Esta é a parte que vale mostrar, porque é onde o modelo mental faz sentido.
- Volte para Browse mods.
- Procure por Piggyback e clique em Install.
- Olhe em Installed mods. Agora você deve ter três entradas: BepInExPack_PEAK, PEAK Unlimited e Piggyback.
- Inicie o modo modded novamente.
Você não reinstala o BepInEx, não inicia um novo perfil, e não precisa se preocupar com ordem de carregamento. O BepInEx carrega tudo que está em plugins e os mods se organizam sozinhos. Adicionar o mod número vinte funciona exatamente da mesma forma que adicionar o mod número dois.
DICA - Existem vários mods no Thunderstore chamados Piggyback. O usado neste guia é do Roose, que é o que tem cerca de um milhão de downloads.
Instalando Com o r2modman Ou Thunderstore Mod Manager
Se preferir usar o r2modman ou o Thunderstore Mod Manager, o fluxo é o mesmo, apenas com rótulos diferentes:
- Instale o gerenciador e selecione PEAK.
- Crie um perfil, ou use o Default.
- Abra Online ou Get mods, procure por cada mod, e use Download with dependencies.
- Clique em Start modded.
r2modman é a opção a se recorrer no Linux ou macOS, embora PEAK em si não tenha versão para macOS.
Instalando Manualmente
Primeiro, encontre a pasta do jogo. Clique com o botão direito em PEAK na Steam, depois em Manage e Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\PEAK
Primeiro O BepInEx
- Abra BepInExPack_PEAK e clique em Manual Download.
- Extraia o zip em algum lugar que não seja a pasta do jogo.
- Abra a pasta extraída e, dentro dela, abra
BepInExPack_PEAK. - Copie o conteúdo dessa pasta para dentro da pasta do PEAK.
BepInEx,doorstop_config.iniewinhttp.dlldevem acabar ao lado dePEAK.exe. - Execute o jogo uma vez e saia, para que o BepInEx crie
BepInEx/plugins.
AVISO - Copie o conteúdo, não a pasta que o contém. Um caminho como PEAK\BepInExPack_PEAK\BepInEx\ não carregará nada.
Depois Os Mods
- Baixe PEAK Unlimited e Piggyback usando Manual Download.
- Extraia cada um.
- Copie o
.dllde cada um paraPEAK\BepInEx\plugins.
Ambos podem ficar soltos juntos em plugins. Mods que vêm com uma pasta de assets devem ter a pasta inteira copiada, o que o BepInEx lida bem.
Instalando Com o TMC App
Por último na lista está o nosso próprio: o TMC App, um gerenciador de mods e navegador de servidores que estamos desenvolvendo. Suas sandboxes funcionam como os perfis mencionados acima, listas de mods nomeadas por jogo com sua própria ordem de carregamento e método de implantação, e alternar entre elas não custa nada porque nada é baixado novamente.
O PEAK ainda não está na lista de jogos suportados. Adicionar um jogo significa escrever quatro arquivos JSON, e não código, então não é um trabalho grande e gostaríamos de chegar a isso.
Um aviso justo antes de você ir procurar: o app está em desenvolvimento bem inicial. Dizemos isso no README e diremos aqui também. Boa parte dele foi testada apenas parcialmente, então use-o ao lado do Gale, e não em substituição a ele, por enquanto. Se você testá-lo e algo der errado, nos avisar é realmente a coisa mais útil que você poderia fazer nesta fase.
O app é código aberto sob a licença GPL-3.0 em github.com/modcommunity/tmc-app. Bugs e solicitações de recursos devem ser reportados em o issue tracker, pull requests são bem-vindos, e o repositório documenta o formato por jogo caso você queira adicionar suporte ao PEAK você mesmo.
Instalando-o:
- Linux: uma linha, sem root e sem gerenciador de pacotes.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: o
setup.exeousetup.msida página de releases. Também há uma build portátil, embora ela não registre a entrada do launcher nem o manipulador de linkstmc://. - macOS: o
.dmgda mesma página de releases.
Lobbies E Listas De Mods Compatíveis
PEAK é co-op para quatro jogadores, e os mods de gameplay normalmente precisam estar presentes em todas as máquinas do lobby, não apenas na do host.
PEAK Unlimited é o caso óbvio. Ele aumenta o limite de jogadores, então um jogador sem ele não conseguirá entrar em um lobby rodando acima de quatro. Piggyback muda o comportamento de uma interação compartilhada, então também precisa coincidir.
Exporte um perfil e compartilhe-o em vez de comparar listas manualmente:
- Gale: Profile, depois Export, o que gera um código ou um arquivo.
- r2modman / Thunderstore Mod Manager: o menu de perfil, depois Export as code ou Export as file.
Quem importa acaba com os mesmos mods nas mesmas versões, que é o que realmente importa.
NOTA - Mods cosméticos e ajustes pessoais de qualidade de vida costumam ser client-side e seguros de usar sozinho. A página do mod no Thunderstore normalmente indica isso. Quando não indicar, assuma que precisa combinar com os demais.
Configurando Mods
A maioria dos mods do PEAK escreve um arquivo de configuração na primeira vez que são executados. Você os encontrará aqui:
PEAK\BepInEx\config
Cada um é um .cfg de texto simples que pode ser editado no Notepad. A configuração do PEAK Unlimited é onde você define o limite real de jogadores, então é provavelmente um dos que você vai querer abrir.
Se preferir não editar arquivos de texto manualmente, tanto o Gale quanto o r2modman têm um editor de configurações embutido que lê e grava os mesmos arquivos .cfg de dentro do gerenciador.
Atualizando, Desativando E Desinstalando
Os gerenciadores marcam mods desatualizados na lista de instalados e os atualizam com um clique. Desativar um mod mantém seus arquivos intactos para que você possa reativá-lo depois; desinstalar os apaga.
Manualmente, remova o .dll de BepInEx/plugins. Para voltar totalmente ao vanilla, apague BepInEx, doorstop_config.ini e winhttp.dll da pasta do jogo. Verificar a integridade dos arquivos no Steam não os remove, pois o Steam não tem registro de arquivos que não colocou lá.
DICA - O PEAK recebe atualizações com uma certa frequência, e um patch do jogo vai quebrar os mods até que os autores os reconstruam. Se tudo parar de funcionar logo após uma atualização, é quase certo que foi isso que aconteceu.
Solução De Problemas
Os mods não fazem nada e não há console do BepInEx. O BepInEx está no lugar errado ou você iniciou o PEAK pela Steam. Inicie pelo seu gerenciador de mods.
Um mod carrega, outro não. Leia o console do BepInEx. Uma dependência ausente ou um mod feito para uma versão mais antiga do PEAK são as duas causas mais comuns.
Não consigo entrar na lobby de um amigo. As listas de mods não coincidem. Importe o perfil exportado por ele.
Crash ao iniciar. Retire tudo de BepInEx/plugins, confirme que o jogo inicia limpo, depois adicione os mods de volta aos poucos até encontrar o culpado.
Engasgos com mais de quatro jogadores. O PEAK Unlimited leva o jogo além do que foi ajustado para suportar. O CrossplayStutterFix é um mod complementar comumente usado justamente para isso.
Linux e Proton. O BepInEx precisa de uma substituição de DLL. Defina as opções de inicialização do PEAK no Steam como WINEDLLOVERRIDES="winhttp=n,b" %command%. O Gale e o r2modman fazem isso automaticamente quando você inicia por eles.
Conclusão
Modar o PEAK é praticamente indolor. Instale o Gale, instale os mods que quiser e inicie pelo Gale em vez da Steam. O BepInEx é cuidado para você, e adicionar mais mods depois não exige nenhum esforço extra.
A única real pegadinha é a do co-op: todos na lobby precisam ter os mesmos mods de gameplay, e exportar um perfil é muito mais rápido do que descobrir isso do jeito difícil às onze da noite.
E se você tiver alguns minutos livres, o TMC App é código aberto, está em estágio bem inicial de desenvolvimento, e qualquer feedback sobre ele é bem-vindo.
Veja Também
- PEAK no Thunderstore
- PEAK Modding Wiki - Voltado para criadores de mods, e uma boa leitura se você quiser fazer um.
- PEAK Modding Discord
- Documentação do BepInEx
- TMC App
Mantemos este guia atualizado na medida do possível, mas tanto o PEAK quanto seu mod loader mudam com o tempo. Se você encontrar alguma instrução que já não corresponda à realidade, por favor reporte ou abra um pull request no repositório do GitHub deste guia.
Junte-se ao nosso servidor do Discord se tiver alguma dúvida ou quiser ajuda com qualquer coisa relacionada a modding!