Visão da instalação

Plataformas neste guia

A experiência publicada do NX2navi é Windows 64 bits. O executável Setup instala um lançador que monta o jogo localmente a partir do dump. É o caminho que estas páginas documentam. Não há imagem de disco para macOS, AppImage de Linux nem pacote de Steam Deck nos GitHub Releases que este guia acompanha. Um exemplo de configuração no repositório pode citar um perfil de Deck para quem já roda o build Windows de formas estranhas; isso não é método de instalação. Se uma tag futura trouxer outro sistema, confie nos Assets dessa tag e espere esta página atualizar. Até lá, instalar NX2navi significa Windows mais o seu dump.

Como instalação se liga à configuração

A instalação termina quando o Setup colocou o lançador e você consegue abri-lo. Configuração é a lista seguinte: o lançador acha o dump, puxa ferramentas, compila neste PC, prepara shaders e abre o jogo. As pessoas misturam as duas porque o SmartScreen parece falha de instalação e um dump ausente parece build quebrado. Fique na página Windows quando o .exe não abre. Fique em Configurar quando o lançador abre mas não termina a compilação. Use Problemas quando uma pasta que já funcionava quebra depois de um update. Use Releases quando não souber qual Asset é o arquivo do jogador. Mantenha Setup e dump num caminho local curto. Pastas sincronizadas na nuvem e unidades de rede criam quebra-cabeça de permissão que parece bug do NX2navi.

O que conta como sucesso

Uma instalação boa de NX2navi é um lançador que sobe, acha o dump e no fim abre o jogo recompilado. Não é um pacote assinado da Microsoft Store. A primeira compilação é lenta de propósito: shaders são preparados para o jogo depois não travar compilando. Visitas seguintes a áreas novas ainda podem engasgar um pouco enquanto o driver vê um pipeline novo. Isso está em Known issues no repo. Se a janela nunca aparece, você ainda está em Instalar ou Problemas. Se a janela aparece e não acha conteúdo, você está em Configurar.

Atualizar sem um segundo Setup

Com o lançador instalado, uma tag nova pode chegar como update no app. As notas do 0.5.0 pediram a quem estava no 0.4.0 para abrir o lançador e aceitar o 0.5.0 em vez de caçar outro .exe. Depois desse tipo de update, o primeiro boot pode reconstruir shaders. Se o lançador não atualizar, baixe o Setup da tag nova e rode do mesmo jeito da primeira vez. Voltar atrás significa o Setup de uma tag antiga nos GitHub Releases.

Disco, tamanho de caminho e o que instalação não é

Deixe o Setup, o dump e a pasta que o lançador cria num volume NTFS local com caminho curto. OneDrive, Dropbox e shares de rede travam arquivo no meio da compilação e depois reportam crash aleatório de ferramenta. Espaço no caminho em geral passa; um caminho que já bate o limite antigo do Windows não passa. Depois que o Setup colocou o lançador, a máquina ainda precisa do dump e de uns vinte minutos sem interrupção. O Asset do GitHub é o lançador, não um instalador de loja que já traz o título.

Como estas páginas mapeiam os docs do repo

Instalar neste site é o caminho Windows Setup do README.md e das notas de release. A primeira configuração parafraseia docs/launcher.md: achar o dump, puxar ferramentas, compilar, preparar shaders. Controles parafraseiam docs/controls.md. Hardware reitera o piso do README. Setup versus código aponta docs/building.md e docs/README-BuildKit.md sem colar flags de compilador. Detalhe de arquitetura vive em docs/architecture.md para quem já abriu uma árvore de código. CONTRIBUTING.md é o molde de bug. Se duas frases brigarem, abra o arquivo no GitHub e trate aquilo como atual. Esta visão só existe para você não misturar esses documentos: não precisa de Visual Studio para jogar, e não precisa remapear F1 antes da primeira janela aparecer.

Perguntas frequentes

Eu preciso compilar o NX2navi para instalar?

Não no caminho de jogador. Baixe o Setup, coloque ao lado do dump e execute. Builds de código são opcionais e ficam em Setup versus código.

Qual arquivo é o instalador?

NX2navi-Setup-<version>.exe. Os outros zips do release são para o próprio lançador atualizar, não uma segunda instalação do jogo.

Tem página de Linux ou macOS?

Não. Este guia só documenta o Setup de Windows.