Deployment Methods ‐ français

Méthodes de déploiement et OverlayFS

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

Anvil peut déployer les mods de deux manières. Le choix est enregistré séparément pour chaque instance de jeu dans Paramètres → Expert → Déploiement des mods.

Comparaison

	Liens symboliques (par défaut)	OverlayFS (expérimental)
Dossier du jeu	Anvil crée des liens vers les fichiers des mods	Le dossier du jeu inchangé est recouvert par une couche de mods
Droits système	Non requis	Requis pour monter et démonter la couche
Méthodes de lancement	Via Anvil ; directement via Steam avec le déploiement permanent	Toutes les méthodes tant que la couche est montée
Écritures du jeu	Vont dans le dossier normal du jeu	Vont dans le dossier overwrite configuré
Nettoyage	Les liens sont supprimés après la fermeture du jeu	Le montage du noyau et la couche temporaire sont supprimés après la fermeture du jeu
« Conserver les mods dans le dossier du jeu »	Disponible	Masqué et toujours désactivé

Liens symboliques

Les liens symboliques sont la méthode par défaut. Anvil crée dans le dossier du jeu des liens vers les fichiers des mods actifs. Les conflits suivent l’ordre de la liste des mods : un mod placé plus haut a une priorité supérieure.

Après une session de jeu surveillée normalement, Anvil supprime les liens. Le stockage d’origine des mods n’est pas modifié.

Conserver les mods dans le dossier du jeu

Cette option est disponible uniquement avec les liens symboliques. Lorsqu’elle est activée, les liens restent en place après la fermeture du jeu et d’Anvil. Le jeu peut alors être lancé avec les mods directement via Steam ou un autre lanceur.

À retenir :

• L’option s’applique uniquement à l’instance de jeu actuelle.
• Anvil la désactive lors du passage à une autre instance.
• Une mise à jour du jeu ou une vérification des fichiers peut remplacer ou supprimer les liens. Il faut ensuite redéployer avec Anvil.
• Ne déplacez et ne supprimez pas le dossier de données d’Anvil tant que les liens sont déployés.
• Désactivez l’option avant de lancer le jeu sans mods.

OverlayFS

OverlayFS est une fonction du noyau Linux. Anvil monte une vue fusionnée directement sur le dossier du jeu configuré :

dossier du jeu visible
├─ couche de mods du profil actif
├─ dossier du jeu d’origine
└─ écritures pendant l’exécution → dossier overwrite

Les fichiers d’origine du jeu ne sont pas remplacés. Tant que le montage est actif, Steam, Proton et le jeu voient la vue fusionnée. Toutes les méthodes de lancement fonctionnent donc, y compris un lancement direct via Steam.

Déroulement

1. Anvil lit le profil, l’ordre des mods et les règles de déploiement propres au jeu.
2. Il construit une nouvelle couche temporaire à partir des mods actifs.
3. Il monte cette couche sur le dossier du jeu avant le lancement.
4. Les écritures du jeu vont dans le dossier overwrite configuré.
5. Anvil démonte OverlayFS et supprime la couche temporaire seulement après la fermeture du véritable processus du jeu.

L’option « Conserver les mods dans le dossier du jeu » est masquée avec OverlayFS et enregistrée comme false. Un montage global du noyau ne doit pas rester actif à l’insu de l’utilisateur comme un ancien état permanent.

Pourquoi un mot de passe est-il nécessaire ?

Monter et démonter un système de fichiers du noyau nécessite des droits système sous Linux. La demande de mot de passe provient de pkexec/polkit, pas d’Anvil. Anvil ne stocke jamais le mot de passe.

Sans configuration supplémentaire, le système demande une autorisation lors du déploiement. « Configurer le montage sans mot de passe… » installe une seule fois :

• l’assistant appartenant à root /usr/local/libexec/anvil-overlay-mount ;
• une règle polkit pour l’utilisateur Linux actuel.

Après cette configuration, seul cet assistant fixe peut être exécuté sans nouvelle demande de mot de passe. Anvil n’autorise volontairement aucun script modifiable dans le dossier utilisateur.

Conditions requises

OverlayFS est disponible uniquement si les vérifications réussissent :

• Le noyau actif prend en charge OverlayFS ou fournit un module overlay chargeable.
• pkexec/polkit est installé.
• Les chemins du jeu et de l’instance sont accessibles.
• Le dossier overwrite se trouve sur un système de fichiers Linux pris en charge, par exemple ext4, btrfs ou xfs.

Si une condition manque, Anvil conserve le choix enregistré, mais désactive OverlayFS dans le dialogue et affiche la raison. Les liens symboliques restent la méthode sûre par défaut.

OverlayFS fonctionne aussi lorsque Anvil tourne en Flatpak : le montage et la configuration polkit sont exécutés sur l'hôte via flatpak-spawn, y compris la règle sans mot de passe une fois configurée.

Sécurité et dépannage

• Effectuez les mises à jour du jeu et la vérification des fichiers Steam uniquement lorsque OverlayFS est démonté.
• Ne modifiez jamais manuellement la couche temporaire, le dossier de travail ou le dossier overwrite pendant que le montage est actif.
• Si le jeu ne s’est pas fermé correctement, vérifiez d’abord si un processus du jeu ou du lanceur fonctionne encore.
• Si le mot de passe est toujours demandé après la configuration, vérifiez à nouveau polkit dans l’onglet Expert.
• Si Anvil signale un système de fichiers non pris en charge, déplacez le dossier overwrite vers ext4, btrfs ou xfs.
• En cas de problème, revenez aux liens symboliques. Anvil démonte une couche OverlayFS existante avant de changer de méthode.

OverlayFS est volontairement facultatif. Les instances existantes restent configurées avec les liens symboliques jusqu’à ce que l’utilisateur sélectionne explicitement OverlayFS.