github weile10000/xc2-ns2-recomp v0.1.1
0.1.1 — first playable package / 首个可玩发布

one hour ago

XC2 NS2 Recomp v0.1.1 — first playable package

Since v0.1.0 (source only), the player's path is complete: unzip, point it at your own dump, press Set up, and
press Play.

Early version. The setup and Play paths are the two that are meant to work end to end. Much of the
launcher around them is not built yet: several settings are placeholders that change a value and nothing else,
pages are still to come, and bugs will show up. Expect the package to keep changing between releases.

What's new

  • Install from your own dump — a .nup package or a folder holding exefs/ and romfs/. A .nup is
    unpacked into base/{exefs,romfs}, updates/ and dlc/<title id>/romfs, and setup runs from there. No game
    data ships either way.
  • Play starts the game from the install itself — no more tools\run\play-301.cmd looked up above the exe,
    which a package does not have (Play used to fail there).
  • DLC loads: ingest now links the dump's dlc/ to game\dlc-301; all seven add-ons are served.
  • DLC openings play: the 4K AV1 .webm files decode through dav1d on the host, 59.9 fps (Torna opens with
    one).
  • Picture fixes
    • the deferred lighting pass gets the front-face convention it is drawn with — without it the whole frame
      stays at the G-buffer's albedo, which reads as black textures
    • the light-list registration mask is derived for every shader, not the built-in eleven — the black
      rectangle at the stairs
    • present_ahead = 0: the guest no longer runs a frame ahead of the replay
  • Shader cache: 12,132 programs from the archive + 12 compute ones from the shader containers + the 5 that
    exist in no file (collected by one short headless run) = 12,149. After each session the launcher translates
    whatever the game asked for and the cache lacked, so new areas fill in instead of staying black.
  • Game language is a setting (Simplified/Traditional Chinese, English, Japanese), not a pinned default.
  • Logs no longer carry the account name: the home folder is written as %USERPROFILE%.

Upgrading from v0.1.0

  • Package users: replace the folder; your saves (save/) and the cache (shader_cache/) can be copied over.
  • Checkout users: git pull, then rebuild as in docs/BUILD.md. An existing cache is kept; the next Set up
    adds the 12 container compute programs and the 5 runtime ones.

Known issues

  • Tested on AMD only. The development machine has a single AMD card, so that is the GPU everything was run
    on; NVIDIA and Intel are untested. The one NVIDIA report so far (issue #2, RTX 4060 Ti) ended in a black screen
    after a lost device. If you have an N or I card, a report helps a lot.
  • Internal rendering is capped at 1440p by the game's own chain.
  • The first visit to a new area can briefly miss shaders; they are translated when you exit, so the next
    launch has them.
  • Cloud-sea shimmer and the blue-grey rim where geometry meets the cloud sea remain (inside the game's own
    640×360 volumetric fog).

Before you press Play

Set up takes 8–15 minutes and it is not hung. It recompiles the game's 537 translation units from your dump,
links them, then translates about 12,150 shader programs; the step list on the page and the log below it move the
whole time. A slower machine takes longer. The first launch after that compiles GPU pipelines for about 20
seconds — one-time, per driver.

Package

file size sha256
XC2-package-dist.zip 154.8 MB (491.7 MB unpacked) D0217DA843ACAE8CACD82E6E8589B4A97C0EDDA1CE868B54CF344B2FF42EE360
xc2-launcher-0.1.1-src.zip 0.5 MB 14D9C1A122B4C70988D4373B64EBC67762689CEAF524F5D3B84E0C2A791E46DE

The package contains no game files: the executable is built on your machine from your own dump and the
shaders are translated from it. Installation: README.

Credits

  • Goldoire/fefw-recomp — the Switch runtime this project is built
    on: NVN/NVN2 replay, service HLE, the shader pipeline and the exe + DLL split all started there.
  • nxrecomp — the static recompiler that lifts the game's code.
  • Ryujinx (MIT) — the Maxwell shader translator in the offline harness.
  • SDL3, Vulkan-Headers, VMA, dav1d and the other vendored dependencies — see licenses/ in the package.

XC2 NS2 Recomp v0.1.1 —— 首个可玩发布

自 v0.1.0(只有源码)以来,玩家侧的链路补齐了:解压 → 指向自己的 dump → Set up → Play。

本版变化

  • 从自己的 dump 安装:.nup 包,或者 exefs/ + romfs/ 目录——.nup 会被解成 base/{exefs,romfs}、updates/、dlc/<title id>/romfs,再从那里安装。两条路都行,包里不含任何游戏数据。
  • Play 直接从安装目录起游戏:不再去 exe 上面找 tools\run\play-301.cmd(包里没有,Play 会直接失败)。
  • DLC 能加载:ingest 现在把 dump 的 dlc/ 链到 game\dlc-301,七个追加内容全部可用。
  • DLC 影片能播:4K AV1 .webm 走主机的 dav1d 解码,59.9 fps(黄金国伊拉开场就是这一段)。
  • 三处画面修复
    • 正面约定:延迟光照那一笔被剔除时,整帧停在 G-buffer 上,看起来就像「贴图全黑」
    • 光照列表的掩码对每个着色器重建,而不是内置的 11 个——楼梯那块黑矩形
    • present_ahead = 0:guest 不再跑到 replay 前面
  • 着色器缓存:档案 12,132 + 容器里的 12 个 compute + 5 个任何文件里都没有的(一次无头运行收集)= 12,149。每次退出后,启动器会把游戏请求过、缓存里没有的块翻译进去,新场景不再一直黑。
  • 游戏语言可在设置里选(简中 / 繁中 / English / 日本語),不再写死。
  • 日志不再带账号名:家目录写成 %USERPROFILE%。

从 v0.1.0 升级

  • 包用户:换个目录即可;save/ 和 shader_cache/ 可以拷过去。
  • 源码用户:git pull 后按 docs/BUILD.md 重编。已有缓存保留,下一次 Set up 会补上容器那 12 个 compute 和 5 个运行时块。

已知问题

  • 目前只在 AMD 上测过:开发机只有一张 A 卡,所以只在这张卡上验证过,N 卡和 I 卡都没测。唯一一份 N 卡报告(issue #2,RTX 4060 Ti)以设备丢失、画面全黑告终。如果你用的是 N 卡或 I 卡,欢迎反馈,对我们帮助很大。
  • 游戏自身链路把内部渲染上限锁在 1440p。
  • 第一次进新区域可能短暂缺着色器;退出后会翻译,下一次启动就有。
  • 云海闪烁、几何与云海交界的蓝灰描边仍在(在游戏自己的 640×360 体积雾里)。

开始之前

Set up 要 8–15 分钟,它没有卡死。 它用你的 dump 重编游戏的 537 个翻译单元、链接,再翻译约 12,150 个着色器程序;页面上的步骤表和下面的日志一直在动。机器慢会更久。之后第一次启动还要编译 GPU 管线,约 20 秒,每个驱动一次。

包内容

文件 大小 sha256
XC2-package-dist.zip 154.8 MB(解压 491.7 MB) D0217DA843ACAE8CACD82E6E8589B4A97C0EDDA1CE868B54CF344B2FF42EE360
xc2-launcher-0.1.1-src.zip 0.49 MB 14D9C1A122B4C70988D4373B64EBC67762689CEAF524F5D3B84E0C2A791E46DE

包里不含游戏文件:exe 在你的机器上从你的 dump 构建,着色器从它翻译。安装见 README。

致谢

  • Goldoire/fefw-recomp —— 本项目的运行时基座:NVN/NVN2 重放、服务层 HLE、着色器管线、exe + DLL 的拆分都源自那里。没有那个项目,就没有这次重编译。
  • nxrecomp —— 把游戏代码举升出来的静态重编译器。
  • Ryujinx(MIT)—— 离线 harness 里的 Maxwell 着色器翻译器。
  • SDL3、Vulkan-Headers、VMA、dav1d 等 vendored 依赖,见包里的 licenses/。

Don't miss a new xc2-ns2-recomp release

NewReleases is sending notifications on new releases.