========================================================================
 MirX - Lancador
========================================================================

 Este programa instala, mantem atualizado e abre o cliente do MIR4 no
 servidor de testes do MirX. Voce nao precisa baixar mais nada por fora.


 COMO USAR
 ------------------------------------------------------------------
 1. Descompacte a pasta "MirX" onde quiser (Documentos serve).
    Nao rode de dentro do .zip -- o Windows abre o zip como se fosse
    uma pasta, mas o programa nao funciona la'.

 2. Abra MirX.exe.

 3. O Windows vai dizer:

        "O Windows protegeu o seu computador"

    Nao ignore esse aviso. Baixe somente a versao publicada pelo canal
    oficial do MirX e confirme a assinatura do release e o SHA-256 antes
    de executar. Se a assinatura ou o hash nao conferirem, interrompa a
    instalacao e envie o arquivo lancador.log ao suporte.

    Para conferir o SHA-256 do .zip no PowerShell:

        Get-FileHash .\MirX-lancador.zip -Algorithm SHA256

    Compare o valor com o SHA-256 publicado junto da mesma versao assinada.

 4. A pasta do jogo ja' esta' pronta: o lancador cria C:\MirX
    sozinho ao abrir. Voce nao precisa criar nada a mao.

    Reserve 9 GB livres nesse disco. Se preferir outro lugar,
    clique em "Pasta" ANTES do passo seguinte e escolha -- o
    lancador guarda a escolha.

 5. Clique em "Atualizar". Na primeira vez ele baixa ~8,4 GB. Numa
    conexao domestica boa isso leva de 15 a 20 minutos. Pode deixar
    rodando e ir fazer outra coisa.

    Se a internet cair -- ou se voce fechar o lancador no meio --,
    e' so' abrir de novo: ele RETOMA de onde parou. Nao recomeca do
    zero e nao perde o que ja' baixou.

 6. Quando o botao JOGAR acender, e' so' clicar.

    Das proximas vezes o lancador so' baixa o que mudou -- em geral
    alguns segundos.


 OS BOTOES
 ------------------------------------------------------------------
 Pasta        muda onde o jogo fica instalado. So' precisa mexer
              nele se nao quiser o padrao (C:\MirX).

 Reparar      confere o sha256 de TODOS os arquivos e rebaixa
              qualquer um que esteja diferente. Use se o jogo passar a
              travar ou dar erro estranho. Demora alguns minutos e NAO
              apaga seus saves nem suas configuracoes.

 Atualizar    baixa e aplica a versao nova.

 JOGAR        so' acende quando a instalacao esta' completa e igual ao
              que o servidor publicou. Se estiver apagado, clique em
              Atualizar.


 SE ALGO DER ERRADO
 ------------------------------------------------------------------
 Antes de avisar, faca duas coisas:

   1. clique em "Reparar";
   2. pegue o arquivo de log em

        %LOCALAPPDATA%\MirX\lancador.log

      (cole esse caminho na barra do Explorador de Arquivos)

 e mande junto com a VERSAO que aparece no topo da janela.

 SE O ANTIVIRUS APAGAR O MirX.exe: nao restaure o arquivo nem crie
 excecao. Confirme a origem do download, a assinatura e o SHA-256 da
 versao publicada. Se algum deles divergir, trate o arquivo como invalido
 e envie ao suporte apenas a versao e o lancador.log.

 SE APARECER "HTTPS interceptado por <nome do antivirus>": e' normal
 e nao e' problema. Varios antivirus abrem as conexoes HTTPS para
 vasculhar o conteudo. O MirX detecta isso e continua funcionando com
 seguranca, porque a lista de arquivos vem assinada digitalmente e
 cada arquivo baixado tem a impressao digital (sha256) conferida
 antes de ser gravado.


 O QUE O LANCADOR NAO FAZ
 ------------------------------------------------------------------
 * nao pede senha, nao cria conta e nao guarda credencial nenhuma
   (a conta e' criada no site e a senha e' digitada dentro do jogo);
 * nao mexe em nada fora da pasta que voce escolheu;
 * nao toca nos seus saves e configuracoes (a pasta SaveData do jogo
   e' area protegida, o lancador se recusa a escrever la');
 * nao exige download manual de uma versao nova do lancador: ao abrir, ele
   verifica a release assinada e se reinicia ja atualizado. Se a versao nova
   sair enquanto o jogo estiver aberto, o guard encerra a sessao, aplica a
   troca assinada e reabre o lancador atualizado.

========================================================================
 ATUALIZACAO DO MIR4 GLOBAL
========================================================================

Se o MIR4 Global for atualizado antes do MirX, abra o launcher. Ele confere o
manifesto assinado do MirX e informa que a compatibilidade dessa build ainda
esta pendente. A instalacao oficial e a copia MirX ficam intactas.

Use **Verificar** para consultar de novo o manifesto assinado. Quando uma
versao compativel for publicada, o mesmo botao volta a **Atualizar** para preparar
a copia. **Reparar** serve para arquivos da copia e nao resolve uma mudanca de
build oficial.

Se a mensagem persistir, envie ao suporte a versao exibida, os passos para
reproduzir e `%LOCALAPPDATA%\MirX\lancador.log`.
