Co-op Anything — 让 AI 编程 Agent 把单机游戏改造成可联机合作

技能简介

Co-op Anything 是一套面向 AI 编程 Agent 的开源技能包（Agent Skills + MCP 服务），目标只有一个：把任意单机游戏改造成能和好友一起玩的合作模式。你只需要把 Agent 指向这个仓库，说一句「我想和朋友一起玩某个游戏」，它就会自己调研现状、必要时逆向游戏的引擎、构建或修复联机功能、在游戏内用机器人做自动化测试，最后打包成一键安装的版本，让朋友通过 Steam 中继直接加入，无需端口转发。仓库由一个 AGENTS.md 主控文件和一组细分技能组成，Claude Code、Codex、Gemini CLI、Cursor、OpenCode 等支持 Agent Skills 的工具都能直接读取。

核心能力

• 双路径工作流：路径一「修复存量」——当某款游戏已有联机 Mod 但存在 Bug、停更或废弃时，Agent 会找到最后一个可用版本、挖掘 issue 与论坛里的报障记录、审计代码并以独立包的形式修复；路径二「从零构建」——完全没有可用方案时，逆向游戏与引擎、挂钩渲染与网络层、同步敌人/世界/剧情、处理关卡切换与存档。
• 七类专用技能：coop-research（调研现有方案）、coop-revive（复活废弃 Mod）、coop-qa（自动化验收）、coop-reverse-engineer（逆向工程）、coop-build-from-zero（从零构建）、coop-networking（联机网络）、coop-sync-testing（同步测试），按任务阶段自动挂载。
• 内置同步测试工具箱：chaos（UDP 中继，注入延迟、丢包、乱序、重复与单向断流）、flight（飞行记录仪，对齐 2~4 台机器定位首个不同步点并收缩成回归测试）、fuzz（带不变式判定的多人模糊测试）、ownership（每 NPC 单归属人 + 纪元切换 + 陈旧回声拒绝的 C++ 库）、fakeworld（无需启动游戏的内存世界）、gameslot/gamepool（单机多开的安全锁与预热池）、bots/scenarios（JSON 起始状态 + 多机器人协同剧本，每步做状态差分）。
• 游戏内机器人验收：不靠「代码看起来对」，而是真实游戏客户端跑自动化测试，每步比对状态差分与画面。
• 一键安装 + Steam 中继：产出的联机包由朋友一键安装，经 Steam 中继加入，不需要公网 IP 或手动端口转发。
• 贡献回路：完成的改造以 Pull Request 形式回流仓库，目前已覆盖 Deus Ex（已发布）、辐射：新维加斯、塞尔达传说：时之笛（已全量同步）、地下城守护者、S.T.A.L.K.E.R. 切尔诺贝利之影等。
• MCP 服务：可检索联机目录、从安装目录识别游戏引擎、读取 playbook 与技能、校验社区贡献。

安装配置

1. 克隆仓库到本地：git clone https://github.com/cranebeaker/coop-anything。
2. 注册 MCP 服务（Claude Code 可直接读取仓库内 .mcp.json，其它客户端手动添加）：claude mcp add coop-anything -- python /tools/mcp/coop_mcp.py。
3. 需要深入二进制层面时，搭配逆向类 MCP（如 REA，npx rea-agents setup）：Co-op Anything 负责「该做什么」，逆向 MCP 负责「游戏内部长什么样」。
4. Codex、Gemini CLI、Cursor 的具体接法见仓库 playbook/mcp.md。

使用步骤

1. 打开你的 AI 编程 Agent，把仓库地址和「我想和朋友联机玩某某游戏」一起丢给它，让它按 AGENTS.md 执行。
2. Agent 先调研该游戏是否已有联机 Mod、当前状态与已知问题，输出两条路径的选择建议。
3. 确认路径后，Agent 按阶段加载对应技能，逐步完成逆向 / 修复 / 网络同步 / 存档兼容。
4. 用 python -I tools/test_all.py 跑全量自测（每个工具都带测试与变异孪生，全部通过会打印 ALL OK）。
5. 在真实游戏客户端里跑多机器人协同剧本，确认同步无偏差后打包发布给朋友。

适用场景

• 老游戏复活：想和朋友重温 Deus Ex、新维加斯这类只有单机的经典作品。
• 联机 Mod 抢救：已有联机 Mod 但长期停更、Bug 遍地，希望有人系统性地修。
• 引擎级折腾：想看 AI Agent 如何在没有源码的情况下逆向引擎并接管网络层。
• 同步质量验证：需要可复现的丢包/乱序/断流测试环境来验证联机稳定性。
• AI Agent 能力演示：作为「Agent 能完成多长链条工程任务」的实战样本。

适用人群

• 喜欢折腾老游戏、有基本命令行能力的玩家
• 使用 Claude Code / Codex / Cursor 等 AI 编程工具的开发者
• 研究 AI Agent 长任务编排与自动化验收的工程师
• 游戏 Mod 作者与逆向工程爱好者

工作原理

仓库把「把单机变联机」这件事拆成可委派的技能与可验证的工具：AGENTS.md 定义总流程与产出标准，.agents/skills 下的技能按阶段提供方法论，tools/ 提供与游戏无关的同步测试基础设施，MCP 服务负责让 Agent 结构化地查询目录、识别引擎并校验贡献。关键在于验收环节——所有改动都必须通过真实客户端的自动化测试与状态差分，才算完成，而不是靠代码评审通过。

官方链接

• GitHub：https://github.com/cranebeaker/coop-anything
• Discord 社区与赞助入口见仓库首页
• 协议：MIT