Century-Ula/dsh-roblox-Blender ↗★ 2
dsh-roblox-blender
Drive Roblox Studio and Blender / 3ds Max from the DeepSeek Harness agent: the ZeroScript-Free bridge as a DSH plugin, with 30+ Studio tools, headless DCC builds, a web console, and no terminal window.
安裝
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Century-Ula/dsh-roblox-Blender說明文件
閱讀完整 README ↗使用
让 Agent 直接干活(主用法)
重启 DSH 后,直接对 Agent 说需求即可,例如:
在 Workspace 里放一个 10×1×10 的 Part,用红色塑料材质
读一下 ServerScriptService 里的主脚本,把玩家跳跃高度改成 60
打开 Play 模式,帮我看看控制台有没有报错
给这个模型截个图,看看光照是否合适
Agent 会自己选择 roblox_execute_luau、roblox_script_read、roblox_screen_capture 等工具,
链路是 Agent → 插件 → bridge.py → StudioMCP → 你的 Studio,全程不经过任何聊天网页。
Studio 侧一次性设置
- 打开 Roblox Studio 并加载一个 place;
- 顶部 Assistant AI → 右上 … → Manage MCP Servers → Enable Studio as MCP Server。
只做一次;之后 Studio 每次启动、插件会自动连上。
独立控制台网页
浏览器打开 ****:
- 顶部状态灯:Bridge / Studio / MCP,右侧显示工具数量;
- 左侧 30+ 个工具(带中文说明)+ 搜索;
- 中间按 schema 自动生成参数表单,或切
JSON手写参数,Ctrl/⌘+Enter执行; - 右侧调用记录;截图会直接内联显示;
- 顶部还有
检测 Studio、刷新工具、启动 Bridge、重连等诊断按钮。
DSH 侧栏面板
刷新 DSH 页面后,左侧栏底部出现 Roblox+Blender 图标,点开是同一套状态灯、工具列表和执行台。 两条 UI 走同一套 HTTP API,结果永远一致。
配置
配置写在 profile patch 条目的 config: 下(见 cordis.patch.example.yml),也可以直接用默认值。
| 字段 | 默认值 | 说明 |
|---|---|---|
port | 17613 | Bridge 端口,对应 ZeroScript 的 ZS_BRIDGE_PORT |
bridgeDir | "" | 含 bridge.py 的目录;留空按版本号自动挑选最新安装 |
autoLaunch | true | Bridge 没在跑时自动以隐藏窗口拉起 |
exposeTools | all | all = 每个 Studio 工具一个 DSH 工具;generic = 只留 3 个常驻工具(省 token) |
toolPrefix | roblox_ | 工具名前缀 |
toolCallTimeoutMs | 120000 | 单次工具调用超时 |
statusPollMs | 5000 | 状态轮询间隔 |
blender / max / zbrush | "" | 显式指定建模软件路径;留空自动探测 |
openCloudKey | "" | Roblox Open Cloud API key(上传资产用)。建议改用环境变量 |
creatorUserId / creatorGroupId | "" | 上传资产归属的用户 / 小组 |
环境变量(更安全,避免密钥进配置文件):
setx ROBLOX_OPEN_CLOUD_KEY "你的 key"
setx ROBLOX_CREATOR_USER_ID "你的用户 ID"
Open Cloud key 需要
assets权限的 Read + Write;上传的是 package(含 MeshPart), 单次 ≤ 20 MB,且会经过审核。