NX2navi · Windows · Vulkan
Setup versus sorgente
Quasi tutti i giocatori NX2navi dovrebbero eseguire Setup.exe e lasciare che il launcher costruisca il gioco. Sorgente e BuildKit esistono per chi vuole già la toolchain NX2navi. Tutti e due hanno comunque bisogno del dump.
Setup e aggiornamenti arrivano dai GitHub Releases di tangerineturtle1/NX2navi. Il tag più recente viene letto al momento della richiesta.
Due modi per arrivare a una cartella giocabile
NX2navi Setup installa un launcher. Quel launcher scarica gli strumenti, compila dal dump e tiene il port aggiornato. È il percorso che le note di release descrivono per i nuovi giocatori. Costruire da sorgente significa clonare tangerineturtle1/NX2navi, installare la toolchain in docs/building.md e produrre i binari da soli. BuildKit è una via di mezzo: la stessa compilazione di gioco che il launcher eseguirebbe, guidata da tools/make_game.py, documentata in docs/README-BuildKit.md. Tutti e tre partono comunque da file già sul disco. Se vuoi solo giocare, Setup è la decisione più piccola.
| Percorso | Cosa scarichi | Ti serve ancora |
|---|---|---|
| Setup.exe | Un installer non firmato dai Releases | Il dump, un PC Windows idoneo |
| BuildKit | Niente in più da questo sito; segui il documento BuildKit | Lo stesso dump, strumenti Python sul PC |
| Clone sorgente | git clone del repository | Il dump più la toolchain in building.md |
Quando Setup è il default giusto
Scegli Setup se hai un PC Windows che rispetta la soglia CPU e Vulkan, hai già un dump e non vuoi mantenere un compilatore. SmartScreen vale comunque. La prima attesa è la compilazione locale, non un download nascosto del gioco finito. I tag NX2navi successivi possono arrivare dal launcher. Segnala i bug del giocatore con i log di quella installazione. Non incollare flag del compilatore nelle Issues a meno che tu non abbia davvero compilato da sorgente; spreca il tempo del maintainer. Queste pagine documentano Setup per primo perché è il file che GitHub Releases spinge ai giocatori.
Quando sorgente o BuildKit valgono la pena
Scegli un checkout sorgente se intendi cambiare NX2navi, riprodurre un errore del compilatore o seguire CONTRIBUTING.md con una patch. Scegli BuildKit se vuoi la compilazione di gioco senza la UI del launcher, e sei disposto a leggere quel documento fino in fondo. Entrambi i percorsi si aspettano che tu tenga gli alberi generati fuori da git; il progetto già gitignore build\ e generated\. Esegui il content check del repo prima di un commit. LICENSE-ADDITIONS riserva diritti sulle aggiunte del progetto, quindi non ripubblicare quelle sorgenti come se fossero codice Nintendo di pubblico dominio. Questo sito non incolla building.md. Lo linkiamo.
Non mescolare gli alberi
Un’installazione Setup e un clone git possono vivere sullo stesso disco. Non dovrebbero condividere una cartella di output. Aggiornare Setup non unisce le tue patch locali. Compilare da sorgente non si registra con l’updater del launcher. Se qualcosa è rotto e non ricordi quale albero hai lanciato, non hai ancora una segnalazione utile. Scegli un percorso, scrivilo nella issue e allega il log corrispondente. Chi spera che il sorgente produca un pacchetto Deck dovrebbe comunque leggere il README: il giocatore pubblicato resta Windows. Questa pagina di confronto non è una promessa di altri sistemi operativi. docs/architecture.md è il posto per come stanno insieme ricompilazione statica e back end Vulkan; non è lettura obbligatoria prima di SmartScreen. tools/make_game.py è l’ingresso BuildKit, non un sostituto nascosto di Setup. Tieni generated\ e build\ fuori da git come il repository già fa con gitignore.
Licenze in un paragrafo
Il repository è pubblico da leggere. Il codice di import di base resta sotto la MIT License nominata in LICENSE. Il codice di terze parti tiene gli avvisi in THIRD_PARTY_NOTICES.md. Aggiunte e modifiche del progetto sono riservate in LICENSE-ADDITIONS: non sono un via libera a ripubblicare il port come prodotto tuo. Un download Setup non cambia quei fatti. Un clone sorgente nemmeno. Queste pagine parafrasano i passi di installazione; non ristampano quei file. Se ti serve il testo legale esatto, aprili su GitHub. I contributor dovrebbero leggere CONTRIBUTING.md prima di mandare una patch, tenere gli alberi generati fuori da git ed eseguire il content check del repo. Chi non apre mai un compilatore può ignorare quel paragrafo e restare su Setup. Se un tutorial ti dice di mescolare output BuildKit in una cartella Setup “per saltare gli shader,” ignoralo; nasconderai solo quale albero si è rotto. Nel dubbio, cancella la cartella mista e riparti da un percorso documentato. Due alberi a metà funzionanti sono peggio di un Setup pulito.
Domande frequenti
- Setup è un gioco diverso da una build da sorgente?
- No. Stesso progetto, stesso requisito di dump. Setup è il percorso launcher impacchettato. Il sorgente è il checkout da sviluppatore.
- Una build da sorgente salta il dump?
- No. Il sorgente ha comunque bisogno dello stesso dump che il launcher cerca. Un clone senza dump non può giocare.
- Dove mando un errore del compilatore?
- GitHub Issues, con i comandi che hai eseguito e un log redatto. Non support@nx2navi.online.