Cómo instalar mods en Boneworks (2026)

Una guía sobre cómo descargar e instalar mods en BONEWORKS en PC.

BONEWORKS es un sandbox de física exclusivo para VR construido en Unity, y sus mods se cargan mediante MelonLoader en lugar de BepInEx. Esa es la principal diferencia respecto a la mayoría de los juegos de Unity que la gente modea. Todo vive en Thunderstore.

Nuestro ejemplo práctico es Custom Maps, un cargador de mapas que te permite añadir niveles hechos por la comunidad al juego. Necesita otros dos mods para funcionar, lo que lo convierte en una buena demostración de cómo encaja todo el stack.

Requisitos

• Un PC con Windows 10 o superior. Linux mediante Proton funciona con una variable de entorno adicional, que se explica más abajo.
• BONEWORKS en Steam, además de un visor de VR y su runtime. No hay modo de pantalla plana.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 bit. MelonLoader lo necesita.
• .NET Desktop Runtime 6.0, x64. BONEWORKS es un juego Il2Cpp y MelonLoader requiere esto para esos casos.
• Unos cientos de MB libres, más si vas a coleccionar mapas personalizados.

BONEWORKS es un juego para un solo jugador sin anti-cheat. Nada de esto pone en riesgo tu cuenta.

MelonLoader, no BepInEx

Si has modeado Lethal Company, Valheim o la mayoría de otros juegos de Unity, habrás usado BepInEx. BONEWORKS no lo usa.

MelonLoader es un cargador de mods universal para Unity distinto, creado por LavaGang, con soporte de primera clase para juegos Il2Cpp como este. Funciona con el mismo principio: engancha el juego al iniciarse y carga los mods, pero la estructura de carpetas y el instalador son propios.

Los mods de MelonLoader son archivos .dll que van en una carpeta Mods dentro del directorio del juego, no en BepInEx/plugins.

ModThatIsNotMod

Casi todos los mods de BONEWORKS que realmente querrás dependen de ModThatIsNotMod de gnonme. Es la librería compartida para este juego: se encarga de cargar objetos personalizados, ofrece a los autores de mods herramientas para los sistemas del juego, y es la base sobre la que se construye el resto del ecosistema.

Custom Maps la necesita, junto con FieldInjection. Así que el stack completo para nuestro ejemplo es:

MelonLoader  ->  ModThatIsNotMod + FieldInjection  ->  Custom Maps

Un gestor de mods se encarga de todo eso por ti.

Una nota sobre los mods de BONELAB

BONEWORKS y BONELAB son juegos separados con comunidades de Thunderstore separadas, y algunos paquetes aparecen listados en ambas. Esa coincidencia en el listado no siempre es significativa.

Hitmarkers es el caso con el que más gente se topa. Aparece en los listados de BONEWORKS, pero cada versión publicada depende de BoneLib, que es una librería de BONELAB sin equivalente en BONEWORKS, y su propia descripción dice que fue rehecho para BONELAB. Instalarlo aquí no hará lo que esperas.

La regla general: si un mod de BONEWORKS lista ModThatIsNotMod como dependencia, es realmente un mod de BONEWORKS. Si lista BoneLib, es un mod de BONELAB que resulta estar listado también aquí.

Instalación con Gale

Gale es la vía más sencilla y se encarga de MelonLoader por ti.

1. Descarga Gale desde Thunderstore o GitHub.
2. Ábrelo y selecciona BONEWORKS.
3. Deja que encuentre tu instalación de Steam, o indícale tú mismo la carpeta del juego.
4. Abre Browse mods, busca Custom Maps y haz clic en Install.
5. MelonLoader, ModThatIsNotMod y FieldInjection se instalan junto con él.
6. Haz clic en Launch game (modded).

Lanzar BONEWORKS desde Steam lo inicia sin mods. Lánzalo desde Gale.

Instalación con r2modman

r2modman funciona de la misma manera.

1. Instala r2modman y selecciona BONEWORKS.
2. Crea un perfil.
3. Abre Online, busca Custom Maps y usa Download with dependencies.
4. Haz clic en Start modded.

Cualquiera de los dos funciona bien. Gale es más ligero; r2modman tiene un soporte de plataformas más amplio.

Instalar MelonLoader tú mismo

Vale la pena saberlo si prefieres no usar un gestor, o si un gestor te está dando problemas.

Primero localiza la carpeta del juego. Haz clic derecho en BONEWORKS en Steam, luego Administrar y Examinar archivos locales:

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

Estás buscando BONEWORKS.exe.

El instalador automatizado

Esta es la forma recomendada y es realmente fácil.

1. Descarga el MelonLoader Installer.
2. Ejecútalo. Busca juegos de Unity instalados y debería listar BONEWORKS por su cuenta. Si no lo hace, usa Add Game Manually e indícale BONEWORKS.exe.
3. Haz clic en BONEWORKS en la lista, elige una versión y pulsa Install.

ADVERTENCIA - No toques el interruptor de nightly builds. Las nightlies se generan a partir de los últimos commits y rompen cosas con frecuencia. La versión estable es contra la que se construyen los mods.

El método manual

1. Descarga MelonLoader.x64.zip. BONEWORKS es de 64 bits.
2. Extrae la carpeta MelonLoader del zip a la carpeta de BONEWORKS.
3. Extrae también version.dll del mismo zip a la carpeta de BONEWORKS.
4. Inicia el juego una vez para que MelonLoader genere sus carpetas, y luego ciérralo.

Ahora deberías tener una carpeta MelonLoader, un version.dll y una carpeta Mods junto a BONEWORKS.exe.

Instalar mods manualmente

Con MelonLoader ya instalado, los mods son sencillos.

1. Abre la página de Thunderstore del mod y haz clic en Manual Download.
2. Extrae el zip.
3. Copia el .dll en la carpeta Mods dentro de tu directorio de BONEWORKS.

Para Custom Maps eso significa tres descargas separadas, ya que también necesitas ModThatIsNotMod y FieldInjection. Consigue cada uno en la versión que indica la sección Dependencies del mod, y copia cada .dll en Mods.

Algunos mods traen contenido extra junto al .dll, como archivos de mapas o modelos. Lee la descripción del mod para saber dónde va eso. Custom Maps, por ejemplo, lee los archivos de mapa desde su propia carpeta en lugar de desde Mods.

NOTA - Los archivos manifest.json, icon.png y README.md de un zip de Thunderstore son archivos de empaquetado para la web. No hacen nada dentro de la carpeta Mods.

Instalación con The TMC App

Para completar la lista está nuestra propia herramienta. The TMC App es un gestor de mods y buscador de servidores que desarrollamos nosotros, con instalación en 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 tener que volver a descargar nada.

BONEWORKS aún no está en su lista de juegos compatibles. Añadir un juego consiste en cuatro archivos JSON y nada de código, así que es un trabajo pequeño, y los juegos con MelonLoader son exactamente el tipo de caso que el sistema de plugins está pensado para cubrir.

Lo honesto: la app está en una fase de desarrollo muy temprana. Lo decimos en su README y lo decimos aquí también. Buena parte de ella solo está probada parcialmente, así que trátala como algo para probar junto a Gale, no como un reemplazo. Si la pruebas, cuéntanos qué pasó, porque eso es lo más útil que cualquiera puede hacer por el proyecto ahora mismo.

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

Instalación:

• Linux: una 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 versión 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.

Comprobar que funcionó

MelonLoader abre una ventana de consola junto al juego al iniciarlo. Durante el arranque imprime su propia versión y luego una línea por cada mod a medida que los carga, con el nombre del mod, la versión y el autor.

Los registros también se guardan en disco:

BONEWORKS\MelonLoader\Latest.log

Ese archivo es lo primero que hay que mirar cuando algo no funciona, y lo primero que te pedirá cualquiera que te ayude.

Para Custom Maps en concreto, el mod añade su propia forma de elegir un nivel dentro del juego una vez que tienes instalados los archivos de mapa.

Ejecutar en Linux

BONEWORKS se ejecuta mediante Proton. MelonLoader necesita una anulación de DLL para poder cargarse, así que configura las opciones de lanzamiento de Steam del juego así:

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

Ten en cuenta que es version, no winhttp. MelonLoader usa una DLL de enganche distinta a la de BepInEx, y copiar la opción de lanzamiento de BepInEx es un error común.

El instalador de MelonLoader también tiene una versión para Linux si prefieres no hacerlo a mano. Gale y r2modman también configuran la anulación por su cuenta cuando lanzas el juego a través de ellos.

Quitar mods

Elimina el .dll de la carpeta Mods, o desinstálalo mediante tu gestor de mods.

Para quitar MelonLoader por completo, elimina la carpeta MelonLoader, version.dll, la carpeta Mods y la carpeta UserData del directorio del juego. El MelonLoader Installer también tiene una opción de desinstalación que hace esto por ti.

La opción de Steam Verificar la integridad de los archivos del juego no limpiará nada de esto, porque Steam no tiene registro de archivos que él no instaló.

Solución de problemas

No aparece la ventana de consola y no hay mods. MelonLoader no se está cargando. Comprueba que version.dll esté justo al lado de BONEWORKS.exe, y que hayas iniciado el juego desde tu gestor de mods y no desde Steam.

MelonLoader carga pero un mod no. Abre MelonLoader\Latest.log. Tanto las dependencias faltantes como las incompatibilidades de versión aparecen claramente ahí.

MelonLoader falla al iniciar. Normalmente falta un requisito previo. Instala el redistribuible de VC++ 2015-2019 x64 y el .NET Desktop Runtime 6.0 x64, que los juegos Il2Cpp necesitan.

Un mod se instaló bien pero no hace absolutamente nada. Comprueba si realmente es un mod de BONEWORKS. Si su lista de dependencias menciona BoneLib, es un mod de BONELAB que está listado también aquí.

Todo se rompió tras una actualización del juego. BONEWORKS no se actualiza muy seguido últimamente, pero cuando ocurre, tanto MelonLoader como los mods necesitan ponerse al día. Vacía la carpeta Mods para confirmar que el juego en sí funciona bien, y luego espera.

Errores del runtime de VR tras instalar mods. Prueba a lanzar el juego sin mods primero para confirmar que el lado del casco funciona. Los problemas de mods y los de SteamVR se ven parecidos desde dentro de un casco.

Conclusión

Modear BONEWORKS es sencillo una vez que sabes que usa MelonLoader en lugar de BepInEx, y que ModThatIsNotMod es la librería sobre la que se apoya todo lo demás. Instala Gale, instala el mod que quieras y lánzalo a través de Gale.

La única trampa específica de BONEWORKS son los paquetes de BONELAB listados también aquí. Revisa la lista de dependencias antes de instalar: ModThatIsNotMod significa BONEWORKS, BoneLib significa BONELAB.

Si quieres ayudar con algo, TMC App es de código abierto y está en fase temprana de desarrollo, y sus comentarios valen muchísimo para nosotros.

Ver también

• BONEWORKS en Thunderstore
• MelonLoader Wiki - La documentación propia del loader, vale la pena leerla.
• MelonLoader en GitHub
• Discord de modding de BONEWORKS
• BONEWORKS Wiki
• TMC App

Mantenemos esta guía lo más actualizada posible, pero MelonLoader y los mods construidos sobre él cambian con el tiempo. Si alguna instrucción aquí ya no coincide con lo que estás viendo, por favor 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!