Um guia sobre como baixar e instalar mods em Hot Dogs, Horseshoes & Hand Grenades (H3VR) no PC.
H3VR é um sandbox shooter exclusivo para VR com uma das cenas de mods mais duradouras do VR, e praticamente tudo isso vive no Thunderstore. Os mods são plugins de BepInEx, e os mods de armas que todo mundo busca ficam em cima de uma pequena pilha de bibliotecas compartilhadas.
Nosso exemplo é o Meats ModulAR, um grande pacote modular de AR. Ele é propositalmente não um mod simples, porque os pacotes de armas do H3VR raramente são, e a cadeia de dependências é o que vale a pena entender.
Requisitos
- Um PC rodando Windows 10 ou superior. Linux via Proton funciona, com uma opção de inicialização extra abordada abaixo.
- H3VR na Steam.
- Um headset de VR e runtime funcionando. H3VR suporta headsets SteamVR, além de dispositivos Oculus e Windows Mixed Reality através dele.
- Vários GB de espaço livre. Os gun packs carregam muitos modelos, texturas e áudio, e uma lista séria de mods para H3VR cresce rapidamente.
- 7-Zip ou equivalente, se você for instalar manualmente.
H3VR é single player e não tem anti-cheat, então não há nada com que se preocupar nesse aspecto.
Apenas VR, Sem Modo Plano
Vale dizer isso claramente antes de tudo. H3VR é um exclusivo de VR sem modo flatscreen, e os mods não mudam isso. Se você não tem um headset, nada disso se aplica.
Também não há versões de console, então tudo abaixo é apenas para PC.
O Que É Instalado
BepInEx
BepInExPack H3VR é o loader. Ele vai para a pasta do jogo, se conecta ao jogo na inicialização e carrega plugins de BepInEx/plugins.
Use o pacote específico do H3VR em vez do BepInEx genérico. Ele está fixado na versão 5.4.1700 e pré-configurado para este jogo, e a comunidade constrói seus mods em cima dele.
OtherLoader e Companhia
É aqui que H3VR difere da maioria dos jogos com BepInEx. Um gun pack não é exatamente "código", é um pacote de itens, e fazer com que esses itens entrem no spawner do H3VR e nos seus sistemas de progressão exige uma infraestrutura compartilhada.
Meats ModulAR depende de alguns destes:
| Dependência | O que faz |
|---|---|
| OtherLoader | Carrega pacotes de itens personalizados no jogo e gerencia as entradas do spawner para eles. |
| H3VRUtilities | Uma biblioteca compartilhada de longa data sobre a qual grande parte da cena é construída. |
| OpenScripts | Scripts de comportamento genéricos que os autores de mods anexam a peças personalizadas. |
| FTW Arms AFCL | Uma biblioteca compartilhada de anexos e peças para mods de armas modulares. |
| Meats ModulARpt2 | A segunda metade do próprio mod, dividida por causa dos limites de tamanho de pacote do Thunderstore. |
Cada um desses precisa estar presente, em uma versão compatível, antes que o pacote de armas funcione. Esse é todo o argumento para usar um gerenciador de mods aqui em vez de baixar arquivos manualmente.
NOTA - Pacotes grandes serem divididos em pacotes de parte 1 e parte 2 é normal no Thunderstore do H3VR. Se você instalar apenas a primeira metade, espere armas faltando em vez de um erro claro.
Instalando Com o r2modman
r2modman é a recomendação habitual para H3VR e aquela que a maioria das páginas de mods pressupõe.
- Baixe o r2modman do Thunderstore ou dos GitHub releases.
- Abra o programa e escolha H3VR.
- Crie um perfil. Dado o tamanho que as listas de mods de H3VR alcançam, ter um perfil por tema de loadout é genuinamente útil, não apenas organizado.
- Clique em Online, procure por Meats ModulAR e abra o resultado de Meat_banono.
- Clique em Download e depois em Download with dependencies.
- Aguarde. Isso baixa várias centenas de MB e inclui OtherLoader, H3VRUtilities, OpenScripts, a biblioteca de peças da FTW e a ModulAR parte 2.
- Verifique a aba Installed. Tudo deve estar listado sem ícones de aviso.
- Clique em Start modded.
Iniciar o H3VR pela Steam, ao invés disso, o abre vanilla. Os mods são conectados pelo gerenciador no momento da inicialização, então a inicialização precisa vir do r2modman.
Instalando Com o Thunderstore Mod Manager
Thunderstore Mod Manager é construído sobre o r2modman e funciona da mesma forma, por trás de um wrapper Overwolf.
- Instale-o e escolha H3VR.
- Escolha um perfil.
- Clique em Get mods, encontre Meats ModulAR, e clique em Download.
- Aceite a lista de dependências.
- Clique em Start modded.
Qualquer um dos dois gerenciadores serve. r2modman é a melhor escolha no Linux, e o único com uma versão para macOS, embora o próprio H3VR não tenha lançamento para macOS.
Instalando Manualmente
Possível, e uma verdadeira chateação para um mod como este. Fazer isso uma vez para um mod pequeno é educativo; fazer isso para um gun pack completo não é um bom uso de uma noite.
Encontre a pasta do seu jogo clicando com o botão direito em H3VR na Steam, depois Manage e Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\H3VR
- Baixe o BepInExPack H3VR usando Manual Download e extraia-o.
- Copie o conteúdo da pasta
BepInExPack_H3VRpara a pasta do H3VR, de forma queBepInEx,doorstop_config.iniewinhttp.dllfiquem ao lado deh3vr.exe. - Inicie o jogo uma vez e feche-o, o que cria a pasta
BepInEx/plugins. - Baixe todas as dependências listadas na página do mod no Thunderstore, nas versões exatas indicadas, além de tudo que essas dependências exigirem por sua vez.
- Extraia cada uma e copie seu conteúdo para
BepInEx/plugins, mantendo cada mod em sua própria subpasta para conseguir diferenciá-los depois. - Faça o mesmo para Meats ModulAR e ModulAR part 2.
AVISO - Mantenha cada mod em sua própria pasta dentro de plugins. Os mods de H3VR trazem asset bundles com nomes genéricos, e juntar vários pacotes numa única pasta é uma forma garantida de fazer com que se sobrescrevam mutuamente.
DICA - O OtherLoader lê os item bundles das pastas de plugins que ele varre. Se um gun pack instala sem erros mas nenhuma arma nova aparece no spawner, uma estrutura de pastas bagunçada por causa de uma instalação manual é a primeira coisa a verificar.
Instalando Com o TMC App
Mais uma opção, e essa é nossa. O TMC App é um gerenciador de mods e navegador de servidores que construímos. Suas sandboxes são perfis de mods nomeados por jogo, cada um com sua própria ordem de carregamento e método de implantação, e alternar entre elas não baixa nada novamente. Para um jogo em que as pessoas mantêm listas separadas para diferentes loadouts e onde cada lista leva uma eternidade para carregar, isso é um recurso com apelo óbvio.
H3VR ainda não está na lista de jogos suportados. Adicionar um jogo significa quatro arquivos JSON em vez de código, então não é um grande trabalho.
Antes de criar expectativas: o app está em desenvolvimento bem inicial. O README dele diz isso, e nós também dizemos. Grande parte dele foi apenas parcialmente testada, e para uma pilha de mods tão dependente quanto a de H3VR, o r2modman ainda é a ferramenta em que confiar. Experimente o app ao lado dele, sem dúvida, e se fizer isso, nos conte como foi. O feedback inicial vale mais para nós do que quase qualquer outra coisa neste momento.
É código aberto sob GPL-3.0 em github.com/modcommunity/tmc-app. O issue tracker recebe bugs e pedidos de recursos, pull requests são bem-vindos, e o repositório documenta como um jogo é adicionado, caso você queira contribuir com suporte a H3VR.
Instalando:
- 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 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.
Encontrando Armas Modadas No Jogo
Mods de armas instalados não substituem nada. Eles aparecem junto ao arsenal vanilla.
Carregue qualquer cena sandbox e abra o Item Spawner. As armas modificadas aparecem nas mesmas listas de categoria das originais, geralmente com as próprias tags do mod ou numa página separada, dependendo de como o autor configurou. Meats ModulAR adiciona receivers modulares de AR além de um grande conjunto de peças, então espere entradas tanto na categoria de armas quanto na de acessórios.
Se o jogo inicia com os mods carregados mas o spawner parece vanilla, isso é um problema do OtherLoader e não do BepInEx, e o console do BepInEx geralmente indicará isso.
Gerenciando Mods Ao Longo do Tempo
O r2modman mostra um selo de atualização ao lado de qualquer item com uma release mais recente no Thunderstore, e Update all cuida da lista. Como os gun packs de H3VR dependem de bibliotecas compartilhadas, atualizar um mod pode trazer uma biblioteca mais nova para a qual um pack mais antigo não foi construído. Clonar um perfil antes de uma grande rodada de atualizações é o seguro barato aqui.
Desativar um mod na lista de instalados deixa seus arquivos intactos. Desinstalar os remove.
Para voltar ao vanilla completamente, apague BepInEx, doorstop_config.ini e winhttp.dll da pasta do jogo. A verificação de arquivos da Steam não vai removê-los, porque a Steam não os instalou.
Solução de Problemas
O jogo inicia sem mods. Você o iniciou pela Steam. Use Start modded.
Sem console do BepInEx. O BepInEx não está carregando. Verifique se winhttp.dll está diretamente ao lado de h3vr.exe.
Os mods carregam mas não há armas novas no spawner. O OtherLoader está ausente, desatualizado, ou os item bundles estão no lugar errado. Reinstale o mod com as dependências pelo seu manager.
Tempos de carregamento longos e travamentos. Normal a partir de certa quantidade de mods. O H3VR carrega todo item bundle na inicialização, e listas grandes realmente demoram. Dividir os mods em vários profiles em vez de rodar tudo de uma vez ajuda bastante.
Texturas faltando ou modelos rosa. Geralmente um pacote instalado pela metade, na maioria das vezes um part 2 que foi ignorado.
Crash ao iniciar após uma atualização do jogo. O H3VR se atualiza em blocos bem grandes e os mods quebram junto. Mova BepInEx/plugins para fora para confirmar, depois espere pelos autores.
Linux e Proton. Configure as opções de inicialização da Steam do H3VR para WINEDLLOVERRIDES="winhttp=n,b" %command%. O r2modman cuida disso sozinho quando você o inicia por ele.
Conclusão
As instalações de mods para H3VR são diretas, desde que você deixe um gerenciador de mods resolver a cadeia de dependências. Instale o r2modman, escolha H3VR, baixe com dependências e inicie no modo modded.
As duas coisas específicas de H3VR para levar com você: gun packs precisam do OtherLoader e seus companheiros para sequer aparecerem no spawner, e pacotes grandes são divididos em múltiplos pacotes do Thunderstore que precisam ser todos instalados.
Se você tiver tempo sobrando, o TMC App é de código aberto, está em desenvolvimento inicial, e o feedback sobre ele seria genuinamente apreciado.
Veja Também
- H3VR on Thunderstore
- H3VR Modding Wiki - A wiki de modding atual da comunidade.
- H3VR Modding Discord
- Official H3VR Wiki - A wiki do jogo em si, não uma de modding, mas útil para descobrir o que é vanilla.
- TMC App
Mantemos este guia atualizado da melhor forma possível, mas o H3VR, o BepInEx e as bibliotecas compartilhadas evoluem de forma independente. Se alguma instrução aqui não corresponder mais ao que você está vendo, por favor reporte ou abra um pull request no repositório GitHub deste guia.
Junte-se ao nosso servidor do Discord se tiver alguma dúvida ou quiser ajuda com qualquer coisa relacionada a modding!