泰坦陨落2 神经链接 · Titanfall 2 Neural Link

中文 · English

让 Coo 接入《泰坦陨落 2》单人战役，当你的泰坦 BT-7274。 Puts Coo into BT-7274, your titan in the Titanfall 2 campaign.

中文

Coo 以 BT 的身份陪你打单人战役：看着战况提醒你，替 BT 出手，在游戏里用 BT 的字幕和声音说话。适合一边玩战役一边和 Coo 搭档。经本包自带的 Northstar 模组和一个本机 sidecar 进程连接游戏。

功能

• 铁驭、BT 和敌人的情报实时送给 Coo。敌方泰坦或死神出现、铁驭低血量、BT 护盾被打穿、交火开始时立刻提醒。
• 跟着剧情台词走。对话模型能看图时，剧情台词会附一张当时的游戏画面。
• 地图导引：目标点、这一关还没拿到的铁驭头盔、BT 装备拾取物、地上的泰坦电池在哪。
• 替 BT 出手：向指定敌人发射追踪飞弹、放电烟幕、放声纳、隔墙标记敌人、让单独作战的 BT 集火。
• 说话时游戏里出 BT 的字幕，用复刻的 BT 声音念出来。声音在本机合成，样片从你自己的游戏里截取。
• 主动程度分被动、均衡、主动三档。
• 跟 Coo 说「打开泰坦陨落」,Coo 会替你装好缺的组件并打开游戏(titanfall2_launch)。

安装前准备

1. Windows 电脑。 推荐 NVIDIA 显卡：BT 的声音靠显卡合成，没有 N 卡也能用，合成会慢很多。
2. Coopanion 或任何 Cortico 部署,配好一个对话模型。
3. 泰坦陨落 2(Steam 版或 EA 版)。Steam 里装的会自动找到;装在别处的，在 World 页签「快速启动」的「游戏目录与模组」里粘贴游戏目录后按回车。
4. EA App,装好并登录。Steam 版也靠它登录。「快速启动」页签第一行显示「EA App 已装」就是装好了。
5. Northstar、模组和 BT 语音组件:不用自己装。启用 World 后在「快速启动」页签点一次「一键准备」:
   • 往游戏目录装 Northstar v1.31.14(约 107 MB)和本包的模组(源码在仓里 mod/Cortico.Titanfall2Assistant,是脚本，不用编译),写好显示设置。
   • 开始下载缺的 BT 语音组件，进度在「BT 语音」里。默认引擎 GPT-SoVITS 有 N 卡时约 6 GB、没有约 2.5 GB,优先从魔搭下载;另一个引擎 VoxCPM2 约 5.6 GB,只能用 N 卡，从 GitHub 和 Hugging Face 下载。组件和 cortico-world-gpt-sovits-for-coopanion、vtuber 扩展共用。
   • 第一行显示「Northstar 已装」「BT 语音组件齐全」就准备好了。语音组件没下完也能玩，BT 先只出字幕。

安装

在 Cortico 或 Coopanion 的扩展页搜 cortico-world-titanfall2-assistant 安装，重启后在 World 总览里启用。

命令行部署：

cd extensions
corepack pnpm add cortico-world-titanfall2-assistant
corepack pnpm approve-builds koffi audify

再在配置里启用 worlds.titanfall2。koffi(调 Windows 接口、截游戏画面)和 audify(播放 BT 的声音)带原生模块，扩展页安装时自动批准构建，命令行安装要用上面的 approve-builds。

使用

World 有两个页签:「快速启动」和「画面与切窗」。

1. 先打开 EA App 并登录。
2. 在「快速启动」点「启动游戏」,或者跟 Coo 说「打开泰坦陨落」。会启动 BT 语音、写好显示设置、打开游戏并切到前台。
3. 第一次进主菜单，Northstar 会问要不要用 EA 令牌登录它的主服务器。单人战役用不到，选「否」。
4. 在主菜单选「战役」,再选「继续」或「选择任务」进入关卡。面板显示「已连上」后 BT 就开始工作。
5. 正常玩。有事直接跟 Coo 说，比如「打那台泰坦」「放烟幕」「下一个目标在哪」。

Coo 什么时候开口由「BT 的主动程度」决定(「快速启动」页签，改了立刻生效):

• 被动：铁驭开口或下令才说话、出手，只有要命的时候主动提醒。
• 均衡(默认):提醒要紧的威胁，战况吃紧时主动用飞弹、烟幕或声纳帮一把。
• 主动：全程配合作战，主动开火、放烟幕、标记，脱战后报下一步该去哪。

「画面与切窗」页签：显示模式默认是铺满屏幕的无边框窗口，桌宠能显示在游戏上面(独占全屏会盖住桌宠)。切到别的窗口(比如在桌宠里打字)时游戏默认继续运行，不暂停、不静音。

想让桌宠的气泡和 BT 的字幕、声音同时出现，跟 Coo 说：「泰坦频道和气泡放在同一次回复里，泰坦频道在前，气泡紧跟在后面。」

配置

常用项。「快速启动」「画面与切窗」页签和配置页签都能改。

| 键 | 默认 | 说明 | |---|---|---| | gameDir | 空 | 游戏目录;留空找 Steam 里的那份 | | initiative | balanced | 主动程度:passive、balanced、active | | display.mode | borderless | 显示模式:borderless 无边框、windowed 窗口、fullscreen 独占全屏、game 保持游戏里的设置 | | display.resolution | 空 | 形如 2560x1600;留空用主屏分辨率 | | focus.keepRunning | true | 切到别的窗口时游戏继续运行 | | voice.engine | gpt-sovits | BT 语音引擎:gpt-sovits 或 voxcpm2(只能用 N 卡) | | voice.sampleLanguage | tchinese | 截样片用的游戏语音包，如 english | | story.language | tchinese | 游戏字幕语言，如 english | | story.frameSec | 30 | 剧情事件附游戏画面的最短间隔(秒);0 不附 | | subtitle.traditional | true | 字幕用繁体(繁中版游戏的字体只有繁体字) |

其余见 src/config.ts。实现细节(协议、启动流程、工具与事件、字幕与语音)见 docs/internals.md。

限制与常见问题

• 一定用「启动游戏」或让 Coo 启动游戏。 从 Steam 或 EA App 直接点开始，启动的是不带 Northstar 的原版，Coo 收不到游戏里的情况。面板会提示「从 Steam 启动的是原版」,关掉游戏再点「启动游戏」。
• 游戏弹出 #ORIGIN_LOGGED_OUT 后退出:EA App 还没登录完。等它登录好再点「启动游戏」。
• 游戏弹出「There was a problem processing game logic」回到主菜单:已知问题，多见于第 7 章开场炸墙一次刷出大量敌人时。原因是 Northstar 的网络回调和游戏生成敌人的脚本撞在一起。扩展已尽量减少，不能完全避免。点「继续」重进即可。
• GPT-SoVITS 和 VoxCPM2 怎么选:游戏和语音合成抢同一块显卡。实测游戏运行时 GPT-SoVITS 一句可能要十几秒，VoxCPM2 两三秒。有 N 卡的话 VoxCPM2 跟得更紧;没有 N 卡只能用 GPT-SoVITS(CPU 档),BT 说得比较慢。
• 游戏不是国语配音时:默认样片取自繁体中文(国语配音)语音包。到配置里把「样片语言」改成游戏的语言(如 english),并把「样片台词」和「样片文字」换成那个语言里的一句 BT 台词及其逐字稿。
• 字幕是繁体:繁体中文版游戏的字体里没有简体字。英文版游戏可以在配置里关掉「字幕用繁体」。
• 会改动游戏目录和设置:往游戏目录装 Northstar 和模组。删掉 NorthstarLauncher.exe、NorthstarLauncher.pdb、r2ds.bat、ns_startup_args*.txt、R2Northstar\、bin\x64_dedi\ 和 bin\x64_retail\wsock32.* 就回到原版。一键准备和启动游戏前按「画面与切窗」改写游戏的显示设置(「显示模式」选「保持游戏里的设置」则不改)。
• 剧情画面会发给模型:对话模型能看图时，剧情台词会附一张当时的游戏截图，按模型的用量计费。截图从屏幕上读，挡在游戏上面的窗口(如桌宠)也会截进去。
• 只支持单人战役，不支持多人模式。

English

Coo rides along as BT through the single-player campaign. Coo watches the fight and warns you, acts for BT, and talks in the game with BT's subtitles and voice. It suits playing the campaign with Coo as your partner. The World talks to the game through a Northstar mod shipped in this package and a local sidecar process.

Features

• Live intel on the pilot, BT and hostiles. Coo is warned at once when an enemy titan or reaper shows up, the pilot runs low, BT's shield breaks or a firefight starts.
• Follows the campaign dialogue. If the chat model takes images, story lines come with a frame of the game at that moment.
• Map guide: the objective, pilot helmets not yet collected on this level, BT loadout pickups and titan batteries on the ground.
• Acts for BT: homing missiles at chosen hostiles, electric smoke, sonar, wall-hack marks on hostiles, and focus fire for BT when it fights on its own.
• When Coo speaks, BT's subtitle appears in the game and a clone of BT's voice reads it. The voice is synthesized on your machine from a line cut out of your own copy of the game.
• Three initiative levels: passive, balanced and active.
• Tell Coo to open Titanfall and Coo installs whatever is missing and opens the game (titanfall2_launch).

Before you install

1. A Windows PC. An NVIDIA GPU is recommended. BT's voice is synthesized on the GPU; without one it still works, much more slowly.
2. Coopanion or any Cortico deployment with a chat model set up.
3. Titanfall 2 (Steam or EA). A Steam copy is found on its own. For another folder, paste it under "Game folder and mod" on the World's Quick start tab and press Enter.
4. The EA app, installed and signed in. The Steam copy signs in through it too. The first line of the Quick start tab reads "EA app installed" when it is in place.
5. Northstar, the mod and BT's voice files are installed for you. Turn the World on and press Prepare once on the Quick start tab:
   • It installs Northstar v1.31.14 (about 107 MB) and this package's mod into the game folder (source in mod/Cortico.Titanfall2Assistant; it is script, nothing to compile), and writes the display settings.
   • It starts downloading BT's missing voice files; progress shows under "BT voice". The default engine, GPT-SoVITS, needs about 6 GB with an NVIDIA GPU and about 2.5 GB without, from ModelScope first. The other engine, VoxCPM2, is about 5.6 GB, needs an NVIDIA GPU, and comes from GitHub and Hugging Face. The files are shared with cortico-world-gpt-sovits-for-coopanion and the vtuber extension.
   • You are set when the first line reads "Northstar installed" and "BT voice files present". You can play before the voice files finish; BT shows subtitles only until then.

Install

Search for cortico-world-titanfall2-assistant on the Extensions page of Cortico or Coopanion, install it, restart, then turn it on in the World overview.

From the command line:

cd extensions
corepack pnpm add cortico-world-titanfall2-assistant
corepack pnpm approve-builds koffi audify

Then enable worlds.titanfall2 in the config. koffi (Windows calls and game capture) and audify (BT's audio output) have native modules. The Extensions page approves their builds on install; from the command line, run approve-builds as above.

Usage

The World has two tabs: Quick start and Display and focus.

1. Open the EA app and sign in.
2. Press Launch game on Quick start, or tell Coo to open Titanfall. It starts BT's voice, writes the display settings, opens the game and brings it to the front.
3. The first time you reach the main menu, Northstar asks whether to sign in to its master server with your EA token. The campaign does not need it; pick No.
4. At the main menu, pick Campaign, then Continue or Mission Select. When the panel shows Connected, BT is at work.
5. Play as usual. Talk to Coo when you need something, such as "hit that titan", "smoke" or "where's the next objective".

How often Coo speaks up depends on BT's initiative (Quick start tab, takes effect at once):

• Passive: speaks and acts when the pilot asks; warns unasked only in mortal danger.
• Balanced (default): calls out the threats that matter; steps in with missiles, smoke or sonar when the fight turns.
• Active: fights alongside throughout, fires, smokes and marks on its own, and reports where to go next after a fight.

Display and focus tab: the default display mode is a borderless window the size of the screen, so the desktop pet shows over the game (exclusive fullscreen hides it). When another window has focus, such as the pet while you type, the game keeps running with sound by default.

To have the pet's bubble appear together with BT's subtitle and voice, tell Coo: "Put the titan channel and the bubble in the same reply, titan channel first, bubble right after it."

Configuration

Common keys. The Quick start and Display and focus tabs and the config page all edit them.

| Key | Default | Meaning | |---|---|---| | gameDir | empty | Game folder; empty finds the Steam copy | | initiative | balanced | Initiative: passive, balanced, active | | display.mode | borderless | borderless, windowed, fullscreen (exclusive) or game (leave the game's setting) | | display.resolution | empty | Like 2560x1600; empty takes the primary screen's | | focus.keepRunning | true | Keep the game running when another window has focus | | voice.engine | gpt-sovits | BT's voice engine: gpt-sovits or voxcpm2 (NVIDIA only) | | voice.sampleLanguage | tchinese | Game audio language the sample is cut from, such as english | | story.language | tchinese | Game subtitle language, such as english | | story.frameSec | 30 | Least seconds between game frames attached to story events; 0 attaches none | | subtitle.traditional | true | Traditional characters in subtitles (the Traditional Chinese game's font has no others) |

The rest is in src/config.ts. How it works inside (protocol, launch flow, tools and events, subtitles and voice) is in docs/internals.md (Chinese).

Limits and FAQ

• Always start the game with Launch game, or through Coo. Starting it from Steam or the EA app runs the original game without Northstar, and Coo hears nothing from it. The panel then says the Steam launch is the original game; close it and press Launch game.
• The game shows #ORIGIN_LOGGED_OUT and exits: the EA app has not finished signing in. Wait for it, then press Launch game.
• "There was a problem processing game logic" drops you to the main menu: a known issue, mostly at the start of chapter 7 when a blown wall spawns many enemies at once. Northstar's network callback collides with the game's spawning script. The World makes it rarer but cannot rule it out. Press Continue to go back in.
• GPT-SoVITS or VoxCPM2: the game and the voice share one GPU. With the game running, GPT-SoVITS took over ten seconds per line in tests, VoxCPM2 two or three. With an NVIDIA GPU, VoxCPM2 keeps up better; without one, only GPT-SoVITS (CPU tier) works and BT speaks slowly.
• Game not voiced in Mandarin: the default sample comes from the Traditional Chinese (Mandarin) voice pack. In the config, set the sample language to the game's (such as english), and replace the sample line and sample text with a BT line in that language and its exact transcript.
• Subtitles in traditional characters: the Traditional Chinese game's font has no simplified ones. With the English game, turn off "Traditional characters" in the config.
• It changes the game folder and settings: Northstar and the mod go into the game folder. Delete NorthstarLauncher.exe, NorthstarLauncher.pdb, r2ds.bat, ns_startup_args*.txt, R2Northstar\, bin\x64_dedi\ and bin\x64_retail\wsock32.* to return to the original game. Prepare and Launch game rewrite the game's display settings from the Display and focus tab (not when the display mode is "keep the game's setting").
• Story frames go to the model: when the chat model takes images, story lines carry a screenshot of the game, billed as model usage. The shot is read from the screen, so windows over the game (such as the pet) are in it.
• Campaign only; multiplayer is not supported.

开发 · Development

corepack pnpm install
corepack pnpm typecheck
corepack pnpm test
corepack pnpm build:webui

许可 · License

MIT. src/binka.ts is a port of FFmpeg code under LGPL-2.1-or-later; see THIRD_PARTY_NOTICES.md.