Como Instalar Mods no BONELAB (2026)

Um guia sobre como baixar e instalar mods em BONELAB no PC e no Meta Quest.

BONELAB é incomum entre os jogos para os quais escrevemos esses guias, porque possui dois sistemas de modding completamente separados que cumprem funções diferentes:

• mod.io já vem integrado ao jogo. Funciona no PC e em um Quest standalone, não precisa de ferramentas externas, e abrange avatares, mapas e itens spawnáveis.
• MelonLoader é um mod loader exclusivo para PC voltado a code mods, aqueles que mudam o funcionamento real do jogo. Esses ficam no Thunderstore.

Qual deles você precisa depende totalmente do tipo de mod que você procura. Cobrimos os dois, e usamos Ragdoll Player como exemplo prático para o lado do MelonLoader.

Requisitos

Para conteúdo do mod.io:

• BONELAB em qualquer plataforma suportada, incluindo Quest 2, Quest 3 e Quest Pro standalone.
• Uma conta gratuita no mod.io.

Para code mods do MelonLoader, adicionalmente:

• Um PC rodando Windows 10 ou posterior, com BONELAB na Steam ou pelo app Oculus PC. Linux via Proton funciona com uma opção de inicialização extra.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 bit.
• .NET Desktop Runtime 6.0, x64. BONELAB é Il2Cpp e o MelonLoader exige isso.
• Alguns GB livres se você planeja colecionar avatares e mapas, que não são pequenos.

Dois Sistemas, Dois Tipos De Mod

Entender essa distinção logo de início economiza bastante tempo.

	mod.io	MelonLoader
Onde conseguir	Integrado ao jogo, ou mod.io	Thunderstore
Plataformas	PC e Quest standalone	Somente PC
O que gerencia	Avatares, mapas, itens spawnáveis, feitos com o BONELAB SDK	Code mods que alteram o comportamento do jogo
Precisa de ferramentas extras	Não	Sim, MelonLoader e geralmente BoneLib
Exemplo	Um avatar customizado ou uma fase extra	Ragdoll Player, multiplayer Fusion

Então, se você quer jogar com um personagem diferente ou carregar um mapa da comunidade, o mod.io é a resposta completa e você nunca precisa mexer em um arquivo. Se você quer mudar o funcionamento do jogo, isso é território do MelonLoader, e os jogadores de Quest ficam de fora.

NOTA - O Quest standalone não consegue rodar o MelonLoader. Não há como contornar isso. Jogadores de Quest conectados a um PC via Link ou Air Link estão rodando a build de PC, então ficam do lado do PC nesta tabela.

Instalando Mods Com mod.io

Dentro Do Jogo

Esta é, de longe, a experiência de modding mais fácil de todos os jogos desta coletânea.

1. Inicie o BONELAB e carregue no Hub.
2. Encontre o terminal do mod.io no Hub e interaja com ele.
3. Faça login na sua conta mod.io. O jogo fornece um código para digitar em mod.io/connect a partir de um celular ou navegador de PC, o que evita digitar senha com as mãos em VR.
4. Navegue ou pesquise no catálogo.
5. Selecione um mod e instale-o. Ele baixa direto para o dispositivo.

Avatares instalados aparecem nos terminais de avatares, mapas aparecem na lista de níveis, e spawnáveis aparecem no catálogo da spawn gun. Não há pasta para procurar nem nada para iniciar de forma diferente.

Pelo Site

Você também pode preparar tudo em um computador.

1. Faça login em mod.io/g/bonelab.
2. Encontre um mod e clique em Subscribe.
3. Inicie o BONELAB conectado com a mesma conta.

As inscrições sincronizam ao iniciar o jogo. Isso é bem mais confortável para navegar do que fazer isso dentro do headset.

DICA - As inscrições acompanham sua conta, não seu dispositivo. Inscreva-se no PC e os mesmos mods aparecem no seu Quest, o que é bastante útil se você joga nos dois.

Notas Para Quest

O armazenamento é o limitador aqui. Avatares e mapas são conteúdo Unity real e se acumulam rapidamente em um headset que já tem tudo mais nele. Cancelar a inscrição dentro do jogo remove os arquivos.

O Quest também roda em uma GPU móvel. Mapas feitos para PC vão rodar, mas nem sempre bem, e a descrição do mod geralmente informa se o Quest é suportado. Quando um mod tem builds separadas para PC e Quest, o mod.io serve a correta automaticamente.

Instalando Code Mods Com MelonLoader

Esta é a metade exclusiva para PC.

BoneLib

Quase todo code mod de BONELAB depende do BoneLib, a biblioteca compartilhada sobre a qual a cena é construída. Ragdoll Player não é exceção.

Há uma peculiaridade que vale conhecer. O BoneLib costumava ser publicado no namespace gnonme e desde então passou para o bonelib. O pacote antigo gnonme/BoneLib ainda existe e agora apenas depende do novo, então mods antigos que referenciam o nome antigo continuam funcionando. Se você vir os dois na sua lista de instalados, é por isso, e não é um problema.

Os gerenciadores de mods cuidam de tudo isso. Só importa se você instalar manualmente.

Usando Gale Ou r2modman

1. Baixe o Gale ou o r2modman e instale-o.
2. Abra-o e selecione BONELAB.
3. Deixe-o detectar sua instalação, ou aponte-o para a pasta do jogo.
4. Pesquise por Ragdoll Player e clique em Install ou Download with dependencies.
5. MelonLoader e BoneLib vêm junto automaticamente.
6. Inicie com Launch game (modded) ou Start modded.

Iniciar o BONELAB pela Steam ou pela app Oculus, em vez disso, executa-o sem mods.

Instalar o MelonLoader Manualmente

Primeiro encontre a pasta do jogo. Na Steam, clique com o botão direito em BONELAB, depois Manage e Browse local files:

C:\Program Files (x86)\Steam\steamapps\common\BONELAB

A forma mais fácil é usar o MelonLoader Installer. Execute-o, escolha o BONELAB na lista de jogos detetados, selecione uma versão estável e clique em Install. Se o BONELAB não for detetado, use Add Game Manually e aponte para BONELAB.exe.

Para fazer isto totalmente à mão:

1. Descarregue o MelonLoader.x64.zip.
2. Extraia a pasta MelonLoader para dentro da pasta do BONELAB.
3. Extraia também o version.dll para dentro da pasta do BONELAB.
4. Execute o jogo uma vez e feche-o, o que cria as pastas Mods e UserData.

AVISO - Não ative builds nightly no instalador. São compiladas a partir dos commits mais recentes e falham com frequência. Os mods são compilados contra as versões estáveis.

Instalar o Ragdoll Player Manualmente

1. Descarregue o BoneLib e o Ragdoll Player com Manual Download.
2. Extraia ambos.
3. Copie cada .dll para a pasta Mods no seu diretório do BONELAB.

Os mods do MelonLoader vão para Mods, não para uma pasta plugins. Se vier de um jogo com BepInEx, esta é a diferença de estrutura a lembrar.

O Ragdoll Player escreve uma configuração na primeira execução em UserData, onde pode definir a tecla que ativa o ragdoll.

Instalar Com a App TMC

Há uma terceira via que vale a pena conhecer, embora se aplique apenas à metade deste guia relativa ao MelonLoader. A TMC App é o nosso próprio gestor de mods e navegador de servidores, com instalações de um clique e sandboxes: perfis de mods nomeados por jogo, cada um com a sua própria ordem de carregamento e método de implementação, alternáveis sem que nada seja descarregado novamente.

O BONELAB ainda não está na lista de jogos suportados. Adicionar um jogo implica quatro ficheiros JSON em vez de código, por isso não é um trabalho grande.

Duas coisas a esclarecer. A app só geriria mods de código; o conteúdo do mod.io é tratado dentro do próprio jogo e nenhuma ferramenta externa vai mudar isso. E a app está numa fase muito inicial de desenvolvimento, algo que o próprio README refere claramente. Grande parte dela está apenas parcialmente testada, por isso use-a em conjunto com o Gale em vez de o substituir, por agora. Se experimentar, gostaríamos mesmo de saber como correu.

É open source sob GPL-3.0 em github.com/modcommunity/tmc-app. Relatórios de bugs e pedidos de funcionalidades devem ir para o issue tracker, pull requests são bem-vindos, e o repositório documenta o formato por jogo caso queira adicionar suporte ao BONELAB você mesmo.

Instalá-la:

• Linux: uma linha, sem root e sem gestor de pacotes.

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

• Windows: o setup.exe ou setup.msi da página de releases. Há também uma build portátil, embora não registe a entrada no launcher nem o gestor de links tmc://.
• macOS: o .dmg da mesma página de releases.

Multijogador Com o Fusion

Vale a pena mencionar porque é o mod que a maioria das pessoas acaba por querer. O Fusion adiciona multijogador completo ao BONELAB e é um dos mods mais descarregados para o jogo, por uma margem considerável.

É um mod do MelonLoader, portanto apenas para PC, e todos numa sessão precisam de o ter instalado. Como também tem de haver acordo sobre que conteúdo do mod.io cada um possui, existe um mod complementar, o ModioModNetworker, que sincroniza avatares e mapas do mod.io entre os jogadores numa sessão.

Instale o Fusion da mesma forma que qualquer outro mod do lado do Thunderstore, e partilhe um perfil do gestor de mods com quem estiver a jogar.

Confirmar Que os Mods Carregaram

Conteúdo do mod.io: basta olhar. Os avatares aparecem nos terminais de avatares, os mapas na seleção de níveis. Se algo a que subscreveu estiver em falta, verifique se está autenticado com a mesma conta dentro do jogo.

Mods do MelonLoader: abre-se uma janela de consola junto ao jogo, que imprime uma linha por mod à medida que é carregado, com nome, versão e autor. O registo completo é escrito aqui:

BONELAB\MelonLoader\Latest.log

Esse registo é a primeira coisa a verificar quando um mod não funciona, e a primeira coisa que qualquer pessoa a ajudar vai pedir para ver.

Linux

O BONELAB corre através do Proton. O MelonLoader precisa de um override de DLL, por isso defina as opções de lançamento da Steam do jogo para:

WINEDLLOVERRIDES="version=n,b" %command%

Isso é version, não winhttp. O MelonLoader e o BepInEx usam DLLs de hook diferentes, e trocar as opções de lançamento é um erro fácil de cometer.

Existe também uma build Linux do instalador do MelonLoader. O Gale e o r2modman definem o override por si quando os usa para lançar o jogo.

O conteúdo do mod.io não precisa de nada especial no Linux, uma vez que é tratado inteiramente dentro do jogo.

Desinstalar

mod.io: cancele a subscrição dentro do jogo ou no site. Os ficheiros são removidos do dispositivo.

Um único mod do MelonLoader: desinstale-o no seu gestor de mods, ou apague a sua .dll da pasta Mods.

MelonLoader por completo: apague a pasta MelonLoader, o version.dll, Mods e UserData do diretório do jogo, ou use a opção de desinstalação no MelonLoader Installer. A verificação de ficheiros da Steam não fará isto, uma vez que nada disto veio da Steam.

Resolução de Problemas

O terminal do mod.io diz que não estou autenticado. Volte a autenticar-se através de mod.io/connect com o código que o jogo mostra.

Os mods subscritos não aparecem. Reinicie o jogo. As subscrições sincronizam ao iniciar, não em tempo real.

O Quest ficou sem armazenamento. Cancele a subscrição do que não está a usar. Mapas e avatares são grandes.

Nenhum console do MelonLoader aparece. O MelonLoader não está carregando. Verifique se version.dll está diretamente ao lado de BONELAB.exe, e se você iniciou o jogo através do seu mod manager.

O MelonLoader carrega, mas um mod não. Leia o MelonLoader\Latest.log. Uma versão do BoneLib ausente ou incompatível é de longe a causa mais comum.

O MelonLoader trava na inicialização. Instale o VC++ 2015-2019 x64 redistributable e o .NET Desktop Runtime 6.0 x64.

Um mod do Thunderstore não faz nada. Verifique se é realmente um mod de BONELAB. Alguns pacotes estão listados também para BONEWORKS, e os mods de BONEWORKS dependem do ModThatIsNotMod em vez do BoneLib.

Tudo quebrou depois de uma atualização. As atualizações da Stress Level Zero quebram os mods do MelonLoader. Esvazie a pasta Mods para confirmar que o jogo roda limpo, depois aguarde os autores atualizarem seus mods.

Conclusão

A decisão que importa é de qual sistema você precisa. Avatares, mapas e itens invocáveis são do mod.io, funcionam no Quest, e você os instala sem sair do jogo. Mods de código são do MelonLoader, são exclusivos para PC, e um mod manager como o Gale torna a instalação um processo de dois cliques.

Se você está em um Quest standalone, o mod.io é toda a história, e é uma boa história.

Se tiver um momento sobrando, o TMC App é open source, está em desenvolvimento bem inicial, e qualquer feedback sobre ele seria muito bem-vindo.

Veja Também

• BONELAB no mod.io
• BONELAB no Thunderstore
• MelonLoader Wiki
• BONELAB Modding Discord
• BONELAB Wiki
• TMC App

Mantemos este guia o mais atualizado possível, mas o jogo, o mod.io e o MelonLoader mudam de forma independente. Se você encontrar uma instrução que não corresponde mais ao que 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!