格斗联机 · 新手上手教程

跟着做,5 分钟就能和朋友对打 · 不需要任何技术背景

第 0 步 · 先下载这个小工具

网页要用到电脑上的一个"小助手"。它不修改游戏文件,只是在旁边帮你转发按键。 下载解压即可,不需要安装到系统里。

解压后你会看到这 4 个可以双击的文件(按编号用)
① 我是房主-点我启动.bat  ← 每次联机双击这个(开小助手)
② 没装Node-先装这个.bat  ← 只有提示缺 Node.js 时才点
③ 检查环境.bat           ← 出问题先点这个,它会告诉你缺什么
④ 手动接入-输房间码.bat  ← 网页检测不到助手时,用它手动接入(会问你房间码)
使用说明.txt               ← 同样内容,可离线看
关于"在 cmd 里输入命令"—— 你不需要打命令
教程和页面上有时会给出类似这样的一行命令:
node tools/api-agent.js --mode join --code 3C16 --poll 50
那是给开发者看的。你只要双击 ④ 手动接入-输房间码.bat,然后按提示输入 4 位房间码就行, 脚本会自动帮你把这条命令跑起来。
(如果哪天真要手打:必须先在客户端文件夹里打开命令行,否则会提示"node 不是内部命令"。)

先说清楚:为什么需要那个"小助手"

浏览器出于安全限制,不能启动你电脑上的程序,也不能往游戏窗口里模拟按键。 而联机必须做到"把对手的按键,送进你的游戏里"。

所以流程是这样的:

你的按键  →  小助手 读取  →  发给房间服务器  →  对手的小助手拿回来  →  注进对手的游戏
对手的按键  →  对手小助手读取  →  服务器  →  你的小助手  →  注进你的游戏

小助手只做这一件事,不碰游戏文件、不改游戏程序、不装驱动。关掉它联机就停了,删掉文件夹就等于卸载。

开始联机(四个步骤)

  1. 两边各开一次小助手

    双击刚才解压出来的 ① 我是房主-点我启动.bat,会弹出一个黑色窗口。

    成功的标志
    黑窗口里出现 启动服务,端口 7788 —— 就对了。
    注意
    这个黑窗口要一直开着,别关。最小化没问题,但关掉联机就断了。
    窗口一闪就没了?
    说明电脑缺 Node.js。双击 ② 没装Node-先装这个.bat,按提示装好后,再回来双击 ①。
  2. 两边各打开游戏,先停在标题界面

    就是显示 BLEACH VS NARUTO 主菜单的那一屏,先别进对战。

  3. 网页上建房 / 加入

    打开 房间页,起个昵称,然后:

    你是谁做什么
    房主点 ⚡ 一键联机,页面会给你一个 4 位房间码(例如 3C16)
    朋友在房间码输入框里填那 4 位码 → 点「加入房间」 → 再点一次 ⚡ 一键联机
    页面顶部那行状态
    显示 本地助手在线 · 端口 7788 才说明一键联机可用; 显示黄色告警说明黑窗口没开,回去做第 1 步。
  4. 两边同时进同一张地图,开打

    网页上两个槽位都显示名字后,两边各自在游戏里选人、选同一张地图、同时开局。 之后你的操作都正常,对面的角色由对手的按键驱动。

关于"双击桌面的 SSV 联机助手"—— 这句话什么意思

先说结论:你其实不需要它。用上面第 1 步的 ① 我是房主-点我启动.bat 就完全够用, "双击桌面图标"只是另一种更省事的启动方式。

如果你以前双击过项目里的 安装.bat,它会在你的 Windows 桌面上放一个图标。 所谓"桌面",就是电脑开机后看到的那一屏(壁纸上面摆着各种程序图标的地方); 所谓"双击",就是用鼠标左键连着快点两下——和双击微信、双击游戏图标一模一样。

🗑
回收站
🌐
浏览器
⚡
SSV 联机助手
🎮
游戏

左边的示意图里,那个被高亮圈起来的 ⚡ SSV 联机助手 就是要双击的目标。 双击它等于双击 ① 我是房主-点我启动.bat,效果完全一样——都是把那个黑窗口开起来。

三种等价的开法,任选一种
A. 双击解压文件夹里的 ① 我是房主-点我启动.bat(最稳,推荐)
B. 双击桌面上的 SSV 联机助手 图标(前提是跑过 安装.bat)
C. 网页上助手没开时,点提示里的「点这里唤起助手」,浏览器问一次"是否允许打开",选允许

遇到问题先看这里

网页提示"未检测到本地助手" 点开
按 A → B → C 顺序排查:
A. 黑窗口没开 → 双击 ① 我是房主-点我启动.bat(或桌面图标),保持窗口开着
B. 窗口开着但仍检测不到 → 点网页上的「重新检测」;若还是不行,是浏览器拦了本机访问
C. 走手动接入 → 记下网页上的 4 位房间码,双击 ④ 手动接入-输房间码.bat,按提示输入房间码。 效果和一键联机一样,只是少了网页通知这一步。
"node tools/api-agent.js ..." 这种命令要在哪输入 点开
不需要手打。那是给开发者看的命令行版本;你双击 ④ 手动接入-输房间码.bat 就够了, 它会帮你跑。
真要在 cmd 里手打的话,必须先进入客户端文件夹再输入(文件夹地址栏输入 cmd 回车即可), 否则会报"node 不是内部或外部命令"。
双击启动器,黑窗口一闪就消失了 点开
几乎都是缺 Node.js。双击 ③ 检查环境.bat 看提示: 如果写着「[缺失] Node.js 没装」,就先双击 ② 没装Node-先装这个.bat 去官网装 LTS 版,装完再试。
按键没反应,对面的角色不动 点开
游戏窗口必须是当前最前面的窗口。小助手只在游戏处于前台时才转发按键—— 这是故意的,免得你在微信里打字也被当成游戏操作。切回游戏再试。
房间码输进去提示"房间不存在" 点开
三种可能:① 输错了(房间码是 4 位大写字母加数字);② 房主把网页关了或点了退出房间; ③ 房间放太久被服务器回收(重新点一键联机建房,把新码给对方)。
感觉有明显延迟 点开
这是正常的。网页这套方案走 HTTP 轮询,输入延迟大约 0.28 秒, 适合朋友随便打打、慢节奏玩法。想要竞技手感需要另外的 UDP 服务器方案,那条路已经做好了, 但需要一台能开放 UDP 端口的主机。
杀毒软件报毒 / 防火墙弹窗 点开
小助手是个本地 Node.js 程序,监听 127.0.0.1:7788(只对本机开放,外网访问不到)。 部分安全软件会对"模拟按键"的行为敏感并提示,选择允许即可;不放心就先关掉它,删掉文件夹就等于卸载。
怎么彻底卸载 点开
直接删掉解压出来的文件夹。它不往系统里装任何东西—— 唯一可能留下的痕迹是桌面快捷方式和注册表里的 ssvnetplay:// 协议(如果你跑过 安装.bat), 删快捷方式即可,协议可执行 reg delete "HKCU\Software\Classes\ssvnetplay" /f 清除。
能在一台电脑上开两个游戏自己跟自己打吗 点开
不行。小助手是把按键注入到游戏窗口的,同一台电脑上两个游戏实例会互相抢键盘。 需要两台电脑(同一局域网或各自上网都可以)。

网页上那些状态是什么意思

显示含义 / 怎么办
本地助手在线一切正常,可以点一键联机
本地助手未运行黑窗口没开,去双击启动器
P1 / P2 槽位灰着对手还没进房,把房间码给他
某一侧的按键指示灯在亮那一侧的玩家正在按键(可以借此确认对方真的在动)
往返 / 轮询网络往返耗时和刷新频率,正常值约 190ms / 50ms
帧号服务端累计的输入帧序号,一直在涨说明通信正常