Cosa viene spostato
Tutto quello che sta dentro il Runtime Path: istanze (con i loro mod, mappe, config), asset condivisi di Minecraft, librerie condivise di Minecraft, installazioni Java scaricate da GDLauncher, database del launcher e log globali. In pratica tutto il grosso che GDLauncher ha creato sulla tua macchina. Cosa non si sposta: l'App Data Path (stato della finestra, cache di Electron, config di alto livello). Resta nella posizione standard del sistema, di solito non lo tocchi.
Quale dimensione aspettarsi
Un'installazione pulita senza istanze pesa circa 1 GB (soprattutto asset di Minecraft e un'installazione di Java). Ogni Modpack aggiunge più o meno la propria dimensione di download, quindi qualche pack grosso può superare facilmente i 50 GB. Guarda la dimensione del tuo percorso dati attuale nel file manager del sistema prima di spostare, così stimi quanto durerà la migrazione.
Se hai già spostato i dati a mano
Se hai copiato gdlauncher_carbon/data altrove a mano (senza passare dalle Settings), puoi far puntare GDLauncher alla nuova posizione. Quando inserisci un percorso che contiene già dati GDLauncher validi, la migrazione viene saltata, GDLauncher aggiorna solo la sua config. Comodo per passare a un'altra macchina e poi far puntare un'installazione fresca ai dati migrati.
Se la migrazione fallisce
Il modal di progresso mostra l'errore se qualcosa va storto a metà. Cause più comuni: spazio non sufficiente sulla destinazione (il disco destinazione deve avere almeno tanto spazio libero quanto la sorgente occupa, il messaggio indica i byte mancanti). Permesso negato (su Windows cartelle come Program Files o la root di C:\ richiedono privilegi admin, su Linux/macOS la destinazione deve stare in un percorso di cui sei proprietario, scegli una cartella utente). Destinazione in sola lettura (alcuni dischi di rete vengono montati read-only di default, prima verifica di poter creare file lì fuori da GDLauncher). Dopo una migrazione fallita GDLauncher torna alla posizione originale e mostra il messaggio di errore. Per i dettagli puoi leggere il file in __gdl_logs__.
Il marker runtime_path_override
Dopo uno spostamento andato a buon fine, GDLauncher scrive un piccolo file di testo chiamato runtime_path_override dentro l'App Data Path (non il Runtime Path). Il file contiene il nuovo Runtime Path, a ogni avvio viene letto per sapere dove vivono i dati. Se lo cancelli per sbaglio, il launcher torna alla posizione di default e non vede i tuoi dati spostati finché non vai in Settings → Runtime Path e ripunti la cartella in cui li hai spostati (verrà rilevata come 'già in uso' e si farà il passaggio senza copia).
Non sincronizzare il Runtime Path mentre giochi
OneDrive, iCloud, Dropbox e simili si contendono i file handle con GDLauncher. Se il Runtime Path è in una cartella che questi tool sincronizzano attivamente, ti ritrovi strani errori 'file in uso' e ogni tanto corruzione dei salvataggi. Metti il Runtime Path su un disco che viene backuppato offline (snapshot, restic, Backblaze), non su uno che sincronizza in continuazione.