Cómo instalar mods en BONELAB (2026)

Una guía sobre cómo descargar e instalar mods en BONELAB en PC y en Meta Quest.

BONELAB es poco habitual entre los juegos para los que escribimos estas guías, porque tiene dos sistemas de modding completamente separados y cumplen funciones distintas:

• mod.io viene integrado en el juego. Funciona en PC y en Quest standalone, no necesita herramientas externas, y cubre avatares, mapas y objetos spawneables.
• MelonLoader es un mod loader exclusivo de PC para mods de código, los que cambian de verdad el comportamiento del juego. Esos están en Thunderstore.

Cuál necesitas depende enteramente del tipo de mod que buscas. Cubrimos ambos, y usamos Ragdoll Player como ejemplo práctico para la parte de MelonLoader.

Requisitos

Para contenido de mod.io:

• BONELAB en cualquier plataforma compatible, incluyendo Quest 2, Quest 3 y Quest Pro standalone.
• Una cuenta gratuita de mod.io.

Para mods de código con MelonLoader, además:

• Un PC con Windows 10 o superior, con BONELAB en Steam o a través de la app de Oculus para PC. Linux mediante Proton funciona con una opción de lanzamiento adicional.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 bit.
• .NET Desktop Runtime 6.0, x64. BONELAB usa Il2Cpp y MelonLoader lo requiere.
• Unos cuantos GB libres si planeas coleccionar avatares y mapas, que no son pequeños.

Dos Sistemas, Dos Tipos De Mod

Dejar clara esta distinción desde el principio ahorra mucho tiempo.

	mod.io	MelonLoader
Dónde lo consigues	Integrado en el juego, o mod.io	Thunderstore
Plataformas	PC y Quest standalone	Solo PC
Qué maneja	Avatares, mapas, objetos spawneables, hechos con el BONELAB SDK	Mods de código que cambian el comportamiento del juego
Necesita herramientas extra	No	Sí, MelonLoader y normalmente BoneLib
Ejemplo	Un avatar personalizado o un nivel extra	Ragdoll Player, multijugador de Fusion

Así que si quieres jugar como un personaje diferente o cargar un mapa de la comunidad, mod.io es toda la respuesta y nunca necesitas tocar un archivo. Si quieres cambiar cómo funciona el juego, eso es territorio de MelonLoader y los jugadores de Quest no tienen suerte.

NOTA - Quest standalone no puede ejecutar MelonLoader. No hay manera de evitarlo. Los jugadores de Quest conectados a un PC vía Link o Air Link están ejecutando la build de PC, así que están del lado de PC en esta tabla.

Instalando Mods Con mod.io

Desde Dentro Del Juego

Esta es, por mucho, la experiencia de modding más fácil de todos los juegos de esta colección.

1. Inicia BONELAB y carga en el Hub.
2. Encuentra la terminal de mod.io en el Hub e interactúa con ella.
3. Inicia sesión en tu cuenta de mod.io. El juego te da un código para introducir en mod.io/connect desde un teléfono o un navegador de PC, lo cual evita escribir una contraseña con las manos en VR.
4. Navega o busca en el catálogo.
5. Selecciona un mod e instálalo. Se descarga directamente en el dispositivo.

Los avatares instalados aparecen en las terminales de avatares, los mapas aparecen en la lista de niveles, y los spawneables aparecen en el catálogo del spawn gun. No hay carpeta que buscar ni nada que lanzar de forma distinta.

Desde La Web

También puedes poner cosas en cola desde una computadora.

1. Inicia sesión en mod.io/g/bonelab.
2. Encuentra un mod y haz clic en Subscribe.
3. Inicia BONELAB con la sesión iniciada en la misma cuenta.

Las suscripciones se sincronizan al iniciar el juego. Esto es mucho más cómodo para explorar que hacerlo dentro de un headset.

CONSEJO - Las suscripciones siguen a tu cuenta, no a tu dispositivo. Suscríbete en tu PC y los mismos mods aparecen en tu Quest, lo cual es realmente útil si juegas en ambos.

Notas Para Quest

El almacenamiento es la limitación aquí. Los avatares y mapas son contenido real de Unity y se acumulan rápido en un headset que además tiene todo lo demás encima. Cancelar la suscripción desde dentro del juego elimina los archivos.

Quest también corre en una GPU móvil. Los mapas hechos para PC funcionarán, pero no siempre bien, y la descripción del mod suele indicar si Quest es compatible. Cuando un mod tiene builds separadas para PC y Quest, mod.io sirve la correcta automáticamente.

Instalando Mods De Código Con MelonLoader

Esta es la mitad exclusiva de PC.

BoneLib

Casi todos los mods de código de BONELAB dependen de BoneLib, la librería compartida sobre la que está construida la escena. Ragdoll Player no es la excepción.

Hay un detalle que vale la pena conocer. BoneLib solía publicarse bajo el namespace gnonme y desde entonces se movió a uno bonelib. El paquete antiguo gnonme/BoneLib todavía existe y ahora simplemente depende del nuevo, así que los mods antiguos que hacen referencia al nombre viejo siguen funcionando. Si ves ambos en tu lista de instalados, esa es la razón, y no es un problema.

Los gestores de mods manejan todo esto. Solo importa si instalas manualmente.

Usando Gale O r2modman

1. Descarga Gale o r2modman e instálalo.
2. Ábrelo y selecciona BONELAB.
3. Deja que detecte tu instalación, o indícale la carpeta del juego.
4. Busca Ragdoll Player y haz clic en Install o Download with dependencies.
5. MelonLoader y BoneLib se instalan automáticamente.
6. Inicia con Launch game (modded) o Start modded.

Iniciar BONELAB desde Steam o la app de Oculus lo ejecuta sin mods.

Instalar MelonLoader manualmente

Primero localiza la carpeta del juego. En Steam, haz clic derecho en BONELAB, luego Administrar y Examinar archivos locales:

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

La forma sencilla es usar el MelonLoader Installer. Ejecútalo, elige BONELAB de la lista de juegos detectados, selecciona una versión estable y haz clic en Install. Si BONELAB no se detecta, usa Add Game Manually y apúntalo a BONELAB.exe.

Para hacerlo completamente a mano:

1. Descarga MelonLoader.x64.zip.
2. Extrae la carpeta MelonLoader en la carpeta de BONELAB.
3. Extrae también version.dll en la carpeta de BONELAB.
4. Ejecuta el juego una vez y ciérralo, lo que crea las carpetas Mods y UserData.

ADVERTENCIA - No actives las builds nightly en el instalador. Se construyen a partir de los últimos commits y se rompen con frecuencia. Los mods se construyen contra las versiones estables.

Instalar Ragdoll Player manualmente

1. Descarga BoneLib y Ragdoll Player con Manual Download.
2. Extrae ambos.
3. Copia cada .dll en la carpeta Mods de tu directorio de BONELAB.

Los mods de MelonLoader van en Mods, no en una carpeta plugins. Si vienes de un juego con BepInEx, esta es la diferencia de estructura que debes recordar.

Ragdoll Player escribe una configuración la primera vez que se ejecuta, bajo UserData, donde puedes definir la tecla que activa el ragdoll.

Instalar con la TMC App

Hay una tercera vía que vale la pena conocer, aunque solo aplica a la mitad de esta guía dedicada a MelonLoader. La TMC App es nuestro propio gestor de mods y buscador de servidores, con instalaciones de un clic y sandboxes: perfiles de mods con nombre por juego, cada uno con su propio orden de carga y método de despliegue, intercambiables sin volver a descargar nada.

BONELAB aún no está en su lista de juegos compatibles. Añadir un juego implica cuatro archivos JSON en lugar de código, así que no es una tarea grande.

Dos cosas que conviene dejar claras. La app solo gestionaría mods de código; el contenido de mod.io se maneja dentro del juego y ninguna herramienta externa va a cambiar eso. Y la app está en una fase muy temprana de desarrollo, algo que su propio README indica claramente. Buena parte de ella solo está parcialmente probada, así que úsala junto a Gale en lugar de reemplazarlo por ahora. Si la pruebas, nos encantaría saber cómo te fue.

Es de código abierto bajo GPL-3.0 en github.com/modcommunity/tmc-app. Los reportes de errores y solicitudes de funciones van en el issue tracker, los pull requests son bienvenidos, y el repositorio documenta el formato por juego si quieres añadir soporte para BONELAB tú mismo.

Instalarla:

• Linux: una sola línea, sin root y sin gestor de paquetes.

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

• Windows: el setup.exe o setup.msi de la página de releases. También hay una build portable, aunque esta no registra la entrada del launcher ni el manejador de enlaces tmc://.
• macOS: el .dmg de la misma página de releases.

Multijugador con Fusion

Vale la pena mencionarlo porque es el mod que la mayoría acaba queriendo. Fusion añade multijugador completo a BONELAB y es, por un margen amplio, uno de los mods más descargados del juego.

Es un mod de MelonLoader, así que solo para PC, y todos en una sesión necesitan tenerlo instalado. Como además tiene que coincidir en qué contenido de mod.io tiene cada uno, existe un mod complementario, ModioModNetworker, que sincroniza avatares y mapas de mod.io entre los jugadores de una sesión.

Instala Fusion igual que cualquier otro mod del lado de Thunderstore, y comparte un perfil de gestor de mods con quien vayas a jugar.

Confirmar que tus mods cargaron

Contenido de mod.io: simplemente mira. Los avatares aparecen en las terminales de avatares, los mapas en la selección de nivel. Si algo a lo que estás suscrito falta, comprueba que has iniciado sesión con la misma cuenta dentro del juego.

Mods de MelonLoader: se abre una ventana de consola junto al juego que imprime una línea por cada mod al cargar, con nombre, versión y autor. El log completo se escribe aquí:

BONELAB\MelonLoader\Latest.log

Ese log es lo primero que hay que revisar cuando un mod no funciona, y lo primero que cualquiera que te ayude va a pedirte que muestres.

Linux

BONELAB se ejecuta a través de Proton. MelonLoader necesita una sobreescritura de DLL, así que configura las opciones de lanzamiento de Steam del juego así:

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

Eso es version, no winhttp. MelonLoader y BepInEx usan DLL de enganche distintas, y confundir las opciones de lanzamiento es un error fácil de cometer.

También existe una build para Linux del instalador de MelonLoader. Gale y r2modman configuran la sobreescritura por ti cuando lanzas el juego a través de ellos.

El contenido de mod.io no necesita nada especial en Linux, ya que se gestiona íntegramente dentro del juego.

Desinstalar

mod.io: cancela la suscripción dentro del juego o en la web. Los archivos se eliminan del dispositivo.

Un solo mod de MelonLoader: desinstálalo desde tu gestor de mods, o elimina su .dll de la carpeta Mods.

MelonLoader por completo: elimina la carpeta MelonLoader, version.dll, Mods y UserData del directorio del juego, o usa la opción de desinstalación del MelonLoader Installer. La verificación de archivos de Steam no hará esto, ya que nada de eso vino de Steam.

Solución de problemas

La terminal de mod.io dice que no he iniciado sesión. Vuelve a iniciar sesión a través de mod.io/connect con el código que te muestra el juego.

Los mods a los que estoy suscrito no aparecen. Reinicia el juego. Las suscripciones se sincronizan al iniciar, no en tiempo real.

A Quest se le acaba el almacenamiento. Cancela la suscripción a lo que no uses. Los mapas y avatares ocupan mucho espacio.

No aparece la consola de MelonLoader. MelonLoader no está cargando. Comprueba que version.dll esté justo al lado de BONELAB.exe, y que hayas iniciado el juego a través de tu gestor de mods.

MelonLoader carga pero un mod no. Lee MelonLoader\Latest.log. Una versión de BoneLib ausente o incompatible es, con diferencia, la causa más común.

MelonLoader falla al iniciar. Instala el redistribuible VC++ 2015-2019 x64 y el .NET Desktop Runtime 6.0 x64.

Un mod de Thunderstore no hace nada. Comprueba que sea realmente un mod de BONELAB. Algunos paquetes están listados también para BONEWORKS, y los mods de BONEWORKS dependen de ModThatIsNotMod en lugar de BoneLib.

Todo se rompió tras una actualización. Los parches de Stress Level Zero rompen los mods de MelonLoader. Vacía la carpeta Mods para confirmar que el juego funciona limpio, y luego espera a que los autores lo actualicen.

Conclusión

La decisión que importa es qué sistema necesitas. Los avatares, mapas y objetos invocables son de mod.io, funcionan en Quest, y se instalan sin salir del juego. Los mods de código son de MelonLoader, son exclusivos de PC, y un gestor de mods como Gale los convierte en un trabajo de dos clics.

Si estás en una Quest standalone, mod.io es toda la historia, y es una buena historia.

Si tienes un momento libre, la TMC App es de código abierto, está en una etapa muy temprana de desarrollo, y cualquier comentario sobre ella sería muy apreciado.

Ver También

• BONELAB en mod.io
• BONELAB en Thunderstore
• Wiki de MelonLoader
• Discord de modding de BONELAB
• Wiki de BONELAB
• TMC App

Mantenemos esta guía tan actualizada como podemos, pero el juego, mod.io y MelonLoader cambian de forma independiente. Si detectas una instrucción que ya no coincide con lo que estás viendo, repórtalo o abre un pull request en el repositorio de GitHub de esta guía.

¡Únete a nuestro servidor de Discord si tienes alguna pregunta o quieres ayuda con cualquier cosa relacionada con el modding!