xcx-recomp README

项目的 README,来自 github.com/jmars125/xcx-recomp。合并为一个 markdown 文件:README.md。

XCX Recomp

Get it on RecompLauncher

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

Experimental source mods

This feature branch supports explicitly enabled Lua source packages, settings/actions in F1/Esc → Mods, optional trusted native providers and one checked Online-menu shortcut to the existing Mods page. Start with the mod-author guide. Linux candidate tests are recorded in the reviewer guide; native Windows acceptance for these additions is pending. This is separate from emulator asset mods and does not expose gameplay APIs or game-native content windows.

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. Started from RecompLauncher, the game reports Recomp Achievements (docs/achievements.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)

正在搜索数据库…

这是什么?XCX Recomp 将《Xenoblade Chronicles X: Definitive Edition》(Nintendo Switch,2025 年)静态重编译为原生 Windows x86-64 应用程序,并使用 Vulkan 渲染器,因此无需模拟器即可在 PC 上运行游戏。
它是模拟器还是别的东西?它不是模拟器。游戏的原始代码会被提前转换为真正的原生 x86-64 机器码,因此它是一个真正的原生 Windows 应用,而不是在运行时被逐条解释执行。
我要怎么让它运行起来?从 Releases 下载 XCX-Setup 压缩包,运行 XCX-Setup.exe,指定你提取的游戏文件,选择语言和安装目录,然后点击开始,先构建一次游戏;之后就可以从安装目录启动 xcx.exe。
我需要自己的游戏副本吗?需要。你需要一份合法提取的《Xenoblade Chronicles X: Definitive Edition》副本(本体加 2.0.0 更新,DLC 可选),以及一台运行 Windows 10 或更高版本、搭载支持 AVX2 的 x86-64 CPU 和 Vulkan 1.3 显卡的电脑,安装过程中还需约 36 GiB 的可用磁盘空间。
这个版本已经可以完整通关了吗?目前仍处于早期开发阶段:新游戏、过场动画和游戏玩法已可以 60fps 运行(可配置为 30–360,超过 60 的为实验性功能),但 Linux/Steam Deck 支持、模拟器模组加载、自定义宽高比和 VRR 等功能目前只是计划,尚未实现。
它只能在 Windows 上运行,还是也支持 Linux?目前只支持 Windows 10 或更高版本;Linux 和 Steam Deck 支持被列为未来的计划工作。
为什么要重编译,而不直接使用模拟器?静态重编译会提前把原始 Switch 代码转换为真正的原生 x86-64 机器码,因此游戏可以直接在 Windows 上运行,无需模拟层,并支持一些原生功能,例如不限制帧率、键盘/鼠标支持,以及游戏内的设置与性能叠加层。
它基于哪些其他项目?它是从 TotK Recomp 分支而来的,并复用了 LAS Recomp、SavageWindRecomp、Ryujinx、deko3d 和 hactool 等项目的技术与代码,还使用了 SDL3、Dear ImGui 和 Vulkan Memory Allocator 等库。
我能使用为 Switch 模拟器制作的模组吗?暂时不能。把模拟器模组解包到 mods 文件夹的功能被列为计划中的功能,目前还无法使用。
代码究竟是谁写的?大部分代码和文档由 AI 编程代理(Claude Code)在维护者的指导下编写,维护者会在合并前审查每一次构建。
作者
jmars125
大小
7.7 MB
星标
345
时长
18天
提交 · 90 天