用途:在运行中的 Roblox 游戏里模拟鼠标、键盘与指针输入,以程序化方式测试 UI 交互,例如点击按钮、填写文本框、滚动、缩放、平移、拖拽与相机视角旋转。
主要能力:通过 execute_luau 创建 VirtualInput,定位 UI 元素并注入输入,再用 screen_capture 截图和 get_console_output 检查错误,形成“交互—验证”循环。提供 /vi-click、/vi-type、/vi-key、/vi-mouse-position、/vi-camera、/vi-scroll、/vi-walkthrough 等命令,支持单击、双击、右键、按键与组合键、滚轮、平移、缩放以及 FPS 式相机移动。
使用方式:必须先进入 Play 模式并保证 PlayerGui 已填充,再在每次 execute_luau 调用中创建一次 VirtualInput。交互前可先做环境检查与 UI 发现,获取元素的 AbsolutePosition、AbsoluteSize、可见性以及可点击/可输入/可滚动类型。多 Studio 实例时需先调用 list_roblox_studios 与 set_active_studio。
限制:不能与 CoreGUI 元素(顶栏、聊天、退出菜单等)交互,会抛异常;不能发送绑定到核心动作的按键(如 Tab、Escape、Backquote、F1、F9);按下与释放必须成对,否则状态重复会报错;发相机增量前需先锁定光标;MCP 截图不会自动保存到磁盘,如需留档要显式保存。具体收费与价格暂未提供。