An unofficial, experimental native Windows port of Astral Chain (Nintendo Switch, PlatinumGames, 2019), made by static recompilation. The game's ARM64 code is translated to C and compiled into an ordinary Windows x64 program, and its NVN graphics calls run on Vulkan. There is no emulator or JIT.

You build it yourself from your own legally dumped game and keys. This repository contains no game code, assets, shaders, keys or firmware, and never will. Everything the setup produces comes from your dump: do not share the build/, game/ or userdata/ folders.

AI disclosure. Most of the code, tooling, reverse engineering and documentation here was written by Claude (Anthropic) through Claude Code, directed and tested by the repository owner. It is shared as-is as a fan project.

Known issues are listed under Known issues.

Fixes marked not yet confirmed were tested in scripted runs, but not yet confirmed in play.

2026-10-25

• Mouse support. Click in the game window to give it the mouse: it turns the camera, left click attacks (ZR), right click calls the Legion (ZL), the wheel changes weapons. Hold Alt to get the cursor back. Sensitivity and invert in Settings > Mouse and keyboard.
• Keyboard and mouse button icons in the game. The button prompts show the keys and mouse buttons you set instead of the Switch buttons (Settings > Mouse and keyboard > Button icons to keep the Switch ones).
• Controls: two bindings per action (main and alternative), mouse buttons and wheel included. New defaults: Shift sprints, Space dodges, Tab is IRIS, Esc the pause menu (the old keys stay as alternatives). Keys you had changed in Controls stay on their actions; a new default that would clash with one of them is left empty.

2026-10-24

• Flickering light in the opening helicopter cutscene: the whole picture jumped between two brightnesses. The game asks for depth clamping, which was ignored, so an effect card it places right in front of the camera was cut away in some frames and drawn in others. Depth clamping is now on. On a test save, that stretch of the cutscene went from 150-200 brightness jumps per 500 frames to 1-2 (camera cuts). The cutscene now stays at the darker of the two brightnesses. Not yet confirmed in play.
• Setup after picking the wrong file: once a wrong base game or update had been picked, every retry failed with the same "belongs to program" message. Setup now extracts again for any other file, and says which file to pick.
• Experimental features on a separate branch: upscaling has an AMD FSR 1 upscaling option, render resolutions from 1920x1080 to 3840x2160, and ultrawide sizes (21:9 and 32:9). They are not part of this version yet; see that branch's README.

2026-10-23

• Shorter wait before the game after a play session. The game records the shader combinations it meets in play; the next Play then redid all of "Preparing shaders" and "Compiling for your GPU". Now only what was added since the last time is done. On the test PC, with about 15% new records, the wait went from about 3 s to under 1 s (the saving is larger on slower PCs). A new version still prepares everything once.
• Fullscreen (issue #5): F11 or Alt+Enter switches between a window and borderless fullscreen on the window's monitor (the display mode is not changed). Settings > Display > Start in fullscreen starts in it.

2026-10-22

• Python no longer needs to be installed (issue #3). Setup downloads its own Python 3.14 into tools\python (pinned, checked by SHA-256), so the version installed on your PC, if any, does not matter. An existing .venv that works is kept.
• Setup from a ZIP download stopped at "unreviewed Maxwell translator identity" (issue #2): a file check depended on line endings. Fixed; confirmed by the reporter.
• Green flashes in the title movie (and noise or green in the tutorial clips): video frames were sometimes drawn before the decoded picture reached the GPU, for up to 8 frames. Textures written by the CPU are now checked every frame. In a recorded start, the title movie had about 50 green frames before and none after. Not yet confirmed in play; the tutorial clips are untested.
• Handheld mode (Settings > Display, off by default; issue #4): the game runs as on a Switch out of its dock and renders at 1280x720 instead of 1600x900 (36% fewer pixels), for GPUs that cannot hold 60 fps. The picture is scaled to the window as before. Its frame rate gain was not measured: the test PC's GPU is not the limit.

2026-10-21

• Keyboard controls can be changed: Controls in the launcher (click a key, press the new one).
• Optional BC7 texture compression (Settings, off by default), in two versions: converted on the GPU while playing, or prepared once at setup. Both save about 2.5 GB of video memory; see Texture compression for what each costs. Not yet confirmed in play.
• Launcher. Astral Chain Launcher.exe: install, compile shaders, play without console windows, play with diagnostics and create a bug report, and settings for every option, over original key art (six backgrounds to pick from with the arrows at the top right). See Playing.
• Shaders compiled for your GPU before the game starts ("Compiling for your GPU", about 10 s the first time). In-game, pipelines are linked from those compiled shaders instead of being compiled whole, and the recorded ones are built before their first draw. Most shader pauses in new areas are gone (see Status). Not yet confirmed.
• ASTC textures are decoded on the GPU instead of the CPU: no more 60-240 ms pauses when large textures load. Checked byte for byte against the CPU decoder.
• Crash at the File 01 boss (when it throws a container): the game stopped on a rumble value out of range. It now ignores such values. Not yet confirmed.
• NSP base games stopped setup at the RomFS step (issue #1). Setup now gives NSTool both the base game's and the update's title keys. Not yet confirmed by the reporter.
• A failed rebuild no longer loses the shader cache.
• Crash dumps in diagnostics mode; the watchdog script now records the game's exit code.

2026-10-20

• All of the game's shaders are translated before the first launch ("Preparing shaders").
• NVN's alpha test is emulated: defeated enemies no longer leave a dark tentacle mass. Not yet confirmed.
• Cutscene cuts keep their time at 60 fps, and sound skips gaps after a stall, so sound stays with the picture. Not yet confirmed. AC_CUTSCENE_FPS=30 plays cutscenes at 30 fps as on the Switch.
• Dragging the window by its title bar no longer freezes the game; closing hides the window at once.
• Each save is also copied to a backup folder (the newest 30 are kept).
• Textures are uploaded ahead of first use on loading screens; the pipeline cache is kept between sessions.
• Fixed wrong textures on faces and armour, and a rare crash in the GPU write-back handler.

• Windows 10 or 11, 64-bit.
• A GPU with Vulkan 1.3. Developed on an NVIDIA RTX 4090; other GPUs are untested.
• About 35 GB free during setup. About 11 GB stays afterwards.
• An internet connection for the one-time setup. It downloads Python, Zig, glslang and NSTool at pinned versions, checked by SHA-256. No Python install is needed.
• Your own dump:
  • the base game (title ID 01007300020FA000), as an XCI or an NSP;
  • the v1.0.1 update NSP. Exactly v1.0.1 is required;
  • your console's prod.keys.

How to dump games and keys from your Switch is not covered here.

1. Download this repository: Code → Download ZIP, or git clone. Put it in a folder you own, for example C:\Games\AstralChain-PC. The path should be short, and not on a network drive.
2. Start Astral Chain Launcher.exe in that folder and press Install game. Pick, when asked:
   1. your prod.keys;
   2. the base game (XCI or NSP);
   3. the v1.0.1 update NSP.
3. Wait. Setup extracts the game data, packs it into game\romfs.bin, then translates and compiles the game and its shaders. The first time takes roughly 15-40 minutes, depending on your CPU and disk. Temporary files are removed at the end. The launcher shows the progress; Cancel stops it.

The game is installed in the launcher's folder. Once it is, Install game is greyed out.

If a step fails, fix the cause and press Install game again: finished steps are skipped.

Without the launcher, setup.cmd does the same in a console window. It also takes the files directly: setup.cmd --keys X:\prod.keys --base X:\AstralChain.xci --update X:\AstralChain-v1.0.1.nsp.

Windows SmartScreen may warn about the launcher because it is not signed. Its source is launcher\Launcher.cs; python launcher\build.py builds it again with the C# compiler that comes with Windows.

Start Astral Chain Launcher.exe:

The arrows at the top right (BACKGROUND ‹ 1 / 6 ›) switch between six backgrounds; the choice is remembered.

Play Astral Chain.cmd and Play Astral Chain (diagnostics).cmd still work, with console windows.

Default keys and mouse buttons (change them with Controls; every action has a main and an alternative binding):

Mouse. Click in the game window to give it the mouse: the cursor hides and the mouse turns the camera (and steers your Legion while ZL is held). Hold Alt, or switch to another window, to get the cursor back; click again to resume. Sensitivity and invert are in Settings > Mouse and keyboard.

Button icons. The game's button prompts show your keys and mouse buttons instead of the Switch buttons (the main binding of each action). Settings > Mouse and keyboard > Button icons brings back the Switch icons for playing with a controller.

F11 or Alt+Enter: fullscreen on or off (F11 and Alt stay game keys if you assign them in Controls).

For GPUs with 8 GB of video memory or less. Most of the game's textures are ASTC, which PC GPUs cannot read, so they are unpacked to 4 bytes per pixel. Settings > Texture compression (BC7) stores them as BC7 instead, a quarter of that size. Off by default. Measured on a fresh install, highway chase, 3 runs each (RTX 4090):

Picture quality measured on 300 of the game's textures (PSNR against the original, higher is better): 46 dB average on the GPU, 51 dB prepared at setup; the GPU's worst texture was 27 dB, setup's 34 dB.

Switching to prepared at setup says when the preparation will run; switching away offers to delete the 16 GB. With less than 20 GB free, setup skips the preparation and the game converts on the GPU instead.

XInput controllers (Xbox pads and compatibles) work too. The game pauses while its window is minimized, as on the Switch's home menu (Settings: Keep running while the game window is minimized). In another window, the game keeps running but takes no keyboard input.

• Saves are in userdata\saves\ (the launcher's Saves folder link). Each save is also copied next to it (the newest 30 are kept); still, back that folder up from time to time.
• Logs of the last session are in build\game\round-00\ (trace.log, stderr.log).
• Shaders. Before the game starts the first time, setup translates all of the game's shaders ("Preparing shaders", about 20 s on a 16-thread CPU), then compiles them for your GPU and driver ("Compiling for your GPU"), together with the render-state combinations recorded so far. Later launches skip both unless something changed (a game update or a new graphics driver); new combinations recorded in play are done alone at the next launch. A combination never seen before is linked from the compiled shaders when first drawn, without a long pause. The cache is in build\game\cache\.

The game always runs under astral_chain\run_guarded.ps1, from the launcher too. It closes the game on the first GPU driver error that Windows logs. The game also stops itself if the GPU stays busy for more than 1.2 s, before Windows would reset the driver.

Download the new version over the old one, or git pull. The next Play rebuilds the game once, in about a minute. Your saves, game data and shader cache are kept.

• Dark, shadow-like patches on scenery when fighting close to it were reported. Under investigation: a screenshot helps.
• Some short pauses remain when entering new areas: the game loading its own data, not shader compiling.
• Defeated enemies left a large dark tentacle mass for about two seconds. Cause found: the chimera blood effect dissolves through NVN's alpha test, which was not emulated. It now is (test runs of the highway chase show no mass), not yet confirmed in play.
• In-game cutscenes were reported with the sound behind the picture after camera cuts (the 60 fps mod's known limit: each cut ended up to a frame early). Cut ends now keep their time: the cutscene after the highway chase lasts 35.192 s, as at the original 30 fps (35.193 s; 35.077 s before). Sound gaps after stalls are skipped to stay in sync. Not yet confirmed fixed.
• Rarely the game closes right at startup (STOP host-shared-placeholder-reserve in trace.log). Start it again.
• Save-slot thumbnails are not captured (nvnTextureReadTexels is not implemented).

Reports are welcome. The easiest way: play with Play with diagnostics in the launcher until the problem happens, then attach the zip that Create report makes. Otherwise include build\game\round-00\stderr.log and trace.log and your GPU and driver version, but no game files.

• How it works
• Troubleshooting
• Development notes

This is an unofficial fan project, not affiliated with or endorsed by Nintendo or PlatinumGames. Astral Chain is a trademark of Nintendo. No game code, assets, shaders, keys or firmware are distributed. Requests for them will be closed.

The original code in this repository is under the MIT License (see LICENSE). Vendored third-party components keep their own licenses, listed in THIRD_PARTY_NOTICES.md.

• LASRecomp (MIT): the ARM64 lifter, the NVN-on-Vulkan layer and the Maxwell shader translator this port builds on.
• AstralChain-Dynamic-FPS by yogesh1239 (MIT): the 60 fps patch.
• astral-extractor by cabalex: format research.
• The launcher's backgrounds and icon (launcher/art/, launcher/icon.ico) are original AI-generated images in the style of the game, without official artwork. The default (1-visor.jpg) was chosen by the project's owner; the other five and the icon were made with OpenAI Codex's image generation for this project.
• AC-Recomp: the macOS recompilation, whose setup flow inspired this one.
• AMD FidelityFX Super Resolution 1 (MIT): the EASU and RCAS shaders of the FSR 1 path (through LASRecomp), used by the experimental upscaling option.
• NSTool, Zig, glslang, Vulkan-Headers, VulkanMemoryAllocator, Capstone, lz4.