Ajuda

Instalar

Windows

Prefere sem aviso? Instale o mesmo aplicativo pela Microsoft Store: assinado, e a Store o mantém atualizado. Ou:

1. Baixe o instalador, um arquivo terminado em .exe.
2. Abra-o. Se o Windows disser O Windows protegeu o computador, clique em Mais informações e depois em Executar assim mesmo. O instalador ainda não tem assinatura de código, então o SmartScreen do Microsoft Defender o bloqueia na primeira vez.
3. Escolha o idioma, English ou Português (Brasil). O aplicativo abre no mesmo.
4. Na última página, escolha se o Sensei Top abre quando o Windows iniciar. Deixe ligado se puder: o aplicativo só registra os jogos enquanto está rodando.

Ele é instalado só para o seu usuário do Windows e nunca pede permissão de administrador. Fechar a janela deixa o aplicativo rodando na bandeja do sistema, ainda registrando; para sair, use o menu do ícone na bandeja.

Linux e Steam Deck

1. Baixe o AppImage, um arquivo terminado em .AppImage, e mova-o para uma pasta sua, como Applications na sua pasta pessoal. Ele se atualiza substituindo esse arquivo, então deixe-o num lugar onde você possa escrever.
2. Abra as propriedades do arquivo, permita que ele seja executado como programa e clique duas vezes nele. No Steam Deck, faça isso no modo desktop.

Se o AppImage não abrir no seu sistema, também há um .tar.gz: descompacte-o e execute o sensei-top que está dentro da pasta. Ele nunca se atualiza sozinho nem pode abrir quando você entra no computador; o guia de instalação (em inglês) tem os passos.

No Linux, fechar a janela encerra o aplicativo, e os jogos que você jogar depois não são registrados. Para mantê-lo rodando, ligue Continuar rodando com a janela fechada em Configurações, na seção Geral. Se o aplicativo não abrir, o guia de instalação (em inglês) tem a solução para cada sistema.

A primeira vez

Na primeira vez que abre, o aplicativo guia você pela configuração, um passo curto de cada vez:

1. Boas-vindas ao Sensei Top: escolha o Idioma, inglês ou português. O que sai deste computador abre a lista de tudo o que o aplicativo baixa. Se você já usou o Sensei Top antes, Entrar com o Google ou Entrar com o Discord traz de volta as partidas do backup da sua conta, e Restaurar de um arquivo de backup traz de volta um arquivo de backup.
2. Onde você joga?: Arena, Magic Online ou Nos dois. Os próximos passos configuram só o que você escolher.
3. Arena: o aplicativo procura o log do Arena e confere se os Registros detalhados estão ligados. Se não estiverem, o passo mostra onde ligá-los: no Arena, abra Opções, depois Conta, marque Registros detalhados (suporte de plugin), feche o Arena e abra-o de novo, e então aperte Verificar de novo. Sem os Registros detalhados, nenhuma partida do Arena é registrada.
4. Magic Online: veja abaixo.
5. Pronto: jogue uma partida. Ela aparece no Início quando termina. Onde o aplicativo pode se atualizar sozinho, este passo tem Verificar uma vez por dia se há uma nova versão; com o AppImage do Linux, também oferece Abrir o Sensei Top ao entrar no computador. Ele também pergunta se você quer ajudar a montar as estatísticas, como explicado abaixo.

Os dados dos cards, cerca de 80 MB, são baixados sozinhos na primeira vez que o aplicativo abre, e o passo Pronto mostra quanto já foi baixado. Os guias de deck precisam deles. Depois disso, o aplicativo baixa os dados de novo sozinho uma vez por dia, e poucos minutos depois de uma atualização do Arena que traga cards novos. Se o download falhar, aperte Tentar de novo ali, ou Baixar dados dos cards em Configurações, na seção Fontes.

Se você joga Arena, o Início mostra Ligue os Registros detalhados no Arena até que o log do Arena diga que eles estão ligados, com os mesmos passos e Verificar de novo. O Arena só escreve essa linha ao iniciar, então abra o Arena de novo antes de verificar.

Para passar pelos passos de novo, abra Configurações, depois Geral, e aperte Passar por eles de novo.

Deixe o aplicativo rodando enquanto joga. O Arena esvazia o log toda vez que abre e guarda a sessão anterior só até abrir de novo. Uma sessão jogada com o Sensei Top fechado se perde depois de duas aberturas do Arena. Abrir quando o Windows iniciar, ou Abrir quando você entrar no computador com o AppImage do Linux, na seção Geral das Configurações, resolve isso.

Magic Online

O log do Magic Online nunca diz qual jogador é você nem qual deck você jogou, então o aplicativo precisa de duas coisas suas, no passo de boas-vindas ou depois em Configurações, na seção Fontes:

• Seu nome no Magic Online, para distinguir os seus jogos dos de seus oponentes.
• A Pasta dos logs de jogo, onde o Magic Online escreve arquivos chamados Match_GameLog. No Windows, quando o aplicativo encontra a pasta em que o Magic Online está escrevendo, ele a preenche para você salvar. Se não, ela fica em AppData\Local\Apps\2.0\Data; no Wine ou no Proton, dentro da pasta drive_c desse prefixo.
• Opcionalmente, a Pasta dos decks, para onde você exporta decks do Magic Online como arquivos .dek. O aplicativo já lê os decks que o Magic Online guarda ao lado dos logs de jogo; esta pasta acrescenta os que você exporta.

Cada jogo é lido quando termina. O Magic Online muda essa pasta de lugar quando se atualiza; se jogos novos pararem de aparecer, escolha a pasta de novo em Configurações, na seção Fontes.

Uma partida do Magic Online conta para um dos seus decks depois que você escolhe o deck. Abra a partida e responda Qual deck foi este?; com muitas partidas esperando, use o card Precisa de um deck no Início. Ele agrupa as partidas pelo deck salvo no Magic Online que tem mais cards dos que você jogou, e uma confirmação escolhe esse deck para o grupo inteiro. Partidas do Magic Online nunca aparecem em Ao vivo, que acompanha só o Arena.

Conta

A conta é gratuita e opcional, e o Sensei Top funciona do mesmo jeito sem ela. Com ela, você pode fazer backup do seu histórico de partidas, levá-lo para outro computador e escolher se envia relatórios de erro. Cada uma dessas coisas é um sim à parte, e nada vem escolhido.

Entrar

Abra Configurações, depois Conta, e aperte Entrar com o Google ou Entrar com o Discord. O login termina no seu navegador, não no aplicativo, que espera até 5 minutos. Não há senha do Sensei Top.

Na primeira vez, alguns passos curtos pedem que você confirme a sua idade (13 anos ou mais e, se tiver menos de 18, com a permissão de um dos seus pais ou do seu responsável) e depois fazem três perguntas: se faz backup do seu histórico de partidas, se envia relatórios de erro e se guarda o seu histórico com o treinador de regras, que chega numa versão futura. Nada vem marcado, e você pode mudar cada resposta depois em Configurações: o backup na seção Backup, as outras duas na seção Conta. Se preferir não ter conta, Pular e não criar uma conta pula as três, apaga a conta que acabou de ser criada e sai dela.

Fazer backup e levar para outro computador

Com Fazer backup do meu histórico de partidas ligado, um resumo de cada partida é enviado: quando foi jogada, o formato, o seu deck, o resultado e os cards do oponente que você viu. Os seus logs do Arena e do Magic Online, nomes e chat nunca são enviados. Uma partida do Magic Online só entra no backup depois que você escolhe o deck dela. O banco de dados do seu computador continua sendo o original; a cópia na nuvem é um backup. A chave fica em Configurações, em Backup, em Cópia na nuvem.

Para levar o seu histórico para outro computador, instale o Sensei Top nele e entre com a mesma conta. As suas respostas vêm com a conta, então o backup também fica ligado lá, e as partidas salvas a partir dos seus outros computadores são baixadas nele. Em Partidas, uma partida que veio da nuvem, e da qual este computador não tem o log, aparece marcada como Restaurada. Ela não tem relatório nem replay turno a turno, porque eles são lidos do log do jogo, que fica no computador em que ele foi jogado.

Exportar e apagar

Em Configurações, na seção Conta:

• Exportar meus dados na nuvem salva tudo o que há na sua conta num arquivo JSON, onde você escolher.
• Apagar histórico na nuvem desliga o backup e então apaga as partidas salvas na sua conta. Se você religar o backup, todas as partidas deste computador são enviadas outra vez.
• Apagar conta apaga a sua conta e tudo o que há nela, e sai da conta neste computador.
• Sair da conta para o backup neste computador até você entrar de novo.

Cada uma das duas opções de apagar pergunta antes, e nenhuma pode ser desfeita. Nenhuma delas mexe nas partidas do seu computador, e nenhuma alcança os jogos enviados para ajudar a montar as estatísticas, porque nada neles diz que são seus.

Entrar no Linux

O aplicativo guarda o seu login criptografado pelo próprio sistema. Um desktop Linux sem um chaveiro configurado, como o GNOME Keyring ou o KWallet, não tem com o que criptografá-lo, então o aplicativo não o guarda: você entra de novo cada vez que abre o aplicativo, e o backup só roda enquanto você está conectado. Configurações, na seção Conta, avisa quando é o caso.

O que é guardado, onde e por quanto tempo está na Política de Privacidade.

Ajudar a montar as estatísticas

Ajudar a montar as estatísticas envia os seus jogos para um acervo privado, do qual são feitas as estatísticas do próprio Sensei Top: quais decks estão indo bem, como vão os matchups, como os cards se saem. Não precisa de conta, e a sua resposta fica neste computador.

Antes de um jogo sair do seu computador, tudo o que identifica você ou o seu oponente é removido, e ele é enviado sem o seu login. Um sim envia os jogos que já estão no seu histórico e também os que você jogar daqui em diante. Nada num jogo enviado diz quem o enviou, então, depois de enviado, ele não pode ser mostrado a você nem apagado, nem mesmo se você apagar a sua conta.

O aplicativo pergunta uma vez: no último passo das boas-vindas ou, se você configurou o aplicativo antes de essa pergunta existir, numa página própria na primeira vez que abrir esta versão, onde Decidir depois não envia nada. Se você criar uma conta sem ter dito sim, o primeiro login pergunta de novo, à parte das perguntas da conta. Até você responder, nenhum jogo é enviado. Um sim pede que você confirme a sua idade: 13 anos ou mais e, se tiver menos de 18, com a permissão de um dos seus pais ou do seu responsável.

Para ligar ou desligar, abra Configurações, depois Conta, na seção Ajudar a montar as estatísticas. Desligar interrompe na hora: nenhum jogo a mais é enviado, nem mesmo um que ainda estava esperando. Os jogos já enviados continuam no acervo.

O que o registro de um jogo traz, e o que ele nunca traz, está na Política de Privacidade.

Algo parece errado

Nenhuma partida do Arena aparece

Confira se Registros detalhados (suporte de plugin) está marcado no Arena e se o Arena foi reaberto depois disso. Depois abra Configurações, na seção Fontes: ela diz se o aplicativo encontrou o log do Arena. Se o seu não for encontrado, informe o Arquivo de log ali; o guia de instalação diz onde ele fica.

Faltam partidas de uma sessão anterior

O Arena esvazia o log toda vez que abre. Uma sessão jogada com o Sensei Top fechado continua no log até a próxima abertura do Arena e se perde depois disso. Deixe o aplicativo rodando sempre que jogar.

O aplicativo diz Acompanhamento parado ou Tracker parado

Saia do Sensei Top e abra-o de novo. No Windows, saia pelo menu do ícone na bandeja: fechar a janela o deixa rodando. Se acontecer de novo, envie um relatório de problema: o motivo está no log do aplicativo.

O aplicativo não abre

A janela dele diz onde fica o arquivo de log. Envie esse arquivo com algumas linhas sobre o que aconteceu, como explicado abaixo.

Datas ou horários parecem errados

Em Configurações, na seção Fontes, mude a Ordem da data para Dia primeiro ou Mês primeiro em vez de Ler do log.

Falta uma partida do Magic Online

Confira Seu nome lá e a Pasta dos logs de jogo em Configurações, na seção Fontes. Depois de uma atualização do Magic Online, a pasta normalmente mudou de lugar. Um jogo só aparece depois de terminar.

O deck do oponente está errado ou sem nome

O aplicativo nomeia o deck do oponente pelos cards que ele revelou, então um jogo em que ele mostrou poucos cards pode ficar com o nome errado ou sem nome. Na página da partida, aperte Corrigir o deck e escolha o certo. O aplicativo guarda a sua escolha.

Enviar um relatório de problema

Relatar um problema

Relatar um problema nos envia algumas linhas sobre o que deu errado, direto do aplicativo. Fica no menu do ícone na bandeja, em Configurações, na seção Sobre, numa mensagem de erro e na tela mostrada quando uma página para de funcionar.

1. Escreva o que você estava fazendo e o que aconteceu. Aberto a partir de um erro, a mensagem do erro aparece à parte e vai depois do seu texto.
2. Se quiser, marque Anexar as últimas 500 linhas do log do aplicativo. É o log do próprio Sensei Top, nunca os logs do Arena ou do Magic Online, e nomes e chaves são removidos dele antes do envio.
3. Concorde com o envio do relatório ao Sentry, nos Estados Unidos. Com os relatórios de erro ligados, esse sim já foi dado e a janela diz isso; senão, ela pergunta toda vez, e nada é enviado até você concordar e apertar Enviar relatório.

Funciona com ou sem conta, com os relatórios de erro ligados ou não: cada clique envia um relatório. Com uma conta, Enviar relatórios de erro em Configurações, na seção Conta, é um sim à parte, que envia um relatório sozinho quando algo dá errado. O que um relatório traz, e por quanto tempo é guardado, está na Política de Privacidade. Para receber uma resposta, abra uma issue ou escreva para nós, como explicado abaixo.

Uma exportação de diagnóstico

Para um problema que precisa ser examinado mais a fundo, uma exportação de diagnóstico mostra o que o aplicativo viu. Leva um minuto.

1. Abra Configurações, depois Sobre, e aperte Exportar diagnóstico. O menu do ícone na bandeja tem a mesma opção.
2. Uma janela lista o que vai no arquivo. Deixe Incluir o Player.log desmarcado, a menos que peçam: o log do Arena tem os nomes dos seus oponentes e os seus decks.
3. Aperte Salvar como… e escolha onde salvar o zip.
4. Envie o zip com algumas linhas: o que você fez, o que esperava, o que o aplicativo mostrou e o que o jogo mostrou.

O que vai no zip

• Os arquivos de log do próprio aplicativo.
• As configurações do aplicativo, sem nenhuma chave e sem o seu nome no Magic Online.
• O que o aplicativo consegue encontrar no seu computador: o log do Arena, a pasta do Magic Online, os dados dos cards e o banco de dados.
• Quantas linhas cada tabela do banco de dados tem. Só a contagem, nunca as linhas.

Nunca vai nele: o seu banco de dados, portanto nenhuma das suas partidas, e nenhuma chave. O Player.log do Arena só vai se você marcar a caixa.

Um problema que vai e volta

Ligue o Modo de diagnóstico em Configurações, na seção Sobre. O aplicativo passa a escrever muito mais detalhe no log; ligar ou desligar reinicia o tracker por um instante. Use o aplicativo até o problema aparecer de novo, exporte e depois desligue.

Para onde enviar

Abra uma issue com o formulário de bug e anexe o zip. O formulário está em inglês, mas pode escrever em português. Issues são públicas, então nunca anexe o Player.log a uma. Se algo parou de aparecer depois de uma atualização do Arena ou do Magic Online, o formulário de mudança no log é o mais indicado. Para enviar um relatório em particular, mande por e-mail para contact@senseitop.com. Uma dúvida, e não um problema, vai para as Discussions.