Fuente oficial
Verifica xivdev/Penumbra y su README.
Guía de mods en tiempo de ejecución para FFXIV
Guía de Penumbra FFXIV: instalar, configurar y solucionar problemas
Penumbra es un plugin de Dalamud que carga archivos de mods compatibles de FFXIV en tiempo de ejecución sin sustituir los archivos originales del juego. La forma más segura de configurarlo es usar el método del repositorio personalizado de plugins que documenta el proyecto, no descomprimir manualmente un ZIP de lanzamiento.
Respuesta rápida: instala mediante Dalamud, no desde un archivo ZIP
Abre XIVLauncher, entra en el juego, ejecuta /xlsettings y añade la URL oficial de repo.json de Penumbra en el apartado Experimental custom plugin repositories. Después instala Penumbra desde /xlplugins para que Dalamud pueda gestionar las actualizaciones.
El README oficial advierte expresamente que no se debe descomprimir manualmente un ZIP de lanzamiento dentro de devPlugins. Las copias manuales pueden no recibir avisos de actualización y entrar en conflicto con la instalación gestionada desde el repositorio.
Comprobación de vigencia a 22 de julio de 2026: la última versión publicada en GitHub Releases es testing_1.7.0.2, del 20 de julio de 2026. Esta guía no ofrece el ZIP como llamada a la descarga porque el README mantenido recomienda el método del repositorio.
Guía de mods en tiempo de ejecución para FFXIV
Cómo identificar el proyecto oficial de Penumbra
Este es el icono almacenado en el repositorio xivdev/Penumbra. Usa en conjunto el propietario del repositorio, el README, el rastreador de incidencias y la dirección de repo.json para verificar el proyecto, en lugar de fiarte de un alojamiento de archivos con un nombre parecido.
Penumbra es software creado por la comunidad, no una función oficial de Square Enix. Su enfoque en tiempo de ejecución evita sobrescribir de forma permanente los archivos del juego, pero no elimina los riesgos de política de cuenta, privacidad, compatibilidad o procedencia de los mods.
Cómo instalar Penumbra en FFXIV
- Empieza con XIVLauncher y Dalamud oficiales. Instala XIVLauncher desde la página de lanzamientos de Goatcorp, inicia FFXIV y confirma que /xlplugins abre el instalador de plugins de Dalamud.
- Abre la configuración de Dalamud. Ejecuta /xlsettings y abre la pestaña Experimental. Evita cambiar otras opciones experimentales que no estén relacionadas.
- Añade la URL oficial del repositorio. Pega https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json en la lista de custom plugin repositories, usa el botón + y luego guarda y cierra.
- Instálalo desde Available Plugins. Abre /xlplugins, localiza Penumbra en Available Plugins, revisa su ficha e instálalo desde el gestor de plugins.
- Elige una carpeta de mods dedicada. Usa una carpeta fuera de los directorios protegidos de Windows o de los directorios de programa de FFXIV. Mantén espacio libre suficiente y no apuntes Penumbra a la carpeta de instalación del juego.
- Prueba un mod cada vez. Importa un único mod de confianza, actívalo para una colección limitada, cambia de zona o vuelve a abrir la ventana afectada y confirma el resultado antes de añadir más.
Flujo de instalación compatible
La vía del repositorio deja más claros el control, las actualizaciones y la reversión que una carpeta de plugin copiada manualmente.
Repositorio de Dalamud
Añade el repo.json oficial en /xlsettings.
Gestor de plugins
Instala y actualiza desde /xlplugins.
Prueba controlada
Activa un mod de confianza y comprueba conflictos.
XIVLauncher + Dalamud + Penumbra
Dónde encaja Penumbra en la cadena de arranque
XIVLauncher inicia FFXIV y carga Dalamud; después, Penumbra se instala y se gestiona como un plugin de Dalamud. No necesitas un launcher aparte, un paquete de inyección independiente ni un ejecutable del juego modificado para usar la configuración compatible de Penumbra.
La captura es material oficial de Goatcorp para XIVLauncher, no una captura de la configuración de Penumbra. Sirve para mostrar la capa del launcher que ve el usuario y evitar que se confunda el plugin con un cliente del juego independiente.
Problemas habituales de Penumbra y la primera comprobación segura
| Problema | Causa probable | Primera comprobación |
|---|---|---|
| Penumbra no aparece en /xlplugins | La URL del repositorio no se guardó o Dalamud todavía no se ha actualizado | Vuelve a abrir /xlsettings, comprueba la URL exacta de repo.json, guarda y actualiza la lista de plugins |
| Los plugins no están disponibles tras una actualización del juego | La compatibilidad de Dalamud está bloqueada temporalmente para la nueva versión de FFXIV | Espera a las actualizaciones mantenidas; no fuerces binarios antiguos de plugins dentro del juego |
| Un mod no aparece | La asignación de la colección, la prioridad o la ruta del archivo no coinciden con el personaje actual | Comprueba la colección activa y usa las herramientas de conflictos de Penumbra antes de reinstalar |
| Las texturas o los modelos se ven mezclados | Dos mods activados sustituyen los mismos archivos | Revisa los conflictos y coloca más arriba en prioridad el mod que quieras mantener |
| Cargas lentas o uso elevado de disco | Biblioteca de mods demasiado grande, crecimiento de caché o almacenamiento lento | Desactiva las incorporaciones recientes, revisa las rutas de caché y mantén el directorio de mods en almacenamiento local en buen estado |
| Comportamiento duplicado del plugin | Una copia manual en devPlugins entra en conflicto con la instalación desde el repositorio | Elimina la copia manual y conserva solo la instalación hecha desde el gestor de plugins |
Soluciona problemas sin dañar la instalación del juego
Desactiva primero el mod más reciente y luego prueba con el mismo personaje, colección, zona y estado de equipamiento. Cambiar varias variables a la vez hace más difícil aislar un conflicto.
No borres archivos de FFXIV, no sustituyas ejecutables del juego, no desactives el antivirus de forma global ni descargues paquetes de plugins reempaquetados. Penumbra está diseñado para mantener los archivos de mods separados de la instalación original; conserva ese límite.
Después de un gran parche de FFXIV, es posible que Dalamud y los plugins sigan sin estar disponibles hasta que termine el trabajo de compatibilidad. Un mensaje temporal de no disponible no demuestra que tu instalación esté rota. Consulta los canales mantenidos del proyecto y espera, en lugar de forzar compilaciones antiguas.
Límite de cuenta, contenido y privacidad
XIVLauncher, Dalamud, Penumbra y los mods son herramientas de terceros. Square Enix no ofrece soporte para ellas y ninguna guía puede garantizar la seguridad de la cuenta. Usa el cliente oficial del juego si necesitas la vía de menor riesgo.
Importa archivos de mods solo desde fuentes que entiendas. Evita archivos que incluyan ejecutables, solicitudes de credenciales, exclusiones de seguridad amplias o propiedad poco clara. Respeta los permisos de los creadores y no uses modificaciones visuales para hacer pasar contenido por oficial.
¿Penumbra es lo mismo que Dalamud?
No. Dalamud es el framework de plugins que se carga mediante XIVLauncher; Penumbra es uno de esos plugins y gestiona la sustitución de mods en tiempo de ejecución.
¿Debo descargar Penumbra.zip desde GitHub Releases?
No para la configuración normal. El README oficial recomienda añadir la URL de repo.json e instalarlo mediante Dalamud para que las actualizaciones se gestionen automáticamente.
¿Por qué los plugins de FFXIV no están disponibles después de una actualización del juego?
Dalamud puede desactivar temporalmente los plugins mientras se comprueba la compatibilidad. Espera a las actualizaciones mantenidas y evita forzar un binario antiguo.
¿Dónde debería estar la carpeta de mods de Penumbra?
Usa una carpeta dedicada con permisos de escritura fuera de la instalación de FFXIV y de las carpetas protegidas del sistema, en almacenamiento local con suficiente espacio libre.
¿Cómo soluciono que dos mods cambien el mismo archivo?
Usa la información de conflictos de Penumbra y las prioridades de colección. Deja activa solo la sustitución que quieras o súbela por encima del mod que compite.
¿Penumbra es seguro?
Es software comunitario abierto con un repositorio oficial, pero sigue siendo de terceros y los archivos de mods añaden riesgos propios de procedencia, privacidad, compatibilidad y política de cuenta.