用途:从 Claude Code 远程控制与自动化 Unity 编辑器,覆盖 GameObject、组件、变换、场景、资源、预制体、材质、着色器、控制台、EditorPrefs、菜单执行等任务,适用于批量操作、实时测试、CI/CD 与数据库驱动工作流。
主要能力:基于 WebSocket 的 JSON-RPC 2.0 实时双向通信;当前已实现 86+ 命令、15 个类别(连接状态、GameObject 与层级、Transform、Component、场景、资源数据库与编辑器、控制台、EditorPrefs、等待、链式命令、菜单、资源、预制体、材质、着色器);可选 SQLite 集成,按 GUID 持久跟踪 GameObject,多场景每秒同步,支持批量操作与撤销/重做;支持 ScriptableObject 的 CRUD、数组/列表与嵌套属性访问;可执行 Unity 菜单项。
使用方式:需 Unity 2020.3 或更高版本,安装 Unity 包并配置 WebSocket 服务器(Tools > Unity Editor Toolkit > Server Window,点击 Install CLI)。命令在 Unity 项目根目录运行:cd <unity-project-root> && node .unity-websocket/uw <command> [options]。使用前先读 references 文档并运行 --help,避免直接读源码。端口自动分配于 9500-9600,状态文件为 {ProjectRoot}/.unity-websocket/server-status.json。
限制:仅本地连接(127.0.0.1);等待命令有延迟响应(默认 5 分钟超时),域重载会取消等待请求;链式命令不支持等待命令;当前为实验性 Phase 2,动画、物理、光照、相机、音频、导航等 400+ 命令仍在规划中。具体收费、价格与平台支持暂未提供。