coop-anything README

项目的 README,来自 github.com/cranebeaker/coop-anything。合并为一个 markdown 文件:README.md。

Co-op Anything

Any single-player game. Your friends. Your agent does the work.

Support me on Ko-fi Join the Discord Browse every co-op mod on CoOp:Anything

Quick start · How it works · What you can co-op · Games so far · Contribute · FAQ · Docs

Want to play a single-player game with your friends? Point your AI coding agent at this repo. It researches what exists, reverse engineers the game and its engine if it has to, builds or fixes the co-op, tests it with bots inside the game, and packages it so your friends install it in one click and join over Steam without port forwarding.

The sky is the limit. Every game that runs on your PC is a candidate.

Playing on one PC? Couchlink runs a copy of the game for each player, each with their own part of the screen, their own controller or keyboard and mouse, and their own Steam account if they want one. It works with co-op mods and with games that only play online. Mods made here can plug into it: see the couchlink skill.

Games being made co-op right now: Deus Ex (released) · Fallout: New Vegas · Zelda: Ocarina of Time (fully synced) · Dungeon Keeper · S.T.A.L.K.E.R. Shadow of Chernobyl

From the community: Mega Man X and Mega Man X4 (native PC with co-op netplay) · Pilotwings 64 (split-screen) · Crab Champions · Stacklands · Half Sword · Enter the Gungeon · Clive Barker's Jericho · Poppy Playtime · Divinity II (split-screen) · Command & Conquer 3 (campaign co-op) · Far Cry 2 · Gothic 3 · Fear & Hunger · Modern Warfare 2 (campaign co-op) · Little Nightmares (on our Discord) · yours next?

Quick start

Tell your agent (Claude Code, Codex, Gemini CLI, Cursor, OpenCode, ...):

Read https://github.com/cranebeaker/coop-anything and follow AGENTS.md.
I want to play <game> in co-op with my friends.

The agent follows AGENTS.md and the skills in .agents/skills (also in .claude/skills for Claude Code).

Add the MCP server

The Co-op Anything MCP lets any agent search the co-op directory, detect a game's engine from its install folder, read the playbook and skills, and validate contributions. Claude Code picks it up from this repo's .mcp.json; for other agents:

claude mcp add coop-anything -- python <clone>/tools/mcp/coop_mcp.py

Codex, Gemini CLI and Cursor setup: playbook/mcp.md. For the binary work, pair it with a reverse-engineering MCP such as REA (npx rea-agents setup): Co-op Anything knows what to do, REA looks inside the game.

How it works

Your agent takes one of two paths.

Path 1: finish what exists Path 2: build it from zero
When A co-op mod exists but is buggy, stalled or abandoned. Most loved games are here. Nothing usable exists.
How Find the last build, mine its bug reports (issues, forums, Discord), audit the code, fix it as a separate package, test, ship. Reverse engineer the game and engine, hook in, show the second player, sync enemies, world and story, handle level changes and saves, test, ship.
Skills coop-research, coop-revive, coop-qa, couchlink coop-reverse-engineer, coop-build-from-zero, coop-networking, coop-sync-testing, coop-qa, couchlink
Guide Reviving abandoned mods How co-op mods work

Both paths end the same way: automated tests with real game clients (QA), easy install, Steam relay networking (networking), and a pull request back here.

Sync test tools

Ready-made, game-agnostic tools for building and testing co-op sync, in tools/. Each has tests, mutation twins and one command that prints ALL OK (python -I tools/test_all.py runs them all).

Tool What it does
chaos UDP relay that adds lag, loss, reorder, duplicates and one-way cuts between real clients, with live control
flight Flight recorder for your mod plus an analyzer: lines up 2 to 4 machines, finds the first desync, shrinks it and writes a regression test
fuzz Seeded N-player co-op fuzzer with invariant oracles (converge, no double apply, one owner, no dupes, nothing stale)
ownership Small C++ library: one owner per NPC with epochs, handoff, and stale echo rejection
fakeworld Example in-memory game world for testing sync without launching the game
gameslot, gamepool Lock and warm pool for running several game copies on one PC safely
scenarios, bots JSON start states plus multi-bot co-op playbooks with a state diff after each step
animcheck Compares animation and pose across machines and flags sliding, T-poses, floating and rubber-banding
bridge, inspect An RPC server template for inside your game (console line, state dump, save, load, screenshot) with a Python client, plus a live side-by-side view of every copy
hotreload Split your mod into a loader and a core, and swap the core inside the running games instead of restarting them
mutants, buildlock Runtime mutation twins for every fix, and a shared build lock with a build cache

Fast iteration shows where the time in an in-game fix round goes and which tool removes each wait.

They come from the fnv-coop project. The coop-sync-testing skill tells your agent when to use which.

What you can co-op

Your game is... Typical approach Tools your agent uses
On an engine with multiplayer already (Unreal 1/2, Source, id Tech, X-Ray) Make the single-player logic run on the existing netcode with script mods Script source, SDK compilers, mod packages
Bethesda (Gamebryo, Creation) Script extender plugin, host-authority sync, reuse Tilted Online style designs SKSE / F4SE / xNVSE, Ghidra, REA
Unity Harmony patches through a mod loader, a networking library in C# BepInEx, MelonLoader, dnSpyEx, Il2CppDumper
Unreal Engine 4/5 Lua or C++ mods with an SDK dump of the game's classes UE4SS, Dumper-7
RE Engine, FromSoftware, other proprietary DLL hooks; extend the game's own online features where they exist REFramework, MinHook, Ghidra, REA, x64dbg
Decompiled or open source (N64 decomps, KeeperFX, OpenMW, source ports) Add networking directly in the code A compiler, the decomp, Docker cross builds
Console only (PS1, PS2, N64, Dreamcast, GameCube, Wii, GBA, ...) Decomp or recompiled PC port first; else emulator netplay, or a memory-sync mod between two emulators Decomps and recompilers (N64Recomp, XenonRecomp), PCSX2 PINE, Dolphin Memory Engine, BizHawk / mGBA Lua
Closed binary, nothing else Full reverse engineering of state, saves and levels; the hardest path REA, GhidraMCP, ida-pro-mcp, Frida, Cheat Engine

Console games: emulator co-op and decompiled or recompiled PC ports, the route Ocarina of Time co-op took.

Couch co-op on one PC? Split screen builds on Nucleus Co-op (Windows) and PartyDeck (Linux and Steam Deck), both open source.

Full tool list with install notes: playbook/tools.md. Which engine has co-op work you can reuse: playbook/engine-families.md.

Games so far

Game What was done Release Write-up
Deus Ex (2000) Revived the HX co-op mod: fix package, Steam relay, automated test suite deus-ex-coop games/deus-ex
Dungeon Keeper (1997) Shared-keeper co-op on KeeperFX, Steam relay networking dungeon-keeper-coop games/dungeon-keeper
S.T.A.L.K.E.R. Shadow of Chernobyl Fix patch for Shadow of COOP (true ending unlocked) stalker-soc-coop-fixes games/stalker
Fallout: New Vegas Story co-op: shared quests, dialogue results, karma and reputation fnv-coop games/fallout-new-vegas
Zelda: Ocarina of Time Fixes for a fully synced Ship of Harkinian co-op fork ocarina-coop games/ocarina-of-time

Plus a directory of 230+ co-op mods and gaps for other games (browse and search it at coopanything.app), each with what it really syncs and how well it was tested.

Everyone is a contributor

Every agent that works on a game sends what it learned back as a pull request: a fix, a bug list, a test, a failed attempt, a corrected directory entry. One person's agent gets a game halfway; the next one starts from there. Pooled together, that's enough compute to get even the biggest games over the line.

CONTRIBUTING.md has the details. Chat with other contributors on Discord.

FAQ

Do I need to know how to code? No. You need the game, a coding agent and some patience. The agent asks before installing anything or using your accounts.
Does my friend need to buy anything? Everyone needs the game installed. The Steam relay uses Valve's free Spacewar test app, so nobody buys anything else.
Is this legal? Modding games for co-op with friends is what the modding community has always done. This repo doesn't host game files or assets (agents can build on decompiled code in each game's own repo), and it doesn't touch anti-cheat or online services. See the rules below.
Will it work for my game? Yes. Some games need more agent hours than others, but it's definitely possible. Check the directory first: if a co-op mod already exists (path 1), most projects take days at most. If nothing exists (path 2), it depends on the engine; the table above gives a feel for it.

Documentation

Rules

Don't commit game files or assets here. Building on decomps is fine; a game's code lives in its own repo. No personal info. Credit the mods you build on and give fixes back to them. Co-op only: nothing that cheats in other people's multiplayer games or touches anti-cheat.

License: MIT.

coop-anything (cranebeaker/coop-anything)

正在搜索数据库…

这是什么?Co-op Anything 是一个 MCP 服务器,外加一套技能与操作手册。它能让 AI 编程代理对任何单机 PC 游戏进行逆向工程、修复、测试并发布联机合作功能,然后打包,方便朋友通过 Steam 安装并加入,无需端口转发。
这是我自己运行的工具,还是把工作交给 AI 代理?这不是一个可以直接运行的应用,而是一个 MCP 服务器加上技能与操作手册库。你的编程代理(Claude Code、Codex、Gemini CLI、Cursor、OpenCode)会读取它们并据此完成改装工作。
除了编程代理,我还需要专门的逆向工程工具吗?你需要一个编程代理(Claude Code、Codex、Gemini CLI、Cursor、OpenCode),如果要处理二进制文件,还需要一个逆向工程 MCP,例如 REA。根据游戏引擎的不同,你可能还需要 Ghidra、Frida、Cheat Engine、BepInEx 或 UE4SS 等工具。
这个方法一定能用在我的游戏上吗?不同游戏所需的工作量差异很大:如果已经有现成的联机改装,大多数项目只需几天;但从零开始做联机功能高度依赖游戏引擎,而没有任何现成改装的闭源二进制文件是最难的情况。
我需要会写代码才能用吗?不需要。你只需要安装好游戏、准备一个编程代理,再有点耐心即可。代理在安装任何东西或使用你的账号之前都会先征求你的同意。
它能在 Windows、Linux 和 Mac 上用吗?同屏合作呢?MCP 和技能可以在任何运行编程代理的 PC 上使用。专用的分屏启动器也已经存在:Windows 上有 Nucleus Co-op,Linux 和 Steam Deck 上有 PartyDeck,两者都是开源的。
这种游戏改装方式的许可协议和规则是什么?本项目采用 MIT 许可证,并将其视为普通的粉丝改装:不托管游戏文件或素材,不触碰反作弊或在线服务,仅基于各游戏自有仓库中保存的反编译代码来构建联机合作功能。
用这种方式为单人游戏改装联机合作,真的合法吗?维护者将其视为标准的粉丝改装:本仓库从不托管游戏文件或素材,代理所基于的反编译代码保存在各游戏各自独立的仓库中,并且不涉及反作弊或在线服务。
哪些游戏已经通过这个项目实现了联机合作?已发布的示例包括 Deus Ex、Dungeon Keeper、S.T.A.L.K.E.R. Shadow of Chernobyl、Fallout: New Vegas,以及同步完善的 Zelda: Ocarina of Time。此外,coopanything.app 上有一个可搜索的社区目录,收录了 230 多个其他联机改装,以及尚缺联机功能的游戏。
同步测试工具是用来做什么的?本仓库提供了与具体游戏无关的工具:chaos(在真实客户端之间注入网络延迟或丢包)、flight(记录不同步问题并自动缩减为回归测试)、fuzz(带种子的多人不变量模糊测试器),以及 ownership(用于 NPC 所有权移交的 C++ 库)。它们可以在不运行实际游戏的情况下调试联机同步问题。
大小
5.4 MB
星标
2.2K
更新
提交Nov 17
时长
1个月
提交 · 90 天