Quale log condividere
GDLauncher scrive due log a livello app in file diversi. La maggior parte delle richieste di supporto ne ha bisogno entrambi:
main.log: il log del processo main di Electron. Copre tutto quello che il launcher fa prima e attorno al core Rust: creazione delle finestre, IPC, auto-update, dialog nativi, crash duri della shell desktop.__gdl_logs__/<timestamp>.log: il log del core Rust. Copre quello che il launcher fa davvero una volta in esecuzione: login account, download degli asset, installazione dei mod loader, lancio di istanze, modifiche alle impostazioni. Ne vengono conservati fino a dieci file, il più recente è quello che ti serve.
In pratica quasi sempre ci servono entrambi. Prendi tutti e due i file prima di aprire un ticket, anche se sei sicuro che ne serva solo uno. Le due metà del launcher si scambiano lavoro di continuo, e la causa di un guasto da una parte spesso emerge nel log dell'altra.
Dove trovarli
Windows
Cartella App data: %APPDATA%\gdlauncher_carbon\
Il modo più rapido per entrarci: premi Win+R, incolla %APPDATA%\gdlauncher_carbon, Invio. Explorer si apre direttamente in quella cartella.
Dentro trovi:
main.log: il log di Electron.data\__gdl_logs__\: i log del core Rust.runtime_path_override(solo se hai spostato i dati su un altro disco): un file di testo di una riga con il percorso della tua cartella runtime custom. Se c'è, guarda in quella cartella custom per__gdl_logs__\invece che nella sottocartelladata\di default.
macOS
Cartella App data: ~/Library/Application Support/gdlauncher_carbon/
Nel Finder premi Cmd+Shift+G, incolla ~/Library/Application Support/gdlauncher_carbon, Invio. ~/Library è nascosta di default, la scorciatoia Go-to-folder è il modo più semplice.
Struttura identica a Windows: main.log in questa cartella, log del core Rust sotto data/__gdl_logs__/, file runtime_path_override opzionale se hai spostato i dati.
Linux
Cartella App data: ~/.local/share/gdlauncher_carbon/ (oppure $XDG_DATA_HOME/gdlauncher_carbon/ se hai impostato XDG_DATA_HOME).
La maggior parte dei file manager nasconde di default le cartelle che iniziano con un punto. Attiva i file nascosti con Ctrl+H (Nautilus, Nemo, Dolphin), oppure incolla direttamente il percorso nella barra dell'indirizzo.
Stessa struttura: main.log nella root, data/__gdl_logs__/ per i log del core Rust, runtime_path_override opzionale.
Se hai spostato il tuo runtime path
Il core Rust scrive i suoi log in <runtime_path>/__gdl_logs__/. Se hai usato Settings → Runtime Path per spostare i dati (per esempio su un altro disco), guarda lì invece che in data/. Il percorso esatto è il valore dentro il file runtime_path_override nella cartella App data, oppure controlla direttamente Settings → Runtime Path nel launcher.
Come allegarli
Su Discord trascina entrambi i file nel canale del ticket. Il limite di 25 MB è abbondante, i log dell'app stanno di solito ben sotto 1 MB l'uno. Su GitHub apri una nuova issue e trascina i file nel commento, GitHub li carica come allegati. Su Reddit incolla prima su gist.github.com, poi linka il gist.
Non incollare il contenuto in chat come muro di testo. I paste lunghi vengono troncati, perdono le interruzioni di riga e sono illeggibili su mobile. Gli allegati mantengono la formattazione originale e permettono a chi aiuta di cercare dentro il file.
mclo.gs è pensato per i log di gioco di Minecraft (quelli dentro un'istanza), non va bene per i log a livello app perché rimuove i timestamp e accorpa le stack trace su più righe. Per i log dell'app usa Discord, GitHub o un gist.
Cosa è sicuro condividere
I log contengono il tuo sistema operativo, la GPU, la versione del launcher, nome utente Minecraft e UUID (entrambi già pubblici) e percorsi di file assoluti. La parte della home directory in quei percorsi contiene il tuo nome utente dell'OS. Se è il tuo nome vero e preferisci non condividerlo, fai un find-and-replace veloce sul file prima di allegarlo: sostituisci C:\Users\YourName (oppure /home/yourname, /Users/yourname) con qualcosa di neutro come C:\Users\user.
Le credenziali non vengono scritte in nessuno dei file di log. Access token e refresh token di Microsoft, il token del backend GDL, il token dell'API locale e l'indirizzo email vengono tutti tenuti fuori dall'output su file. Il launcher registra che è avvenuto un refresh o un login, ma mai il valore del token. Il comando di lancio di Minecraft viene loggato con --accessToken sostituito da <REDACTED>. Non c'è bisogno di ripulire il file prima di condividerlo.
Cerchi i log di gioco o i crash report?
I log dell'app coprono il launcher. Se è Minecraft stesso a crashare o a comportarsi male, ti serve invece il log di gioco per istanza o il crash report. Vedi la guida Trovare i log e i crash report per quello.