Tripwire

Tripwire 可让助手读取、写入和编辑数据模型，通过模拟输入驱动游戏测试，在真实引擎中以无头模式运行代码化测试，标记游戏代码中的客户端信任漏洞，并调用 Open Cloud API（DataStores、MessagingService、Memory Stores 等）。Studio 工具无需 API 密钥；无头测试、资产和 Open Cloud 工具需要 Open Cloud 密钥。

要求

• 一个 MCP 客户端：Claude Code、Codex、Gemini，或任何通过 stdio 使用 MCP 的客户端。
• Roblox Studio，用于 Studio 工具。这些工具无需 API 密钥。
• Node.js，仅在使用 npx 运行服务时需要。预构建二进制文件无需 Node。
• 对于无头测试、资产和 Open Cloud 工具：已发布的 place 和 Roblox Open Cloud API 密钥。请参阅 Open Cloud 设置。

快速开始

Tripwire 面向通过 AI 编码 Agent 操控 Studio 的 Roblox 开发者。

1. 将服务接入 MCP 客户端（只需一条命令或一小段配置，见下文的 安装）。
2. 安装 Studio 插件，以便 Studio 工具能够连接 Studio（见安装步骤中的插件部分）。
3. 在 Studio 中打开 place，启用 Game Settings > Security > Allow HTTP Requests，然后点击 Tripwire 工具栏按钮，并在面板中按下 Connect。面板会显示 Connected，Output 中会打印 [Tripwire v...] connected。
4. 让 Agent 运行 studio_status。Studio 显示已连接即表示桥接正常工作。
5. 可选：添加 Open Cloud 密钥，以使用无头测试、资产和 Open Cloud 工具（见 Open Cloud 设置）。

安装

Tripwire 的服务是一个独立二进制文件。最简单的运行方式是使用 npx，它会获取适用于你平台的预编译二进制文件，因此无需安装 Rust 工具链。更倾向于手动使用二进制文件或从源代码构建？请参阅本节末尾的替代方案。

claude mcp add --transport stdio tripwire -- npx -y tripwire-roblox

{
  "mcpServers": {
    "tripwire": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tripwire-roblox"]
    }
  }
}

[mcp_servers.tripwire]
command = "npx"
args = ["-y", "tripwire-roblox"]

{
  "mcpServers": {
    "tripwire": {
      "command": "npx",
      "args": ["-y", "tripwire-roblox"]
    }
  }
}

command: npx
args:    ["-y", "tripwire-roblox"]

git clone https://github.com/aliboIly/Tripwire.git
cd Tripwire/server
cargo build --release   # produces server/target/release/tripwire-server

cd Tripwire/plugin
npm install
npx rbxtsc
rojo build --output Tripwire.rbxmx
cp Tripwire.rbxmx ~/Documents/Roblox/Plugins/   # macOS; Windows: %LOCALAPPDATA%\Roblox\Plugins

Open Cloud 设置

Tripwire 的大多数功能不需要凭据。以下工具需要凭据，因为它们会调用 Roblox Open Cloud：run_luau、无头测试（run_tests、run_test_file、list_tests），以及下文 Open Cloud 各部分中的所有工具（资源、发布、数据存储、消息、内存、宇宙和服务器、Engine Instance API、审核、密钥、变现、Creator Store、群组、分析、平台和 open_cloud_request）。这些工具使用 Roblox Open Cloud API 密钥进行身份验证。

使用风险自负。 Open Cloud 密钥是真实的凭据，可对你的体验产生实际影响。根据授予的权限范围，它可以读取并覆盖线上 DataStore、发布地点的新版本、将资源上传到你的账户，以及向你的服务器发送消息。请像对待密码一样对待它：只授予实际需要的权限范围，将其限制为你自己的 IP，切勿提交该密钥；如果密钥泄露，请立即撤销。你需要对使用该密钥所做的一切负责。Tripwire 与 Roblox 无关联，也未获得 Roblox 背书。

1. 创建密钥

1. 前往 create.roblox.com/dashboard/credentials 并登录。
2. 点击 Create API Key，为密钥命名（例如 Tripwire）。
3. 在 Access Permissions 下，仅添加你需要使用的工具对应的 API 系统，并授予每个系统所需的操作权限，权限范围限定为你的体验。控制面板提供的每个系统都有对应的工具，映射关系见下方的权限与工具。简要说明：
   • Luau Execution（写入）：run_luau 和无头测试。
   • universe-places（写入）：publish_place。
   • Assets（读取 + 写入）和 Asset Permissions：资源工具。
   • DataStores 和 Ordered DataStores：数据存储工具。
   • Messaging Service（发布）和 Memory Stores：对应工具。
   • Universe、Place、Instance、User Restrictions、Secrets、Analytics：宇宙、服务、实例、内容审核、密钥和分析工具。
   • Developer Products、Game Passes、Creator Store：变现和商店工具。
   • User/Group/Inventory/Subscription/Notification：平台、群组和互动工具。
   • 其他所有系统（旧版和实验性系统）：open_cloud_request。
4. 在 Security 下，将 Accepted IP Addresses 设为你设备的 IP，或设为 0.0.0.0/0 以允许任意 IP（本地使用时最简单）。如有需要，可设置过期时间。
5. 点击 Save & Generate Key 并复制密钥字符串。密钥只会显示一次。

2. 查找宇宙 ID 和地点 ID

在 Studio 命令栏中（依次点击 View、Command Bar），运行：

print("universe", game.GameId, "place", game.PlaceId)

GameId 是你的 ROBLOX_UNIVERSE_ID；PlaceId 是你的 ROBLOX_PLACE_ID。地点必须 发布到 Roblox，Open Cloud 才能对其执行操作。

3. 为 Tripwire 提供凭据

在仓库根目录创建 .env。该文件已加入 gitignore，服务会自动加载：

ROBLOX_OPEN_CLOUD_KEY=paste_the_key_here
ROBLOX_UNIVERSE_ID=000000
ROBLOX_PLACE_ID=000000
ROBLOX_CREATOR_USER_ID=000000   # only for upload_asset (your user id)

或者也可以将相同的变量放入 MCP 客户端的 env 块中（这些变量优先级更高）。 修改任一配置后，都要重新连接 MCP 服务。只要密钥授予了相应范围，每个工具就能正常工作；如果缺少某个范围，工具会返回 Roblox 自身的错误，因此你可以按需逐步添加范围。

工具

连接

空间查询（只读）

编辑（每项操作均为一步撤销）

测试和无头执行（Open Cloud）

安全审查（静态分析，无需密钥）

DataStores（Open Cloud）

Universe、place 与服务

引擎 Instance API（Open Cloud，无需 Studio）

内容审核（Open Cloud）

密钥（Open Cloud）

群组（Open Cloud）

平台、互动与分析（Open Cloud）

其他所有内容（Open Cloud）

你可以在 Creator Dashboard 中为密钥添加的每种 API 系统，以及使用该系统的工具。范围 名称与控制面板和 Roblox 错误消息中使用的名称一致。

你可以做什么

• 根据提示词构建场景。 创建和批量创建实例、设置类型化属性、插入模型并编写脚本，每项操作都会成为独立的撤销步骤。
• 在 CI 中测试游戏玩法。 编写测试规范，通过 Open Cloud 在真实引擎中以无头模式运行，并根据结果决定是否通过拉取请求。
• 在漏洞上线前发现它们。 安全审查器会标记信任客户端输入的服务端处理程序，并提出服务端修复方案；同一检查也会在每个 PR 上自动运行。
• 进行真实的游戏测试。 进入 Play 模式、发送键盘和鼠标输入、让角色走到指定位置、读取合并后的服务端和客户端输出，然后停止。
• 检查正在运行的 place。 读取实例树、按名称或属性搜索、读取和 grep 脚本，并获取 Output 日志。
• 自动化 Open Cloud。 为测试固件填充 DataStores、发布 place、广播 MessagingService 主题，或查询用户、群组和库存。

已知限制

这些是平台限制，并非错误。在这里写明，是为了让你事先了解。

• F5 播放测试停止仅尽力而为。stop_playtest 可能无法生效，因为插件和正在运行的游戏属于不同的 DataModel。stop_simulation（F8）可以正常停止。如果 F5 播放测试无法停止，请在 Studio 中按下 Stop。
• 游戏内操作通过注入的运行器执行。播放测试期间的输入、运行时状态和停止操作会通过桥接转发，而不是直接调用插件。
• 无头测试在服务器上下文中运行。Open Cloud 会在服务器上运行你已发布的场景，此时 RunService:IsStudio() 为 false，且插件 API 不可用。可用它测试服务器和游戏逻辑以及安全性，不适用于 Studio 插件或客户端输入行为。
• 与 Roblox 内置 Assistant 的工具对等性需要手动维护。
• Roblox 方面的多个 Open Cloud 系统处于 Beta 或实验阶段（Instance API、用户限制、密钥、游戏服务器、分析功能，以及 open_cloud_request 背后的所有内容）。其结构可能会变化，而 open_cloud_request 返回的是原始响应，不会整理格式。

Tripwire 由一人利用业余时间维护。Issues 和 pull requests 通常会在约一周内收到回复。回复较慢不代表不会回复。

故障排查

Studio 工具超时或提示没有已连接的 Studio。 插件尚未连接。安装 Tripwire.rbxmx，重启 Studio，点击 Tripwire 工具栏按钮，然后在面板中按下 Connect。面板状态和 Output 中的 [Tripwire v...] connected 均可确认连接成功。

插件提示 HTTP 被阻止。 在当前打开的场景中，启用 Game Settings > Security > Allow HTTP Requests。这是最常见的配置问题。没有此设置，Studio 无法连接本地桥接服务。

Output 显示插件和服务器的版本不匹配。 已安装的 .rbxmx 版本过旧。重新构建它（npx rbxtsc && rojo build --output Tripwire.rbxmx），将其复制到 Plugins 文件夹，然后重启 Studio。插件会显示其编译版本，因此前缀会告诉你实际安装的版本；面板标题也会显示相同版本。

Open Cloud 工具返回 401 Invalid API Key。 API 密钥本身未被接受：它可能已重新生成、过期，或复制不完整。所有工具都会以相同方式失败。请在 Creator Dashboard 上重新创建或复制密钥，替换 ROBLOX_OPEN_CLOUD_KEY，然后重新连接 MCP 服务。

Open Cloud 工具返回 403 或权限范围错误。 密钥缺少该工具所需的权限范围、universe 或 place ID 有误，或者场景尚未发布。请在 Creator Dashboard 上添加所需权限范围（工具说明中会注明），确认 ID，然后重新连接 MCP 服务。错误文本由 Roblox 提供，因此会指出缺少的内容。

run_tests 没有看到你的最新更改。 它读取的是已发布的场景。请先发布；rojo serve 只会更新实时编辑会话，不会更新 Open Cloud 运行的内容。

npx 无法获取服务器。 你没有安装 Node.js，或者首次下载时没有网络连接。请安装 Node，或使用 Releases 页面中的预构建二进制文件，并将 command 指向该文件（参见 Install 下的 Alternatives）。

服务器提示桥接端口正被占用。 先前的服务器仍占用端口 44331。请关闭旧的 MCP 会话或残留进程，然后重新连接。

先例项目

Studio 运行时方案（由插件对本地服务器进行长轮询，并注入游戏内运行器） 借鉴了 boshyxd/robloxstudio-mcp 和 Chrrxs/robloxstudio-mcp 中的思路。Tripwire 是独立从头实现的项目；无头测试框架、CI 安全审查器和 Open Cloud 工具均为其自行开发。

贡献

欢迎提交 Bug 报告、功能建议和补丁。有关环境设置、构建门禁以及分支和提交规则，请参阅 CONTRIBUTING.md；有关各部分如何协同工作，请参阅 ARCHITECTURE.md。参与本项目即表示你同意遵守行为准则。

发现安全问题？请勿公开提交 issue。有关私下披露的流程，请参阅 SECURITY.md。

更新日志

每个版本的发行说明请查看 Releases 页面。

许可证

MIT。请参阅 LICENSE。