Um guia sobre como baixar e instalar mods em Risk of Rain 2 no PC, cobrindo o r2modman, o método manual, e a pilha de dependências que atrapalha a maioria das pessoas.
Risk of Rain 2 tem uma das cenas de modding mais antigas e melhor organizadas do Thunderstore. Também tem uma das pilhas de dependências mais profundas, e entender essa pilha é realmente a diferença entre uma instalação funcional e uma hora de confusão.
Nosso exemplo prático é o Starstorm 2, um grande mod de conteúdo que adiciona sobreviventes, itens e inimigos. É um bom exemplo justamente por não ser simples.
Requisitos
- Um PC rodando Windows 10 ou superior, ou Linux.
- Risk of Rain 2 na Steam ou na Epic Games Store.
- Algumas centenas de MB livres. Mods de conteúdo na escala do Starstorm 2 ocupam mais espaço.
- Uma ferramenta de arquivos como o 7-Zip se você instalar manualmente.
Não há anti-cheat em Risk of Rain 2 e nenhum risco de banimento por usar mods. Alguns mods desativam as conquistas da Steam em certas configurações, então tenha isso em mente se você ainda está atrás delas.
A Pilha De Mods
Os mods de Risk of Rain 2 se apoiam em duas camadas, e um mod vai se recusar a carregar se alguma delas estiver ausente ou desatualizada. Vale a pena entender isso mesmo se você usa um gerenciador de mods que cuida disso para você, porque explica praticamente toda mensagem de erro que você vai encontrar.
BepInEx
BepInExPack é o carregador de mods. Ele intercepta o jogo na inicialização e carrega os plugins de BepInEx/plugins.
O pacote de Risk of Rain 2 não é o BepInEx puro. Ele já vem com vários patches da comunidade incluídos, como RoR2BepInExPack, FixPluginTypesSerialization e BepInEx_GUI. Eles existem por causa de peculiaridades específicas deste jogo, e é por isso que você quer esse pacote em vez do BepInEx original.
R2API
R2API é uma API de modding que fica entre o BepInEx e os mods. Ela dá aos autores de mods uma forma estável e compartilhada de adicionar sobreviventes, itens, elites, buffs e assim por diante, sem que cada mod reinvente isso e colida com todos os outros mods.
O R2API foi dividido em submódulos faz um tempo, e é essa parte que confunde as pessoas. Em vez de um único R2API.dll grande, agora existem pacotes separados como R2API_Prefab, R2API_Networking e R2API_Difficulty. Um mod depende apenas dos submódulos que realmente usa. O Starstorm 2 puxa cerca de uma dúzia deles.
Você quase nunca instala esses manualmente. Deixe o gerenciador de mods fazer isso.
O Mod Em Si
Com essas duas camadas presentes, o mod é uma .dll em BepInEx/plugins como qualquer outro plugin do BepInEx.
NOTA - As versões importam mais aqui do que na maioria dos jogos. Um mod feito para o R2API 5.0.5 pode não carregar com um R2API mais antigo. Gerenciadores de mods instalam as versões que um mod declara, e essa é a principal razão pela qual instalações manuais dão errado mais frequentemente neste jogo do que em outros.
Instalando Com O r2modman
O r2modman é a ferramenta padrão para este jogo e foi originalmente criado para ele. O Thunderstore Mod Manager é construído sobre a mesma base de código e funciona de forma idêntica se você preferir; o Gale é uma alternativa mais leve que também dá suporte a este jogo.
Configurando Um Perfil
- Baixe o r2modman na sua página do Thunderstore ou no GitHub.
- Abra-o e escolha Risk of Rain 2.
- Escolha a loja onde você tem o jogo, Steam ou Epic. O r2modman encontra a pasta de instalação a partir daí.
- Você vai cair na tela de perfis. Crie um novo perfil em vez de usar o Default, e dê a ele um nome relacionado ao que você está fazendo, por exemplo
starstorm.
Os perfis são o recurso que vale a pena aprender a usar. Cada um mantém sua própria lista de mods, suas próprias configurações e seu próprio estado relacionado a saves, e alternar entre eles é instantâneo e não baixa nada novamente. Manter um perfil por partida ou por grupo de amigos é bem menos doloroso do que ativar e desativar mods manualmente.
Instalando O Starstorm 2
- Com seu perfil selecionado, clique em Online na barra lateral esquerda.
- Procure por Starstorm2 e abra o resultado da TeamMoonstorm.
- Clique em Download e depois em Download with dependencies quando solicitado.
- Deixe rodar. Ele vai baixar o BepInExPack, o MoonstormSharedUtils e os submódulos do R2API que o Starstorm 2 precisa, o que é uma lista longa.
- Mude para Installed e confirme que tudo aparece sem ícone de aviso.
Iniciando Com Mods
Clique em Start modded no topo da janela do r2modman.
Não inicie o jogo pela Steam ou pela Epic. Isso o inicia sem mods. O r2modman funciona injetando o BepInEx na inicialização através do perfil, então o lançamento precisa passar pelo r2modman para que qualquer coisa seja aplicada.
DICA - Se você quiser um atalho da Steam que inicie com mods, o r2modman pode gerar os argumentos de lançamento para você em Settings, depois Browse profile folder. A maioria das pessoas acha mais simples apenas deixar o r2modman aberto.
Instalando Manualmente
É viável, e vale a pena saber fazer, mas é genuinamente mais trabalhoso neste jogo do que na maioria por causa da situação dos submódulos do R2API.
Primeiro, encontre a pasta do jogo. Na Steam, clique com o botão direito em Risk of Rain 2, depois em Manage e Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\Risk of Rain 2
Então:
- Baixe o BepInExPack com Manual Download, extraia-o e copie o conteúdo da pasta
BepInExPackpara a pasta do jogo. Você deve terminar comBepInEx,doorstop_config.iniewinhttp.dllao lado deRisk of Rain 2.exe. - Inicie o jogo uma vez para que o BepInEx crie suas pastas, depois saia.
- Baixe o R2API e cada submódulo listado pelo mod, extraia-os e copie os arquivos
.dllparaBepInEx/plugins. - Baixe o Starstorm 2 e copie seu conteúdo também para
BepInEx/plugins.
O passo 3 é o pega. Para fazer isso corretamente, você precisa ler a lista Dependencies do mod no Thunderstore, buscar cada entrada na versão exata listada e repetir para tudo que essas entradas tiverem como dependências. Para o Starstorm 2, isso são mais de uma dúzia de downloads.
AVISO - Se você instalar manualmente, não misture versões. Pegar os submódulos R2API mais recentes quando o mod pede versões mais antigas é a causa mais comum de um mod falhar silenciosamente ao carregar.
Instalando Com O TMC App
Há mais um gerenciador que vale mencionar, que é o nosso próprio. O TMC App faz instalações de mods com um clique, sandboxes (perfis nomeados por jogo, cada um com sua própria ordem de carregamento e método de implantação, alternáveis sem precisar baixar nada de novo), um navegador de servidores com gráficos de latência em tempo real, e RCON.
Risk of Rain 2 ainda não está na lista de jogos suportados. Gostaríamos que estivesse, e adicionar um jogo é uma questão de quatro arquivos JSON, não de código.
Antes de sair procurando, porém: o app está em desenvolvimento muito inicial e ele mesmo diz isso. A maior parte foi apenas parcialmente testada. Para um jogo com um grafo de dependências tão profundo quanto este, o r2modman continua sendo a ferramenta de confiança, e o TMC App é algo para experimentar ao lado dele, não no lugar dele. Quem estiver dispostx a testá-lo e reportar de volta está nos fazendo um favor de verdade.
É código aberto sob a licença GPL-3.0 em github.com/modcommunity/tmc-app. Issues e pedidos de funcionalidades vão em the tracker, pull requests são bem-vindos, e o repositório explica o formato por jogo caso você queira adicionar suporte ao Risk of Rain 2 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. Há também uma versão portátil, embora ela não registre a entrada do launcher nem o manipulador de linkstmc://. - macOS: o
.dmgda mesma página de releases.
Multiplayer E Sincronização De Mods
O multiplayer de Risk of Rain 2 exige que todos os jogadores estejam usando mods compatíveis. Mods de conteúdo que adicionam itens ou survivors precisam ser iguais em todo o lobby, e uma incompatibilidade normalmente aparece como um chute ao entrar ou como itens desincronizados durante a run.
A solução prática é o compartilhamento de perfis. No r2modman, abra seu perfil, clique em Export e escolha Export as file ou Export as code. Seus amigos usam Import com o arquivo ou código e acabam com uma lista de mods idêntica byte a byte.
NOTA - Mods puramente visuais e alguns mods de qualidade de vida são client-side e não precisam ser iguais. A página do mod no Thunderstore normalmente informa isso. Quando não informa, assuma que precisa ser igual.
Consoles
Risk of Rain 2 também está disponível em PlayStation, Xbox e Nintendo Switch, e nenhuma dessas versões suporta mods. Tudo neste guia é exclusivo para PC. Não há solução alternativa, e qualquer coisa que afirme modificar as versões de console não é algo que você deveria baixar.
Gerenciando Seus Mods
O r2modman mostra um ícone de atualização ao lado de qualquer mod instalado que tenha uma versão mais nova no Thunderstore, e Update all cuida de tudo de uma vez. Como os submódulos do R2API são versionados independentemente, atualizar um mod às vezes traz submódulos mais novos junto, o que pode quebrar um segundo mod que queria os antigos. É exatamente para essa situação que os perfis existem: clone o perfil, atualize o clone e mantenha o funcional até ter certeza.
Desativar um mod é um toggle na lista Installed e deixa os arquivos no lugar. Desinstalar os remove.
Para voltar totalmente ao vanilla, delete BepInEx, doorstop_config.ini e winhttp.dll da pasta do jogo. Verificar os arquivos pelo Steam não os removerá, já que o Steam não rastreia arquivos que não instalou.
Solução De Problemas
Rodou modado, mas sem mods. Você iniciou pelo Steam ou Epic em vez de pelo r2modman.
Um mod está instalado mas nunca carrega. Verifique a console do BepInEx por uma linha que o mencione. Se a console menciona um tipo ou método faltando, é uma incompatibilidade de versão com o R2API. Reinstale o mod com as dependências pelo gerenciador.
O jogo trava na tela de splash. Geralmente é um mod feito para uma versão mais antiga do jogo. As atualizações de Risk of Rain 2 quebram mods regularmente, e a solução normalmente é esperar pelo autor.
Chutado ao entrar na sala de um amigo. As listas de mods não coincidem. Importe o perfil exportado por ele.
As conquistas pararam de desbloquear. Comportamento esperado com certos mods instalados. Use um perfil vanilla separado se quiser continuar ganhando conquistas.
Linux e Proton. Configure suas opções de inicialização do Steam para WINEDLLOVERRIDES="winhttp=n,b" %command% para que o BepInEx seja carregado. O r2modman faz isso automaticamente quando você inicia por ele.
Conclusão
Modar Risk of Rain 2 parece intimidante de fora por causa dos submódulos do R2API, mas na prática um gerenciador de mods transforma tudo em uma operação de dois cliques. Instale o r2modman, crie um perfil, faça o download com dependências e inicie modado.
As duas coisas que realmente vale lembrar: inicie pelo gerenciador em vez do Steam, e exporte seu perfil para quem quer que você jogue com.
Se você tiver tempo, o TMC App é de código aberto, está em desenvolvimento inicial, e feedback sobre ele seria genuinamente apreciado.
Veja Também
- Risk of Rain 2 no Thunderstore
- Discord de Modding de Risk of Rain 2
- R2Wiki - A wiki de modding da comunidade, e a melhor referência para autores de mods.
- R2API no GitHub
- TMC App
Tentamos manter este guia atualizado, mas o jogo, o BepInEx e o R2API são todos atualizados em seus próprios cronogramas. Se algo aqui não corresponder mais ao que você está vendo, avise-nos ou abra um pull request no repositório GitHub deste guia.
Junte-se ao nosso servidor do Discord se tiver dúvidas ou quiser ajuda com qualquer coisa relacionada a modding!

