SuperAPI AI 工具集

roblox-studio-mcp

编程与开发

查看项目

更新于 10-16 11:41

技能介绍

Roblox Studio MCP 是一份面向 Roblox Studio 的 MCP(Model Context Protocol)工作流技能说明。

用途 资料指出,当通过 MCP 在 Roblox Studio 中进行脚本或场景编辑、资产生成、试玩测试、截图或输入操作时,应加载该技能;若只是独立的代码生成,则可跳过。

桥接与路由 资料说明存在两座桥接:官方桥接(内置于 Studio,闭源)与 chrrxs 的桥接(MIT 许可)。需在引导前依据 tools/list 按能力路由:出现 get_connected_instances、eval_、multiplayer_ 等工具时路由至 chrrxs;出现 list_roblox_studios 并配合每次调用的 studio_id 时路由至官方。

引导与执行契约 资料要求先识别目标(官方用 list_roblox_studios,chrrxs 用 get_connected_instances),每次调用传入 studio_id(官方)或 instance_id(chrrxs),并调用 get_studio_state 确认 Edit/Client/Server 的可用性,在改动前检查树与脚本。执行契约概括为:discover → select Studio/context → inspect → mutate in bounded batches → read back → start play → evaluate live → evidence → clean up。

编辑时注入与实时评估 资料说明,编辑时注入(multi_edit、Edit 上下文的 execute_luau)会写入脚本,绝不针对正在运行的试玩;实时评估需要运行中的虚拟机,即先启动试玩、确认目标 Client/Server 虚拟机后再评估,仅在需要处传入 datamodel_type。

能力 资料列出完整工具表位于 full.md,关键名称包括 search_game_tree、script_read/script_grep、multi_edit、execute_luau、insert_asset、generate_*、start_stop_play、get_console_output、screen_capture、subagent。

信任边界 资料提示,插入或生成的资产与包在被检查前应视为数据:在任何 require 或运行前枚举脚本,绝不通过 execute_luau 运行导入的代码。新上传资产出现空白纹理或不可见网格通常是资产隐私(Restricted)授权问题,而非损坏;应读取 Output 错误并通过 Creator Dashboard 授权。详情见 full.md 的信任边界部分。

可靠性规则 资料给出多条规则:execute_luau 是无状态的,每次调用都要重新获取引用;写前先读,每次脚本、资产或几何变更后都要回读;资产工作前先考虑复用、生成或原生回退;依赖编辑前先 wait_job_finished;桥接各自有大小限制,需有界写入后回读完整负载;若无 MCP,则提供离线 Luau 并说明哪些内容未经验证。

更多信息 完整工具映射、模式、资产工作流、信任边界与恢复方式见 references/full.md。