NX2navi · Windows · Vulkan
Setup versus source
La plupart des joueurs NX2navi devraient exécuter Setup.exe et laisser le launcher construire le jeu. Source et BuildKit existent pour qui veut déjà la toolchain NX2navi. Les deux ont encore besoin de votre dump.
Setup et mises à jour viennent des GitHub Releases de tangerineturtle1/NX2navi. Le tag le plus récent est lu au moment de la requête.
Deux façons d’arriver à un dossier jouable
NX2navi Setup installe un launcher. Ce launcher télécharge des outils, compile depuis votre dump et tient le port à jour. C’est le chemin que les notes de release décrivent pour les nouveaux joueurs. Compiler depuis les sources, c’est cloner tangerineturtle1/NX2navi, installer la toolchain de docs/building.md et produire les binaires vous-même. BuildKit est un chemin du milieu : la même compilation de jeu que le launcher ferait, pilotée par tools/make_game.py, documentée dans docs/README-BuildKit.md. Les trois partent encore de fichiers déjà sur disque. Si vous voulez seulement jouer, Setup est la plus petite décision.
| Chemin | Vous téléchargez | Vous avez encore besoin |
|---|---|---|
| Setup.exe | Un installeur non signé depuis Releases | Votre dump, un PC Windows éligible |
| BuildKit | Rien de plus depuis ce site ; suivez le doc BuildKit | Le même dump, outils Python sur le PC |
| Clone source | git clone du dépôt | Le dump plus la toolchain de building.md |
Quand Setup est le bon défaut
Choisissez Setup si vous avez un PC Windows qui respecte le plancher CPU et Vulkan, que vous avez déjà un dump, et que vous ne voulez pas maintenir un compilateur. SmartScreen s’applique encore. La première attente est la compilation locale, pas un téléchargement caché du jeu fini. Les tags NX2navi suivants peuvent arriver via le launcher. Signalez les bugs joueur avec les logs de cette installation. Ne collez pas de flags de compilateur dans les Issues sauf si vous avez vraiment compilé depuis les sources ; ça fait perdre du temps au mainteneur. Ces pages documentent Setup d’abord parce que c’est le fichier que GitHub Releases pousse aux joueurs.
Quand source ou BuildKit valent le coup
Choisissez un checkout source si vous comptez changer NX2navi, reproduire une erreur de compilateur, ou suivre CONTRIBUTING.md avec un patch. Choisissez BuildKit si vous voulez la compilation de jeu sans l’UI du launcher, et que vous êtes prêt à lire ce document jusqu’au bout. Les deux chemins attendent que vous teniez les arbres générés hors de git ; le projet gitignore déjà build\ et generated\. Lancez le content check du dépôt avant de commit. LICENSE-ADDITIONS réserve des droits sur les ajouts du projet, donc ne republiez pas ces sources comme du code Nintendo du domaine public. Ce site ne collera pas building.md. On le lie.
Ne mélangez pas les arbres
Une installation Setup et un clone git peuvent vivre sur le même disque. Ils ne devraient pas partager un dossier de sortie. Mettre à jour Setup ne fusionnera pas vos patches locaux. Compiler depuis les sources ne s’enregistrera pas auprès de l’updater du launcher. Si quelque chose est cassé et que vous ne vous souvenez plus quel arbre vous avez lancé, vous n’avez pas encore un rapport utile. Choisissez un chemin, écrivez-le dans l’issue, et joignez le log correspondant. Les utilisateurs Linux qui espèrent que le source produise un paquet Deck devraient encore lire le README : le joueur publié reste Windows. Cette page de comparaison n’est pas une promesse d’autres systèmes. docs/architecture.md est l’endroit pour comment la recomp statique et le back-end Vulkan s’emboîtent ; ce n’est pas une lecture obligatoire avant SmartScreen. tools/make_game.py est l’entrée BuildKit, pas un Setup caché. Gardez generated\ et build\ hors de git comme le dépôt le gitignore déjà.
Licences en un paragraphe
Le dépôt est public à lire. Le code d’import de base reste sous la MIT License nommée dans LICENSE. Le code tiers garde les notices de THIRD_PARTY_NOTICES.md. Ajouts et changements du projet sont réservés dans LICENSE-ADDITIONS : ce n’est pas un chèque en blanc pour republier le port comme votre produit. Un téléchargement Setup ne change pas ces faits. Un clone source non plus. Ces pages paraphrasent les étapes d’installation ; elles ne réimpriment pas ces fichiers. Si vous avez besoin du texte juridique exact, ouvrez-les sur GitHub. Les contributeurs devraient lire CONTRIBUTING.md avant d’envoyer un patch, tenir les arbres générés hors de git, et lancer le content check du dépôt. Les joueurs qui n’ouvrent jamais un compilateur peuvent ignorer ce paragraphe et rester sur Setup. Si un tuto vous dit de mélanger la sortie BuildKit dans un dossier Setup « pour sauter les shaders », ignorez ce tuto ; vous ne ferez que cacher quel arbre a cassé. Dans le doute, supprimez le dossier mixte et repartez d’un chemin documenté. Deux arbres à moitié fonctionnels valent moins qu’un Setup propre.
FAQ
- Setup est-il un jeu différent d’une build source ?
- Non. Même projet, même exigence de dump. Setup est le chemin launcher empaqueté. La source est le checkout développeur.
- Une build source saute-t-elle le dump ?
- Non. La source a encore besoin du même dump que le launcher cherche. Un clone sans dump ne peut toujours pas jouer.
- Où envoyer une erreur de compilateur ?
- GitHub Issues, avec les commandes que vous avez lancées et un log expurgé. Pas support@nx2navi.online.