How captainj-sparrow/astral-chain-pc-recomp works
Astral Chain Recomp turns a user-supplied Switch game and update into a native x86-64 application, then runs it with a compatibility runtime. The documented installation flow extracts and merges game data, lifts code to C, and builds the executable. At runtime, the host layer, graphics translation, and settings/input UI support play and the documented visual and control features. The README supplies the installation sequence and product capabilities; sampled source and the SOURCE INDEX support only selected internal links, so unsampled integrations are shown only where documented.
Main entry points: main.c Native game executable · gen.py C generation · steps.py Setup workflow · menu.cpp In-game menu
Components 25
Installation
- Setup workflow
installer/steps.py - Game extraction
tools/extract.py - Install layout
installer/layout.py
Static Recompilation
- C generation
recomp/gen.py - AArch64 lifter
recomp/lifter.py - SIMD lowering
recomp/simd_c.py - Interprocedural analysis
recomp/ipa.py - Code patches
recomp/patches.py - Register allocation
recomp/regs.py - Jump tables
recomp/jumptables.py
Runtime Compatibility
- Native game executable
runtime/main.c - Guest host services
runtime/host.h - Platform services
runtime/platform/platform.h - Runtime settings
runtime/cfg.h
Graphics
- NVN replay
runtime/vk_exec_draw.c - Vulkan pipelines
runtime/vk_pipeline.c - HDR output
runtime/vk_hdr.c - Upscaling integrations
runtime/vk_fsr3.c - XeSS integration
runtime/vk_xess.c - FSR 4 integration
runtime/vk_fsr4.c
Player Experience
- Input and remapping
runtime/input.h - In-game menu
runtime/ui/menu.cpp - Settings controls
runtime/ui/option_rows.cpp - Localized UI text
runtime/ui_text.c
Other components
- Player
Connections 26
- Player → Setup workflow: starts setup
README.md - Setup workflow → Game extraction: extracts game data
README.md - Setup workflow → Install layout: selects install options
installer/steps.py - Game extraction → C generation: provides game code
README.md - C generation → AArch64 lifter: uses
recomp/gen.py - C generation → SIMD lowering: uses
recomp/gen.py - C generation → Interprocedural analysis: uses
recomp/gen.py - C generation → Code patches: uses
recomp/gen.py - C generation → Register allocation: uses
recomp/gen.py - C generation → Jump tables: uses
recomp/gen.py - C generation → Native game executable: builds executable
README.md - Player → Native game executable: runs game
README.md - Native game executable → Guest host services: uses host services
runtime/main.c - Native game executable → Platform services: uses platform layer
runtime/main.c - Native game executable → Runtime settings: reads settings
runtime/main.c - Native game executable → Input and remapping: accepts controls
README.md - Native game executable → NVN replay: renders game
README.md - NVN replay → Vulkan pipelines: requests pipelines
runtime/vk_pipeline.c - Player → In-game menu: opens menu
README.md - In-game menu → Settings controls: uses settings rows
runtime/ui/menu.cpp - Settings controls → Runtime settings: changes settings
runtime/ui/option_rows.cpp - In-game menu → Localized UI text: displays localized text
README.md - Native game executable → HDR output: offers HDR
README.md - Native game executable → Upscaling integrations: offers FSR 3
README.md - Native game executable → XeSS integration: offers XeSS
README.md - Native game executable → FSR 4 integration: offers FSR 4
README.md