github akirahayabusa/ngb-pc-native-port-release v1.1.4
Ninja Gaiden Black Hurricane PC 1.1.4

latest releases: v2.2.29, v2.2.28, v2.2.27...
19 days ago

《忍者龙剑传 黑之章》飓风版中文汉化 vb-zh-x2.1(初代 Xbox)的非官方 Windows 原生移植。1.1.4。

1.1.4

  • 修好 Steam Deck(Proton)上警告画面之后、Team Ninja 标志影片之前闪退:影片开始播放时游戏会执行一条清 CPU 缓存的特权指令,程序本来会把它跳过;Windows 把它报成「特权指令」,Proton 却报成「访问违规」,没被认出来,游戏就退出了。现在两种都认(依据玩家的 Steam Deck 日志,Proton 11.0-2)。Windows 上没有变化,集成显卡实测游戏速度不变。Steam Deck 上仍待玩家实测,有问题请附上游戏文件夹里的 logs\black.log。

1.1.3

  • 试修 Steam Deck(Proton / Wine)开机提示「脏盘」:游戏开机会列出光盘上的影片目录,我们查目录时带了一个Wine 不支持的参数(Wine 遇到它一律回答「未实现」),游戏列不出目录,就以为光盘坏了。现在不带这个参数(做法同 black-pc 上游的修复)。Windows 上没有变化,集成显卡实测游戏速度不变。Steam Deck 上尚未实机验证,欢迎回报;若仍有问题,请附上游戏文件夹里的 logs\black.log。

1.1.2

  • 新设置「全屏分辨率」(启动器「显示」页),给配置较低的电脑:选「窗口大小」后,全屏与无边框时画面按「窗口大小」输出(保持屏幕的比例,不会变形),再放大铺满屏幕,画面略软,但显卡要处理的像素少;渲染分辨率选「跟随窗口」时 3D 画面也按这个尺寸画。不切换显示器分辨率。集成显卡实测(1920×1200 屏幕、窗口 1280×720)无边框每帧 9.37 → 8.47 毫秒。想减轻显卡负担,最有效的仍是调低「图形」页的渲染分辨率。默认「跟随屏幕」,和以前一样。
  • 修好独占全屏下按 Alt+Enter 退不回窗口(1.1.1 引入)。
  • 独占全屏下 Win+D 能正常最小化;最小化期间不再每隔几秒重置一次显卡设备。
  • 修好极少数情况下 Alt+Enter 切回独占全屏时连续重置两次(多停顿约 0.2 秒)。

1.1.1

  • 修好 boss 战敌人没有影子(如第 1 章村井和白衣忍者):boss 战里游戏会多用一张阴影贴图,之前没被认出来,它的深度缓冲建得比贴图本身还小,敌人的影子一直画不进去。现在和原版(xemu 对照)一样有影子,玩家实机确认。
  • 修好无边框全屏下按 Win+D 后,游戏又铺满屏幕:之前无边框窗口不能被「显示桌面」最小化,只是被临时挡住,一打开别的程序,游戏就回到屏幕、盖住整个桌面。现在 Win+D 会真正最小化游戏,点任务栏图标也能最小化与恢复。

1.1.0

  • 图形部分改用 Direct3D 9Ex(Windows 10/11 自带的新版 Direct3D 9):全屏切后台、锁屏、UAC 弹窗不再丢失显卡设备,切回来直接继续,不必重建画面;1.0.0 的切后台闪退、黑屏只有声音从根上不会再出现。游戏速度不变(集成显卡实测)。
  • 显卡驱动崩溃或重启后自动恢复:驱动卡死、被重置或更新时,整个显卡设备连同全部画面资源重新建立,游戏接着跑,不再黑屏(反复重建 20 次,内存不增长、画面一致)。
  • Alt+Enter 从全屏回到窗口后不再变慢:之前切回窗口后每帧多花约 0.3 毫秒,现在自动处理。
  • 最小化再恢复更顺:改用 9Ex 后同样不卡。
  • 启动器「画面比例」新增带鱼屏三项:64:27(5120×2160、2560×1080)、43:18(3440×1440)、12:5(3840×1600),每项带对应的窗口大小;21:9 的窗口大小改为真正 21:9 的尺寸(如 2520×1080、3360×1440)。
  • 启动器逐项检查修正:选「跟随窗口」或恢复默认时渲染倍率一并复位;按键设置里不能再绑定 Alt(会和 Alt+Enter 冲突);迁移存档没有可迁移的文件时会明确提示;版本号显示统一;若干说明文字更正。

1.0.1

  • 修好最小化后恢复窗口黑屏、卡住几秒(无边框与窗口模式):最小化期间画面没有交给屏幕,积压的工作在恢复时一次处理,窗口黑着、游戏停住 1 到 10 秒。现在最小化时照常交付,实测反复最小化再恢复不再卡;游戏速度不变。
  • Windows 10 上启动器左边菜单的图标不再显示成方块:图标字体只有 Windows 11 自带,Windows 10 改用系统自带的同款图标字体。
  • 窗口大小显示更清楚:无边框与全屏时显示「跟随屏幕」与屏幕的实际尺寸(如 5120×2160);窗口模式下屏幕本身的尺寸提示「选无边框可铺满」。

1.0.0 正式版

  • 修好全屏切后台闪退,以及切回来黑屏、只有声音:游戏在关卡里用过一次「可见性测试」后,Direct3D 设备重置就一直失败,画面恢复不了(只剩声音),游戏恰好要新建画面缓冲时就闪退。锁屏、睡眠唤醒、UAC 弹窗后同理。现在重置前先释放它,实测独占全屏反复切后台全部恢复。
  • 修好 21:9 等宽屏下水下花屏:水下的波纹和晃动被当成菜单类 2D 画面压进中间 16:9,两侧出现竖缝;现在铺满全屏(玩家实机验证)。
  • 带鱼屏全屏铺满:启动器「画面比例」新增「跟随显示器」,按显示器真实比例显示:3440×1440(43:18)、3840×1600(12:5)、5120×2160 与 2560×1080(64:27)全屏都不留黑边。
  • 启动器「关于」页的开源仓库链接改为公开的发布仓库。

和重编译版有什么不同

黑之章目前有两种 PC 版。重编译版(基于 ngbrecomp)把游戏代码翻译成一个新的 PC 程序;本项目是原生执行:原版
default.xbe 里的 x86 代码一条不改,直接在 PC 的 CPU 上跑。Xbox 的内核、Direct3D、声音、手柄这些系统部分,由加载器在 PC
上重新实现。

原生移植版(本项目) 重编译版
游戏代码 原版机器码直接执行,不翻译、不改动 翻译成新程序
游戏逻辑 就是原版那份代码 由翻译出的代码重现
显卡要求 Direct3D 9,集成显卡也能跑满 60 帧 Vulkan 1.3
内置游戏 街机版、SFC 三部曲都能从主菜单进入 街机版;不含 SFC 三部曲
存档 标准 Xbox 格式,可与 xRevive 互导 与 Xbox / xemu 分开存放

原生执行的好处:

  • 不会出现「翻译错误」:游戏逻辑就是原版那份代码,不会因为转换产生新 bug。
  • 问题好查:画面、声音上的差异只会出在系统部分,范围小;每处修正的依据都记录在 project/docs/07_证据盘点.md。
  • 整张光盘都能用:游戏通过系统调用切换程序(街机版、SFC 三部曲),加载器照原样重启进入,不用为每个程序单独转换。

另外,原生移植版还有:

  • 手柄:Xbox、PS3/4/5、Switch Pro、Joy-Con、DirectInput 手柄直接用,都带震动。
  • 可选的 Insignia 联网排行榜。
  • 压缩包约 2.7 MB,不用装任何运行库。

怎么玩

  1. 下载 ngb-hurricane-pc-1.1.4-win32.zip,解压到任意位置。
  2. 打开 NGB-Hurricane\Ninja Gaiden Black Hurricane Launcher.exe,在「安装」页选择你自己的 vb-zh-x2.1 镜像(.iso)安装。
  3. 回到「开始游戏」页开始。装好后也可以直接双击 Ninja Gaiden Black Hurricane.exe。

需要:Windows 10 / 11,支持 Direct3D 9 的显卡(集成显卡也可以)。不需要安装任何运行环境。
不包含游戏本身:请使用你自己合法取得的游戏镜像。

这一版有什么

  • 启动器:从镜像安装、显示 / 图形 / 控制设定(按「保存」生效,每项有「?」说明与实测性能影响)、存档备份与还原、与 xRevive 互导存档。
  • 窗口 / 独占全屏 / 无边框;16:9、16:10、21:9(实验性)、4:3、跟随显示器(带鱼屏);渲染倍数 1×–10×;阴影质量、纹理过滤、抗锯齿、垂直同步、性能参数叠加层。
  • 键盘游玩(默认 WASD / 方向键 / J K / 空格 / Esc),手柄按钮可重映射。
  • 内置的 SFC / 街机程序可从游戏中进入。

已知问题

  • 21:9 为实验性:标题画面背景被横向拉宽,部分画面尚未逐一检查。
  • 更多见 README 的「已知问题」。

预发布期间的更新(0.1.0)

2026-10-22 更新:程序带龙剑图标;名称去掉 X21;不经启动器直接双击游戏程序也能启动;游戏默认装在 game\ 文件夹。

2026-10-22 第二次更新:垂直同步只在独占全屏下起作用(窗口和无边框本来不撕裂),独占全屏开垂直同步时集显 60 Hz 屏幕不再变慢(实测游戏速度 78% → 97%,与关闭时相同);启动器英文界面显卡下拉框文字不再重叠。

2026-10-22 第三次更新:主菜单最下面加了「退出游戏」,用游戏自己的确认框问「要退出游戏吗?」(Ⓐ是 退回桌面,Ⓑ否 回到菜单);21:9 / 16:10 下标题画面与各菜单完整保持 16:9,不再被拉宽(21:9 左右、16:10 上下留黑边)。

2026-10-22 第四次更新:修复夜景等场景里光晕闪烁、人物身上有重影、转视角时光晕像螺旋转动的问题,光晕效果照原版截图还原为柔和的一团。

2026-10-23 第五次更新:联网排行榜(可选)。用你自己在 xemu 里注册过 Insignia 的主机与账号,在游戏「排行榜」里登录并查看真实榜单。默认关闭,不打开时和以前完全一样;打开后性能实测不变(集显第 1 章 97.7%)。

怎么联网

  1. 先在 xemu 里按 Insignia 官网的说明注册主机和账号,确认 xemu 里能登录。
  2. 关掉 xemu(同一台主机不能同时登录两次)。
  3. 在 NGB-Hurricane\black.ini 里加三行(没有这个文件就新建):
    online = 1
    online_eeprom = 你的xemu的eeprom.bin路径
    online_hdd = 你的xemu的xbox_hdd.qcow2路径
    
    两个文件只读,不会被修改。
  4. 游戏主菜单 →「排行榜」→ 选自己的玩家代号登录。

要不要开 InsigniaDNS.exe? 默认不用:DNS 默认交给「Insignia 公网 DNS」,也就是 Insignia 架在网上的服务器,什么都不用装。「本地 InsigniaDNS.exe」是在你电脑上运行的小程序,开着代理 TUN 时才需要:先关 TUN,启动它,再开 TUN,然后在联网页选它。出现「无法连接 XBOX LIVE」按 Ⓑ。详见 README「联网」。
2026-10-23 第六次更新:启动器加了「联网」页,不用再手改 black.ini。

  • 页面里可以开关联网,选 EEPROM 与硬盘镜像。选好后会自动检查:主机身份是否有效、是否注册过、有哪些玩家代号。
  • DNS 查询方式默认「直接用 Insignia DNS」(现叫「Insignia 公网 DNS」),不用再开 InsigniaDNS.exe。也可以选「按主机设定」,和 xemu 一样。
  • 「检查网络」一键查出 DNS 是否正常、是否被代理软件的 TUN 模式截走。
  • 游戏右下角会提示「已连接 Insignia」,连不上时会说明原因。
  • 排行榜里「无法连接」「修复玩家代号」框按 Ⓐ 也是取消,不会再重启游戏。

2026-10-23 第七次更新:第二种 DNS 方式改为「用 InsigniaDNS」(现叫「本地 InsigniaDNS.exe」)。

  • 地址直接在启动器里填,或点「找本机」自动找到这台电脑上正在运行的 InsigniaDNS。
  • 不再用 xemu 主机设定里写死的地址,所以换电脑、换网络后只要在启动器里改一下。
  • 代理软件的 TUN 模式截走公网 DNS 时用它:实测 Clash TUN 开着也能经本机 InsigniaDNS 登录。
  • DNS 一栏第一行改为「当前 DNS」:直接显示游戏实际会用的 DNS 和自动 / 手动,不再显示用不到的 xemu 主机设定。

2026-10-23 第八次更新:联网页「登录」卡加了「注册步骤」按钮,点开是在 xemu 里注册 Insignia 的六步说明(整理自 Insignia 官网的连接指南)。

2026-10-23 第九次更新:分清两个名字很像的 DNS。

  • 「Insignia 公网 DNS」是 Insignia 架在网上的服务器,什么都不用装;「本地 InsigniaDNS.exe」是在你电脑上运行的小程序。启动器、游戏内提示和 README 都统一用这两个叫法。
  • 开着代理 TUN 时:先关 TUN,启动 InsigniaDNS.exe,再开 TUN,然后选「本地 InsigniaDNS.exe」,就能照常登录(实测)。

2026-10-23 第十次更新:修好手柄震动。

  • 以前移植版读错了游戏的震动数据,大马达(左)的震动从来没发给手柄,小马达的震动也错发到了大马达上,所以很多震动缺失(例如砍中敌人时)。
  • 现在左右马达都和原机一样:按住 Y 蓄力时一直震,放出超杀、砍中敌人时也会震(实测,并经玩家在手柄上确认)。

2026-10-23 第十一次更新:启动器「关于」页加了「请作者喝杯茶」。《黑之章》的中文汉化、飓风补丁和这个 PC 移植版都是我做的,都免费,以后也一直免费。觉得值一杯茶的话,按钮里有微信和支付宝收款码,转账时请备注姓名或昵称;不赞助也完全没关系。

2026-10-23 第十二次更新:赞助挪到启动器左边菜单最后一项「支持作者」(金色的心),页面标题改为「请作者喝杯奶茶」;「关于」页不再有赞助按钮。支付宝收款码中间的照片换成了一张猫的插画,码本身没变(实测能扫)。

2026-10-23 第十三次更新:修好黑屏 / 白屏过场时画面左边、上边漏光(遮罩没盖住最边上的一两行像素,底下的场景透出来)。

2026-10-23 第十四次更新:支持更多手柄,不用再装 DS4Windows:PS4 / PS5 手柄、Switch Pro 手柄、Joy-Con(一对或单只)、DirectInput 手柄与老手柄的 USB 转接器(PS3 手柄需先装驱动),都带震动。按键按位置对应 Xbox 布局(最下面的键是 A),PS 手柄按下触摸板等于 Back。遇到问题可加启动参数 --no-sdl-pads 只用 XInput,并把 black.log 发给我。

-symbols.zip 是调试符号,只在回报崩溃时需要。


English

An unofficial native Windows port of Ninja Gaiden Black's Hurricane Chinese translation vb-zh-x2.1 (original Xbox). 1.1.4.

1.1.4

  • Fixed the crash on Steam Deck (Proton) after the warning screen, before the Team Ninja logo movie: when a movie starts, the game executes a privileged instruction that flushes the CPU cache, which the program skips; Windows reports it as a "privileged instruction", but Proton reports it as an "access violation", which was not recognized, so the game exited. Now both are recognized (based on a player's Steam Deck log, Proton 11.0-2). Nothing changes on Windows; game speed measured unchanged on integrated graphics. Still waiting for a player's test on a Steam Deck; if there is a problem, please attach logs\black.log from the game folder.

1.1.3

  • Attempted fix for "dirty disc" at startup on Steam Deck (Proton / Wine): at startup the game lists the movie folder on the disc, and our folder query passed a parameter Wine does not support (Wine answers "not implemented" to it every time), so the game could not list the folder and took the disc for damaged. Now the parameter is not passed (the same fix as upstream black-pc's). Nothing changes on Windows; game speed measured unchanged on integrated graphics. Not yet verified on a real Steam Deck; reports welcome. If it still fails, please attach logs\black.log from the game folder.

1.1.2

  • New setting "Fullscreen resolution" (the launcher's Display page) for lower-end PCs: with "Window size", fullscreen and borderless output the picture at the window size (keeping the screen's shape, no distortion) and then scale it up to fill the screen; the picture is a little softer, but the graphics card has fewer pixels to handle. With the render resolution set to "Follow the window", the 3D picture is drawn at that size too. The display's resolution is not switched. Measured on integrated graphics (1920×1200 screen, 1280×720 window): borderless 9.37 → 8.47 ms per frame. To lighten the graphics card, lowering the render resolution on the Graphics page is still the most effective. The default, "Follow the screen", is as before.
  • Fixed Alt+Enter not getting back to a window from exclusive fullscreen (introduced in 1.1.1).
  • Win+D minimizes properly in exclusive fullscreen; while minimized, the graphics device is no longer reset every few seconds.
  • Fixed a rare double reset (about 0.2 s more pause) when Alt+Enter returns to exclusive fullscreen.

1.1.1

  • Fixed enemies without shadows in boss fights (such as Murai and the white-robed ninja in chapter 1): boss fights use one more shadow map, which was not recognized, and its depth buffer was made smaller than the map itself, so the enemies' shadows were never drawn. Now they have shadows as in the original (compared with xemu), confirmed by a player on their PC.
  • Fixed the game covering the screen again after Win+D in borderless fullscreen: the borderless window could not be minimized by "Show desktop", only hidden for the moment, so opening any other program brought the game back over the whole desktop. Now Win+D really minimizes the game, and its taskbar icon minimizes and restores it too.

1.1.0

  • Graphics now use Direct3D 9Ex (the newer Direct3D 9 built into Windows 10/11): a fullscreen game going to the background, a lock screen or a UAC prompt no longer loses the graphics device; coming back simply continues, with nothing to rebuild. 1.0.0's crash on going to the background and the black screen with only sound can no longer happen at all. Game speed unchanged (measured on integrated graphics).
  • Automatic recovery after a graphics driver crash or restart: when the driver hangs, is reset or is updated, the whole graphics device with all picture resources is rebuilt and the game keeps running, no black screen (rebuilt 20 times in a row: no memory growth, the same picture).
  • No slowdown after Alt+Enter from fullscreen back to a window: each frame used to take about 0.3 ms more after returning to a window; now it is handled automatically.
  • Smoother minimize and restore: with 9Ex it does not stall either.
  • Three ultrawide entries in the launcher's "Aspect ratio": 64:27 (5120×2160, 2560×1080), 43:18 (3440×1440), 12:5 (3840×1600), each with matching window sizes; 21:9's window sizes are now truly 21:9 (e.g. 2520×1080, 3360×1440).
  • Launcher checked item by item: choosing "Follow the window" or restoring defaults also resets the render scale; Alt can no longer be bound in the key settings (it would clash with Alt+Enter); migrating saves says clearly when there is nothing to migrate; version numbers shown the same way everywhere; several texts corrected.

1.0.1

  • Fixed a black, frozen window for a few seconds when restoring after minimizing (borderless and window modes): while minimized, frames were not handed to the screen, and the backlog was processed all at once on restore, leaving the window black and the game stopped for 1 to 10 seconds. Now frames are handed over as usual while minimized; measured, minimizing and restoring again and again no longer stalls, and the game speed is unchanged.
  • The icons in the launcher's left menu no longer show as boxes on Windows 10: the icon font only comes with Windows 11; Windows 10 uses its own built-in font with the same icons.
  • Clearer window size display: in borderless and fullscreen it shows "Follow the screen" with the screen's actual size (e.g. 5120×2160); in window mode the screen's own size hints "choose borderless to fill it".

1.0.0 full release

  • Fixed the crash when a fullscreen game goes to the background, and the black screen with only sound after coming back: once the game had used a "visibility test" in a stage, every Direct3D device reset failed, the picture never came back (only the sound), and the game crashed whenever it happened to create a new picture buffer. The same after a lock screen, waking from sleep or a UAC prompt. Now it is released before the reset; measured, exclusive fullscreen recovers every time after going to the background again and again.
  • Fixed the broken underwater picture on 21:9 and other wide screens: the underwater ripples and wobble were treated as menu-style 2D and squeezed into the middle 16:9, leaving vertical gaps at the sides; now they fill the screen (verified by a player on their PC).
  • Ultrawide screens filled in fullscreen: the launcher's "Aspect ratio" has a new "Follow the display" that shows the display's real shape: 3440×1440 (43:18), 3840×1600 (12:5), 5120×2160 and 2560×1080 (64:27) all fill the fullscreen without black bars.
  • The open-source repository link on the launcher's About page now points to the public release repository.

How it differs from the recompiled version

Ninja Gaiden Black has two PC versions now. The recompiled version (based on ngbrecomp) translates the game's code into a new PC program; this project runs it natively: the x86 code in the original
default.xbe runs unchanged, directly on the PC's CPU. The Xbox's kernel, Direct3D, sound and controllers, the system parts, are
reimplemented on the PC by the loader.

Native port (this project) Recompiled version
Game code The original machine code runs as it is, not translated, not changed Translated into a new program
Game logic The original code itself Reproduced by the translated code
Graphics Direct3D 9; integrated graphics run it at a full 60 fps Vulkan 1.3
Bundled games The arcade game and the SFC trilogy all start from the main menu The arcade game; no SFC trilogy
Saves Standard Xbox format, exchangeable with xRevive Kept apart from the Xbox / xemu

What running it natively brings:

  • No "translation errors": the game logic is the original code, so the conversion cannot add new bugs.
  • Problems are easy to find: differences in picture or sound can only come from the system parts, a small area; the evidence for every fix is recorded in project/docs/07_证据盘点.md.
  • The whole disc works: the game switches programs (the arcade game, the SFC trilogy) through system calls, and the loader restarts into them as the console does, with no separate conversion per program.

The native port also has:

  • Controllers: Xbox, PS3/4/5, Switch Pro, Joy-Con and DirectInput pads work directly, all with rumble.
  • Optional Insignia online leaderboards.
  • A zip of about 2.7 MB, with no runtimes to install.

How to play

  1. Download ngb-hurricane-pc-1.1.4-win32.zip and extract it anywhere.
  2. Open NGB-Hurricane\Ninja Gaiden Black Hurricane Launcher.exe and on the Install page choose your own vb-zh-x2.1 image (.iso) to install.
  3. Go back to the Play page and start. Once installed you can also double-click Ninja Gaiden Black Hurricane.exe directly.

Requirements: Windows 10 / 11 and a graphics card with Direct3D 9 (integrated graphics are fine). No runtime to install.
Not included: the game itself. Use your own legally obtained game image.

What this version has

  • Launcher: installing from the image, display / graphics / controls settings (applied with Save; each item has a "?" with an explanation and its measured performance cost), save backup and restore, save exchange with xRevive.
  • Window / exclusive fullscreen / borderless; 16:9, 16:10, 21:9 (experimental), 4:3, follow the display (ultrawide); render scale 1×–10×; shadow quality, texture filtering, anti-aliasing, vsync, a performance overlay.
  • Keyboard play (default WASD / arrow keys / J K / Space / Esc); controller buttons can be remapped.
  • The bundled SFC / arcade programs start from inside the game.

Known issues

  • 21:9 is experimental: the title screen's background is stretched sideways, and some screens have not been checked one by one yet.
  • More under "Known issues" in the README.

Updates during the pre-release (0.1.0)

Update 2026-10-22: the program has the Dragon Sword icon; "X21" is gone from the names; double-clicking the game program without the launcher also starts it; the game installs into the game\ folder by default.

Second update 2026-10-22: vsync only acts in exclusive fullscreen (window and borderless do not tear anyway); with vsync on in exclusive fullscreen, a 60 Hz screen on integrated graphics no longer slows down (measured game speed 78% → 97%, the same as with it off); the graphics card list in the launcher's English interface no longer overlaps.

Third update 2026-10-22: an "Exit game" row at the bottom of the main menu, asking "Exit the game?" in the game's own confirmation box (Ⓐ Yes back to the desktop, Ⓑ No back to the menu); at 21:9 / 16:10 the title screen and all menus stay a complete 16:9 and are no longer stretched (black bars left and right at 21:9, top and bottom at 16:10).

Fourth update 2026-10-22: fixed the glow flickering in night scenes and others, ghost images on characters, and the glow swirling like a spiral when the camera turns; the glow is back to the soft haze of the original screenshots.

Fifth update 2026-10-23: online leaderboards (optional). With the console and account you registered with Insignia in xemu, sign in from the game's Ranking menu and see the real leaderboards. Off by default, and with it off everything is as before; with it on, the measured performance is unchanged (integrated graphics, chapter 1: 97.7%).

How to go online

  1. First register a console and an account in xemu as Insignia's website explains, and check that you can sign in in xemu.
  2. Close xemu (one console cannot sign in twice at the same time).
  3. Add three lines to NGB-Hurricane\black.ini (create the file if it does not exist):
    online = 1
    online_eeprom = path to your xemu eeprom.bin
    online_hdd = path to your xemu xbox_hdd.qcow2
    
    Both files are only read, never changed.
  4. Game main menu → Ranking → choose your gamertag to sign in.

Do I need InsigniaDNS.exe? Not by default: DNS goes to "Insignia's public DNS", the server Insignia runs on the internet, with nothing to install. "Local InsigniaDNS.exe" is a small program running on your PC, needed only with a proxy's TUN on: turn TUN off, start it, turn TUN back on, then choose it on the Online page. If "Cannot connect to XBOX LIVE" appears, press Ⓑ. Details in the README, "Online".
Sixth update 2026-10-23: the launcher has an "Online" page, no more editing black.ini by hand.

  • The page turns online play on and off and picks the EEPROM and hard disk image. Once chosen, they are checked automatically: whether the console identity is valid, whether it is registered, which gamertags it has.
  • DNS lookups default to "Use Insignia DNS directly" (now called "Insignia's public DNS"), no InsigniaDNS.exe needed. "As the console is set" is also available, as in xemu.
  • "Check network" finds out with one click whether DNS works and whether a proxy's TUN mode is taking it over.
  • The bottom right of the game shows "Connected to Insignia", or the reason when it cannot connect.
  • In Ranking, Ⓐ on the "Cannot connect" and "Repair gamertag" boxes also cancels and no longer restarts the game.

Seventh update 2026-10-23: the second DNS choice is now "Use InsigniaDNS" (now called "Local InsigniaDNS.exe").

  • Enter the address in the launcher, or press "This PC" to find the InsigniaDNS running on this computer.
  • The address fixed in xemu's console settings is no longer used, so after changing computer or network you only change it in the launcher.
  • Use it when a proxy's TUN mode takes over public DNS: measured, with Clash TUN on, signing in through the local InsigniaDNS works.
  • The DNS box's first row is now "Current DNS": the DNS the game will actually use, and whether automatic or manual, instead of xemu console settings that are not used.

Eighth update 2026-10-23: the Online page's "Sign in" card has a "How to register" button with six steps for registering with Insignia in xemu (taken from the connection guide on Insignia's website).

Ninth update 2026-10-23: two DNS options with similar names told apart.

  • "Insignia's public DNS" is the server Insignia runs on the internet, nothing to install; "Local InsigniaDNS.exe" is a small program running on your PC. The launcher, the in-game messages and the README all use these two names.
  • With a proxy's TUN on: turn TUN off, start InsigniaDNS.exe, turn TUN back on, then choose "Local InsigniaDNS.exe", and signing in works as usual (measured).

Tenth update 2026-10-23: controller rumble fixed.

  • The port used to read the game's rumble data wrongly: the big (left) motor's rumble never reached the controller, and the small motor's went to the big one, so a lot of rumble was missing (for example when a hit lands).
  • Now both motors work as on the console: holding Y to charge rumbles all the way, and Ultimate Techniques and hits rumble too (measured, and confirmed by a player on a controller).

Eleventh update 2026-10-23: the launcher's About page has "Buy the author a tea". The Chinese translation of Ninja Gaiden Black, the Hurricane patch and this PC port are all my work, all free, and they will stay free. If you think it is worth a cup of tea, the button shows WeChat and Alipay payment codes; please add your name or nickname to the transfer. Not sponsoring is completely fine too.

Twelfth update 2026-10-23: sponsoring moved to the last item of the launcher's left menu, "Support the author" (a golden heart), with the page titled "Buy the author a milk tea"; the About page no longer has a sponsor button. The photo in the middle of the Alipay code is now a cat illustration; the code itself is unchanged (measured, it scans).

Thirteenth update 2026-10-23: fixed light leaking at the left and top edges during black / white fade cutscenes (the cover missed the outermost one or two rows of pixels and the scene below showed through).

Fourteenth update 2026-10-23: more controllers, no DS4Windows needed: PS4 / PS5 controllers, the Switch Pro controller, Joy-Con (a pair or one), DirectInput pads and USB adapters for older pads (PS3 controllers need their driver first), all with rumble. Buttons follow the Xbox layout by position (the bottom button is A); pressing a PS controller's touchpad is Back. If something goes wrong, the launch option --no-sdl-pads uses XInput only; please send me black.log.

-symbols.zip holds the debug symbols, needed only when reporting a crash.

Don't miss a new ngb-pc-native-port-release release

NewReleases is sending notifications on new releases.