Come fare il backup di GDLauncher prima di formattare il PC

Cosa devi salvare davvero

Una cartella sola: il runtime path. Dentro ci sono tutte le istanze (con mod, mondi, config, screenshot, dati dei mondi), gli asset condivisi di Minecraft, le libraries condivise, i runtime Java scaricati da GDLauncher, il database SQLite del launcher (gdl_conf.db) con account e impostazioni, e i log a livello app sotto __gdl_logs__/. Fai il backup di quella cartella e hai tutto quello che conta.

Non serve salvare la cartella dati di Electron. Contiene solo roba che il launcher ricostruisce al primo avvio: posizione della finestra, cache interne, cose così. Saltarla non ti costa niente.

Trovare il tuo runtime path

Il modo più semplice: apri GDLauncher, vai in Settings → Runtime Path e copia il percorso mostrato. Quella è la fonte affidabile, che tu l'abbia mai spostato o no.

Se GDLauncher non si apre più (disco che sta morendo, sistema rotto), la posizione di default è:

• Windows: %APPDATA%\gdlauncher_carbon\data (incollalo in Win+R o nella barra degli indirizzi di Esplora file).
• macOS: ~/Library/Application Support/gdlauncher_carbon/data (Finder → Cmd+Shift+G, incolla, Invio).
• Linux: ~/.local/share/gdlauncher_carbon/data (oppure $XDG_DATA_HOME/gdlauncher_carbon/data se hai impostato XDG_DATA_HOME).

Se hai spostato il runtime path dalle impostazioni, la cartella di default qui sopra sarà vuota o non ci sarà proprio, e un file chiamato runtime_path_override lì accanto punta alla posizione reale. Aprilo con un editor di testo qualsiasi: la sua unica riga è il percorso assoluto dei tuoi dati.

Fare il backup

Prima chiudi GDLauncher. Il database SQLite nel runtime path si copia senza rischi a launcher chiuso, ma può darti una copia corrotta se lo prendi mentre ci sta scrivendo.

Poi copia la cartella del runtime path, con la struttura intatta, dove vuoi tenere il backup. Un altro disco, una chiavetta, un NAS, un archivio cloud offline: la destinazione non conta, basta che non sia il disco che stai per cancellare.

Ripristinare dopo la formattazione

Sul sistema appena installato:

1. Installa GDLauncher. Avvialo una volta e chiudilo, così crea le cartelle di default.
2. Copia la cartella del runtime path che hai salvato nella sua posizione definitiva sul sistema nuovo. Può essere lo stesso disco e percorso di prima, o un posto diverso (un disco più capiente, per dire).
3. Riapri GDLauncher. Vai in Settings → Runtime Path e puntalo alla cartella appena ripristinata. Quando punti a una cartella che contiene già dati GDLauncher validi, il launcher se ne accorge e ci passa senza copiare né duplicare nulla.
4. Riavvia il launcher. Istanze, account, impostazioni e installazioni Java sono tutte tornate.

Cosa c'è nel backup e cosa no

Si conserva salvando il runtime path:

• Tutte le istanze: mod, config, mondi salvati, screenshot, resource pack, shader pack, datapack.
• Gli account Microsoft con cui hai fatto l'accesso (salvati nel database del launcher, token compresi). Al primo avvio potrebbero doversi rinfrescare, ma non dovrai rifare il login.
• Le impostazioni: tema, lingua, argomenti Java di default, memoria di default, il runtime path stesso.
• Le installazioni Java scaricate da GDLauncher. Puoi anche saltarle e lasciare che GDLauncher le riscarichi al primo avvio: backup più veloce in cambio di un download una tantum.
• I log a livello app e quelli per istanza.

Non si conserva (e non ti serve):

• Lo stato della finestra di Electron (dimensione, posizione). Il launcher riparte semplicemente dai suoi default.
• Le voci nel portachiavi di sistema: GDLauncher gestisce gli account nel proprio database.

Backup minimo se sei a corto di spazio

Se il runtime path intero non ci sta, copia solo <runtime_path>/instances/ e <runtime_path>/gdl_conf.db. In instances ci sono mondi e config, nel database account e impostazioni. Perdi gli asset di Minecraft, le libraries e le installazioni Java in cache, ma quelli si riscaricano al primo avvio.

Per il minimo assoluto, copia la sottocartella instance/saves/ di ogni istanza. Sono solo i file dei mondi. Perdi la configurazione dell'istanza (lista mod, versione, modloader) ma i dati dei mondi sopravvivono e potrai caricarli in seguito in un'istanza creata da zero.

Se oltre a formattare cambi anche disco o PC

Stesso backup, ripristino sulla macchina nuova. I dati runtime di GDLauncher si spostano bene all'interno della stessa famiglia di sistemi. Windows → Windows o Linux → Linux funziona direttamente. Passando tra Windows ↔ macOS ↔ Linux continuano a funzionare mondi, config, resource pack e la maggior parte delle mod, ma il launcher rileverà di nuovo Java (binari diversi per sistema) e potrebbe riscaricare librerie native al primo avvio.

Vedi anche: Spostare i dati di GDLauncher su un altro disco per il modo integrato nell'app, senza copia-incolla a mano.

Non sincronizzare il runtime path mentre giochi

OneDrive, iCloud, Dropbox, Google Drive desktop e simili si contendono i file handle con GDLauncher. Dopo il ripristino non mettere il runtime path dentro una cartella che questi tool sincronizzano attivamente: ti ritrovi errori "file in uso" e ogni tanto salvataggi corrotti. Tieni il runtime path su un normale disco locale e fanne il backup separatamente.