NX2navi · Windows · Vulkan
Setup versus Quellcode
Die meisten NX2navi-Spieler sollten Setup.exe ausführen und den Launcher das Spiel bauen lassen. Quellcode und BuildKit gibt es für Leute, die die Toolchain schon wollen. Beide brauchen weiterhin Ihren Dump.
Setup und Updates kommen von GitHub Releases für tangerineturtle1/NX2navi. Der aktuelle Tag wird beim Aufruf gelesen.
Zwei Wege zu einem spielbaren Ordner
NX2navi-Setup installiert einen Launcher. Dieser Launcher lädt Tools, kompiliert aus Ihrem Dump und hält den Port aktuell. Das ist der Weg, den Release-Notes für neue Spieler beschreiben. Aus dem Quellcode bauen heißt tangerineturtle1/NX2navi klonen, die Toolchain aus docs/building.md installieren und Binaries selbst erzeugen. BuildKit ist der Mittelweg: derselbe Spielbuild, den der Launcher fahren würde, über tools/make_game.py, dokumentiert in docs/README-BuildKit.md. Alle drei starten noch von Dateien, die schon auf der Platte liegen. Wollen Sie nur spielen, ist Setup die kleinere Entscheidung.
| Weg | Sie laden | Sie brauchen weiterhin |
|---|---|---|
| Setup.exe | Einen unsignierten Installer von Releases | Ihren Dump, einen Windows-PC, der die Untergrenze trifft |
| BuildKit | Nichts Extra von dieser Site; folgen Sie dem BuildKit-Doc | Denselben Dump, Python-Tools auf dem PC |
| Quell-Clone | git clone des Repositories | Den Dump plus die Toolchain in building.md |
Wann Setup der richtige Standard ist
Wählen Sie Setup, wenn Sie einen Windows-PC haben, der CPU- und Vulkan-Untergrenze trifft, schon einen Dump haben und keinen Compiler pflegen wollen. SmartScreen gilt weiter. Das erste Warten ist der lokale Build, kein versteckter Download des fertigen Spiels. Spätere NX2navi-Tags können über den Launcher kommen. Melden Sie Spieler-Bugs mit Logs aus dieser Installation. Fügen Sie keine Compilerflags in Issues ein, außer Sie haben wirklich aus dem Quellcode gebaut; das verschwendet Maintainer-Zeit. Diese Seiten dokumentieren Setup zuerst, weil das die Datei ist, die GitHub Releases an Spieler schiebt.
Wann Quellcode oder BuildKit sich lohnt
Wählen Sie einen Quell-Checkout, wenn Sie NX2navi ändern, einen Compilerfehler reproduzieren oder CONTRIBUTING.md mit einem Patch folgen wollen. Wählen Sie BuildKit, wenn Sie den Spielbuild ohne Launcher-UI wollen und bereit sind, dieses Dokument bis zum Ende zu lesen. Beide Wege erwarten, generierte Bäume aus Git zu halten; das Projekt ignoriert build\ und generated\ schon. Führen Sie den Content-Check des Repos vor einem Commit aus. LICENSE-ADDITIONS behält Rechte an den eigenen Ergänzungen des Projekts, also veröffentlichen Sie diese Quellen nicht, als wären sie gemeinfreier Nintendo-Code. Diese Website klebt building.md nicht. Wir verlinken es.
Die Bäume nicht mischen
Eine Setup-Installation und ein Git-Clone können auf derselben Platte leben. Sie sollten keinen Ausgabeordner teilen. Setup zu aktualisieren merged Ihre lokalen Patches nicht. Quellcode zu bauen registriert sich nicht beim Launcher-Updater. Ist etwas kaputt und Sie erinnern sich nicht, welchen Baum Sie gestartet haben, haben Sie noch keinen nützlichen Bugreport. Wählen Sie einen Weg, schreiben Sie ihn ins Issue und hängen Sie das passende Log an. Linux-Nutzer, die hoffen, Quellcode erzeuge ein Deck-Paket, sollten das README weiter lesen: der veröffentlichte Spieler bleibt Windows. Diese Vergleichsseite verspricht keine anderen Betriebssysteme. docs/architecture.md ist der Ort, wie die statische Rekomp und das Vulkan-Backend zusammenpassen; Pflichtlektüre vor SmartScreen ist es nicht. tools/make_game.py ist der BuildKit-Einstieg, kein verstecktes Setup. Halten Sie generated\ und build\ aus Git, wie das Repository sie schon ignoriert.
Lizenzen in einem Absatz
Das Repository ist öffentlich lesbar. Basis-Importcode bleibt unter der MIT-Lizenz in LICENSE. Drittanbietercode behält die Hinweise in THIRD_PARTY_NOTICES.md. Ergänzungen und Änderungen des Projekts sind in LICENSE-ADDITIONS vorbehalten: das ist kein Freibrief, den Port als eigenes Produkt neu zu veröffentlichen. Ein Setup-Download ändert diese Fakten nicht. Ein Quell-Clone auch nicht. Diese Seiten umschreiben Installationsschritte; sie drucken diese Dateien nicht nach. Brauchen Sie den genauen Rechtstext, öffnen Sie sie auf GitHub. Beitragende sollten CONTRIBUTING.md lesen, bevor sie einen Patch senden, generierte Bäume aus Git halten und den Content-Check des Repos fahren. Spieler, die nie einen Compiler öffnen, können diesen Absatz ignorieren und bei Setup bleiben. Sagt ein Tutorial, BuildKit-Ausgabe in einen Setup-Ordner zu mischen „um Shader zu überspringen“, ignorieren Sie das Tutorial; Sie verstecken nur, welcher Baum brach. Im Zweifel den gemischten Ordner löschen und von einem dokumentierten Weg neu starten. Zwei halbfertige Bäume sind schlechter als ein sauberes Setup.
Häufige Fragen
- Ist Setup ein anderes Spiel als ein Quellbuild?
- Nein. Dasselbe Projekt, dieselbe Dump-Pflicht. Setup ist der paketierte Launcher-Weg. Quellcode ist der Entwickler-Checkout.
- Überspringt ein Quellbuild den Dump?
- Nein. Quellcode braucht denselben Dump, den der Launcher sucht. Ein Clone ohne Dump spielt weiterhin nicht.
- Wohin schicke ich einen Compilerfehler?
- GitHub Issues, mit den Befehlen, die Sie ausgeführt haben, und einem gekürzten Log. Nicht support@nx2navi.online.