Um guia sobre como baixar e instalar mods em BONEWORKS no PC.
BONEWORKS é uma sandbox de física exclusiva para VR construída em Unity, e seus mods são carregados pelo MelonLoader em vez do BepInEx. Essa é a principal diferença em relação à maioria dos jogos Unity que as pessoas modificam. Tudo fica no Thunderstore.
Nosso exemplo prático é o Custom Maps, um carregador de mapas que permite adicionar níveis feitos pela comunidade ao jogo. Ele precisa de outros dois mods para funcionar, o que o torna uma boa demonstração de como a stack se encaixa.
Requisitos
- Um PC rodando Windows 10 ou superior. Linux via Proton funciona com uma variável de ambiente extra, abordada mais abaixo.
- BONEWORKS na Steam, além de um headset de VR e seu runtime. Não há modo flatscreen.
- Microsoft Visual C++ 2015-2019 Redistributable, 64 bit. O MelonLoader precisa dele.
- .NET Desktop Runtime 6.0, x64. BONEWORKS é um jogo Il2Cpp e o MelonLoader exige isso para esses casos.
- Algumas centenas de MB livres, mais se você for colecionar mapas customizados.
BONEWORKS é single player e não tem anti-cheat. Nada aqui coloca sua conta em risco.
MelonLoader, Não BepInEx
Se você já modificou Lethal Company, Valheim ou a maioria dos outros jogos Unity, já usou o BepInEx. BONEWORKS não usa isso.
O MelonLoader é um carregador de mods universal diferente para Unity, feito pela LavaGang, com suporte de primeira classe para jogos Il2Cpp como este. Ele funciona no mesmo princípio: hooka o jogo na inicialização e carrega os mods, mas a estrutura de pastas e o instalador são próprios.
Mods do MelonLoader são arquivos .dll que vão em uma pasta Mods no diretório do jogo, não em BepInEx/plugins.
ModThatIsNotMod
Quase todo mod de BONEWORKS que você realmente vai querer depende do ModThatIsNotMod, feito por gnonme. É a biblioteca compartilhada deste jogo: ela cuida do carregamento de itens customizados, dá aos autores de mods auxiliares para os sistemas do jogo, e é a base sobre a qual o resto do ecossistema é construído.
Custom Maps precisa dele, junto com FieldInjection. Então a stack completa para nosso exemplo é:
MelonLoader -> ModThatIsNotMod + FieldInjection -> Custom Maps
Um gerenciador de mods resolve tudo isso para você.
Uma Palavra Sobre Mods do BONELAB
BONEWORKS e BONELAB são jogos separados com comunidades separadas no Thunderstore, e alguns pacotes são listados em ambos. Essa listagem cruzada nem sempre é significativa.
Hitmarkers é o que as pessoas mais encontram. Ele aparece nas listagens de BONEWORKS, mas toda versão publicada dele depende de BoneLib, que é uma biblioteca do BONELAB sem equivalente em BONEWORKS, e a própria descrição diz que foi refeito para BONELAB. Instalá-lo aqui não fará o que você quer.
A regra prática: se um mod de BONEWORKS lista ModThatIsNotMod como dependência, é genuinamente um mod de BONEWORKS. Se lista BoneLib, é um mod de BONELAB que por acaso está listado em ambos.
Instalando Com Gale
O Gale é o caminho mais fácil e cuida do MelonLoader para você.
- Baixe o Gale pelo Thunderstore ou pelo GitHub.
- Abra-o e selecione BONEWORKS.
- Deixe-o encontrar sua instalação da Steam, ou aponte para a pasta do jogo você mesmo.
- Abra Browse mods, procure por Custom Maps e clique em Install.
- MelonLoader, ModThatIsNotMod e FieldInjection são instalados junto com ele.
- Clique em Launch game (modded).
Iniciar o BONEWORKS pela Steam o inicia sem mods. Inicie pelo Gale.
Instalando Com r2modman
O r2modman funciona da mesma forma.
- Instale o r2modman e selecione BONEWORKS.
- Crie um perfil.
- Abra Online, procure por Custom Maps e use Download with dependencies.
- Clique em Start modded.
Qualquer um dos dois funciona bem. O Gale é mais leve; o r2modman tem suporte mais amplo a plataformas.
Instalando o MelonLoader Você Mesmo
Vale a pena saber se você preferir não usar um gerenciador, ou se um gerenciador estiver dando problema.
Primeiro encontre a pasta do jogo. Clique com o botão direito em BONEWORKS na Steam, depois Manage e Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\BONEWORKS
Você está procurando o BONEWORKS.exe.
O Instalador Automatizado
Este é o jeito recomendado e é genuinamente fácil.
- Baixe o MelonLoader Installer.
- Execute-o. Ele procura por jogos Unity instalados e deve listar BONEWORKS sozinho. Se não listar, use Add Game Manually e aponte para
BONEWORKS.exe. - Clique em BONEWORKS na lista, escolha uma versão e clique em Install.
AVISO - Não mexa na opção de nightly builds. As nightlies são geradas a partir dos commits mais recentes e quebram coisas regularmente. A versão estável é aquela para a qual os mods são construídos.
O Método Manual
- Baixe MelonLoader.x64.zip. BONEWORKS é 64 bits.
- Extraia a pasta
MelonLoaderdo zip para dentro da pasta do BONEWORKS. - Extraia
version.dlldo mesmo zip também para dentro da pasta do BONEWORKS. - Inicie o jogo uma vez para que o MelonLoader gere suas pastas, depois feche.
Agora você deve ter uma pasta MelonLoader, um version.dll e uma pasta Mods ao lado de BONEWORKS.exe.
Instalando Mods Manualmente
Com o MelonLoader instalado, os mods são simples.
- Abra a página do mod no Thunderstore e clique em Manual Download.
- Extraia o zip.
- Copie o
.dllpara a pastaModsno seu diretório do BONEWORKS.
Para o Custom Maps isso significa três downloads separados, já que você também precisa do ModThatIsNotMod e do FieldInjection. Baixe cada um na versão indicada na seção Dependencies do mod, e copie cada .dll para Mods.
Alguns mods trazem conteúdo extra além do .dll, como arquivos de mapas ou modelos. Leia a descrição do mod para saber onde eles devem ir. O Custom Maps, por exemplo, lê os arquivos de mapa da sua própria pasta em vez de Mods.
OBSERVAÇÃO - Os arquivos manifest.json, icon.png e README.md de um zip do Thunderstore são arquivos de empacotamento para o site. Eles não fazem nada dentro da pasta Mods.
Instalando Com o TMC App
Completando a lista está nossa própria ferramenta. O TMC App é um gerenciador de mods e navegador de servidores que desenvolvemos, com instalação em um clique e sandboxes: perfis de mods 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.
BONEWORKS ainda não está na lista de jogos suportados. Adicionar um jogo é questão de quatro arquivos JSON e nenhum código, então é uma tarefa pequena, e jogos com MelonLoader são exatamente o tipo de coisa que o sistema de plugins foi feito para cobrir.
A parte honesta: o app está em estágio bem inicial de desenvolvimento. Dizemos isso no README dele e estamos dizendo aqui também. Boa parte dele foi apenas parcialmente testada, então trate-o como algo para experimentar ao lado do Gale, não como substituto. Se você testar, por favor nos conte o que aconteceu, porque isso é a coisa mais útil que qualquer pessoa pode fazer pelo projeto agora.
É código aberto sob a licença GPL-3.0 em github.com/modcommunity/tmc-app. Bugs e pedidos de funcionalidades vão no rastreador de issues, pull requests são bem-vindos, e o repositório documenta o formato por jogo caso você queira adicionar suporte ao BONEWORKS você mesmo.
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. Também há 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.
Verificando Se Funcionou
O MelonLoader abre uma janela de console ao lado do jogo na inicialização. Durante a inicialização, ele imprime sua própria versão e depois uma linha por mod conforme os carrega, com nome do mod, versão e autor.
Os logs também são gravados em disco:
BONEWORKS\MelonLoader\Latest.log
Esse arquivo é a primeira coisa a se verificar quando algo não funciona, e a primeira coisa que qualquer pessoa te ajudando vai pedir.
Especificamente para o Custom Maps, o mod adiciona sua própria forma de escolher um nível dentro do jogo depois que você tiver arquivos de mapa instalados.
Rodando No Linux
O BONEWORKS roda através do Proton. O MelonLoader precisa de um override de DLL para ser carregado, então defina as opções de inicialização do Steam do jogo como:
WINEDLLOVERRIDES="version=n,b" %command%
Observe que é version, não winhttp. O MelonLoader usa uma DLL de hook diferente da do BepInEx, e copiar a opção de inicialização do BepInEx é um erro comum.
O instalador do MelonLoader também tem uma versão para Linux caso você prefira não fazer manualmente. Tanto o Gale quanto o r2modman configuram o override automaticamente quando você inicia através deles.
Removendo Mods
Exclua o .dll da pasta Mods, ou desinstale através do seu gerenciador de mods.
Para remover o MelonLoader completamente, exclua a pasta MelonLoader, o version.dll, a pasta Mods e a pasta UserData do diretório do jogo. O MelonLoader Installer também tem uma opção de desinstalação que faz isso por você.
O Verificar integridade dos arquivos do jogo do Steam não vai limpar nada disso, porque o Steam não tem registro de arquivos que ele não instalou.
Solução de Problemas
Nenhuma janela de console e nenhum mod. O MelonLoader não está carregando. Verifique se o version.dll está diretamente ao lado do BONEWORKS.exe, e se você iniciou pelo seu gerenciador de mods em vez do Steam.
O MelonLoader carrega, mas um mod não. Abra o MelonLoader\Latest.log. Dependências faltando e incompatibilidades de versão aparecem claramente ali.
O MelonLoader trava ao iniciar. Geralmente é um pré-requisito faltando. Instale o redistribuível VC++ 2015-2019 x64 e o .NET Desktop Runtime 6.0 x64, que jogos Il2Cpp precisam.
Um mod foi instalado sem problemas, mas não faz nada. Verifique se ele é de fato um mod do BONEWORKS. Se a lista de dependências dele menciona o BoneLib, é um mod do BONELAB que acabou listado em ambos.
Tudo quebrou depois de uma atualização do jogo. O BONEWORKS não é atualizado com frequência hoje em dia, mas quando é, o MelonLoader e os mods precisam se atualizar também. Esvazie a pasta Mods para confirmar que o jogo em si está funcionando, e depois espere.
Erros de runtime VR depois de instalar mods. Tente iniciar sem mods primeiro para confirmar que o lado do headset está funcionando. Problemas de mods e problemas do SteamVR parecem parecidos de dentro do headset.
Conclusão
Modar o BONEWORKS é simples uma vez que você sabe que é MelonLoader, não BepInEx, e que o ModThatIsNotMod é a biblioteca sobre a qual tudo o resto se apoia. Instale o Gale, instale o mod que quiser, e inicie pelo Gale.
A única armadilha específica do BONEWORKS são os pacotes do BONELAB listados em ambos. Verifique a lista de dependências antes de instalar: ModThatIsNotMod significa BONEWORKS, BoneLib significa BONELAB.
Se você quiser ajudar com algo, o TMC App é código aberto e está em estágio inicial de desenvolvimento, e feedback sobre ele vale muito para nós.
Veja Também
- BONEWORKS no Thunderstore
- Wiki do MelonLoader - A documentação oficial do loader, vale a leitura.
- MelonLoader no GitHub
- Discord de Mods do BONEWORKS
- Wiki do BONEWORKS
- TMC App
Mantemos este guia o mais atualizado possível, mas o MelonLoader e os mods construídos sobre ele mudam com o tempo. 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!