Deployment Methods ‐ español

Métodos de despliegue y OverlayFS

English · Deutsch · Français · Español · Italiano · Português · Русский

Anvil puede desplegar los mods de dos maneras. La selección se guarda por separado para cada instancia de juego en Ajustes → Experto → Despliegue de mods.

Comparación

	Enlaces simbólicos (predeterminado)	OverlayFS (experimental)
Carpeta del juego	Anvil crea enlaces a los archivos de los mods	La carpeta del juego sin modificar queda cubierta por una capa de mods
Permisos del sistema	No son necesarios	Son necesarios para montar y desmontar la capa
Formas de inicio	Mediante Anvil; directamente desde Steam con el despliegue permanente	Cualquier forma mientras la capa esté montada
Escrituras del juego	Van a la carpeta normal del juego	Van a la carpeta overwrite configurada
Limpieza	Los enlaces se eliminan al cerrar el juego	El montaje del kernel y la capa temporal se eliminan al cerrar el juego
«Mantener los mods en la carpeta del juego»	Disponible	Oculto y siempre desactivado

Enlaces simbólicos

Los enlaces simbólicos son el método predeterminado. Anvil crea enlaces en la carpeta del juego para los archivos de los mods activos. Los conflictos siguen el orden de la lista de mods: un mod situado más arriba tiene mayor prioridad.

Después de una sesión de juego supervisada normalmente, Anvil elimina los enlaces. El almacenamiento original de los mods no se modifica.

Mantener los mods en la carpeta del juego

Esta opción solo está disponible con enlaces simbólicos. Cuando está activada, los enlaces permanecen después de cerrar el juego y Anvil. Así, el juego puede iniciarse con mods directamente desde Steam u otro lanzador.

Ten en cuenta lo siguiente:

• La opción solo se aplica a la instancia de juego actual.
• Anvil la desactiva al cambiar a otra instancia.
• Una actualización del juego o la verificación de archivos puede reemplazar o eliminar los enlaces. Después hay que volver a desplegar mediante Anvil.
• No muevas ni elimines la carpeta de datos de Anvil mientras los enlaces estén desplegados.
• Desactiva la opción antes de iniciar el juego sin mods.

OverlayFS

OverlayFS es una función del kernel de Linux. Anvil monta una vista combinada directamente sobre la carpeta de juego configurada:

carpeta del juego visible
├─ capa de mods del perfil activo
├─ carpeta original del juego
└─ escrituras durante la ejecución → carpeta overwrite

Los archivos originales del juego no se reemplazan. Mientras el montaje está activo, Steam, Proton y el juego ven la vista combinada. Por eso funciona cualquier forma de inicio, incluido el inicio directo desde Steam.

Proceso

1. Anvil lee el perfil, el orden de los mods y las reglas de despliegue específicas del juego.
2. Crea una nueva capa temporal a partir de los mods activos.
3. Monta la capa sobre la carpeta del juego antes de iniciarlo.
4. Las escrituras del juego van a la carpeta overwrite configurada.
5. Solo cuando termina el proceso real del juego, Anvil desmonta OverlayFS y elimina la capa temporal.

La opción «Mantener los mods en la carpeta del juego» se oculta con OverlayFS y se guarda como false. Un montaje global del kernel no debe permanecer activo sin que el usuario lo advierta como un estado permanente antiguo.

¿Por qué se necesita una contraseña?

Montar y desmontar un sistema de archivos del kernel requiere permisos del sistema en Linux. La solicitud de contraseña pertenece a pkexec/polkit, no a Anvil. Anvil nunca guarda la contraseña.

Sin configuración adicional, el sistema solicita autorización al desplegar. «Configurar montaje sin contraseña…» instala una sola vez:

• el asistente propiedad de root /usr/local/libexec/anvil-overlay-mount;
• una regla polkit para el usuario actual de Linux.

Después, solo ese asistente fijo puede ejecutarse sin otra solicitud de contraseña. Anvil no autoriza deliberadamente ningún script modificable por el usuario.

Requisitos

OverlayFS solo está disponible cuando se superan las comprobaciones:

• El kernel en ejecución admite OverlayFS o proporciona un módulo overlay cargable.
• pkexec/polkit está instalado.
• Las rutas del juego y de la instancia son accesibles.
• La carpeta overwrite está en un sistema de archivos Linux compatible, por ejemplo ext4, btrfs o xfs.

Si falta algún requisito, Anvil conserva la selección guardada, pero desactiva OverlayFS en el diálogo y muestra el motivo. Los enlaces simbólicos siguen siendo el método seguro predeterminado.

OverlayFS también funciona cuando Anvil se ejecuta como Flatpak: el montaje y la configuración de polkit se ejecutan en el anfitrión mediante flatpak-spawn, incluida la regla sin contraseña una vez configurada.

Seguridad y solución de problemas

• Ejecuta las actualizaciones del juego y la verificación de archivos de Steam únicamente cuando OverlayFS esté desmontado.
• No modifiques manualmente la capa temporal, el directorio de trabajo ni la carpeta overwrite mientras el montaje esté activo.
• Si el juego no se cerró correctamente, comprueba primero si todavía se ejecuta algún proceso del juego o del lanzador.
• Si la contraseña sigue solicitándose después de la configuración, revisa de nuevo polkit en la pestaña Experto.
• Si Anvil informa de un sistema de archivos no compatible, mueve la carpeta overwrite a ext4, btrfs o xfs.
• Si hay problemas, vuelve a los enlaces simbólicos. Anvil desmonta cualquier OverlayFS existente antes de cambiar de método.

OverlayFS es opcional de forma deliberada. Las instancias existentes permanecen configuradas con enlaces simbólicos hasta que el usuario selecciona OverlayFS expresamente.