NX2navi · Windows · Vulkan
Setup versus código
A maioria dos jogadores de NX2navi deve rodar o Setup.exe e deixar o lançador montar o jogo. Código e BuildKit existem para quem já quer a toolchain. Os dois ainda precisam do seu dump.
O Setup e as atualizações saem do GitHub Releases do tangerineturtle1/NX2navi. A tag mais recente é lida na hora do pedido.
Dois jeitos de chegar numa pasta jogável
O Setup do NX2navi instala um lançador. Esse lançador baixa ferramentas, compila a partir do dump e mantém o port atualizado. É o caminho que as notas de release descrevem para jogadores novos. Compilar do código significa clonar tangerineturtle1/NX2navi, instalar a toolchain de docs/building.md e produzir os binários você mesmo. BuildKit é o meio-termo: a mesma compilação de jogo que o lançador rodaria, dirigida por tools/make_game.py, documentada em docs/README-BuildKit.md. Os três ainda começam de arquivos que já estão no disco. Se você só quer jogar, Setup é a decisão menor.
| Caminho | Você baixa | Você ainda precisa |
|---|---|---|
| Setup.exe | Um instalador sem assinatura nos Releases | Seu dump, um PC Windows que passa no piso |
| BuildKit | Nada extra deste site; siga o doc de BuildKit | O mesmo dump, ferramentas Python no PC |
| Clone de código | git clone do repositório | O dump mais a toolchain em building.md |
Quando o Setup é o padrão certo
Escolha Setup se você tem um PC Windows que bate o piso de CPU e Vulkan, já tem um dump e não quer manter um compilador. O SmartScreen ainda vale. A primeira espera é a compilação local, não um download escondido do jogo pronto. Tags seguintes de NX2navi podem chegar pelo lançador. Abra bugs do jogador com logs dessa instalação. Não cole flags de compilador em Issues a menos que você realmente tenha compilado do código; isso gasta o tempo do maintainer. Estas páginas documentam o Setup primeiro porque é o arquivo que os GitHub Releases empurram para jogadores.
Quando código ou BuildKit vale a pena
Escolha um checkout de código se pretende mudar o NX2navi, reproduzir um erro de compilador ou seguir CONTRIBUTING.md com um patch. Escolha BuildKit se quer a compilação do jogo sem a UI do lançador e topa ler aquele documento até o fim. Os dois caminhos esperam que você mantenha árvores geradas fora do git; o projeto já ignora build\ e generated\. Rode o check de conteúdo do repo antes de commitar. LICENSE-ADDITIONS reserva direitos nas adições do projeto, então não republicar essas fontes como se fossem código Nintendo de domínio público. Este site não cola building.md. A gente linka.
Não misture as árvores
Uma instalação Setup e um clone git podem viver no mesmo disco. Não devem compartilhar pasta de saída. Atualizar o Setup não funde seus patches locais. Compilar código não se registra no atualizador do lançador. Se algo quebrou e você não lembra qual árvore lançou, ainda não tem um bug report útil. Escolha um caminho, escreva no Issue e anexe o log correspondente. Usuários de Linux esperando que código produza um pacote de Deck ainda devem ler o README: o jogador publicado continua Windows. Esta página de comparação não promete outros sistemas. docs/architecture.md é o lugar de como a recomp estática e o back end Vulkan se encaixam; não é leitura obrigatória antes do SmartScreen. tools/make_game.py é a entrada do BuildKit, não um Setup escondido. Mantenha generated\ e build\ fora do git do jeito que o repositório já ignora.
Licenças num parágrafo
O repositório é público para ler. Código-base de import fica sob a MIT nomeada em LICENSE. Código de terceiros guarda os avisos em THIRD_PARTY_NOTICES.md. Adições e mudanças do projeto estão reservadas em LICENSE-ADDITIONS: não é cheque em branco para republicar o port como produto seu. Um download de Setup não muda esses fatos. Um clone de código tampouco. Estas páginas parafraseiam passos de instalação; não reimprimem esses arquivos. Se precisar do texto legal exato, abra-os no GitHub. Quem contribui deve ler CONTRIBUTING.md antes de mandar patch, manter árvores geradas fora do git e rodar o check de conteúdo. Jogadores que nunca abrem um compilador podem ignorar esse parágrafo e ficar no Setup. Se um tutorial manda misturar saída de BuildKit numa pasta de Setup “para pular shaders”, ignore o tutorial; você só esconde qual árvore quebrou. Na dúvida, apague a pasta misturada e recomece de um caminho documentado. Duas árvores pela metade são piores que um Setup limpo.
Perguntas frequentes
- O Setup é um jogo diferente de um build de código?
- Não. Mesmo projeto, mesma exigência de dump. Setup é o caminho do lançador empacotado. Código é o checkout de quem desenvolve.
- Um build de código pula o dump?
- Não. Código ainda precisa do mesmo dump que o lançador procura. Um clone sem dump ainda não joga.
- Onde mando um erro de compilador?
- GitHub Issues, com os comandos que você rodou e um log recortado. Não support@nx2navi.online.