Bonsaibauer: Importing a new version from external source

2026-11-07T01:34:28Z

Importing a new version from external source

New page

<languages />



[[File:ShroudForge-Wiki-game-profile-discovery.svg|thumb|left|600px|Automatic beta game profiles]]

 

La ricerca beta facoltativa confronta una nuova versione del gioco con una versione supportata salvata. Crea un profilo beta completo solo se sono disponibili le prove necessarie. I profili di gioco regolari corrispondenti hanno la precedenza.


== Prepararsi prima di un aggiornamento del gioco ==

Il modulo è abilitato per impostazione predefinita e può essere disattivato. Un'impostazione disabilitata salvata esplicitamente resta disattivata. L'interruttore si trova in '''Settings → General → Game profile''', accanto al selettore dei profili.

# Verifica che '''Dynamic game profile creation (Beta)''' sia abilitato. Attivalo se necessario.
# Riavvia completamente il gioco o il server dedicato mentre è ancora disponibile un profilo regolare corrispondente.
# ShroudForge verifica l'eseguibile corrente esatto e lo salva nella cache come base di confronto. Non è necessario scaricare un eseguibile storico.
# Dopo un aggiornamento successivo, il nuovo processo di gioco avvia automaticamente il confronto e usa la base salvata.

Il client e il server dedicato conservano basi separate. Un client non può sostituire la base del server. Se il modulo viene abilitato per la prima volta dopo un aggiornamento e non è stata salvata una base corrispondente, non può ricostruire la versione precedente.


== Cosa succede all'avvio del gioco ==

L'analisi viene eseguita durante l'avvio del gioco. Il gioco attende il risultato prima di continuare l'avvio. Per questa fase non è necessario caricare un mondo.

ShroudForge cerca prima un profilo regolare corrispondente all'eseguibile esatto in esecuzione. Se ne esiste uno, la selezione automatica lo usa. Quando la ricerca è abilitata, memorizza anche nella cache l'eseguibile supportato per gli aggiornamenti futuri.

Se non esiste un profilo regolare corrispondente, il modulo controlla la base regolare idonea più recente per lo stesso processo di destinazione e formato KFC. L'eseguibile salvato in precedenza deve corrispondere esattamente a quella base. Il confronto verifica codice, riferimenti, tipi registrati e contratti strutturali richiesti usando le immagini di confronto. Gli indirizzi di destinazione devono essere stabiliti dalla nuova immagine.

Il risultato mantiene l'intero contratto del profilo precedente, incluse le relative funzionalità. Prove irrisolte o in conflitto impediscono la pubblicazione dell'intero profilo beta. La diagnostica ne indica il motivo. Attendere più a lungo o entrare in un mondo non risolve l'assenza di prove statiche.


== Archiviazione e selezione ==

I profili regolari e quelli generati condividono la directory dei profili configurata. I percorsi predefiniti sono:

{| class="wikitable"
! Contenuto !! Posizione
|-
| Profili client || <code>shroudforge/runtime/profiles/enshrouded/client/</code>
|-
| Profili server || <code>shroudforge/runtime/profiles/enshrouded/server/</code>
|-
| Immagini di confronto e prove salvate || <code>shroudforge/cache/game-profile-discovery/</code>
|}

I profili generati iniziano con <code>beta_</code>. La selezione '''Automatic''' può usare un profilo beta corrispondente completamente verificato quando non è disponibile un profilo regolare corrispondente. Il selettore mostra i profili disponibili. Un profilo regolare corrispondente aggiunto in seguito ha la precedenza.

La modifica dell'interruttore o della selezione del profilo richiede il riavvio completo del gioco o del server interessato. Riaprire la finestra Modloader non riavvia il runtime.


== Distinguere ricerca, profili e mondo in esecuzione ==

L'avviso blu '''Dynamic profile search in progress''' indica che è in corso una ricerca del profilo. '''Workflow and help''' apre questa guida. Se la ricerca termina senza un profilo corrispondente, il problema viene mostrato in rosso. L'avviso arancione '''Experimental game profile active''' identifica il profilo beta effettivamente selezionato. Gli errori effettivi del runtime continuano a essere mostrati come errori.

I controlli strutturali dell'eseguibile non richiedono un mondo caricato. Le operazioni dipendenti dal mondo richiedono inoltre i relativi contesti attivi, registrazioni e controlli di sicurezza del runtime. Un profilo generato non dimostra che siano stati eseguiti comandi di gioco o che abbiano prodotto effetti visibili. Anche le verifiche funzionali devono testare client e server separatamente.

Se non viene generato alcun profilo, leggi il motivo e i dettagli tecnici riportati. Una base salvata mancante, un profilo sorgente non idoneo o prove irrisolte sul codice e sulla disposizione richiedono ciascuno l'input pertinente o ulteriori analisi. Un profilo regolare corrispondente o un aggiornamento ShroudForge adatto può fornire supporto.


== Registrazione dettagliata ==

Debug Console mostra i messaggi di ricerca del log principale con la sorgente <code>game-profile-discovery</code>. Per visualizzare ogni confronto e campo di rebase, imposta '''Settings → General → Logging → Minimum level''' su '''Diagnostic'''. '''Advanced''' mostra ulteriori riepiloghi.

Il banner runtime rosso e la voce di log <code>[compatibility-check] check=runtime</code> provengono dallo stesso controllo runtime. L'aggiornamento UI esistente registra il cambio di stato prima di inviare lo stesso stato al Modloader. Debug Console applica l'impostazione popup esistente alle righe di avviso ed errore di quel log principale.

In caso di errore, il log principale fornisce il percorso del rapporto corrente <code>''.v2.unresolved.json</code> o <code>''.v2.error.json</code>. In caso di successo, indica il percorso delle prove <code>''.v2.proof.json</code> e il percorso completo di salvataggio del profilo generato <code>beta_''.json</code>. I rapporti sono archiviati nella cache di ricerca.


== Linux e Proton ==

La ricerca viene eseguita nel modulo runtime nativo e non richiede programmi PowerShell o Python esterni. Questo flusso di lavoro non è ancora stato testato dal vivo con Proton.

Per informazioni su runtime, API delle mod e parser, consulta [[Special:MyLanguage/Engine|Motore]].

[[Category:guide:Shroudforge]]

Automatic beta game profiles/it - Revision history

Bonsaibauer: Importing a new version from external source