Como compartilhar os logs do app GDLauncher ao reportar um problema

Qual log compartilhar

O GDLauncher escreve dois logs de nível app em arquivos diferentes. A maioria dos pedidos de suporte precisa dos dois:

• main.log: o log do processo main do Electron. Cobre tudo que o launcher faz antes e em volta do core Rust: criação de janela, IPC, auto-update, diálogos nativos, crashes pesados do shell desktop.
• __gdl_logs__/<timestamp>.log: o log do core Rust. Cobre o que o launcher realmente faz quando tá rodando: login de conta, downloads de assets, instalações de mod loader, execuções de instância, mudanças de configurações. Até dez arquivos ficam, o mais novo é o que você quer.

Na prática quase sempre precisamos dos dois. Pegue os dois arquivos antes de abrir um ticket, mesmo se você tem certeza que só um é relevante. As duas metades do launcher passam trabalho entre si o tempo todo, e a causa de uma falha de um lado costuma aparecer no log do outro.

Onde achar

Windows

Pasta app data: %APPDATA%\gdlauncher_carbon\

Jeito mais rápido: aperte Win+R, cole %APPDATA%\gdlauncher_carbon, Enter. O Explorer abre direto na pasta.

Dentro você vê:

• main.log: o log do Electron.
• data\__gdl_logs__\: os logs do core Rust.
• runtime_path_override (só se você moveu seus dados pra outro drive): um arquivo de texto de uma linha com o caminho pra sua pasta runtime customizada. Se estiver lá, olha nessa pasta custom por __gdl_logs__\ em vez da subpasta padrão data\.

macOS

Pasta app data: ~/Library/Application Support/gdlauncher_carbon/

No Finder, aperte Cmd+Shift+G, cole ~/Library/Application Support/gdlauncher_carbon, Enter. ~/Library fica oculta por padrão, o atalho Go-to-folder é o caminho mais fácil.

Estrutura igual ao Windows: main.log nessa pasta, logs do core Rust em data/__gdl_logs__/, arquivo runtime_path_override opcional se você moveu os dados.

Linux

Pasta app data: ~/.local/share/gdlauncher_carbon/ (ou $XDG_DATA_HOME/gdlauncher_carbon/ se você setou XDG_DATA_HOME).

A maioria dos gerenciadores de arquivos esconde pastas com ponto por padrão. Ative arquivos ocultos com Ctrl+H (Nautilus, Nemo, Dolphin), ou só cole o caminho na barra de localização.

Mesma estrutura: main.log na raiz, data/__gdl_logs__/ pros logs do core Rust, runtime_path_override opcional.

Se você moveu seu runtime path

O core Rust escreve os logs em <runtime_path>/__gdl_logs__/. Se você usou Settings → Runtime Path pra realocar seus dados (ex: outro drive), olha lá em vez de data/. O caminho exato é o valor dentro do arquivo runtime_path_override na pasta app data, ou só confere Settings → Runtime Path no launcher.

Como anexar

Pro Discord, arraste os dois arquivos pro canal do ticket. O limite de 25 MB é mais que suficiente, logs de app costumam ficar bem abaixo de 1 MB cada. Pro GitHub, abra uma issue nova e arraste os arquivos pro comentário, o GitHub sobe como attachment. Pro Reddit, cole primeiro no gist.github.com e depois linka o gist.

Não cola o conteúdo no chat como muro de texto. Pastes longos são truncados, perdem quebras de linha e ficam ilegíveis no mobile. Anexos de arquivo mantêm o formato original e deixam quem tá ajudando pesquisar dentro do arquivo.

mclo.gs foi feito pra logs de jogo do Minecraft (os dentro de uma instância), não cai bem pra logs de nível app porque remove timestamps e funde stack traces de várias linhas. Pra logs de app, use Discord, GitHub ou um gist.

O que é seguro compartilhar

Os logs contêm seu sistema operacional, GPU, versão do launcher, seu nome de usuário e UUID do Minecraft (ambos já públicos) e caminhos de arquivo absolutos. A parte de home-directory desses caminhos inclui seu nome de usuário do OS. Se é seu nome real e você prefere não compartilhar, faça um find-and-replace rápido no arquivo antes de anexar: troque C:\Users\YourName (ou /home/yourname, /Users/yourname) por algo neutro tipo C:\Users\user.

Credenciais não são escritas em nenhum dos arquivos de log. Tokens de acesso e refresh do Microsoft, o token de backend GDL, o token de API local e seu endereço de e-mail ficam todos fora da saída do arquivo. O launcher registra que rolou um refresh ou login, mas nunca o valor do token. O comando de lançamento do Minecraft é registrado com --accessToken trocado por <REDACTED>. Não precisa limpar o arquivo antes de compartilhar.

Procurando logs de jogo ou crash reports?

Logs de app cobrem o launcher. Se o Minecraft em si crasha ou faz coisa estranha, você quer o log de jogo por instância ou o crash report. Veja o guia Achar logs e crash reports pra isso.