Una guía sobre cómo descargar e instalar mods en Valheim en PC, que cubre gestores de mods e instalación manual en Windows, Linux y macOS.
Valheim corre sobre Unity y sus mods son plugins de BepInEx. La comunidad mantiene su propia build de BepInEx en lugar de usar la oficial, y eso es lo primero que hay que tener claro.
Nuestro ejemplo es EpicLoot, una revisión de objetos mágicos y botín de larga trayectoria. Es un buen caso de demostración porque incorpora dependencias reales y porque hay que instalarlo tanto en el servidor como en el cliente.
Requisitos
- Un PC con Windows 10 o superior, Linux o macOS. Valheim tiene builds nativas para los tres.
- Valheim, idealmente la versión de Steam. Ve la siguiente sección para saber por qué.
- Unos cientos de MB libres. Los grandes overhauls como EpicLoot ocupan más.
- 7-Zip o cualquier herramienta de archivos si instalas a mano.
- Una copia de seguridad de tus mundos y personajes antes de empezar. Se encuentran en
%userprofile%\AppData\LocalLow\IronGate\Valheimen Windows.
ADVERTENCIA - Tómate en serio esa copia de seguridad. Los mods que añaden objetos y progresión, incluido EpicLoot, escriben datos en tu partida. Eliminar ese mod más adelante puede dejarte con un personaje que lleva objetos que el juego ya no reconoce.
Qué versión de Valheim tienes importa
Valheim se vende en Steam, en la Microsoft Store y en consolas Xbox.
- Steam es la versión que asume toda esta guía, y la versión a la que apunta toda la escena de mods.
- Las instalaciones de Microsoft Store y Game Pass viven en
C:\XboxGames\Valheim\Contenty son mucho más difíciles de modear. BepInEx necesita escribir archivos en la carpeta del juego, y estas instalaciones están protegidas de formas que generalmente lo impiden. No hay una vía compatible aquí y no debes esperar que los gestores de mods funcionen. - Las consolas Xbox no se pueden modear en absoluto. El crossplay permite que un jugador de Xbox se una a un servidor de PC, pero el cliente de Xbox sigue siendo vanilla y no puede cargar nada.
BepInExPack Valheim
BepInExPack Valheim es el cargador, y no es el BepInEx normal. Es una build específica para Valheim mantenida por Azumatt, Vapok y Margmas, con un BepInEx.cfg preconfigurado, scripts de lanzamiento para Linux y el servidor dedicado, cambios en el preloader de los que dependen varios mods, y soporte de versionado semántico que la versión oficial de BepInEx 5 descarta.
Instala ese pack, no el BepInEx genérico.
NOTA - Al ser un fork de la comunidad, el Discord oficial de BepInEx no puede ayudarte con problemas de Valheim, y te lo dirán sin rodeos. Lleva los problemas de Valheim a la comunidad de modding de Valheim en su lugar.
Además de BepInEx, EpicLoot depende de dos librerías compartidas:
- Jötunn, la librería de modding de Valheim sobre la que se construyen la mayoría de mods importantes.
- JsonDotNET, una copia empaquetada de Newtonsoft.Json.
Los gestores de mods instalan ambas automáticamente.
Instalar con un gestor de mods de Thunderstore
Este es el camino más transitado y el que enlazan las páginas de mods.
Tres gestores funcionan con Valheim y los tres leen el mismo formato de perfil:
| Gestor | Plataformas |
|---|---|
| Gale | Windows, Linux |
| Thunderstore Mod Manager | Windows |
| r2modman | Windows, Linux, macOS |
Los pasos son los mismos elijas el que elijas:
- Instala el gestor y selecciona Valheim.
- Crea un perfil.
- Busca EpicLoot.
- Haz clic en Install o Download with dependencies. BepInExPack Valheim, Jötunn y JsonDotNET se instalan junto con él.
- Lanza el juego a través del gestor con Start modded o Launch game (modded).
Lanzar Valheim directamente desde Steam lo ejecuta en modo vanilla, ya que el gestor conecta BepInEx en el momento del lanzamiento.
Instalar con Vortex
Vortex soporta Valheim y obtiene los mods de Nexus Mods en lugar de Thunderstore. El catálogo de Valheim en Nexus es mucho más reducido y la mayoría de autores publican primero en Thunderstore, así que usa esta opción si Vortex ya es tu herramienta habitual y has encontrado allí lo que buscabas.
- Instala Vortex e inicia sesión.
- En Games, busca Valheim, pasa el cursor sobre la miniatura y haz clic en Manage.
- Instala BepInExPack Valheim tú mismo siguiendo los pasos manuales de más abajo. Vortex no configurará el loader por ti.
- Descarga mods desde Nexus con Mod Manager Download, luego Install y Enable.
- Lanza el juego desde Steam normalmente. Vortex escribe archivos en la carpeta del juego de forma permanente, así que no hace falta un lanzamiento especial una vez que BepInEx está instalado.
ADVERTENCIA - No ejecutes Vortex y un gestor de mods de Thunderstore sobre la misma instalación. Ambos quieren controlar BepInEx/plugins y deshacerán el trabajo del otro.
Instalación manual
Primero, localiza la carpeta del juego. Haz clic derecho en Valheim en Steam, luego Administrar y Examinar archivos locales:
C:\Program Files (x86)\Steam\steamapps\common\Valheim
Descarga BepInExPack Valheim con Manual Download, extráelo en un lugar que no sea la carpeta del juego, y luego mueve el contenido de la carpeta BepInExPack_Valheim a tu carpeta de Valheim. Si lo haces bien, verás BepInEx, winhttp.dll y doorstop_config.ini junto a valheim.exe.
Luego descarga EpicLoot, Jötunn y JsonDotNET, extrae cada uno, y copia sus archivos .dll en Valheim\BepInEx\plugins.
Lo que hagas a continuación depende de tu plataforma.
Windows
No hay nada más que hacer. Inicia el juego y debería aparecer una ventana de consola de BepInEx junto a él.
Linux
- Haz que el script de lanzamiento sea ejecutable:
chmod u+x start_game_bepinex.sh
- En Steam, abre las Propiedades de Valheim y configura las opciones de lanzamiento como:
./start_game_bepinex.sh %command%
- Inicia el juego a través de Steam.
También puedes indicar la ruta completa al script en lugar de una relativa, lo que te permite mantener el pack fuera de la carpeta del juego por completo.
macOS
Valheim tiene una build nativa para macOS, pero BepInEx 5 no funciona de forma nativa en Apple Silicon, porque depende de MonoMod y MonoMod aún no tiene soporte para arm64. La solución alternativa es forzar el juego a través de Rosetta.
- Haz el script ejecutable:
chmod u+x start_game_bepinex.sh
- Configura las opciones de lanzamiento de Valheim en Steam como:
/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%
- Inicia el juego a través de Steam.
Si omites la parte arch -x86_64 en un Mac con chip M, el juego igual se inicia, pero lo hace sin BepInEx y no carga ninguno de tus mods. Los Mac Intel no lo necesitan.
Instalar con la app de TMC
Valheim es uno de los juegos que la app de TMC ya soporta, así que, a diferencia de la mayoría de nuestras guías, esta es una opción real y no una promesa. La app es nuestro propio gestor de mods y navegador de servidores, y despliega los mods de Valheim en BepInEx/plugins igual que todo lo demás en esta guía.
Instalándola:
- 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.exeosetup.msidesde la página de releases. También hay una build portable, aunque esta no registra la entrada del lanzador ni el manejador de enlacestmc://. - macOS: el
.dmgde la misma página de releases.
Una vez instalada:
- Abre la app y añade Valheim, apuntándola a tu carpeta de instalación de Steam.
- Crea un sandbox. Los sandboxes son perfiles de mods con nombre propio, con su propio orden de carga y método de despliegue, y cambiar entre ellos no vuelve a descargar nada.
- Instala los mods que quieras en ese sandbox.
- Lanza el juego.
ADVERTENCIA - Por favor, lee esta parte antes de confiar en ella. La app está en una fase muy temprana de desarrollo y preferimos decírtelo antes de que lo descubras a mitad de una partida. Su propio README enumera todos los juegos soportados como no probados, incluido Valheim, así que trátala como algo para experimentar junto a Gale o r2modman en lugar de como un reemplazo de estos. Conserva la copia de seguridad que mencionamos en los requisitos.
Dicho esto, esta es justamente la etapa en la que probarla resulta más útil. Si funciona, nos gustaría saberlo. Si despliega en la carpeta equivocada o desordena tu load order, nos gustaría mucho saberlo, y ese tipo de reporte vale más para el proyecto ahora mismo que casi cualquier otra cosa.
La app 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 cómo funcionan las reglas por juego si quieres mejorar tú mismo el soporte de Valheim.
Mods del lado del servidor y multijugador
Esta es la parte que suele sorprender a los jugadores de Valheim, porque funciona de forma distinta a la mayoría de juegos cooperativos.
Los mods de Valheim se dividen aproximadamente en tres categorías:
- Solo cliente. Ajustes de UI, cambios de cámara, mods visuales. Instálalos en tu máquina y a nadie más le importa.
- Cliente y servidor. Cualquier cosa que añada objetos, recetas, criaturas o progresión. EpicLoot entra claramente aquí, y debe instalarse tanto en el servidor dedicado como en el cliente de cada jugador.
- Solo servidor. Herramientas de administración, copias de seguridad, gestión del mundo.
Hacerlo mal suele manifestarse como ser expulsado al conectar por una discrepancia de versiones, o como objetos que desaparecen porque el servidor no los reconoce.
Para un servidor dedicado, BepInExPack Valheim incluye un script start_server_bepinex.sh exactamente para esto. Hazlo ejecutable con chmod u+x start_server_bepinex.sh, edita sus parámetros de lanzamiento de la misma forma en que editarías el propio script del servidor de Valheim, y ejecútalo en lugar de start_server.sh.
Si estás configurando un servidor desde cero, nuestra guía aparte del servidor de Valheim cubre ese aspecto.
CONSEJO - Varios hosts gestionados de Valheim instalarán BepInEx por ti con un simple interruptor. Si prefieres no tocar una terminal, ese es un atajo legítimo.
Configurar los mods
Los mods escriben sus archivos de configuración aquí en la primera ejecución:
Valheim\BepInEx\config
Son archivos de texto plano .cfg. EpicLoot pone gran parte de su ajuste ahí, junto con archivos JSON para las tablas de botín y los efectos mágicos, y vale la pena echarles un vistazo si quieres ajustar en lugar de aceptar los valores predeterminados.
BepInEx Configuration Manager añade una ventana de configuración dentro del juego que edita los mismos valores sin necesidad de alternar entre ventanas. Gale y r2modman también incluyen editores de configuración.
Comprobar que todo cargó
En Windows, BepInEx abre una ventana de consola junto al juego. Aparece en la barra de tareas y puedes observar en ella la secuencia de arranque.
Lo que quieres ver es texto gris y blanco, que es salida informativa. Los colores significan problemas:
| Color | Significado |
|---|---|
| Rojo | Error fatal |
| Rojo oscuro | Error |
| Amarillo | Advertencia |
| Gris oscuro | Salida de depuración |
El pack también imprime en la consola su propia versión de Thunderstore, que es distinta de la versión de BepInEx subyacente.
Para EpicLoot en concreto, carga un mundo y comprueba en tu inventario las pestañas de objetos mágicos y las recetas de la estación de aumento.
Actualizar y desinstalar
Los gestores de mods marcan los mods desactualizados y los actualizan con un clic. Haz tus actualizaciones entre sesiones de juego en lugar de a mitad de una partida, ya que un mod que escribe en tu partida guardada puede comportarse mal cuando las versiones cambian debajo de él.
Para eliminar un mod, desinstálalo en tu gestor o borra su .dll de BepInEx/plugins. Para volver a vanilla, elimina BepInEx, winhttp.dll, doorstop_config.ini y los scripts de lanzamiento de la carpeta del juego. La verificación de archivos de Steam no los eliminará, porque Steam no los instaló.
ADVERTENCIA - Antes de eliminar un mod que añadió objetos a tu mundo, considera si quieres conservar ese personaje y ese mundo después. Para eso está la copia de seguridad.
Solución de problemas
No aparece la consola de BepInEx y no hay mods. En Windows, comprueba que winhttp.dll esté justo junto a valheim.exe. En Linux, comprueba que tus opciones de lanzamiento incluyan ./start_game_bepinex.sh %command%. En macOS, comprueba que el prefijo arch -x86_64 esté presente.
Expulsado de un servidor por discrepancia de versiones. Tus mods y los del servidor no coinciden. Instala las mismas versiones que ejecuta el servidor, o pide al host que exporte su lista.
Los mods dejaron de funcionar tras una actualización de Valheim. Es de esperar. Los parches de Iron Gate rompen los mods de BepInEx y los autores necesitan tiempo. Revisa las páginas de Thunderstore de tus mods por si hay versiones actualizadas.
El juego falla al iniciar. Saca todo de BepInEx/plugins, confirma que arranca limpio y luego vuelve a añadir mods de a la mitad para encontrar al culpable.
Los mods funcionan en un jugador pero no en mi propio servidor. Los mods del lado del servidor también deben instalarse en el servidor, no solo en el cliente que lo aloja. Usa start_server_bepinex.sh.
La versión de Microsoft Store no se puede modear. En gran medida no se puede, y no hay una forma soportada de solucionarlo. La versión de Steam es la que hay que usar.
No carga nada en un Mac con chip M. Te falta el prefijo de Rosetta en las opciones de lanzamiento.
Conclusión
La versión corta para la mayoría: instala Gale o r2modman, elige Valheim, instala EpicLoot con sus dependencias, y lanza el juego en modo modded. BepInExPack Valheim viene incluido y nunca tienes que preocuparte por él.
Las dos cosas específicas de Valheim que vale la pena recordar son que el pack de BepInEx es un fork de la comunidad con sus propias particularidades y sus propios canales de soporte, y que cualquier cosa que toque objetos o progresión debe instalarse tanto en el servidor como en el cliente.
Valheim es uno de los pocos juegos que nuestra propia TMC App ya soporta. Es de código abierto y está en una etapa muy temprana de desarrollo, así que vale la pena probarla más que confiar plenamente en ella, y cualquier feedback sobre la misma sería genuinamente apreciado.
Ver También
- Valheim en Thunderstore
- Valheim en Nexus Mods
- Discord de Modding de Valheim
- Wiki de Modding de Valheim
- FAQ Oficial de Modding de Valheim - Las propias notas de Iron Gate sobre el sistema de asset bundles con el que los mods deben funcionar.
- Documentación de Jötunn
- TMC App
Mantenemos esta guía lo más actualizada posible, pero Valheim, BepInEx y las librerías de mods se actualizan por separado. Si alguna instrucción aquí 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!

