Deployment Methods ‐ italiano

Metodi di distribuzione e OverlayFS

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

Anvil può distribuire le mod in due modi. La scelta viene salvata separatamente per ogni istanza di gioco in Impostazioni → Esperto → Distribuzione delle mod.

Confronto

	Link simbolici (predefinito)	OverlayFS (sperimentale)
Cartella del gioco	Anvil crea collegamenti ai file delle mod	La cartella del gioco invariata viene coperta da un livello di mod
Privilegi di sistema	Non necessari	Necessari per montare e smontare il livello
Metodi di avvio	Tramite Anvil; direttamente da Steam con la distribuzione permanente	Qualsiasi metodo mentre il livello è montato
Scritture del gioco	Vanno nella normale cartella del gioco	Vanno nella cartella overwrite configurata
Pulizia	I collegamenti vengono rimossi dopo la chiusura del gioco	Il mount del kernel e il livello temporaneo vengono rimossi dopo la chiusura del gioco
«Mantieni le mod nella cartella del gioco»	Disponibile	Nascosto e sempre disattivato

Link simbolici

I link simbolici sono il metodo predefinito. Anvil crea nella cartella del gioco collegamenti ai file delle mod attive. I conflitti seguono l’ordine dell’elenco delle mod: una mod più in alto ha una priorità maggiore.

Dopo una sessione di gioco monitorata normalmente, Anvil rimuove i collegamenti. L’archivio originale delle mod non viene modificato.

Mantieni le mod nella cartella del gioco

Questa opzione è disponibile solo con i link simbolici. Quando è attiva, i collegamenti rimangono dopo la chiusura del gioco e di Anvil. Il gioco può quindi essere avviato con le mod direttamente da Steam o da un altro launcher.

Informazioni importanti:

• L’opzione si applica solo all’istanza di gioco corrente.
• Anvil la disattiva quando si passa a un’altra istanza.
• Un aggiornamento del gioco o la verifica dei file può sostituire o rimuovere i collegamenti. In seguito è necessario distribuire nuovamente le mod tramite Anvil.
• Non spostare o eliminare la cartella dati di Anvil mentre i collegamenti sono distribuiti.
• Disattiva l’opzione prima di avviare il gioco senza mod.

OverlayFS

OverlayFS è una funzionalità del kernel Linux. Anvil monta una vista unificata direttamente sulla cartella di gioco configurata:

cartella del gioco visibile
├─ livello delle mod del profilo attivo
├─ cartella originale del gioco
└─ scritture durante l’esecuzione → cartella overwrite

I file originali del gioco non vengono sostituiti. Mentre il mount è attivo, Steam, Proton e il gioco vedono la vista unificata. Funziona quindi qualsiasi metodo di avvio, incluso l’avvio diretto da Steam.

Procedura

1. Anvil legge il profilo, l’ordine delle mod e le regole di distribuzione specifiche del gioco.
2. Crea un nuovo livello temporaneo dalle mod attive.
3. Monta il livello sulla cartella del gioco prima dell’avvio.
4. Le scritture del gioco vanno nella cartella overwrite configurata.
5. Solo dopo la chiusura del processo reale del gioco, Anvil smonta OverlayFS e rimuove il livello temporaneo.

L’opzione «Mantieni le mod nella cartella del gioco» viene nascosta con OverlayFS e salvata come false. Un mount globale del kernel non deve rimanere attivo senza che l’utente lo sappia come vecchio stato permanente.

Perché è necessaria una password?

Montare e smontare un filesystem del kernel richiede privilegi di sistema su Linux. La richiesta della password proviene da pkexec/polkit, non da Anvil. Anvil non memorizza mai la password.

Senza una configurazione aggiuntiva, il sistema richiede l’autorizzazione durante la distribuzione. «Configura montaggio senza password…» installa una sola volta:

• l’helper di proprietà di root /usr/local/libexec/anvil-overlay-mount;
• una regola polkit per l’utente Linux corrente.

Successivamente, solo questo helper fisso può essere eseguito senza un’altra richiesta di password. Anvil non autorizza deliberatamente script modificabili dall’utente.

Requisiti

OverlayFS è disponibile solo quando i controlli hanno esito positivo:

• Il kernel in esecuzione supporta OverlayFS o fornisce un modulo overlay caricabile.
• pkexec/polkit è installato.
• I percorsi del gioco e dell’istanza sono accessibili.
• La cartella overwrite si trova su un filesystem Linux supportato, ad esempio ext4, btrfs o xfs.

Se manca un requisito, Anvil conserva la scelta salvata, ma disattiva OverlayFS nella finestra e mostra il motivo. I link simbolici rimangono il metodo sicuro predefinito.

OverlayFS funziona anche quando Anvil viene eseguito come Flatpak: il mount e la configurazione di polkit vengono eseguiti sull'host tramite flatpak-spawn, inclusa la regola senza password una volta configurata.

Sicurezza e risoluzione dei problemi

• Esegui gli aggiornamenti del gioco e la verifica dei file di Steam solo quando OverlayFS è smontato.
• Non modificare manualmente il livello temporaneo, la directory di lavoro o la cartella overwrite mentre il mount è attivo.
• Se il gioco non si è chiuso correttamente, controlla prima se è ancora in esecuzione un processo del gioco o del launcher.
• Se la password viene ancora richiesta dopo la configurazione, controlla di nuovo polkit nella scheda Esperto.
• Se Anvil segnala un filesystem non supportato, sposta la cartella overwrite su ext4, btrfs o xfs.
• In caso di problemi, torna ai link simbolici. Anvil smonta un OverlayFS esistente prima di cambiare metodo.

OverlayFS è volutamente opzionale. Le istanze esistenti rimangono configurate con i link simbolici finché l’utente non seleziona esplicitamente OverlayFS.