Freminet/ScarlettX
游戏在 Windows x64 上运行合法获取的 Xbox Series X|S GDK 游戏的高层模拟器实验项目。
项目定位
ScarlettX 在 Windows x64 上模拟 Xbox Series X|S(Scarlett / Gen9 Game Core)软件。Gen9 可执行文件本身就是 x86-64 PE32+,因此项目不重编译 CPU 代码,而是补齐运行层:xgameruntime.dll、TaskQueue/Async、d3d12_xs 图形、DirectStorage/XVD 存储、GameInput、XAudio2/AcpHal 以及光追栈。适合研究主机运行时模拟的人,也适合调试 GDK 游戏启动的开发者。
仓库声明不包含、不解密、不分发微软的二进制、密钥、固件或商业游戏资源,自动化测试跑在本仓库源码构建的合成 PE 标题上;一个商业游戏 Concept Destruction 被作为外部启动验证目标。
架构与覆盖范围
按 HLE API 实现划分:PE64 加载器与自动 stub、GDK 运行时、带根签名和 PSO 的 d3d12_xs、DXR/BVH、DirectStorage 与未加密 XVD 挂载、GameInput、XGameSave、XAudio2/AcpHal,以及 Bink2、FidelityFX 等中间件 shim。公开状态显示模拟器整体覆盖 404 个跟踪函数中的 64.4%,Concept Destruction 启动里程碑完成 87%;图形、存储和任务队列层最完整,Xbox 统一内存、KernelX、RDNA2 着色器提升、零售 XVC/XVD 解密和在线 Xbox 服务仍为 0%。
构建与测试
需要 Windows x86-64 环境:CMake 3.20+、Ninja、C++20 编译器(MinGW-w64 GCC 13+ 或 MSVC 2022),以及 Windows 自带的 D3D12 运行时和 WARP。官方流程如下:
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
ctest --test-dir build --output-on-failure
构建后可检查并启动合成测试包:
./build/scarlettx inspect build/packages/hello_scarlett
./build/scarlettx boot build/packages/hello_scarlett --headless --frames 3
./build/scarlettx boot build/packages/rt_showcase --headless --frames 2 --rt-dump rt_frame.ppm
运行真实游戏
在包含 scarlettx.exe 和 shim DLL 的目录下,用 --in-process 启动解包后的 Mount 目录(真实游戏走这条路径),可按需加 --gpu 或 --warp、--stats、--trace。键盘上方向键/WASD 映射手柄,Enter/Space 为 A,Escape/Backspace 为 B,也接受 XInput 手柄。窗口标题栏不负责关闭,需在控制台按 Ctrl+C 停止。存档默认写到 %TEMP%\scarlettx_saves,可用 SCARLETTX_SAVE_ROOT 修改。README 记录了一个商业游戏在硬件 GPU 下可进入 in-game 状态,约 110–140 fps,有声音且进度可保存。
使用约束
- 真实游戏支持只覆盖某一款游戏用到的接口槽,其他游戏会碰到未实现或未命名的 Xbox COM 槽位。
- 全屏不可用:Alt+Enter 后画面会冻结在最后一帧,再按一次可恢复;帧间隔未生效,帧率不设上限。
- Guest 纹理上传会晚一帧到达宿主纹理,有专门测试因此失败。
- 子进程模式依赖
PATH查找 shim,可能先命中系统的xgameruntime.dll导致0xC0000139退出;--in-process可避开,两个启动测试在子进程模式下失败。 - Bink2、FidelityFX、DirectStorage 解压、XMA2、HTTP/XCurl 使用确定性的离线 shim,合成测试通过不等于零售游戏可运行。
- 震动状态只记录不转发给宿主手柄。仓库未声明许可证。
HotRepo 点评
ScarlettX 出现在 HotRepo 2026-11-22 的 C++ 新项目榜上,记录窗口内新增 5 星,累计 105 星、14 fork;全部语言日榜名次未记录。技术上值得关注的是它公开覆盖表和三个失败测试,清楚标出了合成模拟与真实游戏对齐之间的边界:64.4% 的函数覆盖之外,统一内存、KernelX 和零售包解密这些 0% 子系统才是剩余工作的大头。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- zortos293/Lichii面向 Windows、Linux 和 macOS 的实验性 Switch 与 Switch 2 模拟器,适合愿意折腾兼容性的玩家测试游戏。
- zortos293/Eglantine用 C++ 编写的实验性 Nintendo Switch / Switch 2 模拟器,面向桌面玩家和兼容性测试者。
- InoriRus/Kyty一个早期阶段的 C++ 模拟器,可在 Windows 10 x64 上运行部分 PS4 游戏和 PS5 自制程序。
- omonkeyz/xbox-emulator用 Rust 实现 Xbox Series X|S 运行时,让已解密的游戏转储以 Windows 进程运行,并记录兼容进度。
- Djihads80/Eglantine面向 Windows、Linux 和 macOS 的实验性 Switch 2 模拟器,用 C++ 编写,适合愿意跟随每日构建测试兼容性的玩家。