sammwyy/xvalkyrie
游戏在 64 位 Windows 上原生运行 Xbox One 与 Series X|S 程序的实验性翻译层,面向研究与自制软件开发者。
项目介绍
XValkyrie 是一个实验性兼容层,让 Xbox One(Durango)和 Xbox Series X|S(Scarlett)软件在 64 位 Windows 上运行。它不是主机模拟器:两台主机本身就是跑着精简版 Windows 的 x86-64 机器,所以标题的可执行文件会被映射进进程,代码原生执行,它导入的 d3d12_xs.dll、xgameruntime.dll、kernelx.dll 等由本项目实现,并建立在宿主机的 Direct3D、音频和输入之上 工作原理。
真正需要翻译的是与 PC 不同的部分:主机版 Direct3D 11 和 12、Series 标题以主机 GPU 机器码形式携带的着色器、标题自行管理物理页的内存方式,以及用户、存档、Xbox Live 等系统服务。项目用 C++20 编写,思路更接近 Wine 和 Proton,而不是主机模拟器。
当前状态
项目仍处早期,还不能完整游玩游戏。Xbox One 上使用 Direct3D 11.X 和 WinRT 的标题可以到达菜单和场景,并能用键盘或 XInput 操作手柄,但存档、音频解码和 Xbox Live 仍是占位或缺失。Xbox Series X|S 方面,40 个可构建的公开 GDK 示例都能画出画面;零售标题可以启动、创建设备并出帧,某个零售标题启动后四分钟内创建的 2004 个着色器中有 1966 个能翻译并编译,但画面尚不正确 Status。逐函数实现情况记录在 docs/STATUS.md,后续计划见 ROADMAP.md。
构建
需要 Windows 10 或 11 64 位、带「Desktop development with C++」的 Visual Studio 2022、CMake 3.25 或更新版本以及 Python 3。首次配置时 CMake 会拉取依赖。在仓库目录的命令行中执行:
build.cmd --test
产物是 build\win\Release 下的 xvalkyrie.exe 和 xvboot.exe。可选参数包括 Debug(调试构建)、--vulkan(额外构建基于 Vulkan 的 Direct3D 11,需要 Meson 和 glslang)、--target NAME 与 --reconfigure;环境变量 JOBS 控制并行编译数 Building。把 dxcompiler.dll 和 dxil.dll 放在 xvalkyrie.exe 旁边或 Windows SDK 中可加快着色器编译;否则使用系统旧编译器,最大的着色器需要几分钟。
快速使用
启动 xvalkyrie 打开游戏库窗口,在 Options > Game Libraries 中添加要扫描的文件夹。一个标题可以是可执行文件,也可以是解包后的标题文件夹(其中包含 MicrosoftGame.config 或 AppxManifest.xml);.xvc 打包文件会被列出但无法打开,因为 XValkyrie 不解密任何内容。选中标题后启动,或从命令行运行:
xvalkyrie [FILE|FOLDER]
xvboot exec TITLE [--allow-missing] [--trace] [--mute] [--backend d3d11|vulkan]
窗口中,Options > Input 把游戏手柄绑定到按键或宿主机手柄,Options > Graphics 选择后端和 F11 的行为,Options > Console 设置登录用户以及可选的系统存储。配置保存在 %APPDATA%\xvalkyrie\config.ini,每次会话和每个标题的日志在旁边的 logs 目录。如果不想运行标题,可用 xvboot inspect、assess、bind、map 或 properties 检查文件,它们会输出 JSON 报告 Usage。
使用约束
- 仅支持 Windows x64;项目依赖 Windows 提供主机系统中属于 Windows 的那部分,因此没有 Linux 版本。
- 实验阶段:会遇到崩溃和画面错误,而不是完整游玩。Xbox One 支持只到菜单和场景,Series 零售标题的画面仍不正确。
xvboot exec在自己的进程中运行标题代码,没有沙箱,只应运行你信任的程序。- 不附带也不链接游戏、密钥、固件或 SDK 文件,零售包无法解密,需要自备已解包的标题。
- 采用 GPL-3.0 许可,衍生作品需保持同一许可并保留声明;第三方组件保留各自许可 license。
HotRepo 点评
XValkyrie 在 2026-11-22 出现在 HotRepo 新项目榜的 C++ 语言榜第 113 名,约五小时的观察窗口内新增 12 个 Star;当天下午的 Star 曲线从 101 升到 113。项目没有全语言日榜记录,也没有 Hacker News 讨论可参考。这组数字只能说明仓库在短时间内获得了一定关注,不能说明兼容层已经成熟:项目自己的状态说明指出 Series 零售标题画面仍不正确,因此这条榜单记录反映的是对技术路线的兴趣,而非可玩的成品。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- R0Y00/Xbox2Windows研究把 Xbox Series X|S 软件静态重编译到 x64 Windows 的实验项目,以 GTA VI 为案例。
- Freminet/ScarlettX在 Windows x64 上运行合法获取的 Xbox Series X|S GDK 游戏的高层模拟器实验项目。
- ivall/xcl在 Windows 上原生运行 Xbox Series X|S 游戏文件的实验性兼容层,适合研究主机兼容与着色器重编译的技术用户。
- Vita3K/Vita3K一个实验性的 PlayStation Vita 模拟器,让玩家在 Windows、Linux、macOS 和 Android 上运行自制程序与商业游戏。
- cemu-project/Cemu在 64 位 Windows、Linux 和 macOS 上运行大多数 Wii U 游戏与自制程序的开源模拟器。