xcx-recomp README

The project's README from github.com/jmars125/xcx-recomp. As one markdown file: README.md.

XCX Recomp

XCX Recomp is a static recompilation of Xenoblade Chronicles X: Definitive Edition (Nintendo Switch, 2025) into a native Windows x86-64 application (docs/architecture.md). It is a fork of TotK Recomp by Valiantsin Dzerakh.

[!IMPORTANT] No game files are included. You need your own legally obtained copy of Xenoblade Chronicles X: Definitive Edition, dumped from your own console: the base game and the 2.0.0 update (the add-on content is optional). Instructions for obtaining those files will not be provided.

The game is built from your files on your machine, so the result contains the game. It is for your own use. Do not share it.

Status

Early development. New Game, cutscenes and gameplay run on Windows with sound, text and the menu, at 60 fps by default (30 to 360 in the settings; above 60 is experimental).

Report problems as issues, following CONTRIBUTING.md.

Features

Planned

Installing

Requirements: Windows 10 or later, an x86-64 CPU with AVX2, a GPU with Vulkan 1.3 and VK_EXT_external_memory_host, about 36 GiB free during setup (20 GiB after).

  1. Download XCX-Setup-<version>-windows.zip from Releases and unpack it.
  2. Start XCX-Setup.exe. If SmartScreen warns about an unsigned app, choose More info, then Run anyway.
  3. Pick your game files, the language and an install folder, and press Start. The setup builds the game once.
  4. Play xcx.exe from the install folder.

To update, run a newer XCX-Setup.exe on the same folder; saves and settings are kept. Settings are in the in-game menu and in xcx.ini (xcx.ini.example lists every key). Controls: docs/controls.md.

Credits

XCX Recomp builds on the projects below. What was taken from each, with its license, is listed in THIRD_PARTY_NOTICES.md.

License

The project's own code is under the MIT License; third-party code keeps its own license (THIRD_PARTY_NOTICES.md). The license grants nothing for Nintendo's game.

XCX Recomp is an independent, non-commercial fan project, not affiliated with or endorsed by Nintendo. Xenoblade Chronicles X and Nintendo Switch are trademarks of Nintendo; Xenoblade Chronicles X is developed by Monolith Soft.

Building from source

docs/building.md lists the toolchain and the steps. Everything the build writes stays under build\ and generated\, which git ignores; run tools/check_content.py before a commit. Testers: docs/tester-guide.md.

Most of the code and documentation is written by AI coding agents (Claude Code) under the maintainer's direction; the maintainer plays every build and decides what is merged. AGENTS.md holds the rules they work under.

xcx-recomp (jmars125/xcx-recomp)

avx2
Searching Database…

120 ·GitHub
Xcx-recomp
What is this?XCX Recomp statically recompiles Xenoblade Chronicles X: Definitive Edition (Nintendo Switch, 2025) into a native Windows x86-64 application with a Vulkan renderer, so the game runs on PC without an emulator.
Is this an emulator or something different?It is not an emulator. The game's original code is converted ahead of time into real native x86-64 machine code, so it runs as a genuine native Windows app rather than being interpreted at runtime.
How do I get it running?Download the XCX-Setup zip from Releases, run XCX-Setup.exe, point it at your dumped game files, pick a language and install folder, and press Start to build the game once; afterwards you launch xcx.exe from the install folder.
Do I need my own copy of the game?Yes, you need your own legally dumped copy of Xenoblade Chronicles X: Definitive Edition (base game plus the 2.0.0 update, DLC optional), plus a Windows 10+ PC with an AVX2 x86-64 CPU, a Vulkan 1.3 GPU and about 36 GiB of free disk space during setup.
Is this ready for a full playthrough?It's early development: new game, cutscenes and gameplay already run at 60fps (configurable 30-360, with above-60 experimental), but things like Linux/Steam Deck support, emulator mod loading, custom aspect ratios and VRR are only planned, not yet implemented.
Does it run on Linux or just Windows?Right now it only targets Windows 10 or later; Linux and Steam Deck support is listed under planned future work.
Why recompile instead of just using an emulator?Static recompilation turns the original Switch code into real native x86-64 machine code ahead of time, so the game runs directly on Windows without an emulation layer, enabling native features like an uncapped framerate, keyboard/mouse support, and an in-game settings/performance overlay.
What other projects does it build on?It's forked from TotK Recomp and reuses techniques and code from projects like LAS Recomp, SavageWindRecomp, Ryujinx, deko3d and hactool, plus libraries such as SDL3, Dear ImGui and Vulkan Memory Allocator.
Can I use mods made for the Switch emulators?Not yet. Unpacking emulator mods into a mods folder is listed as a planned feature, not something that works today.
Who actually writes the code?Most of the code and docs are written by AI coding agents (Claude Code) under the maintainer's direction, with the maintainer reviewing every build before merging.
What are similar projects?SkyRecomp, totk-pc-recomp, ShadowOfTheColossus-PC, RingOut, SavageWindRecomp, horizon-modpack-compatibility, The-Darkness-Recomp, bbhost
Which topics is it in?avx2, decompilation, vulkan-api, x86-64, modding, windows-10, native, app, game, gaming, reverse-engineering, windows-app
Creator
jmars125
Size
3.4 MB
Stars
120
Updated
CommitNov 02Releasev0.1.13Nov 02
Age
1d
Commits · 90 Days