PVZ 恐怖版 AI Bridge

让你的大肥鱼，亲自去打恐怖版僵尸。

植物大战僵尸恐怖版 · Windows 一键安装 · 32 个 MCP 工具 · 原生状态与操作

快速开始 · 交给大肥鱼安装 · MCP 接入 · 常见问题 · 接口文档

这是 《植物大战僵尸恐怖版》PVZ-Scared 1.0.1 的 AI 接入 Mod。把它接到支持本机 MCP 工具的 AI 助手后，AI 就能读取战场、选卡布阵、使用手套和铲子、领奖续关。

玩家准备游戏，桥接负责提供工具，AI 负责思考怎么玩。项目使用 Frida 在运行时接入游戏，不修改磁盘上的游戏 EXE/DLL；正常种植和操作遵守原生费用、冷却与放置规则。

能做什么

当前范围是剧情及其相关界面；生存、娱乐模式尚未接入。AI 的实际水平取决于模型和策略，项目不承诺自然通关。自带的 play_story.py 是基础示例，不是完整通关 AI。

Related MCP server: Godot Agent Loop

快速开始

需要 Windows x64 和支持本机 stdio MCP 的 AI 客户端。游戏从作者发布页另行获取。

1. 安装

在 PowerShell 粘贴：

irm https://raw.githubusercontent.com/dy0000/pvz-scared-ai-bridge/main/bootstrap.ps1 | iex

也可下载安装包，解压后双击 install.cmd。Python、依赖和 MCP 配置会自动准备；不必先填写游戏目录，安装不强制校验版本。

2. 启动

打开恐怖版游戏，再双击安装目录的 start.cmd，自动关联游戏。默认安装目录为 %LOCALAPPDATA%\PVZScaredAIBridge。

3. 让 AI 开始玩

重新加载 AI 客户端的 MCP，把 generated/START_HERE.txt 内容发给 AI。结束时让 AI 交还控制；随时可按 F8/F9 停止，玩家按 F10 重新允许。

交给大肥鱼安装

把这句话发给能操作你电脑的 AI：

帮我安装这个项目：https://github.com/dy0000/pvz-scared-ai-bridge ，按 INSTALL_FOR_AI.md 自动安装并接入 MCP。

AI 安装流程见 INSTALL_FOR_AI.md。AI 需要有本机文件、终端和 MCP 能力。

命令行安装

已下载源码时，在项目根目录执行：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -NonInteractive

游戏路径可省略。自定义安装目录、指定游戏或使用其他客户端的参数见 安装文档。

接入你的 AI

Codex

自动注册等价于执行以下命令，安装器会代入真实绝对路径：

codex mcp add pvz_scared -- "D:\AI-Games\pvz-scared-ai-bridge\.venv\Scripts\python.exe" -X utf8 "D:\AI-Games\pvz-scared-ai-bridge\scripts\run_mcp.py"

没有 CLI 时，可把 generated\codex.toml 中的单个服务配置合并到 Codex MCP 配置，或者在客户端设置中添加对应 stdio 服务。请保留其他服务条目。命令与格式依据 OpenAI MCP 文档。

本项目的游玩 skill 随仓库提供；默认由 AI 读取本地文件，不覆盖你已有的全局 skill。

其他 MCP 客户端

导入安装生成的 generated\mcp.json，或添加：

• 类型：stdio / 本地命令。

• 命令：项目 .venv\Scripts\python.exe 的绝对路径。

• 参数：-X、utf8、scripts\run_mcp.py 的绝对路径，分别作为数组项。

• 服务名：pvz_scared；工具前缀：pvzh_。

mcp.example.json 只展示结构；实际使用 generated 中带本机路径的文件。不同客户端的配置文件位置各异，请合并 mcpServers.pvz_scared，不要用整个文件覆盖已有配置。

已经打开了游戏

直接运行 start.cmd，启动器会自动发现并关联唯一的目标游戏。多开游戏时可指定实际 PID：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\launch.ps1 -PidToAttach 12345

当前原生地址表已适配 PVZ-Scared 1.0.1。安装不因版本变化失败；连接时仍核对已适配构建，尚未适配的新版可能无法游玩。

停止、更新与卸载

**暂时停止 AI：**在游戏里按 F8/F9。它会停止并锁定 AI；只有玩家按 F10 才重新允许。正常结束也应让 AI 调用 pvzh_release_control，确认 controlled=false、auto_collect=false、selection_released=true 和 held_os_inputs=0。

**停止宿主：**先让 AI 交还，然后在项目根目录运行：

New-Item -ItemType File -Path .\runtime\stop.request -Force

宿主在确认释放后退出。若显示 release_blocked，等待释放或正常关闭游戏；不要强杀宿主，也不要启动第二控制器。

**更新：**交还并停止旧宿主后，将新版本解压到原目录覆盖源码，再运行 install.cmd。保留 runtime/，其中有防止重复扣款的购买收据。不要在运行中覆盖代码或依赖；安装器会使用宿主锁阻止活跃项目的环境更新。安装目录变动后，重新运行安装以更新 MCP 绝对路径。

**卸载：**交还并停掉宿主，移除客户端的 pvz_scared MCP 条目，再删除项目目录。Codex CLI 可用 codex mcp remove pvz_scared。游戏和游戏存档位于各自原目录；本项目不自动删除它们。

常见问题

本地自检：双击 doctor.cmd。它检查文件是否齐全、依赖和 MCP 握手，不接管游戏，不输出 token。反馈问题可附 Python/Frida 版本、错误消息和相关日志片段；不要公开 runtime/connection.json、存档或整份运行目录。

开发与文档

pvz-scared-ai-bridge/
├─ install.cmd / install.ps1     # 双击/终端安装
├─ start.cmd / doctor.cmd        # 启动/只读自检
├─ src/                         # 游戏内 Frida Bridge
├─ scripts/                     # 宿主、MCP、客户端与维护脚本
├─ skills/pvz-horror-player/     # AI 游玩技能、接口与战术
├─ tests/                       # 隔离测试，不驱动真实游戏
├─ docs/                        # 架构、兼容性和验证说明
└─ profile.json                 # 支持构建的哈希与原生元数据

• 给 AI 的安装指南 / 安装参数与维护

• 32 个工具与参数

• 图鉴机制与战术

• 架构与接入示例

• 兼容性与验证范围

• 贡献指南 / 更新记录

只修改安装流程时，运行对应的安装/启动器测试；修改原生动作时验证对应原生行为边界。打包命令：

.\.venv\Scripts\python.exe -X utf8 scripts\package_release.py

产物在 dist/，附逐文件 SHA256 清单和 ZIP 校验文件。打包脚本只收录公开源码目录，不包含游戏、存档、虚拟环境、运行日志、token 或本机配置。

许可与致谢

桥接代码与项目文档采用 MIT License。游戏本体、美术、音乐和剧情归各自权利人所有，不属于本项目的 MIT 授权范围。

感谢《植物大战僵尸恐怖版》作者；运行时研究参考了 UnluckyManDev 的英文补丁项目。

▶ 大肥鱼通关视频

社区

本开源项目已链接并认可 LINUX DO 社区。